翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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 アクションの場合、複数値パラメーターはフラグメント内の同じパラメーターのインスタンスを 1 つだけ必要とします (例: `p.city=<<$city>>`)
+ 直接的な URL の場合、単一パラメータの複数値には、フラグメント内の同じパラメータの 2 つのインスタンスがあります。例については、以下を参照してください。
+ アンパサンド (`&`) により、複数のパラメータが区切られます。例については、以下を参照してください。

サーバーは日付を 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
```

前の例では、4 つのパラメータを設定します。
+ `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
```

1 つのダッシュボード（または分析）からユーザーのデータポイントの選択に基づいて別のダッシュボードに値を渡すには、カスタム URL アクション を使用します。選択した場合、これらの URL を手動で生成し、それらを使用してデータの特定のビューを共有することもできます。

カスタムアクションの作成については、「[フィルタリングとナビゲーション用のカスタムアクションの使用](quicksight-actions.md)」を参照してください。