在 URL 中使用參數 - Amazon Quick Suite

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在 URL 中使用參數

您可以在 Amazon Quick Suite 的 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]"。

    • 若要將參數的值指派給 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 動作。您也可選擇手動產生這類 URL，並將其用於共享特定的資料檢視。

如需建立自訂動作的資訊，請參閱 使用自訂動作進行篩選和導覽。