在 URL 中使用参数 - Amazon QuickSight
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

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

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

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

  • 参数的前缀为 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 YorkSeattle

  • 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,并使用它们共享特定的数据视图。

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