Workiva支持中心

通过参数，您可以在每次运行查询时提示用户输入要用于查询筛选器或计算的值。通过在运行时设置这些值，每次运行查询时，都可以在不同的上下文（例如帐户、区域或时间段）中使用查询。

您可以创建自定义参数以用于特定查询，或者您的工作区所有者可以创建全局参数以用于多个查询。

为查询创建自定义参数

您可以在构建器或 SQL 编辑器中设置查询参数。创建参数时，可以在查询中将其与多个筛选条件和计算条件一起使用。 

步骤 1. 创建参数

1. 从 参数 面板中，单击 添加，然后选择 创建新参数。
   
<!--
2. From the Parameters panel, click Create Parameter.
   
-->
3. 为了帮助识别参数，请输入一个仅包含 字母数字字符且不包含 空格的唯一名称。
4. 在 筛选类型中，选择要筛选的数据类型，例如文本或整数。

步骤 2. 设置参数值

当查询运行时，其参数可以接受自由格式的值（基于数据类型），也可以提供特定值列表供选择。 

• 要接受任何自由格式值，请输入默认值（如果适用），然后单击 创建。
• 提供具体数值列表：

1. 启用 选择列表。
2. 要为参数启用多个值，请选中 多选 框。
3. 在 列出选项中，输入要选择的值，每输入一个值后按 Enter 。

   注： 对于日期或时间戳参数，请以 YYYY -MM-dd 格式输入每个选项。

4. 选择参数的任意默认值，然后单击 接受。

   注： 对于 多选参数，请至少选择一个默认值 。

5. 点击 创建 完成。

步骤 3. 在查询中使用参数

要将参数值应用于查询，请在筛选器或计算中使用它：

• 要根据 Builder 中的参数 设置 筛选器的值，请在定义筛选器时从右侧面板的 “筛选器属性 ”中选择该参数。

  注意： 对于多选 参数，选择Is In List 或Is Not In List 的过滤运算符筛选s 标签。

• 要在 SQL 编辑器中使用筛选器来使用参数 ，或在计算中引用其值，请在 SQL 语句中用冒号 (:) 后输入其名称，例如 :ReportingPeriod 。

在查询中使用全局参数

您的工作区所有者可以 配置全局参数 ，用于多个查询中使用的通用值。要在查询中使用全局参数：

1. 从 参数 面板中，单击 添加，然后选择 选择全局参数。
   
2. 选择要在查询中使用的全局参数，然后单击 添加。
3. 要编辑全局参数，请选择该参数，并根据查询需要更新其名称或值。

   注： 为确保分析的一致性，您的工作区所有者可能会锁定全局参数，以防止其值被编辑。

4. 要将全局参数的值应用于查询，请在筛选器或计算中使用它：

   • 要根据 Builder 中的参数 设置 筛选器的值，请在定义筛选器时从右侧面板的 “筛选器属性 ”中选择该参数。

     注意： 对于多选 参数，选择Is In List 或Is Not In List 的过滤运算符筛选s 标签。

   • 要在 SQL 编辑器中引用参数，请在 SQL 语句中用冒号 (:) 后输入参数名称，例如 :ReportingPeriod。
   • 要 引用计算的SQL语句中的参数值，请从 “参数 ”菜单中选择该参数。

编辑查询参数

调整或管理参数的详细信息：

1. 从 参数面板中，选择要编辑的参数。
2. 根据需要编辑参数名称、数据类型或值。
3. 点击 应用。

删除查询参数

如果不再需要某个参数，可以将其从查询中删除。在 参数面板中，单击参数的 删除 ，然后单击 保存 。