本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Amazon Quick 中的参数
参数

*参数* 是一种命名变量，可以传输值供操作或对象使用。通过使用参数，您可以为控制面板用户创建更简单的方式，让他们以技术性较低的方式与控制面板功能进行交互。此外，参数还可将控制面板连接起来，让控制面板用户能够深入了解不同分析中的数据。

例如，控制面板用户可以使用列表选择一个值。该值设置一个参数，而参数将某个筛选条件、计算或 URL 操作设置为选定的值。然后，控制面板中的视觉对象对用户的选择做出响应。

要使参数可供控制面板查看者访问，您需要添加参数控制。您可以设置级联控件，使在某个控件中的选择对显示在另一个控件中的选项进行筛选。控件可以显示为选项列表、滑块或文本输入区域。如果不创建控制，您仍可将值传递到控制面板 URL 中的参数。

为了让参数起作用，无论是否有相关控件，都需要将其连接到分析中的某些内容。您可以在以下内容中引用参数：
+ 计算字段（多值参数除外）
+ 筛选条件
+ 仪表板和分析 URLs
+ 操作
+ 整个分析中的标题和描述

使用参数的一些方法如下所示：
+ 利用计算，您可以转换在分析中显示的数据。
+ 如果您向要发布的分析添加了一个包含筛选条件的控件，控制面板用户就可以筛选数据而不创建自己的筛选条件。
+ 通过使用控件和自定义操作，您可以让控制面板用户设置 URL 操作的值。

**Topics**
+ [

# 在 Amazon Quick 中设置参数
](parameters-set-up.md)
+ [

# 在 Amazon Quick 中使用带有参数的控件
](parameters-controls.md)
+ [

# 在 Amazon Quick 中创建参数默认值
](parameters-default-values.md)
+ [

# 连接到 Amazon Quick 中的参数
](parameters-connections.md)

# 在 Amazon Quick 中设置参数
设置参数

使用以下过程创建或编辑基本参数。

**创建或编辑基本参数**

1. 选择要使用的分析，然后确定要参数化的字段。

1. 从页面顶部的图标列表中选择**参数**图标。

1. 选择窗格顶部附近的加号（**\$1 添加**）以添加新参数。

   通过先选择参数名称旁边的 `v` 形图标，然后选择 **Edit parameter (编辑参数)** 来编辑现有参数。

1. 对于**名称**，请输入参数的字母数字值。

1. 对于**数据类型**，选择**字符串**、**数字**、**整数**或**日期时间**，然后完成以下步骤。
   + 如果您选择**字符串**、**数字**或**整数**，请执行以下操作：

     1. 对于**值**，请选择**单值**或**多值**。

        对于只能包含一个值的参数，请选择“单值”选项。对于可以包含一个或多个值的参数，请选择“多值”。多值参数不能是 `datetime` 数据类型。它们也不支持动态默认值。

        要将某个现有参数在单值和多值之间切换，请删除并重新创建该参数。

     1. （可选）对于**静态默认值**或**静态多个默认值**，请输入一个或多个值。

        如果未提供动态默认值或 URL 参数，将在第一个页面加载期间使用此类型的静态值。

     1. （可选）选择**默认显示为空白**。

        选择此选项，将多值列表的默认值显示为空白。此选项仅适用于多值参数。
   + 如果选择**日期时间**，则执行以下操作：

     1. 对于**时间粒度**，选择**日**、**小时**、**分钟**或**秒**。

     1. 对于**默认日期**，请选择**固定日期**或**相对日期**，然后执行以下操作：
        + 如果选择的是**固定日期**，请使用日期和时间选择器输入日期和时间。
        + 如果选择的是**相对日期**，请选择一个滚动日期。您可以选择**今天**、**昨天**，也可以指定**筛选条件**（开始时间或结束时间）、**范围**（当前日期、前一天或后一天）和**期限**（年、季度、月、周或天）。

1. （可选）选择**设置动态默认值**，针对用户创建默认值。

   *动态默认值* 是针对控制面板的第一个页面加载的每用户默认值。使用动态默认值为每个用户创建个性化视图。

   计算字段不能用作动态默认值。

   动态默认值不会阻止用户选择其他值。如果您想保护数据，则可以添加行级别锁定。有关更多信息，请参阅 [使用采用基于用户的规则的行级别安全性限制对数据集的访问使用基于用户的规则](restrict-access-to-a-data-set-using-row-level-security.md)。

   仅当选择单值参数时，才会显示此选项。多值参数不能具有动态默认值。
