当前位置 > 支持 > 帮助中心 > Tableau 帮助手册 > Tableau Desktop 与 Web 制作 > 帮助 > 构建图表和分析数据

创建参数

版本：2022.1 及更高版本

适用于： Tableau Desktop, Tableau Online, Tableau Public, Tableau Server

参数是工作簿变量，例如数字、日期或字符串，可以替换计算、筛选器或参考行中的常量值。

例如，您可能会创建一个在销售额大于 $500,000 时返回“True”否则返回“False”的计算字段。可以在公式中使用参数来替换常量值“500000”。然后，可使用参数控件来动态更改计算中的阈值。

您甚至可以创建一个动态参数，该参数设置为自动刷新其当前值（依据独立于视图的单值计算的结果）、值列表（基于数据源列）或值范围。每次打开工作簿并且 Tableau 连接到参数引用的数据源，或者从数据源的上下文菜单中选择“刷新”时，都会发生这种情况。

可通过在参数动作中使用参数来使参数更加动态并更具交互性。参数动作可让受众通过直接与可视化项交互（例如单击或选择标记）来更改参数值。

创建参数

按以下说明操作从“数据”窗格中创建新参数。

在“数据”窗格中，单击右上角中的下拉箭头，并选择“创建参数”。
在“创建参数”对话框中，为字段指定一个名称。
指定参数将接受的值的数据类型：
指定当前值。这是参数的默认值。在这种情况下，让我们保留字段，因为我们将使用最新的数据，我们将在下一步中配置这些数据。
在工作簿打开时指定值。在这种情况下，让我们通过将参数的默认值设置为独立于视图的单值计算的结果来创建动态参数。
注意：如果有多个值，则工作簿将无法选择默认值。计算还必须与视图无关，以便值不会随着可视化项的变化而变化。为此，可以使用不依赖于可视化项的结构的 FIXED 详细级别 (LOD) 表达式。计算的所有部分都必须位于 FIXED LOD 表达式内。如果使用 FIXED LOD 表达式作为默认值，并且使用上下文筛选器，则动态参数不会反映任何上下文筛选器。有关 LOD 表达式的详细信息，请参见在 Tableau 中创建详细级别表达式。
对于此动态参数，让我们使用“Latest Month”（最近一个月）。这意味着，如果已连接的数据源已更新并且工作簿已打开，则参数将在打开工作簿时自动更新。
指定要在参数控件中使用的显示格式（仅限 Tableau Desktop）。
指定参数接受值的方式。可从以下选项中选择：
这些选项的可用性由数据类型确定。例如，字符串参数只能接受所有值或列表。它不支持范围。
如果选择“列表”，则必须指定值列表。在左边的列中单击以键入值列表，或者可以通过选择“添加值来源”来添加字段的成员。
如果选择“范围”，则必须指定最小值、最大值和步长。例如，可以定义介于 2019 年 1 月 1 日和 2019 年 12 月 31 日之间的日期范围，并将步长设置为 1 个月以创建可用来选择 2019 年的每个月的参数控件。
在这种情况下，若要在工作簿打开时刷新参数的值列表（或域），请选择“列表”，然后选择 “工作簿打开时”。请注意，左侧的值列表显示为灰色，因为工作簿正在动态地从数据源中拉取值。

全部 — 参数控件是一个简单的文本字段。
列表 — 参数控件提供可供选择的可能值的列表。
范围 — 参数控件可用于选择指定范围中的值。

完成后，单击“确定”。
参数现在列在“数据”窗格底部的“参数”部分中。
您可以使用参数的其他任何地方（例如，“筛选器”对话框中的“前”选项卡或“参考线”对话框）中也有参数。参数在工作簿中为全局参数，可在任何工作表中使用。

参数值或值列表无法刷新时

以下是一些默认参数值或可刷新参数值列表（域）不会按预期更新的情况：

默认字段返回其数据与参数的数据类型不兼容的值。
默认字段不返回单个值（对于参数的当前值）。
默认字段返回 null。
默认字段位于尚未连接的数据源中。
不再能够在工作簿的命名空间中找到默认字段（即已将其删除）。
在 Tableau 尝试连接时，用户将取消对数据源的查询。

