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

# 在 URL 中使用參數
<a name="parameters-in-a-url"></a>

您可以在 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`。井字號 (`#)` 接在第一部分後面，以引進*片段*，其中包含您想要設定的數值。

 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，並將其用於共享特定的資料檢視。

如需建立自訂動作的資訊，請參閱 [使用自訂動作進行篩選和導覽](quicksight-actions.md)。