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

# 连接到 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)。