注意：在 Tableau Desktop 上，当打开工作簿并且 Tableau 首次连接到字段的数据源时，将对这些查询进行初始评估。还可以通过刷新数据源来评估查询。为此，请按 F5，或打开数据源的上下文菜单并选择“刷新”。在 Tableau Server 和 Tableau Online 上，可以通过单击工具栏中的“数据源刷新”按钮来刷新数据源。但是，在这种情况下，请记住返回的值取决于服务器的缓存策略。

如果默认字段无法返回值，则参数的行为将如下所示：

当前值将保留最新的有效值。
值列表将为空，因为 Tableau 不会序列化从工作簿中的查询返回的值。

当前值必须位于值列表中才能将其分配给参数。如果值列表为空，则将依据数据类型（1 表示整数，1.0 表示浮点，"” 表示字符串，以及当前日期表示日期和日期时间）为参数分配回退值。

编辑参数

可通过“数据”窗格或参数控件来编辑参数。请按以下说明操作以编辑参数：

执行以下操作之一：

在“数据”窗格中右键单击（在 Mac 上按住 Control 单击）参数，并选择“编辑”。
在参数控件卡菜单中选择“编辑参数”。

在“编辑参数”对话框中进行必要的修改。
完成后，单击“确定”。参数会随使用它的任何计算一起更新。

若要删除参数，请在“数据”窗格中右键单击该参数并选择“删除”。使用已删除参数的任何计算字段都变为无效。

在计算中使用参数

您可通过参数来动态修改计算中的值。您可以使用参数而不是手动编辑计算（以及所有依赖计算）。然后在要更改值时，可打开参数控件并更改值；使用该参数的所有计算都会更新。

若要在计算中使用参数，请将参数从“数据”窗格拖放到计算编辑器中，放在公式中的一个新位置，或替换当前公式的一个部分：

在筛选器中使用参数

您可通过参数来动态修改“前 N 个”筛选器中的值。您可以使用参数而不是在筛选器中手动设置要显示的值数。然后，在要更改该值时打开参数控件和筛选器更新。例如，当创建筛选器显示总利润最高的 10 种产品时，您可能希望使用参数而不是固定值“10”。这样，您就可以快速更新筛选器来显示利润最高的 10、20 或 30 种产品。

“筛选器”对话框“前”选项卡上的下拉列表中有一个参数列表。选择要在筛选器中使用的参数。

若要显示参数控件，请在“数据”窗格中右键单击参数并选择“显示参数”。使用参数控件可修改筛选器以显示利润最高的 10、15、20 种产品，以此类推。

在参考线中使用参数

您可通过参数来动态修改参考线、参考区间或框。例如，您可以参考一个参数而不是在轴上的一个固定位置显示一条参考线。然后就可以使用参数控件移动参考线。

“添加参考线、参考区间或框”对话框的“值”下拉列表中有一个参数列表。选择要使用的参数。

参考线在参数指定的“当前值”处绘制。若要打开参数控件，请在“数据”窗格中右键单击（在 Mac 上按住 Control 单击）参数，然后选择“显示参数”。使用参数控件可更改参考线的绘制位置。

在可视化项中显示参数控件

参数控件是可用来修改参数值的工作表卡。参数控件与筛选器卡非常相似，因为它们都包含修改视图的控件。您可以在工作表和仪表板上打开参数控件，在保存到 Web 或发布到 Tableau Server 时会包括这些参数控件。

若要打开参数控件，请在“数据”窗格中右键单击（按住 Control 单击）参数并选择“显示参数”。

像其他卡一样，参数控件具有一个菜单，您可以使用卡右上角中的下拉箭头打开此菜单。使用此菜单，可自定义控件的显示。例如，可以将值列表显示为单选按钮、精简列表、滑块或字段中的类型。此菜单中可用的选项取决于参数的数据类型以及该参数是接受所有值、值列表还是值范围。