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

# 在 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)。