**注意**  
如果选择多值参数，屏幕将更改以删除默认选项。相反，您会看到一个包含文本 **Enter values you want to use for this control (输入要用于此控件的值)** 的框。您可以在该框中输入多个值（一行一个）。这些值用作参数控件中的默认选定值。此处的值与您选择为该参数控件输入的值联合起来使用。有关参数控制的更多信息，请参阅[参数控制](parameters-controls.md)。

1. （可选）设置保留值以确定**全选**值的值。参数的*保留值*是您选择**全选**作为参数值时分配给参数的值。当您设置参数的特定保留值时，该值不再被视为数据集中的有效参数值。保留值不能用于任何*参数使用者*，例如筛选条件、控件和计算字段以及自定义操作。此外，该值不会显示在参数控件列表中。您可以从**推荐值**、**Null** 和**自定义值**中进行选择。**推荐值**是默认值。如果您选择**推荐值**，则会根据值类型将保留值设置为以下值：
   + 字符串：`"ALL_VALUES"`
   + 数字：`"Long.MIN_VALUE"-9,223,372,036,854,775,808`
   + 整数：`Int.MIN_VALUE"-2147483648`

   要在新参数中设置保留值，请在**创建新参数**页面或**编辑参数**页面中选择**高级设置**下拉列表，然后选择所需的值。

1. 选择 **Create（创建）**或 **Update（更新）**以完成创建或更新参数。

创建参数后，您可以用各种方式使用它。您可以创建一个控件（如按钮），以便能为您的参数选择一个值。有关更多信息，请参阅以下部分。

# 在 Amazon Quick 中使用带有参数的控件
参数控件

在控制面板中，参数控件显示在数据表顶部，该表包含一组视觉对象。通过提供一个控件，可以允许用户选择要在预定义的筛选条件或 URL 操作中使用的值。控制面板用户可以使用控件在控制面板上的所有视觉对象数据集中应用筛选，不必自行创建筛选条件。

