在 URL 中使用参数 - Amazon QuickSight

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

在 URL 中使用参数

您可以在 Amazon QuickSight 中的 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。第一部分后的井号 (#)) 用于引入片段，其中包含您要设置的值。

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

# 后的片段遵循这些规则：

  • 参数的前缀为 p.。名称是参数名称，而不是控件名称。您可以打开分析，在左侧边栏上选择 Parameter (参数) 以查看参数名称。

  • 使用等号 (=) 设置值。以下规则适用：

    • 文本值不使用引号。

    • 浏览器自动对值中的空格进行编码，因此在手动创建 URL 时无需使用转义字符。

    • 要返回所有值，将参数设置为等于 "[ALL]"。

    • 在自定义操作中，目标参数名称以 $ 开头，例如：<<$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 操作。您也可以选择手动生成这些 URL，并使用它们共享特定的数据视图。

有关创建自定义操作的信息，请参阅使用自定义操作进行筛选和导航。