如何让Data Studio社区连接器getFields的计算字段捕获更新的参数值

你遇到的问题根源在于getFields()方法的结果会被Data Studio缓存，首次加载时拼接的公式'$Characteristic = "' + request.configParams.characteristic_selected + '"'会被固定下来，后续用户切换下拉选项时，这个计算字段的公式不会重新生成，所以始终用的是初始的参数值。

下面提供两种可行的解决方案：

方案1：在getData()中直接过滤数据（推荐，性能更优） #

这种方法不需要创建计算字段，直接在数据获取阶段根据选中的参数过滤，减少返回的数据量，提升报表加载速度。修改getData()方法即可：

function getData(request) {
  // 获取用户选中的特征值
  const selectedChar = request.configParams.characteristic_selected;
  
  // 示例1：如果是数据库查询，直接在SQL中加入过滤条件
  const sql = `SELECT * FROM your_target_table WHERE Characteristic = '${selectedChar}'`;
  // 执行SQL查询并处理数据...

  // 示例2：如果是内存数据过滤
  const rawData = fetchRawDataFromSource(); // 替换为你获取原始数据的函数
  const filteredData = rawData.filter(row => row.Characteristic === selectedChar);
  
  // 将过滤后的数据转换为Data Studio要求的格式返回
  return {
    schema: fields.build(),
    rows: filteredData.map(row => { /* 转换为符合要求的行格式 */ })
  };
}

方案2：使用动态参数引用重构计算字段 #

如果必须在连接器中提供计算字段，不要直接拼接参数值，而是用Data Studio原生支持的@参数ID语法动态引用配置参数，让公式实时响应参数变化。修改getFields()中的计算字段代码：

fields.newDimension()
  .setId('Characteristic calc')
  .setDescription('选中的特征与维度匹配时返回True')
  .setFormula('$Characteristic = @characteristic_selected') // 用@引用参数ID
  .setType(types.BOOLEAN);

注意：这里的@characteristic_selected要和getConfig()中定义的参数ID完全一致，不需要额外加引号，Data Studio会自动处理参数值的类型匹配。

采用第二种方案后，用户切换下拉控件选项时，计算字段会自动使用最新的参数值，过滤器就能正确过滤出对应的数据，无需在每个报表中手动创建计算字段。

内容的提问来源于stack exchange，提问作者Clusive