以下规则适用：
+ 要创建或编辑参数的控件，请确保该参数存在。
+ 多选列表控件与分析 URLs、仪表板 URLs、自定义操作和自定义筛选器兼容。筛选条件必须等于或不等于提供的值。不支持其他比较。
+ 列表最多显示 1,000 个值。如果不同的值超过 1,000 个，则会出现一个搜索框，供您筛选列表。当筛选后的列表包含的值少于 1,001 个时，列表的内容将显示为行项目。
+ **Style (样式)** 选项仅显示适用于参数的数据类型和单值或多值设置的样式类型。如果要使用的样式不在列表中，请使用适当的设置重新创建参数，然后重试。
+ 如果参数链接到数据集字段，则该字段必须是实际字段。不支持计算字段。
+ 值按字母顺序在控件中显示，除非有超过 1,000 个不同的值。然后，控件改为显示搜索框。每次搜索要使用的值时，它都会启动一个新的查询。如果结果包含 1,000 个以上值，则您可以使用分页滚动值。支持通配符搜索。要了解有关通配符搜索的更多信息，请参阅 [使用通配符搜索](search-filter.md#search-filter-wildcard)。

使用以下过程为现有参数创建或编辑控件。

**创建或编辑现有参数的控件**

1. 选择一个现有参数的上下文菜单（参数名称旁边的 `v` 图标），然后选择 **Add control（添加控件）**。

1. 输入一个名称为新控件提供标签。此标签显示在工作区顶部，随后显示在显示控制面板的工作表顶部。

1. 从以下选项中选择一个控件样式：
   + **文本字段**

     文本字段允许您键入字段自身的值。数字和文本（字符串）都适用于文本字段。
   + **文本字段 – 多行**

     多行文本字段允许您键入字段自身的值。使用此选项，您可以选择用换行符、逗号、竖线（\$1）或分号来分隔在参数控件中输入的值。数字和文本（字符串）都适用于文本字段。
   + **下拉菜单**

     下拉列表控件可用于选择单值。数字和文本（字符串）适用于列表控件。
   + **下拉菜单 – 多选**

     列表控件可用于选择多个值。数字和文本（字符串）适用于列表控件。
   + **列表**

     列表控件可用于选择单值。数字和文本（字符串）适用于列表控件。
   + **列表 – 多选**

     列表控件可用于选择多个值。数字和文本（字符串）适用于列表控件。
   + **Slider**

     滑块可让用户通过将控件从滚动条的一端滑动到另一端来选择数字值。滑块与数字结合使用。
   + **Date-picker（日期选取器）**

     您可以使用日期选择器从日历控件中选择日期。选择添加日期选择器控件时，可以自定义如何设置控件中的日期格式。为此，对于**日期格式**，请使用 [在 Quick 中自定义日期格式](format-visual-date-controls.md) 中所述的标记输入所需的日期格式。

1. （可选）如果选择下拉控件，屏幕将展开，以便您可以选择要显示的值。您可以指定一系列值，或使用数据集中的字段。选择以下任一选项：
   + **Specific values（特定值）**

     要创建特定值的列表，请在每行键入一个值（没有用于分隔的空格或逗号），如以下屏幕截图所示。

     这些值在控件中按字母顺序显示，而不是按输入顺序显式。
   + **链接到数据集字段（Link to a data set field）**

     要链接到某个字段，请选择包含您字段的数据集，然后从列表中选择该字段。

     如果您更改了参数中的默认值，请选择控件上的 **Reset（重置）**以显示新值。

   在此处选择的值将与参数设置中的静态默认值联合起来使用。

1. （可选）启用选项**如果参数配置了默认值，则从控件中隐藏 [全部] 选项**。此操作只会显示数据值，并删除在控件中选择所有项目的选项。如果未对参数配置静态默认值，则此选项将不起作用。通过选择参数并选择 **Edit parameter (编辑参数)**，可在添加控件后添加默认值。

1. （可选）您可以限制控件中显示的值，使它们仅显示对其他控件中选择的值有效的值。这称为级联控件。

   要创建级联控件，请选择 **Show relevant values only (仅显示相关值)**。选择一个或多个能够更改此控件显示内容的控件。

   创建级联控件时，以下限制适用：
   + 级联控件必须与同一数据集中的数据集列相关联。
   + 子控件必须是下拉列表或列表控件。
   + 对于参数控件，子控件必须链接到数据集列。
   + 对于筛选条件控件，子控件必须链接到筛选条件（而不是仅显示特定值）。
   + 父控件必须是以下任一类型：
     + 字符串、整数或数字参数控件。
     + 字符串筛选条件控件（不包括“前几项/后几项”筛选条件）。
     + 非聚合数字筛选条件控件。
     + 日期筛选条件控件（不包括“前几项/后几项”筛选条件）。

1. 为控件选择完选项后，选择 **Add（添加）**。

已完成的控件将显示在工作区顶部。上下文菜单（形状像 `v`）提供了四个选项：
+ **Reset（重置）**，用于将用户的选择还原为默认状态。
+ **刷新列表**仅适用于链接到数据集中字段的下拉菜单。选择 **Refresh list（刷新列表）**将查询数据以检查更改。控件中使用的数据将被缓存。
+ **Edit（编辑）**，用于重新打开控件创建屏幕，使您可以更改设置。

  打开**编辑控件**窗格后，单击不同的视觉对象和控件即可查看特定视觉对象或控件的格式设置数据。有关设置视觉对象格式的更多信息，请参阅[在 Amazon 中快速格式化](formatting-a-visual.md)。
+ **Delete（删除）**，用于删除控件。您可以通过选择参数上下文菜单来重新创建它。

在工作区中，您还可以调整控件的大小和重新整理控件。控制面板用户在您执行这些操作时可以看到控件，只不过不能编辑或删除控件。

# 在 Amazon Quick 中创建参数默认值
参数默认值

通过本节可详细了解可用的参数默认值的类型以及如何设置各个默认值。

每个字段都可以有一个参数和一个与之关联的控件。如果有人查看控制面板或电子邮件报告，任何配置了静态默认值的工作表控件都会使用静态默认值。默认值可以更改数据的筛选方式、自定义操作的行为方式以及动态工作表标题中显示的文本内容。电子邮件报告还支持动态默认值。

最简单的默认值是静态（不变）默认值，会向所有人显示相同的值。作为控制面板的设计者，您可以选择默认值。使用控制面板的人无法对其进行更改。不过，此人可以从控件中选择任何值。设置默认值并不能改变这一点。要限制人员可以选择的值，请考虑使用行级别安全性。有关更多信息，请参阅 [使用采用基于用户的规则的行级别安全性限制对数据集的访问使用基于用户的规则](restrict-access-to-a-data-set-using-row-level-security.md)。

**创建或编辑适用于所有人的控制面板视图的静态默认值**

1. 选择要编辑的参数旁边的上下文菜单 (`v`)，或通过执行 [在 Amazon Quick 中设置参数](parameters-set-up.md) 中的步骤创建新参数。

1. 为**静态默认值**输入一个值来设置静态默认值。

要根据正在查看控制面板之人显示不同的默认值，请创建动态默认参数（DDP）。使用动态默认值需要做一些准备工作，以便将人员映射到分配给他们的默认值。首先，您需要创建数据库查询或数据文件，其中包含要显示的人员、字段和默认值的有关信息。您将此类信息添加到数据集中，然后将该数据集添加到分析中。接下来，您可以找到可用于收集信息、创建数据集以及向参数添加动态默认值的过程。

创建动态默认值的数据集时，请遵循以下指南：
+ 建议您使用单个数据集来包含用户或用户组的逻辑分组的所有动态默认定义。如果可以，请将其保存在单个表或文件中。
+ 我们还建议数据集中的字段名称应与分析中的字段名称极为匹配。并非所有数据集字段都需要成为分析的一部分，例如在多个控制面板中使用相同的数据集作为默认数据集。字段可以按任何顺序排列。
+ 不建议您将用户名和组名称合并到同一列甚至同一数据集中。这种配置需要更多的维护和问题排查工作。
+ 如果您使用逗号分隔的文件来创建数据集，请确保删除文件中值之间的所有空格。以下示例演示了正确的逗号分隔值（CSV）格式。用单引号或双引号将包含非字母数字字符（如空格、撇号）的文本（字符串）括起来。您可以用引号将日期或时间字段括起来，但这不是必要操作。例如，如果数字包含特殊字符，则可以用引号将数字字段括起来，如下所示。

  ```
  "Value includes spaces","Field contains ' other characters",12345.6789,"20200808"
  ValueWithoutSpaces,"1000,67","Value 3",2020-AUG-08
  ```
+ 创建数据集后，请务必仔细检查 Quick 为字段选择的数据类型。

在开始之前，您需要即将拥有动态默认值人员的用户名或组名列表。要生成用户或组列表，您可以使用 Amazon CLI 来获取信息。要运行 CLI 命令，请确保您已经安装并配置 Amazon CLI 。有关更多信息，请参阅《Amazon CLI 用户指南》**中的[安装 Amazon CLI](https://docs.amazonaws.cn/cli/latest/userguide/cli-chap-install.html)。

这只是如何获取用户名或组名列表的一个示例。使用最适合自己的方法就行。

**识别动态默认参数（DDP）的用户**
+ 列出单个用户名或组名：
  + 要列出单个用户名，请添加一列来识别您 DDP 的用户。此列应包含每个人的系统用户名，他们使用该用户名从您的身份提供商连接到 Quick。此用户名通常与某人 @ 符号之前的电子邮件别名相同，但并非总是如此。

    要获取用户列表，请使用 [ListUsers](https://docs.amazonaws.cn/quicksight/latest/APIReference/API_ListUsers.html)Quick API 操作或 Amazon CLI 命令。CLI 命令如下例所示。为您的身份提供者指定 Amazon Web Services 区域 ，例如 `us-east-1`。

    ```
    awsacct1="111111111111"
    namespace="default"
    region="us-east-1"
    
    aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region
    ```

    以下示例通过添加一个将结果限制在活动用户范围内的查询来修改前面的命令。

    ```
    awsacct1="111111111111"
    namespace="default"
    region="us-east-1"
    
    aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region --query 'UserList[?Active==`true`]'
    ```

    结果集类似于以下示例。此示例摘自 JSON 输出 (`--output json`)。拥有联合用户名的用户拥有以 IDs 该词开头的主体`federated`。

    ```
    [
        {
            "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/anacasilva",
            "UserName": "anacarolinasilva",
            "Email": "anacasilva@example.com",
            "Role": "ADMIN",
            "Active": true,
            "PrincipalId": "federated/iam/AIDAJ64EIEIOPX5CEIEIO"
        },
        {
            "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/Reader/liujie-stargate",
            "UserName": "Reader/liujie-stargate",
            "Role": "READER",
            "Active": true,
            "PrincipalId": "federated/iam/AROAIJSEIEIOMXTZEIEIO:liujie-stargate"
        },
        {
            "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/embedding/cxoportal",
            "UserName": "embedding/cxoportal",
            "Email": "saanvisarkar@example.com",
            "Role": "AUTHOR",
            "Active": true,
            "PrincipalId": "federated/iam/AROAJTGEIEIOWB6BEIEIO:cxoportal"
        },
        {
            "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/zhangwei@example.com",
            "UserName": "zhangwei@example.com",
            "Email": "zhangwei@example.com",
            "Role": "AUTHOR",
            "Active": true,
            "PrincipalId": "user/d-96123-example-id-1123"
        }
    ]
    ```
  + 要列出组名，请添加一列来识别包含您 DDP 用户名的组。此列应包含用于从您的身份提供商连接到 Quick 的系统组名称。要识别可以添加到数据集的群组，请使用以下一个或多个 Quick API 操作或 CLI 命令：
    + [ListGroups](https://docs.amazonaws.cn/quicksight/latest/APIReference/API_ListGroups.html)— 按 Amazon Web Services 账户 ID 和命名空间列出包含您的身份提供商 Amazon Web Services 区域 的 Quick 群组。
    + [ListGroupMemberships](https://docs.amazonaws.cn/quicksight/latest/APIReference/API_ListGroupMemberships.html)— 列出指定的 Quick 组中的用户。
    + [ListUserGroups](https://docs.amazonaws.cn/quicksight/latest/APIReference/API_ListUserGroups.html)— 列出 Quick 用户所属的快速群组。

    您也可以要求自己的网络管理员查询身份提供者来获取此信息。

接下来的两个过程提供了有关如何完成为动态默认值创建数据集的说明。第一个过程是为单值 DDP 创建数据集。第二个过程是为多值 DDP 创建数据集。

**为单值 DDP 创建数据集**

1. 使用单值参数创建数据集列。查询或文件中的第一列应适用于使用控制面板的人员。该字段可以包含用户名或组名。但是，对群组的支持仅在 Quick Enterprise 版本中可用。

1. 对于显示单值参数的动态默认值的每个字段，请向数据集添加一列。列名无关紧要，您可以使用与字段或参数相同的名称。

   只有当用户实体和动态默认值的组合对于该参数的字段来说是唯一时，单值参数才能按指定方式生效。如果用户实体的默认字段有多个值，则该字段的单值控件会改为显示静态默认值。如果未定义静态默认值，则该控件不会显示默认值。使用组名时请务必小心，因为有些用户名可以是多个组的成员。如果这些组具有不同的默认值，则此类用户名充当重复条目。

   以下示例演示了似乎包含两个单值参数的表。我们之所以作出这样的假设，是因为没有用户名与多个默认值配对。为了让该表更易于理解，我们在分析的字段名称前添加单词 `'default'`。因此，您可以通过执行以下语句来读取该表，并更改每行的值：由 `anacarolinasilva` 查看时，控件会显示默认区域 `NorthEast` 和默认分段 `SMB`。    
[\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/quick/latest/userguide/parameters-default-values.html)

1. 将此数据导入 Quick，然后将其另存为新数据集。

1. 在分析中添加自己创建的数据集。分析至少需要使用一个与您为默认值定义的列相匹配的其他数据集。有关更多信息，请参阅 [向分析中添加数据集](adding-a-data-set-to-an-analysis.md)。

**为多值 DDP 创建数据集**

1. 使用多值参数创建数据集列。查询或文件中的第一列应适用于使用控制面板的人员。该字段可以包含用户名或组名。但是，对群组的支持仅在 Quick Enterprise 版本中可用。

1. 对于显示多值参数的动态默认值的每个字段，请向数据集添加一列。列名无关紧要，您可以使用与字段或参数相同的名称。

   与单值参数不同，多值参数允许与参数关联的字段中存在多个值。

   以下示例演示了似乎包含一个单值参数和一个多值参数的表。我们之所以作出这样的假设，是因为每个用户名在一列中有唯一值，而有些用户名在另一列中有多个值。为了让该表更易于理解，我们在分析的字段名称前添加单词 `'default'`。因此，您可以通过执行以下语句来读取该表，并更改每行的值：如果 `viewed-by` 是 `liujie`，则控件显示 `default-region` 值 `SouthEast`、`default-city` 值 `Atlanta`。如果向前读取一行，我们就会看到 `liujie` 在 `default-city` 中也有 `Raleigh`。    
[\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/quick/latest/userguide/parameters-default-values.html)

   在此示例中，无论是单值参数还是多值参数，我们应用 `default-region` 的参数都能正常生效。如果是单值参数，则两个条目适用于一个用户，因为这两个条目是相同的值，即 `SouthEast`。如果是多值参数，其仍然有效，只是默认情况下只选择一个值。不过，如果我们将使用 `default-city` 作为默认值的参数从多值参数更改为单值参数，则不会看到选择这些默认值。相反，如果定义了静态默认值，则该参数使用静态默认值。例如，如果静态默认值设置为 `Atlanta`，则 `liujie` 在该控件中选择 `Atlanta`，而不是 `Raleigh`。

   在某些情况下，静态默认值也可能用作动态默认值。如果是这样，请测试控件用户名，确保使用的默认值不能同时满足这两种属性。

   如果一个用户名属于多个组，则指定用户会看到一组默认值，这些值是两个组默认值的并集。

1. 将此数据导入 Quick，然后将其另存为新数据集。

1. 在分析中添加自己创建的数据集。分析至少需要使用一个与您为默认值定义的列相匹配的其他数据集。有关更多信息，请参阅 [向分析中添加数据集](adding-a-data-set-to-an-analysis.md)。

要将动态默认参数添加到分析，请按照以下过程操作。在开始之前，请确保您的数据集包含每个用户名或组名的动态默认值。另外，请确保自己的分析使用的是该数据集。有关这些要求的帮助，请参阅前面的过程。

**向分析中添加 DDP**

1. 在 Quick 控制台中，选择页面顶部的**参数**图标，然后选择现有参数。在参数的菜单中选择**编辑参数**。要添加新参数，请选择**参数**旁边的加号 (`+`)。

1. 选择 **Set a dynamic default（设置动态默认值）**。

1. 使用您的设置配置以下选项：
   + **具有默认值和用户信息的数据集** – 选择您创建并添加到分析中的数据集。
   + **用户名列** – 要创建基于用户名的默认值，请选择数据集中包含用户名的列。
   + **组名列** – 要创建基于组名的默认值，请选择数据集中包含组名的列。
   + **默认值列** – 选择包含该参数默认值的列。

1. 选择**应用**保存对设置所作的更改，然后选择**更新**保存对参数所作的更改。要退出而不保存任何更改，请改为选择**取消**。

1. 为每个包含动态默认值的字段添加筛选条件，让默认值生效。要了解有关将筛选条件与参数结合使用的更多信息，请参阅 [在 Amazon Quick 中使用带参数的筛选条件](parameters-filtering-by.md)。

   Amazon Quick 对任何用户名不存在于数据集中、未分配默认值或没有唯一默认值的人使用静态默认值。每个人只能有一组默认值。如果不想使用动态默认值，可以设置静态默认值。

# 连接到 Amazon Quick 中的参数
连接到参数

请在设置参数后使用本节内容，以连接参数并使参数正常工作。

创建参数后，您可以创建参数的使用者。*参数使用者* 是使用参数值的组件，例如筛选条件、控件、计算字段或自定义操作。

您可以通过其他方式导航到每个选项，如下所示：
+ 要创建过滤器，请选择页面顶部的**筛选器**图标。简言之，是创建一个 **Custom Filter (自定义筛选条件)** 并启用 **Use parameters (使用参数)**。列表仅显示符合条件的参数。
+ 要为参数添加新控件，请选择页面顶部的**参数**图标。简言之，是选择参数，然后 **Add control (添加控件)**。
+ 要在计算字段中使用参数，请编辑现有的计算字段，或通过选择左上角的 **Add (添加)** 添加新字段。参数列表显示在字段列表下方。
**注意**  
不能为计算字段使用多值参数。
+ 要创建 URL 操作，请选择视觉对象上的 **v** 形菜单，然后选择 **URL Actions (URL 操作)**。

有关每个主题的更多信息，请参阅下面几节。

**Topics**
+ [将筛选条件与参数结合使用](parameters-filtering-by.md)
+ [将计算字段与参数结合使用](parameters-calculated-fields.md)
+ [将自定义操作与参数结合使用](parameters-custom-actions.md)
+ [中的参数 URLs](parameters-in-a-url.md)
+ [标题和描述中的参数](parameters-in-titles.md)

# 在 Amazon Quick 中使用带参数的筛选条件
将筛选条件与参数结合使用

使用本节内容可以按单值参数值筛选分析或控制面板中的数据。要使用多值参数（带有多选下拉控件的多值参数），请创建一个等于（或不等于）这些值的自定义筛选条件。

在将筛选条件与参数结合使用之前，您应该已经了解如何使用筛选条件。

1. 验证您的分析是否已创建一个参数。从参数或控件菜单中选择**编辑**，了解正在使用的设置。

1. 从屏幕左侧选择 **Filter (筛选条件)** 窗格。如果您要使用的字段已经有一个筛选条件，请选择它以打开其设置。否则，请为要按参数筛选的字段创建筛选条件。

1. 选择 **Use Parameters (使用参数)**。

1. 从 **Use parameters（使用参数）**下方的列表中选择您的参数。对于文本（字符串）字段，请选择 **Custom Filter（自定义筛选条件）**，然后启用 **Use Parameters（使用参数）**。

   对于日期字段，选择 **Start date（开始日期）**和 **End date（结束日期）**参数，如以下屏幕截图所示。

   对于具有其他数据类型的字段，请选择 **Select a parameter（选择一个参数）**，然后从列表中选择您的参数。
**注意**  
可以包含多个值的参数必须使用等于或不等于作为比较类型。

1. 选择 **Apply (应用)** 以保存更改。

通过选择位于分析顶部附近的控件来测试新筛选条件。在本例中，我们使用了没有默认值的基本参数，以及链接到示例数据集（名为 **销售管道**）中**区域**字段的动态控件。该控件将查询数据并返回所有值。

如果您删除或重新创建了要在筛选条件中使用的参数，则可以使用新参数更新筛选条件。为此，请打开筛选条件，选择要使用的新参数，然后选择 **Apply（应用）**。

如果您重命名了某个参数，则不需要更新筛选条件或任何其他使用者。

# 在 Amazon Quick 中使用带有参数的计算字段
将计算字段与参数结合使用

您可以将参数的值传递到分析中的计算字段。在创建计算时，您可以从 **Parameter list (参数列表)** 下面的参数列表中选择现有参数。。您无法创建包含多值参数（即具有多选下拉控件的参数）的计算字段。

对于公式，您可以使用任何可用的函数。您可以将查看者的选择从参数控件传递给 `ifElse` 函数。随后您会得到一个指标。下面是一个示例。

```
ifelse(

${KPIMetric} = 'Sales',sum({Weighted Revenue}),

${KPIMetric} = 'Forecast',sum({Forecasted Monthly Revenue}),

${KPIMetric} = '# Active', distinct_count(ActiveItem),

NULL

)
```

上面的示例创建了一个指标（小数），您也可在字段中使用。然后，在用户从参数控制中选择值时，视觉对象会更新以体现其选择。

# 在 Amazon Quick 中使用带有参数的自定义操作
将自定义操作与参数结合使用

*自定义操作*允许您通过在视觉对象中选择数据点 URLs 或从上下文菜单中选择操作名称来启动或筛选视觉对象。在将 URL 操作与参数一起使用时，您可以动态地将参数传递或发送到 URL。要使其正常工作，您可以设置一个参数，然后在使用 **URL action (URL 操作)** 操作类型创建自定义操作时在 URL 中使用该参数。发送端和接收端的参数必须具有匹配的名称和数据类型。所有参数都与 URL 操作兼容。

有关创建 URL 操作的详细信息，请参阅[在 Amazon Quick Sight 中创建和编辑自定义操作](custom-actions.md)。如果您只希望在链接中使用参数而不创建 URL 操作，请参阅[在 URL 中使用参数](parameters-in-a-url.md)。

# 在 URL 中使用参数
中的参数 URLs

您可以在 Amazon Quick 的 URL 中使用参数名称和值，在控制面板或分析中为该参数设置默认值。

以下示例介绍为另一个控制面板设置参数的控制面板 URL。

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.myParameter=12345
```

在上面的示例中，第一部分是指向目标控制面板的链接：`https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234`。第一部分后的井号 (`#)`) 用于引入*片段*，其中包含您要设置的值。

 Amazon 服务器不会接收或记录片段中的值。此功能确保您的数据值更安全。

`#` 后的片段遵循这些规则：
+ 参数的前缀为 `p.`。名称是参数名称，而不是控件名称。您可以打开分析，在左侧边栏上选择 **Parameter (参数)** 以查看参数名称。
+ 使用等号 (`=`) 设置值。以下规则适用：
  + 文本值不使用引号。
  + 浏览器自动对值中的空格进行编码，因此在手动创建 URL 时无需使用转义字符。
  + 要返回所有值，将参数设置为等于 `"[ALL]"`。
  + 要将参数的值赋给 `null`，请将其设置为 `%00`。例如 `p.population=%00`。
  + 在自定义操作中，目标参数名称以 `$` 开头，例如：`<<$passThroughParameter>>`
  + 在自定义操作中，参数值显示在尖括号 (`<< >>`) 内，例如 `<<dashboardParameter1>>`。控制面板用户看到的是查找值，而不是变量。
+ 对于自定义 URL 操作，多值参数在片段中只需要同一参数的一个实例，例如：`p.city=<<$city>>`
+ 对于直接 URL，单个参数的多个值在片段中有同一参数的两个实例。有关示例，请参阅以下内容。
+ 使用 `&` 分隔多个参数。有关示例，请参阅以下内容。

服务器将日期转换为 UTC，并将其以无时区字符串的形式发送到后端。要使用通用协调时间 (UTC) 日期，请不要包括时区。以下是一些有效的日期格式示例：
+ `2017-05-29T00%3A00%3A00` 
+ `2018-04-04 14:51 -08:00`
+ `Wed Apr 04 2018 22:51 GMT+0000`

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.shipdate=2018-09-30 08:01&p.city=New York&p.city=Seattle&p.teamMember=12&p.percentageRank=2.3
```

在浏览器中，此代码将变为以下内容。

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.shipdate=2018-09-30%2008:01&p.city=New%20York&p.city=Seattle&p.teamMember=12&p.percentageRank=2.3
```

前面的示例设置四个参数：
+ `shipDate` 是一个日期参数：`Sept 30, 2018`。
+ `city` 是一个多值字符串参数：`New York` 和 `Seattle`
+ `teamMember` 是一个整数参数：`12`。
+ `percentageRank` 是一个小数参数：`2.3`。

以下示例介绍如何为接受多个值的参数设置值。

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.MultiParam=WA&p.MultiParam=OR&p.MultiParam=CA
```

要根据用户选择的数据点将值从一个控制面板（或分析）传递到另一个控制面板，请使用自定义 URL 操作。如果您愿意，也可以 URLs 手动生成这些数据，并使用它们来共享数据的特定视图。

有关创建自定义操作的信息，请参阅[使用自定义操作进行筛选和导航](quicksight-actions.md)。

# 在 Amazon Quick 中使用标题和描述中的参数
标题和描述中的参数

在 Amazon Quick 中创建参数时，可以在图表和分析的标题和描述中使用这些参数，以动态显示参数值。

您可以在分析的以下区域中使用参数：
+ 图表标题和副标题
+ 轴标题
+ 图例标题
+ 参数控件标题
+ 工作表标题和描述

下图展示了使用参数的图表标题。

![\[在“设置视觉对象格式”窗格的图像中，有包含一个参数的图表标题，以及标题中的参数值用红框标出的图表。\]](http://docs.amazonaws.cn/quick/latest/userguide/images/parameters-in-titles-labels2.png)


参照以下过程来了解如何在整个分析中向区域添加参数。有关参数和如何创建参数的更多信息，请参阅 [参数](parameters-in-quicksight.md)。

## 向图表标题和副标题添加参数
图表标题

要了解如何向图表标题和副标题添加参数，请按照以下过程操作。

**向图表标题或副标题添加参数**

1. 打开要设置格式的视觉对象的**属性**窗格。

1. 在**属性**窗格中，选择**标题**选项卡。

1. 选择**显示标题**或**显示副标题**。这些选项可能已被选中。

1. 选择**编辑标题**或**编辑副标题**右侧的三个点，然后从列表中选择一个参数。

   该参数将添加到**属性**窗格中的标题中。在图表中，参数值会显示在标题中。

   有关编辑视觉对象中的标题和副标题的更多信息，请参阅 [Quick 中视觉类型上的标题和字幕](customizing-a-visual-title.md)。

## 向轴标题添加参数
轴标题

要了解如何向轴标题添加参数，请按照以下过程操作。

**向轴标题添加参数**

1. 打开要设置格式的视觉对象的**属性**窗格。

1. 在**属性**窗格中，选择要设置格式的轴。

1. 选择**显示标题**。

1. 选择默认轴标题右侧的三个点，然后从列表中选择一个参数。

   该参数将添加到**属性**窗格中的轴标题中。在图表中，参数值会显示在轴标题中。

   有关编辑轴标题的更多信息，请参阅 [轴线和网格线](showing-hiding-axis-grid-tick.md)。

## 向图例标题添加参数
图例标题

要了解如何向图例标题添加参数，请按照以下过程操作。

**向图例标题添加参数**

1. 打开要设置格式的视觉对象的**属性**窗格。

1. 在**窗格**窗格中，选择**图例**。

1. 选择**显示图例标题**。

1. 选择**图例标题**右侧的三个点，然后从列表中选择一个参数。

   该参数将添加到**属性**窗格中的图例标题中。在图表中，参数值会显示在图例标题中。

   有关设置图例格式的更多信息，请参阅 [Quick 中关于视觉类型的图例](customizing-visual-legend.md)。

## 向控件标题添加参数
控件标题

要了解如何向参数控件标题添加参数，请按照以下过程操作。

**向参数控件标题添加参数**

1. 选择要编辑的参数控件，选择参数控件标题右侧的三个点，然后选择**编辑**。

1. 在打开的**编辑控件**页面中选择**显示标题**。

1. 选择**显示名称**右侧的三个点，然后从列表中选择一个参数。

   该参数将添加到参数控件标题中。

   有关使用参数控件的更多信息，请参阅 [参数控件](parameters-controls.md)。

## 向工作表标题和描述添加参数
工作表标题和描述

要了解如何在分析中向工作表标题和描述添加参数，请按照以下过程操作。

**向工作表标题或描述添加参数**

1. 在分析页面上，选择应用程序栏中的**工作表**，然后选择**添加标题**或**添加描述**。

   工作表标题或描述会显示在工作表上。

1. 对于**工作表标题**或**描述**，请选择右边的三个点，然后从列表中选择一个参数。

   该参数将添加到工作表标题或描述中；当您关闭文本框时，参数值会显示在文本中。

   有关添加工作表标题和描述的更多信息，请参阅 [向分析添加标题和描述](adding-a-title-and-description.md)。