URL でのパラメータの使用 - Amazon QuickSight

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

URL でのパラメータの使用

Amazon の URL でパラメータ名と値を使用して QuickSight 、ダッシュボードまたは分析でそのパラメータのデフォルト値を設定できます。

次の例は、別のダッシュボードのパラメータを設定するダッシュボードの 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 アクションの場合、複数値パラメーターはフラグメント内の同じパラメーターのインスタンスを 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 を手動で生成し、それらを使用してデータの特定のビューを共有することもできます。

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