翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Quick Sight でのインタラクティブシートの使用
インタラクティブシートは、ビジュアルで表現されたデータの集まりで、シートがダッシュボードにパブリッシュされると、ユーザーはインタラクティブに操作できるようになります。Amazon Quick 作成者は、ダッシュボードビューワーが公開されたデータから詳細情報を取得するために使用できるさまざまなレイアウト、コントロール、フィルターをインタラクティブシートに追加できます。分析のすべてのシートは、デフォルトでインタラクティブシートになっています。アカウントに **Pixel perfect reporting アドオン**がない場合は、インタラクティブシートのみを作成して公開できます。
インタラクティブシートの作成について詳しくは、「[Quick Sight で分析を開始する](creating-an-analysis.md)」を参照してください。
インタラクティブシートの書式の詳細は、以下のトピックを参照してください。
**Topics**
+ [Amazon Quick Sight でのダッシュボードレイアウトのカスタマイズ](customizing-dashboards-and-visuals.md)
+ [Amazon Quick のパラメータ](parameters-in-quicksight.md)
+ [フィルタリングとナビゲーション用のカスタムアクションの使用](quicksight-actions.md)
# Amazon Quick Sight でのダッシュボードレイアウトのカスタマイズ
ダッシュボードのレイアウトをカスタマイズして、ビジネス要件に合わせてデータを整理できます。3 つのダッシュボードレイアウトから選択できます。ビジュアルのサイズ、背景色、境界線の色、インタラクションを変更して、完全にカスタマイズされたダッシュボードを作成することもできます。
以下のトピックを使用して、ダッシュボードとビジュアルのカスタマイズの詳細を学びます。
**Topics**
+ [レイアウトのタイプ](types-of-layout.md)
+ [レイアウトの選択](choosing-a-layout.md)
+ [フリーフォームレイアウトでのビジュアルのカスタマイズ](customizing-visuals-in-free-form.md)
+ [条件付きルール](conditional-rules.md)
# レイアウトのタイプ
[**タイル**]、[**フリーフォーム**]、[**クラシック**] の 3 つのダッシュボードレイアウトデザインから選択できます。
## タイルレイアウト
[**タイル**] レイアウトのビジュアルは、標準の間隔と位置合わせでグリッドにスナップします。ビジュアルを任意のサイズにして、ダッシュボード内の任意の場所に配置できますが、ビジュアルは重なり合うことはありません。
![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/fixed-layouts-tiled-demo.gif)
ダッシュボードは設計どおりに表示され、実際のサイズで画面またはビューに合わせるオプションがあります。また、[**View**] の [**Fit to window**] を選択して、ダッシュボード全体をウィンドウに合わせることもできます。このオプションは、以前 [**Optimized**] と呼ばれていました。
**注記**
モバイルデバイスでは、タイルレイアウトのダッシュボードがポートレートモードでは単一の列として表示され、ランドスケープモードでは設計どおりに表示されます。
## フリーフォームレイアウト
[**フリーフォーム**] レイアウトのビジュアルは、正確な座標を使用してダッシュボードのどこにでも配置できます。ビジュアルは、目的の場所にドラッグするか、ビジュアルの位置の座標を入力することもできます。ビジュアルの位置の正確な座標を入力するには、次の手順を使用します。
![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/fixed-layouts-freeform-placement1.gif)
ダッシュボードは、それらを設計するために選択した方法で表示され、画面の大きさに合わせるオプション、または実際のサイズで表示するオプションがあります。フリーフォームレイアウトは特定の解像度での表示向けに最適化でき、デフォルトの解像度は 1,600 ピクセルです。右上隅にある **[View]** (表示) の **[Fit to window]** (ウィンドウに合わせる) を選択して、ダッシュボード全体をブラウザのウィンドウに合わせることもできます。
**注記**
最適化された解像度を使用するダッシュボードは、表示者のコンピュータの解像度がダッシュボードの設定解像度と一致しない場合、表示者のコンピュータで大きくまたは小さく表示されることがあります。
**[Free-form]** (フリーフォーム) から別のレイアウトに切り替えると、一部のビジュアル要素の位置が変わることがあります。
モバイルデバイスでは、**[Free-form]** (フリーフォーム) のダッシュボードが公開されたとおりに表示され、レイアウトは変更されません。
## クラシックレイアウト
[**クラシック**] レイアウトのビジュアルは、標準の間隔と位置合わせでグリッドにスナップします。ダッシュボードは、小さな画面サイズに収まるように、データを非表示にしたり、フォーマットを変更したりします。例えば、ビジュアルを変更して大幅に小さくした場合、ビジュアルのエディタが非表示になるので、グラフ要素を表示するスペースが広くなります。また、棒グラフのビジュアルに表示されるデータポイントの数が少なくなります。
ブラウザウィンドウのサイズを小さくすると、Amazon Quick Sight はビジュアルのサイズを変更し、必要に応じてビジュアルの順序を変更して最適な表示にします。例えば、横に並んでいた小さいビジュアルが順番に表示される場合があります。ブラウザウィンドウのサイズが再び拡大されると、元のレイアウトに復元されます。
**注記**
モバイルデバイスでは、クラシックレイアウトのダッシュボードは単一の列として表示され、ランドスケープモードでは設計どおりに表示されます。
# レイアウトの選択
**ダッシュボードのレイアウトを変更するには**
1. [クイックコンソール](https://quicksight.aws.amazon.com/)を開きます。
1. クイックホームページから、**分析**を選択し、変更する分析を選択します。
1. 分析ページで、**[編集]** を選択し、**[分析設定]** を選択します。
1. **[シートのレイアウト]** を展開し、使用するレイアウトを選択します。
1. 完了したら、[**Apply**] を選択します。
# フリーフォームレイアウトでのビジュアルのカスタマイズ
フリーフォームレイアウトを使用して、ダッシュボードの各ビジュアルの色、サイズ、位置、および表示設定を完全にカスタマイズできます。
## ビジュアルの整理
ビジュアルをダッシュボード内の希望の場所にドラッグする以外に、ビジュアルを必要な正確な位置に移動する方法はたくさんあります。
**ビジュアルの位置の座標を入力するには**
1. 目的のビジュアルを選択します。
1. ビジュアルの右上隅にあるメニューで、[**ビジュアルのフォーマット**] アイコンを選択します。
1. **[プロパティ]** ペインが開いたら **[配置]** を選択します。
1. ビジュアルを配置する位置の **X** および **Y** 座標を入力します。**幅**および**高さ**の値を入力して、ビジュアルのサイズを調整することもできます。
選択したビジュアルは、キーボードの矢印キーを使用してピクセル単位で移動することもできます。
ビジュアル同士を重ね合わせて、データを表示する多層ビジュアルを作成できます。
ビジュアルは、手動で前面、背面に移動できる複数のレイヤーに編成できます。
**重ねたビジュアルを前面、背面に移動するには**
1. 目的のビジュアルを選択します。
1. ビジュアルの右上にある 3 つのドットのメニューで、**メニューオプションを選択します**。
1. [**Menu options**] で、以下のオプションから選択します。
+ [**Send to back**] でビジュアルを背面に送ります。
+ [**Send backward**] でビジュアルを 1 つ後ろのレイヤーに送ります。
+ [**Bring forward**] でビジュアルを 1 つ前のレイヤーにやります。
+ [**Bring to front**] でビジュアルを一番前に持ってきます。
## ビジュアルの背景色を変更する
ビジュアルの背景、境界、選択フレームの色は、**[プロパティ]** ペインの **[表示設定]** ペインでカスタマイズできます。
**ビジュアルの背景、境界、または選択フレームの色を変更するには**
1. 変更するビジュアルを選択します。
1. ビジュアルの右上隅にあるメニューで、**[プロパティ]** を選択します。
1. 左側に表示される **[プロパティ]** ペインで、**[表示設定]** を選択します。
1. **[カードスタイル]** セクションに移動し、使用可能なアクションを 1 つ以上実行します。
+ ビジュアルの背景の色を変更するには、**[背景]** 色ボックスを選択し、目的の色を選択します。
+ ビジュアルの境界の色を変更するには、**[境界]** 色ボックスを選択し、目的の色を選択します。
+ ビジュアルの選択フレームの色を変更するには、**[選択]** 色ボックスを選択し、目的の色を選択します。
ビジュアルの背景、境界、または選択フレームにカスタム色を使用する場合は、変更するプロパティの色ボックスを選択し、**[カスタム色]** を選択します。**[カスタム色]** ウィンドウが表示されたらカスタム色を選択するか、色の 16 進コードを入力します。完了したら、**[適用]** を選択します。
ビジュアルのカスタマイズした背景をデフォルトに戻すこともできます。
**ビジュアルの外観をリセットするには**
1. 変更するビジュアルを選択します。
1. ビジュアルの右上隅にあるメニューで、**[プロパティ]** を選択します。
1. 左側に表示される **[プロパティ]** ペインで、**[表示設定]** を選択します。
1. リセットする色を選択し、**[デフォルトにリセット]** を選択します。
## 視覚的な背景、境界線、選択範囲の色の非表示
また、ビジュアルの背景枠や選択範囲の色を表示しないように選択することもできます。これは、複数のビジュアルを重ねる場合に便利です。**[境界]**、**[背景]**、または **[選択]** の色ボックスの横にある目のアイコンを選択すると、ビジュアルの背景、境界、選択の色を非表示にできます。ビジュアルのロードアニメーションを削除するには、**[ロードアニメーションを表示]** スイッチをオフにします。
## ビジュアルメニューの無効化
**[プロパティ]** ペインの **[インタラクション]** パネルを使用して、選択したビジュアルから **[コンテキスト]** メニューと **[On-visual]** メニューを非表示にします。セカンダリビジュアルメニューを非表示にして、ビジュアルの混雑を少なくすることや、オーバーレイのように視覚的な動作を作成することができます。
データポイントのクリック時に [**Context**] メニューが開きます。[**Context menu**] の一般的なアクションには、[**Focus**]、[**Exclude**]、および [**Drill-down**] があります。
[**On-visual**] メニューは、ビジュアルの右上側に表示されます。**[On-visual]** メニューは、**[プロパティ]** ペインへのアクセス、ビジュアルの **[最大化]**、**[メニューオプション]** へのアクセス、[**異常に関するインサイト]** のレビューに使用されます。
セカンダリビジュアルメニューは、**[Context menu]** (コンテキストメニュー) と **[On-visual menu]** (ビジュアルメニュー) オプションをオフに切り替えることで無効にできます。
**注記**
**[Interactions]** (操作) パネルでの変更を **[Analyses]** (分析) でプレビューすることはできません。ダッシュボードを公開して、変更を表示します。
# 条件付きルール
この機能は現在、[**フリーフォーム**] レイアウトで使用できます。条件付きルールは、特定の条件が満たされたときにビジュアルを表示または非表示にするために使用されます。これは、同じビジュアルの複数のバージョンが互いにオーバーラップしていて、選択したパラメータ値を最もよく表すバージョンをダッシュボードビューワーに表示したい場合に便利です。
条件付きルールでは、パラメータとパラメータコントロールを使用して、ビジュアルの表示と非表示を切り替えます。パラメータは、アクションまたはオブジェクトにより使用される値を転送できる名前付きの変数です。この機能は、文字列パラメータと数値パラメータをサポートします。ダッシュボードの表示者に対してパラメータをアクセス可能にするには、パラメータコントロールを追加します。パラメータコントロールを提供することで、ユーザーは値を選択して定義済みのフィルターまたは URL アクションで使用することができます。パラメータとパラメータコントロールの詳細については、「[Amazon Quick のパラメータ](parameters-in-quicksight.md)」を参照してください。
以下のセクションを使用して、条件付きルールを設定および使用します。
**Topics**
+ [デフォルトでビジュアルを非表示にする](hiding-a-visual-by-default.title.md)
+ [条件付きルールの設定](setting-a-conditional-rule.title.md)
+ [条件付きルールの使用](using-conditional-rules.md)
# デフォルトでビジュアルを非表示にする
**[プロパティ]** ペインの **[インタラクション]** ペインで、デフォルトでビジュアルを非表示にするができます。これは、特定の条件に基づいたビジュアルのみを表示者に表示したいという場合に便利です。
**ビジュアルをデフォルトで非表示にするには**
1. クイックホームページから、**分析**を選択し、カスタマイズする分析を選択します。
1. ルールを追加するビジュアルを選択します。
1. ビジュアルの右上隅にあるメニューで、**[プロパティ]** を選択します。
1. **[プロパティ]** ペインが開いたら **[インタラクション]** を選択し、**[ルール]** ドロップダウンを開きます。
1. **[ルール]** ペインで **[このビジュアルをデフォルトで非表示にする]** を選択します。
非表示のビジュアルは、表示ダッシュボードでは完全に非表示になります。[**Analyses**] ペインでは、非表示のビジュアルが「ルールに基づいて非表示」というメッセージとともに表示されます。この表示では、ダッシュボードのすべてのビジュアルがどこにあるかを確認できます。
**注記**
デフォルトで既に非表示になっているビジュアルを非表示にする条件付きルールや、デフォルトで既に表示されているビジュアルを表示する条件付きルールを作成することはできません。ビジュアルのデフォルトの外観を変更すると、新しいデフォルトの外観と矛盾する既存のルールは無効になります。
# 条件付きルールの設定
条件付きルールを設定するときに、特定の条件が満たされたときにビジュアルを表示または非表示にする条件ステートメントを作成します。現在、ビジュアルの表示/非表示を切り替える条件付きルールを作成できます。非表示のビジュアルを表示する条件付きルールを作成する場合は、**[プロパティ]** メニューの **[ルール]** ペインで、**[このビジュアルをデフォルトで非表示にする]** を選択します。
**注記**
始める前に、新しい条件付きルールの基礎となるパラメータと対応するパラメータコントロールを作成します。サポートされているパラメータは、文字列パラメータと数値パラメータです。パラメータとパラメータコントロールの詳細については、「[Amazon Quick のパラメータ](parameters-in-quicksight.md)」を参照してください。
**条件付きルールを設定するには**
1. クイックホームページから、**分析**を選択し、カスタマイズする分析を選択します。
1. ルールを追加するビジュアルを選択します。
1. ビジュアルの右上隅にあるメニューで、**[プロパティ]** を選択します。
1. 左側に表示される **[プロパティ]** ペインで、**[インタラクション]** を選択して **[ルール]** を選択します。
1. **[ルールの追加]** を選択します。
1. [**Add rule**] ペインの最初のメニューで、目的のパラメータを選択します。
1. [**Add rule**] ペインの 2 番目のメニューで、使用する条件を選択します。文字列パラメータでは、サポートされる条件は、[**〜に等しい**]、[**〜で始まる**]、[**〜を含む**]、および [**〜に等しくない**] です。数値パラメータでは、サポートされる条件は、[**〜に等しい**]、[**〜で始まる**]、[**〜を含む**]、および [**〜に等しくない**] です。
1. 条件付きルールが満たす値を入力します。
**注記**
値は大文字と小文字が区別されます。
1. [**Add rule**] をクリックして、新しい条件付きルールをビジュアルに適用します。ルールをキャンセルするには、[**キャンセル**] を選択します。
条件付きルールは編集および削除することもできます。
**条件付きルールを編集するには**
1. ビジュアルの右上隅にあるメニューで、**[プロパティ]** を選択します。
1. 左側に表示される **[プロパティ]** ペインで、**[インタラクション]** を選択して **[ルール]** を選択します。
1. 編集するルールの右側にあるメニューアイコンをクリックし、**[Edit]** (編集) を選択します。
1. 必要な変更を加えて、**[Save]** (保存) をクリックします。
**条件付きルールを削除するには**
1. ビジュアルの右上隅にあるメニューで、**[プロパティ]** を選択します。
1. 左側に表示される **[プロパティ]** ペインで、**[インタラクション]** を選択して **[ルール]** を選択します。
1. 編集するルールの右側にあるメニューアイコンをクリックし、**[Delete]** (削除) を選択します。
# 条件付きルールの使用
パラメータとパラメータコントロールに接続された条件付きルールを設定したら、パラメータコントロールを使用して、設定した条件付きルールを有効または無効にすることができます。
**条件付きルールを有効にする**
1. クイックホームページから、**分析**を選択し、カスタマイズする分析を選択します。
1. ワークスペースの上部にある **[Controls]** (コントロール) バーで、ドロップダウンアイコンをクリックします。
1. 作成した条件付きルールに関連付けられているパラメータコントロールを選択します。
1. パラメータのメニューから、作成した条件付きルールに関連付けられている値を選択します。目的の値を **[Search value]** (値を検索) に手動で入力することもできます。
**注記**
値は大文字と小文字が区別されます。
正しい値を選択すると、設定したルールに応じてビジュアルが表示または非表示になります。
ビジュアルが表示されているシートにパラメータコントロールを表示させることもできます。これは、パラメータコントロールを関連付けられているビジュアルの横に配置する場合や、特定の条件が満たされる場合にのみ表示されるようにコントロールに条件付きルールを追加する場合に便利です。
**パラメータコントロールをシートに表示させるには**
1. クイックホームページから、**分析**を選択し、カスタマイズする分析を選択します。
1. ワークスペースの上部にある **[Controls]** (コントロール) バーで、移動させるコントロールをクリックします。
1. コントロールの右上で、**[Menu options]** (メニューオプション) メニューを開きます。
1. [**Move to sheet**] をクリックします。
**パラメータコントロールをコントロールバーに戻すには**
1. ダッシュボードで、移動するパラメータコントロールを選択します。
1. コントロールの右上隅にあるメニューで [**Menu options**] メニューを開きます。
1. **[シートの先頭に移動]** をクリックします。
# Amazon Quick のパラメータ
*パラメータ*は、アクションまたはオブジェクトにより使用される値を転送できる名前付きの変数です。パラメータを使用することにより、ダッシュボードユーザーはダッシュボード機能をあまりテクニカルではない方法で簡単に操作できます。また、パラメータでは、1 つのダッシュボードを別のダッシュボードに接続することもできます。これにより、ダッシュボードユーザーは異なる分析のデータをドリルダウンできます。
たとえば、ダッシュボードユーザーはリストを使用して値を選択できます。この値は、パラメータを設定し、次にパラメータがフィルタ、計算、または URL アクションを選択した値に設定します。次に、ダッシュボードのビジュアルがユーザーの選択に反応します。
ダッシュボードの表示者に対してパラメータをアクセス可能にするには、パラメータコントロールを追加します。1 つのコントロールの選択が別のコントロールに表示されるオプションをフィルタリングするように、カスケードコントロールを設定できます。コントロールはオプションのリスト、スライダー、またはテキスト入力エリアとして表示される場合があります。コントロールを作成しない場合でも、ダッシュボード URL でパラメータに値を渡すことができます。
パラメータを機能させるには、関連するコントロールがあるかどうかにかかわらず、分析中に何かに接続されている必要があります。以下でパラメータの詳細を参照してください。
+ 計算フィールド (複数値パラメータを除く)
+ フィルタ
+ ダッシュボードと分析 URL
+ アクション
+ 分析全体のタイトルと説明
パラメータを使用できる方法は次のとおりです。
+ 計算を使用すると、分析に表示されるデータを変換できます。
+ 発行する分析にフィルタ付きのコントロールを追加すると、ダッシュボードユーザーは独自のフィルタを作成しなくてもデータをフィルタリングできます。
+ コントロールとカスタムアクションを使用して、ダッシュボードユーザーに URL アクションの値を設定させることができます。
**Topics**
+ [Amazon Quick でのパラメータの設定](parameters-set-up.md)
+ [Amazon Quick で パラメータでコントロールを使用する](parameters-controls.md)
+ [Amazon Quick でのパラメータのデフォルトの作成](parameters-default-values.md)
+ [Amazon Quick のパラメータへの接続](parameters-connections.md)
# Amazon Quick でのパラメータの設定
次の手順を使用して、基本パラメータを作成または編集します。
**基本パラメータを作成または編集するには**
1. 操作する分析を選択し、どのフィールドをパラメータ化するかを決めます。
1. ページ上部のアイコンリストから **[パラメータ]** アイコンを選択します。
1. 新しいパラメータを追加するには、ペインの上部近くにあるプラス記号 (**[\$1 追加]**) を選択します。
最初にパラメータ名の近くにある `v` 字型アイコンを選択し、[**Edit parameter (パラメータを編集)**] を選択して既存のパラメータを編集します。
1. [**Name (名前)**] に、パラメータの英数字の値を入力します。
1. [**Data type (データタイプ)**] で、[**String (文字列)**]、[**Number (数値)**]、[**Integer (整数)**]、[**Datetime (日時)**] のいずれかを選択し、以下のステップを完了します。
+ **[String]** (文字列)、**[Number]** (数値)、**[Integer]** (整数) を選択した場合、次を実行します。
1. [**Values (値)**] で、[**Single value (単一の値)**] または [**Multiple values (複数の値)**] を選択します。
1 つの値だけを含むパラメータには、単一の値のオプションを選択します。1 つ以上の値を含むパラメータには複数の値を選択します。複数値パラメータは `datetime` データ型にすることはできません。また、動的なデフォルト値をサポートしていません。
既存のパラメータで単一の値と複数の値を切り替えるには、パラメータを削除して再作成します。
1. (オプション) [**Static default value (静的デフォルト値)**] または [**Static multiple default values (静的な複数のデフォルト値)**] で、1 つ以上の値を入力します。
このタイプの静的な値は、動的デフォルト値または URL パラメータが指定されていない場合、最初のページのロード時に使用されます。
1. (オプション) [**Show as blank by default (デフォルトで空白として表示)**] を選択します。
複数値リストのデフォルト値を空白として表示するには、このオプションを選択します。このオプションは、複数値パラメータにのみ適用されます。
+ **[Datetime]** (日時) を選択した場合、次を実行します。
1. [**Time granularity (時間詳細度)**] で、[**Day (日)**]、[**Hour (時間)**]、[**Minute (分)**]、[**Second (秒)**] を選択します。
1. **[Default date]** (デフォルトの日付) で、**[Fixed date]** (固定日付) または **[Relative date]** (相対日付) のいずれかを選択し、次の操作を実行します。
+ **[Fixed date]** (固定日付) を選択した場合、ピッカーを使用して日付と時刻を入力します。
+ **[Relative date]** (相対日付) を選択した場合、ローリング日付を選択します。**[Today]** (今日)、**[Yesterday]** (昨日) を選択できます。また、**[Filter condition]** (フィルタ条件) (開始時または終了時)、**[Range]** (範囲) (当、前、翌)、**[Period]** (期間) (年、四半期、月、週、日) を指定できます。
1. (オプション) ユーザー固有のデフォルトを作成するには、[**Set a dynamic default (動的デフォルトの設定)**] を選択します。
*動的なデフォルト*は、ダッシュボードの最初のページ読み込みに対するユーザーごとのデフォルト値です。動的なデフォルトを使用して、ユーザーごとにパーソナライズされたビューを作成できます。
計算されたフィールドは、動的なデフォルトとして使用することはできません。
動的なデフォルトは、ユーザーが異なる値を選択するのを妨げるものではありません。データを保護する場合は、行レベルのロックを追加できます。詳細については、「[データセットへのアクセスを制限するためのユーザーベースのルールでの行レベルのセキュリティの使用ユーザーベースのルールの使用](restrict-access-to-a-data-set-using-row-level-security.md)」を参照してください。
単一値パラメータを選択した場合にのみ、このオプションが表示されます。複数値パラメータは動的なデフォルトを含めることはできません。
**注記**
複数値パラメータを選択した場合は、画面が変更されてデフォルトのオプションが削除されます。代わりに、テキスト [**Enter values you want to use for this control (このコントロールに使用する値を入力する)**] のボックスが表示されます。このボックスに複数の値をそれぞれ 1 行に入力できます。これらの値は、パラメータコントロールのデフォルトの選択値として使用されます。ここでの値は、パラメータコントロールに入力する値と連動しています。パラメータコントロールの詳細については、「[パラメータコントロール](parameters-controls.md)」を参照してください。
1. (オプション) 予約値を設定して、**[Select all]** (すべて選択) の値を指定します。パラメータの予約値とは、パラメータ値として **[Select all]** (すべて選択) を選択したときにパラメータに割り当てられる値です。パラメータに特定の予約値を設定すると、その値はデータセットの有効なパラメータ値とは見なされなくなります。予約値は、フィルター、コントロール、計算フィールド、カスタムアクションなど、パラメータのコンシューマーでは使用できません。また、パラメータのコントロールリストに表示されません。**[Recommended value]** (推奨値)、**[Null]**、**[Custom value]** (カスタム値) から選択できます。**[Recommended value]** (推奨値) を使用することをお勧めします。**[Recommended value]** (推奨値) を選択すると、予約値は値のタイプに基づいて次の値に設定されます。
+ 文字列: `"ALL_VALUES"`
+ 数字: `"Long.MIN_VALUE"-9,223,372,036,854,775,808`
+ 「整数: `Int.MIN_VALUE"-2147483648`
新しいパラメータに予約値を設定するには、**[Create a new parameter]** (新しいパラメータの作成) ページまたは **[Edit parameter]** (パラメータの編集) ページのいずれかで **[Advanced settings]** (詳細設定) ドロップダウンリストを選択し、必要な値を選択します。
1. **[Create]** (作成) または **[Update]** (更新) を選択して、パラメータの作成または更新を完了します。
パラメータを作成したら、さまざまな方法で使用できます。パラメータ (ボタンなど) を作成して、パラメータの値を選択することができます。詳細については、次のセクションを参照してください。
# Amazon Quick で パラメータでコントロールを使用する
ダッシュボードでは、データシートの上部にパラメータコントロールが表示されます。データシートには一連のビジュアルが含まれています。コントロールを提供することで、ユーザーは値を選択して定義済みのフィルタまたは URL アクションで使用することができます。ダッシュボードユーザーは、フィルタ自体を作成することなく、ダッシュボード上のすべてのビジュアルデータセットにフィルタ処理を適用できます。
以下のルールが適用されます。
+ パラメータのコントロールを作成または編集するには、パラメータが存在することを確認します。
+ 複数選択リストコントロールは、分析 URL、ダッシュボード URL、カスタムアクション、カスタムフィルタと互換性があります。フィルタは、指定された値と等しいか、等しくない必要があります。その他の比較はサポートされていません。
+ リストには最大 1,000 個の値が表示されます。異なる値が 1,000 個を超える場合は、検索ボックスが表示され、リストをフィルタリングできます。フィルタリングされたリストに含まれる値が 1,001 未満の場合、リストの内容は行項目として表示されます。
+ また、[**Style (スタイル)**] オプションは、パラメータのデータ型と単一または複数値の設定に適したスタイルタイプのみを表示します。使用するスタイルがリストにない場合、適切な設定でパラメータを再度作成して、再試行します。
+ パラメータをデータセットフィールドにリンクする場合は、実際のフィールドである必要があります。集計フィールドはサポートされていません。
+ 1,000 を超える異なる値がない限り、値はコントロール内でアルファベット順に表示されます。次に、検索ボックスが表示されます。使用したい値を検索するたびに、新しいクエリが開始されます。結果に 1,000 を超える値が含まれている場合は、ページ分割を使用して値をスクロールできます。ワイルドカード検索はサポートされています。ワイルドカード検索の詳細については、[ワイルドカード検索の使用](search-filter.md#search-filter-wildcard) を参照してください。
次の手順を使用して、既存のパラメータのコントロールを作成または編集します。
**既存のパラメータのコントロールを作成または編集するには**
1. 既存のパラメータのコンテキストメニューを選択し、パラメータ名の近くにある `v` 字アイコンを選択して、[**Add control (コントロールを追加)**] を選択します。
1. 新しいコントロールのラベルを付ける名前を入力します。このラベルは WorkSpace の上部に表示され、後でダッシュボードに表示されるシートの上部に表示されます。
1. コントロールのスタイルを次から選択します。
+ **テキストフィールド**
テキストフィールドでは、独自の値を入力できます。テキストフィールドは数字とテキスト (文字列) で動作します。
+ **テキストフィールド - 複数行**
複数行のテキストフィールドでは、独自の値を入力できます。このオプションを使用すると、パラメータコントロールに入力する値を、改行、カンマ、パイプ (\$1)、セミコロンで区切ることができます。テキストフィールドは数字とテキスト (文字列) で動作します。
+ **ドロップダウン**
単一の値を選択するためのドロップダウンリストコントロール リストコントロールは数字とテキスト (文字列) で動作します。
+ **ドロップダウンの複数選択**
複数の値を選択するためのリストコントロール リストコントロールは数字とテキスト (文字列) で動作します。
+ **リスト**
単一の値を選択するためのリストコントロール リストコントロールは数字とテキスト (文字列) で動作します。
+ **リスト - 複数選択**
複数の値を選択するためのリストコントロール リストコントロールは数字とテキスト (文字列) で動作します。
+ **[Slider]** (スライダー)
スライダーを使用すると、コントロールをバーの一端から別の端にスライドすることで数値を選択できます。スライダーは数字で動作します。
+ **Date-picker (日付選択ツール)**
日付選択ツールを使用すると、カレンダーコントロールから日付を選択できます。日付選択コントロールを追加することを選択すると、コントロール内の日付の書式設定方法をカスタマイズできます。これを行うために、[**Date format**] で、[Quick での日付形式のカスタマイズ](format-visual-date-controls.md)で 説明するトークンを使用する日付の書式を入力します。
1. (オプション) ドロップダウンコントロールを選択すると、画面が展開され、表示する値を選択できます。値のリストを指定するか、データセット内のフィールドを使用します。次のいずれかを選択します。
+ [**Specific values (特定の値)**]
特定の値のリストを作成するには、次のスクリーンショットに示すように、空白またはコンマを区切って 1 行に 1 つずつ入力します。
コントロールでは、入力順ではなく、アルファベット順に値が表示されます。
+ [**Link to a data set field (データセットフィールドへのリンク)**]
フィールドにリンクするには、フィールドを含むデータセットを選択し、リストからフィールドを選択します。
パラメータのデフォルト値を変更する場合は、コントロールの [**Reset (リセット)**] を選択して、新しい値を表示します。
ここで選択した値は、パラメータ設定の静的なデフォルト値と連動しています。
1. (オプション) **パラメータにデフォルトが設定されている場合、コントロールで、[Hide [ALL] option (「すべての」オプションを隠す)]** オプションを有効にします。これを行うと、データ値のみが表示され、コントロール内のすべての項目を選択するオプションが削除されます。パラメータで静的デフォルトを設定しない場合、このオプションは機能しません。コントロールを追加した後にデフォルトを追加するには、パラメータを選択し、[**Edit parameter (パラメータを編集する)**]を選択します。
1. (オプション) コントロールに表示される値は、他のコントロールで選択されているものに対して有効な値のみを表示するように制限できます。これは、カスケードコントロールと呼ばれます。
これを作成するには [**Show relevant values only (関連する値のみ表示)**] を選択します。このコントロールに表示される内容を変更できる 1 つ以上のコントロールを選択します。
カスケードコントロールを作成する場合、次のような制限があります。
+ カスケードコントロールは、同じデータセットのデータセット列に関連付ける必要があります。
+ 子コントロールは、ドロップダウンコントロールまたはリストコントロールでなければなりません。
+ パラメータコントロールの場合、子コントロールはデータセット列にリンクさせる必要があります。
+ フィルタコントロールの場合、子コントロールは (特定の値のみを表示するのではなく) フィルタにリンクさせる必要があります。
+ 親コントロールは次のいずれかである必要があります。
+ 文字列、整数、または数値パラメータコントロール。
+ 文字列フィルタコントロール (上下のフィルタを除く)。
+ 集計されていない数値フィルターコントロール。
+ 日付フィルタコントロール (上下のフィルタを除く)。
1. コントロールのオプションの選択が終わったら、[**Add (追加)**] を選択します。
終了したコントロールは、ワークスペースの上部に表示されます。`v` のような形をしたコンテキストメニューには、次の 4 つのオプションがあります。
+ [**Reset (リセット)**] は、ユーザーの選択をデフォルト状態に戻します。
+ [**Refresh list (リストの更新)**] は、データセット内のフィールドにリンクされているドロップダウンにのみ適用されます。[**Refresh list (リストの更新)**] を選択すると、データをクエリして変更を確認します。コントロールで使用されるデータがキャッシュされます。
+ [**Edit (編集)**] はコントロールの作成画面を開き、設定を変更することができます。
**[Edit control]** (コントロールを編集) ペインが開くと、さまざまなビジュアルやコントロールをクリックして、特定のビジュアルまたはコントロールのフォーマットデータを表示できます。ビジュアルの形式設定については、「[Amazon Quick でのフォーマット](formatting-a-visual.md)」を参照してください。
+ [**Delete (削除)**] はコントロールを削除します。パラメータのコンテキストメニューを選択して再作成することができます。
ワークスペースでは、コントロールのサイズを変更して並べ替えることもできます。ダッシュボードのユーザーは、編集や削除ができない場合を除き、表示します。
# Amazon Quick でのパラメータのデフォルトの作成
このセクションを参照して、使用可能なパラメータのデフォルトのタイプと、それぞれのパラメータの設定方法の詳細について学びます。
各フィールドにパラメータとコントロールを関連付けることができます。ユーザーがダッシュボードまたは E メールレポートを表示すると、静的デフォルト値が設定されているシートコントロールでは、静的デフォルトが使われます。デフォルト値で、データのフィルタリング方法、カスタムアクションの動作、動的シートタイトルに表示されるテキストを変更できます。E メールレポートは、動的デフォルトもサポートしています。
最も簡単なデフォルトは、静的 (変化しない) デフォルトで、全員に同じ値が表示されます。ダッシュボードのデザイナーとして、デフォルト値を選択します。この値は、ダッシュボードを使用しているユーザーが変更することはできません。ただし、そのユーザーはコントロールから任意の値を選択できます。デフォルトを設定しても、これは変更されません。ユーザーが選択できる値を制限するには、行レベルのセキュリティの使用を検討します。詳細については、[データセットへのアクセスを制限するためのユーザーベースのルールでの行レベルのセキュリティの使用ユーザーベースのルールの使用](restrict-access-to-a-data-set-using-row-level-security.md)を参照してください。
**全員のダッシュボードビューに適用される静的デフォルト値を作成または編集するには**
1. 編集するパラメータでコンテキストメニュー (`v`) を選択するか、[Amazon Quick でのパラメータの設定](parameters-set-up.md) のステップに従って新しいパラメータを作成します。
1. 静的デフォルトを設定するには、[**Static default value (静的デフォルト値)**] の値を入力します。
ダッシュボードを表示しているユーザーに応じて異なるデフォルトを表示するには、動的デフォルトパラメータ (DDP) を作成します。動的デフォルトを使用するには、割り当てられたデフォルトにユーザーをマッピングする準備が必要です。まず、表示するユーザー、フィールド、デフォルト値に関する情報を含むデータベースクエリまたはデータファイルを作成する必要があります。これをデータセットに追加し、そのデータセットを分析に追加します。ここでは、情報の収集、データセットの作成、およびパラメータへの動的デフォルトの追加の手順について説明します。
動的デフォルト値のデータセットを作成する際は、次のガイドラインに従ってください。
+ 単一のデータセットを使用して、ユーザーまたはグループの論理グループのすべての動的デフォルト定義を含めることをお勧めします。可能であれば、単一のテーブルまたはファイルにそれらを保持します。
+ また、データセット内のフィールド名は、分析のフィールド名と一致させることを推奨します。例えば、複数のダッシュボードのデフォルトに同じデータセットを使用している場合、すべてのデータセットフィールドが分析の一部である必要はありません。フィールドは任意の順序で指定できます。
+ 同じ列または同じデータセット内で、ユーザー名とグループ名の両方を組み合わせることはお勧めしません。このような設定にすると、メンテナンスとトラブルシューティングが煩雑になります。
+ カンマ区切りファイルを使用してデータセットを作成する場合は、ファイル内の値の間のスペースを削除してください。次の例は、正しいカンマ区切り値の (CSV) 形式を示しています。英数字以外の文字 (スペース、アポストロフィなど) を含むテキスト (文字列) は、一重引用符または二重引用符で囲みます。日付または時刻のフィールドも引用符で囲むことができますが、必須ではありません。数値フィールドは引用符で囲むことができます (以下のように、数字に特殊文字が含まれている場合など)。
```
"Value includes spaces","Field contains ' other characters",12345.6789,"20200808"
ValueWithoutSpaces,"1000,67","Value 3",2020-AUG-08
```
+ データセットを作成したら、Quick がフィールドに対して選択するデータ型を再確認してください。
開始する前に、動的デフォルトを設定しようとしているユーザーのユーザー名またはグループ名のリストが必要です。ユーザーまたはグループのリストを生成するには、 AWS CLI を使用して情報を取得します。CLI コマンドを実行するには、 AWS CLI がインストールおよび設定されていることを確認します。詳細については、「*AWS CLI ユーザーガイド*」の「[Installing the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html)」を参照してください。
これは、ユーザー名またはグループ名のリストを取得する方法の一例です。最適な方法を使用してください。
**動的デフォルトパラメータ (DDP) のユーザーを識別するには**
+ 個々のユーザー名またはグループ名のいずれかを一覧表示します。
+ 個々のユーザー名を一覧表示するには、DDP のユーザーを識別する列を含めます。この列には、ID プロバイダーから Quick への接続に使用する各ユーザーのシステムユーザー名が含まれている必要があります。このユーザー名は多くの場合、@ 記号の前にあるユーザーの E メールエイリアスと同じです。
ユーザーのリストを取得するには、[ListUsers](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListUsers.html) Quick API オペレーションまたは AWS CLI コマンドを使用します。次の例に示すように、CLI コマンドを使用します。ID プロバイダーの AWS リージョン を指定します (例: `us-east-1`)。
```
awsacct1="111111111111"
namespace="default"
region="us-east-1"
aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region
```
次の例では、結果をアクティブなユーザーに限定するクエリを追加して、以前のコマンドを変更します。
```
awsacct1="111111111111"
namespace="default"
region="us-east-1"
aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region --query 'UserList[?Active==`true`]'
```
結果セットは以下の例のようになります。この例は、JSON 出力 (`--output json`) から抜粋したものです。フェデレーティッドユーザー名を持つユーザーは、`federated` という単語で始まるプリンシパル ID を持っています。
```
[
{
"Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/anacasilva",
"UserName": "anacarolinasilva",
"Email": "anacasilva@example.com",
"Role": "ADMIN",
"Active": true,
"PrincipalId": "federated/iam/AIDAJ64EIEIOPX5CEIEIO"
},
{
"Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/Reader/liujie-stargate",
"UserName": "Reader/liujie-stargate",
"Role": "READER",
"Active": true,
"PrincipalId": "federated/iam/AROAIJSEIEIOMXTZEIEIO:liujie-stargate"
},
{
"Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/embedding/cxoportal",
"UserName": "embedding/cxoportal",
"Email": "saanvisarkar@example.com",
"Role": "AUTHOR",
"Active": true,
"PrincipalId": "federated/iam/AROAJTGEIEIOWB6BEIEIO:cxoportal"
},
{
"Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/zhangwei@example.com",
"UserName": "zhangwei@example.com",
"Email": "zhangwei@example.com",
"Role": "AUTHOR",
"Active": true,
"PrincipalId": "user/d-96123-example-id-1123"
}
]
```
+ グループ名を一覧表示するには、DDP のユーザー名を含むグループを識別する列を含めます。この列には、ID プロバイダーから Quick への接続に使用されるシステムグループ名が含まれている必要があります。データセットに追加できるグループを特定するには、次の 1 つ以上のクイック API オペレーションまたは CLI コマンドを使用します。
+ [ListGroups](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListGroups.html) – ID プロバイダー AWS リージョン を含む の AWS アカウント ID と名前空間別にクイックグループを一覧表示します。
+ [ListGroupMemberships](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListGroupMemberships.html) – 指定されたクイックグループのユーザーを一覧表示します。
+ [ListUserGroups](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListUserGroups.html) – クイックユーザーがメンバーであるクイックグループを一覧表示します。
または、ID プロバイダーに問い合わせてこの情報を取得するよう、ネットワーク管理者に依頼することもできます。
次の 2 つの手順は、動的デフォルト値のデータセットの作成を完了する方法です。最初の手順は、単一値 DDP のデータセットを作成する方法です。2 番目は、複数値 DDP のデータセットを作成する方法です。
**単一値 DDP のデータセットを作成するには**
1. 単一値パラメータを持つデータセット列を作成します。クエリまたはファイルの最初の列は、ダッシュボードを使用しているユーザー用である必要があります。このフィールドには、ユーザー名またはグループ名を含めることができます。ただし、 グループのサポートは Quick Enterprise Edition でのみ利用できます。
1. 単一値パラメータの動的デフォルトを表示するフィールドごとに、データセットに列を追加します。列の名前は何でも構いません。フィールドまたはパラメータと同じ名前を使用できます。
単一値パラメータは、ユーザーエンティティと動的デフォルトの組み合わせがそのパラメータフィールドで一意である場合にのみ、指定どおりに機能します。ユーザーエンティティのデフォルトフィールドに複数の値がある場合、そのフィールドの単一値コントロールには、静的デフォルトが代わりに表示されます。静的デフォルトが定義されていない場合、コントロールにはデフォルト値が表示されません。一部のユーザー名は複数のグループのメンバーである可能性があるため、グループ名を使用する場合は注意が必要です。これらのグループのデフォルト値が異なる場合、このタイプのユーザー名は重複エントリとして機能します。
次の例は、2 つの単一値パラメータを含むテーブルを示しています。ユーザー名が複数のデフォルト値とペアになっていないため、この仮定を行います。このテーブルを理解しやすくするために、単語 `'default'` を分析のフィールド名の前に追加します。このように、以下のステートメントを作成し、各行の値を変更することで、テーブルを読み込むことができます。`anacarolinasilva` によって表示される場合、コントロールはデフォルトのリージョン `NorthEast` およびデフォルトのセグメント `SMB` を表示します。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/parameters-default-values.html)
1. このデータを Quick にインポートし、新しいデータセットとして保存します。
1. 分析で、作成したデータセットを追加します。分析では、デフォルトで定義した列と一致する他のデータセットを 1 つ以上使用する必要があります。詳細については、「[分析へのデータセットの追加](adding-a-data-set-to-an-analysis.md)」 を参照してください。
**複数値 DDP のデータセットを作成するには**
1. 複数値パラメータを持つデータセット列を作成します。クエリまたはファイルの最初の列は、ダッシュボードを使用しているユーザー用である必要があります。このフィールドには、ユーザー名またはグループ名を含めることができます。ただし、 グループのサポートは Quick Enterprise Edition でのみ利用できます。
1. 複数値パラメータの動的デフォルトを表示するフィールドごとに、データセットに列を追加します。列の名前は何でも構いません。フィールドまたはパラメータと同じ名前を使用できます。
単一値パラメータとは異なり、複数値パラメータでは、パラメータに関連付けられたフィールドに複数の値を使用できます。
次の例は、単一値パラメータと複数値パラメータを含むテーブルを示しています。各ユーザー名は 1 つの列に一意の値を持ち、一部のユーザー名はもう一方の列に複数の値を持つため、この仮定を行うことができます。このテーブルを理解しやすくするために、単語 `'default'` を分析のフィールド名の前に追加します。このように、以下のステートメントを作成し、各列の値を変更することで、テーブルを読み込むことができます。`viewed-by` が `liujie` の場合、コントロールは `SouthEast` の `default-region` 値、および `Atlanta` の `default-city` 値を表示します。1 行先を読み込むと、`liujie` も `default-city` の `Raleigh` を表示します。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/parameters-default-values.html)
この例では、`default-region` を適用するパラメータは、単一値パラメータか複数値パラメータかにかかわらず、正しく機能します。単一値パラメータの場合、両方のエントリが同じ値 `SouthEast` であるため、1 人のユーザーに対して 2 つのエントリが機能します。複数値パラメータの場合も、デフォルトで 1 つの値のみが選択されている点を除いて、機能します。ただし、`default-city` を使用しているパラメータを変更した場合、デフォルトも複数値から単一値パラメータに変更されるため、これらのデフォルトは選択されません。代わりに、パラメータに静的デフォルトが定義されている場合は、静的デフォルトが使われます。例えば、`Atlanta` に静的デフォルトが設定されている場合、`liujie` はそのコントロールで `Raleigh` ではなく `Atlanta` を選択します。
場合によっては、静的デフォルト値が動的デフォルト値として使用されることもあります。その場合は、両方のデフォルト値を使用しないユーザー名のコントロールをテストしてください。
あるユーザー名が複数のグループに属している場合、指定されたユーザーには、2 つのグループのデフォルト値の和集合である一連のデフォルト値が表示されます。
1. このデータを Quick にインポートし、新しいデータセットとして保存します。
1. 分析で、作成したデータセットを追加します。分析では、デフォルトで定義した列と一致する他のデータセットを 1 つ以上使用する必要があります。詳細については、「[分析へのデータセットの追加](adding-a-data-set-to-an-analysis.md)」 を参照してください。
以下の手順に従って、分析に動的デフォルトパラメータを追加します。開始する前に、各ユーザー名またはグループ名の動的デフォルトを含むデータセットがあることを確認します。また、分析でこのデータセットを使用していることを確認してください。これらの要件については、前述の手順を参照してください。
**分析に DDP を追加するには**
1. クイックコンソールで、ページの上部にある**パラメータ**アイコンを選択し、既存のパラメータを選択します。パラメータのメニューから、**[Edit parameter]** (パラメータの編集) を選択します。新しいパラメータを追加するには、**[Parameters]** (パラメータ) の近くにあるプラス (`+`) 記号を選択します。
1. [**Set a dynamic default (動的なデフォルトを設定)**] を選択します。
1. 以下のオプションを設定します。
+ **デフォルト値およびユーザー情報を含むデータセット** — 作成して分析に追加したデータセットを選択します。
+ **ユーザー名の列** — ユーザー名に基づくデフォルトを作成するには、データセット内のユーザー名を含む列を選択します。
+ **グループ名の列** — グループ名に基づくデフォルトを作成するには、データセット内のグループ名を含む列を選択します。
+ **デフォルト値の列** — このパラメータのデフォルト値を含む列を選択します。
1. **[Apply]** (適用) を選択して設定変更を保存し、続いて **[Update]** (更新) を選択してパラメータの変更を保存します。変更せずに終了するには、**[Cancel]** (キャンセル) を選択します。
1. 動的デフォルトを含む各フィールドにフィルタを追加して、デフォルトを機能させます。パラメータによるフィルターの使用方法の詳細については、「[Amazon Quick のパラメータでフィルターを使用する](parameters-filtering-by.md)」を参照してください。
Amazon Quick は、ユーザー名がデータセットに存在しない、デフォルトが割り当てられていない、または一意のデフォルトを持たないすべてのユーザーに静的なデフォルト値を使用します。各ユーザーは、デフォルトのセットを 1 つだけ持つことができます。動的デフォルト値を使用しない場合は、静的デフォルトを設定できます。
# Amazon Quick のパラメータへの接続
パラメータを設定した後にこのセクションを参照して、パラメータを接続して機能させます。
パラメータを作成したら、そのパラメータのコンシューマーを作成できます。*パラメータのコンシューマー*は、フィルター、コントロール、計算フィールド、カスタムアクションなど、パラメータの値を消費するコンポーネントです。
次のように、これらのオプションのそれぞれに別の方法で移動できます。
+ フィルターを作成するには、ページ上部の**フィルター**アイコンを選択します。つまり、[**Custom Filter (カスタムフィルター)**] を作成し、[**Use parameters (パラメーターを使用)**] を有効にします。リストには、対象となるパラメータのみが表示されます。
+ パラメータに新しいコントロールを追加するには、ページ上部の**パラメータ**アイコンを選択します。つまり、パラメーターを選択してから、[**Add control (コントロールを追加)**] を選択します。
+ 計算フィールドでパラメーターを使用するには、既存の計算フィールドを編集、または左上にある [**Add (追加)**] を選択して、新しいフィールドを追加します。パラメータリストはフィールドリストの下に表示されます。
**注記**
計算フィールドで複数値パラメータを使用することはできません。
+ URL アクションを作成するには、ビジュアルで、[**v**] 字型メニューを選択してから [**URL Actions (URL アクション)**] を選択します。
これらの各トピックの詳細については、以下のセクションを参照してください。
**Topics**
+ [パラメータとのフィルターの使用](parameters-filtering-by.md)
+ [パラメータとの計算フィールドの使用](parameters-calculated-fields.md)
+ [パラメータとのカスタムアクションの使用](parameters-custom-actions.md)
+ [URL のパラメータ](parameters-in-a-url.md)
+ [タイトルと説明のパラメータ](parameters-in-titles.md)
# Amazon Quick のパラメータでフィルターを使用する
このセクションを参照して、分析またはダッシュボード内のデータを単一値のパラメータ値でフィルタリングします。複数値のパラメータ - 複数選択のドロップダウンコントロールを使用するパラメータ - 値と等しい (または等しくない) カスタムフィルタを作成します。
パラメータを使用してフィルタを使用する前に、フィルタの操作方法を知っておく必要があります。
1. 分析にパラメータがすでに作成されていることを確認します。パラメータまたはコントロールメニューから **[Edit]** (編集) を選択して、使用中の設定を確認します。
1. 画面の左側にある [**Filter (フィルター)**] ペインを選択します。使用するフィールドのフィルタが既に存在する場合は、それを選択して設定を開きます。それ以外の場合は、パラメータでフィルタリングするフィールドのフィルタを作成します。
1. [**Use Parameters (パラメーターを使用する)**] を選択します。
1. リストまたは [**Use parameters (パラメーターの使用)**] のリストからパラメーターを選択します。テキスト (文字列) フィールドの [**Custom Filter (カスタムフィルター)**] を選択し、[**Use Parameters (パラメーターの使用)**] を有効にします。
日付フィールドの場合は、次のスクリーンショットのように、[**Start date (開始日)**] と [**End date (終了日)**] パラメーターを選択します。
他のデータ型のフィールドで、[**Select a parameter (パラメーターの選択)**] を選択して、リストからパラメーターを選択します。
**注記**
複数の値を持つことのできるパラメータは、比較のタイプとして、等しい/等しくないを使用する必要があります。
1. **[適用]** を選択して変更を保存します。
分析の上部付近のコントロールを選択して、新しいフィルタをテストします。この例では、デフォルトを持たないベーシックパラメータと、**[Sales Pipeline]** (販売パイプライン) というサンプルデータセットの **[Region]** (リージョン) フィールドにリンクされた動的コントロールを使用します。コントロールはデータのクエリを行い、すべての値を返します。
フィルタで使用しているパラメータを削除または再作成する場合は、新しいパラメータでフィルタを更新できます。これを行うには、フィルターを開き、使用する新しいパラメーターを選択し、[**適用**] を選択します。
パラメータの名前を変更する場合は、フィルタや他のコンシューマーを更新する必要はありません。
# Amazon Quick でパラメータを使用して計算フィールドを使用する
分析の計算フィールドにパラメータの値を渡すことができます。計算を作成するときは、[**パラメータリスト**] のパラメータリストから既存のパラメータを選択できます。複数選択のドロップダウンコントロールを使用する複数値のパラメータを含む計算フィールドを作成することはできません。
式では、利用可能ないずれかの関数を使用できます。表示者の選択項目をパラメータコントロールから、`ifElse` 関数に渡します。引き換えに、メトリクスを取得します。例を以下に示します。
```
ifelse(
${KPIMetric} = 'Sales',sum({Weighted Revenue}),
${KPIMetric} = 'Forecast',sum({Forecasted Monthly Revenue}),
${KPIMetric} = '# Active', distinct_count(ActiveItem),
NULL
)
```
前の例では、フィールドウェルで使用できるメトリクス (小数) が作成されます。次に、パラメータコントロールから値を選択すると、ビジュアルが更新され、選択項目が反映されます。
# Amazon Quick のパラメータでカスタムアクションを使用する
*カスタムアクション*を使用すると、ビジュアル内のデータポイントを選択するか、コンテキストメニューからアクション名を選択して、URL を起動、またはビジュアルをフィルターできます。パラメータで URL アクションを使用する場合、パラメータを URL に動的に渡す、または送信できます。これを有効にするには、パラメータを設定し、[**URL action (URL アクション)**] のアクションタイプでカスタムアクションを作成するときに URL で使用します。送信側と受信側の両方のパラメータは、名前とデータ型が一致する必要があります。すべてのパラメータは、URL アクションと互換性があります。
URL アクションの作成の詳細については、「[Amazon Quick Sight でのカスタムアクションの作成と編集](custom-actions.md)」を参照してください。URL アクションを作成せずにリンクのパラメータを使用するだけの場合は、「[URL でのパラメータの使用](parameters-in-a-url.md)」を参照してください。
# URL でのパラメータの使用
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>>`）
+ カスタムアクションでは、パラメータ値は山括弧 `<< >>` で表示されます (例: `<>`)。ダッシュボードユーザーには、変数ではなくルックアップ値が表示されます。
+ カスタム 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)」を参照してください。
# Amazon Quick でのタイトルと説明でのパラメータの使用
Amazon Quick でパラメータを作成すると、グラフと分析全体のタイトルと説明でパラメータ値を自動的に表示することができます。
以下の分析領域で、パラメータを使用します。
+ グラフタイトルとサブタイトル
+ 軸タイトル
+ 凡例タイトル
+ パラメータコントロールのタイトル
+ シートタイトルと説明
次の画像は、パラメータを使用するグラフタイトルを示しています。
![\[グラフタイトルのパラメータと、赤丸で囲まれたタイトルにパラメータ値があるグラフが表示された [Format visual (ビジュアルのフォーマット)] ペインの画像。\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/parameters-in-titles-labels2.png)
以下の手順に従って、分析全体の領域にパラメータを追加します。パラメータおよびその作成方法の詳細については、「[パラメータ](parameters-in-quicksight.md)」を参照してください。
## グラフタイトルとサブタイトルへのパラメータの追加
以下の手順に従って、グラフタイトルとサブタイトルにパラメータを追加します。
**グラフタイトルまたはサブタイトルにパラメータを追加するには**
1. 書式を設定するビジュアルの **[プロパティ]** ペインを開きます。
1. **[プロパティ]** ペインで **[タイトル]** タブを選択します。
1. **[Show title]** (タイトルを表示) または **[Show subtitle]** (サブタイトルを表示) を選択します。これらのオプションはすでに選択されている可能性があります。
1. **[Edit title]** (タイトルの編集) または **[Edit subtitle]** (サブタイトルの編集) の右側にある 3 つのドットを選択し、続いてリストからパラメータを選択します。
パラメータが **[プロパティ]** ペインのタイトルに追加されます。グラフで、パラメータ値がタイトルに表示されます。
ビジュアルでのタイトルとサブタイトルの編集の詳細については、「[Quick のビジュアルタイプのタイトルとサブタイトル](customizing-a-visual-title.md)」を参照してください。
## 軸タイトルへのパラメータの追加
以下の手順に従って、軸タイトルにパラメータを追加します。
**軸タイトルにパラメータを追加するには**
1. 書式を設定するビジュアルの **[プロパティ]** ペインを開きます。
1. **[プロパティ]** ペインで、書式を設定する軸を選択します。
1. **[Show title]** (タイトルの表示) を選択します。
1. デフォルトの軸タイトルの右側にある 3 つのドットを選択し、続いてリストからパラメータを選択します。
パラメータが **[プロパティ]** ペインの軸タイトルに追加されます。グラフで、パラメータ値が軸タイトルに表示されます。
軸タイトルの編集の詳細については、「[軸とグリッド線](showing-hiding-axis-grid-tick.md)」を参照してください。
## 凡例タイトルへのパラメータの追加
以下の手順に従って、凡例タイトルにパラメータを追加します。
**凡例タイトルにパラメータを追加するには**
1. 書式を設定するビジュアルの **[プロパティ]** ペインを開きます。
1. **[プロパティ]** ペインで **[凡例]** を選択します。
1. **[Show legend title]** (凡例タイトルを表示) を選択します。
1. **[Legend title]** (凡例タイトル) の右側にある 3 つのドットを選択し、続いてリストからパラメータを選択します。
パラメータが **[プロパティ]** ペインの凡例タイトルに追加されます。グラフで、パラメータ値が凡例タイトルに表示されます。
凡例の書式設定の詳細については、「[Quick のビジュアルタイプの凡例](customizing-visual-legend.md)」を参照してください。
## コントロールタイトルへのパラメータの追加
以下の手順に従って、パラメータコントロールタイトルにパラメータを追加します。
**パラメータコントロールタイトルにパラメータを追加するには**
1. 編集するパラメータコントロールを選択し、パラメータコントロールタイトルの右側にある 3 つのドットを選択してから、**[Edit]** (編集) をクリックします。
1. 開いている **[Edit control]** (コントロールの編集) のページで、**[Show title]** (タイトルを表示) を選択します。
1. **[Display name]** (名前を表示) の右側にある 3 つのドットを選択し、続いてリストからパラメータを選択します。
パラメータがパラメータコントロールタイトルに追加されます。
パラメータコントロールの使用の詳細については、「[パラメータコントロール](parameters-controls.md)」を参照してください。
## シートのタイトルと説明へのパラメータの追加
以下の手順に従って、分析のシートタイトルと説明にパラメータを追加します。
**シートタイトルまたは説明にパラメータを追加するには**
1. 分析ページで、アプリケーションバーの **[シート]** を選択し、**[タイトルの追加]** または **[説明を追加]** を選択します。
シートタイトルまたは説明がシートに表示されます。
1. **[Sheet title]** (シートタイトル) または **[Description]** (説明) で、右側にある 3 つのドットを選択し、続いてリストからパラメータを選択します。
パラメータがシートタイトルまたは説明に追加され、テキストボックスを閉じるとパラメータ値がテキストに表示されます。
シートタイトルと説明を追加する方法の詳細については、「[分析へのタイトルと説明の追加](adding-a-title-and-description.md)」を参照してください。
# フィルタリングとナビゲーション用のカスタムアクションの使用
ダッシュボードサブスクライバー (クイックリーダー) のインタラクティブオプションを追加するには、分析で 1 つ以上のビジュアルにカスタムアクションを作成します。カスタムアクションでダッシュボードを強化すると、データセット内からコンテキストを追加してデータを探しやすくなります。これにより、詳細を掘り下げ、同じダッシュボード、別のダッシュボード、別のアプリケーションで新しいインサイトを見つけやすくなります。ダッシュボード内の各ビジュアルに最大 10 個のカスタムアクションを追加できます。
始める前に、計画を立てると便利です。例えば、フィルタリングや、別のシートを開く、URL を開く、あるいは電子メーを送るのに適したフィールドを特定するなどです。各シートで、これらのフィールドを表示するウィジェットを特定します。次に、アクションを含むウィジェットを決定します。命名規則を作成してアクションの名前を分析全体で一貫させておくことも有効です。名前が一貫していると、分析を使用しているユーザーがアクションの実行内容を把握しやすくなり、分析全体で重複している可能性のあるアクションを簡単に管理できます。
アクションは、作成したダッシュボードウィジェットにのみ存在し、そのウィジェットの親シートと、表示される子フィールドのコンテキストで動作します。アクションは、特定の種類のウィジェット (ビジュアルとインサイト) に対してのみ作成できます。フィルターやリストコントロールなど、他のウィジェットには追加できません。カスタムアクションは、作成したウィジェットからのみアクティブにできます。
アクションをアクティブ化するには、分析を使用しているユーザーが、データポイントを左クリック (選択) するか、または右クリック (コンテキストメニューを使用) します。データポイントは、折れ線グラフのポイント、ピボットテーブルのセル、円グラフのスライスなどのデータセット内にある項目です。ユーザーがビジュアル要素をクリックすると、*選択*アクションがアクティブになります。これは、分析内の**アクション**の**選択時**カテゴリに現在含まれているアクションです。代わりに、ビジュアル要素を右クリックすると、*メニュー*アクションの一覧から選択できます。一覧表示されたアクションは、現在、分析内の**アクション**の**メニューオプション**のカテゴリに含まれています。**選択時**カテゴリに含めることができるアクションは 1 つだけです。
デフォルトでは、最初に作成したアクションが選択アクションになります。左クリックでアクティブになります。**選択時**カテゴリからアクションを削除するには、アクションの**アクティベーション**設定を**メニューオプション**に変更します。変更を保存したら、別のアクションの**アクティベーション**を**選択**に設定します。
アクションを設定するときは、次の 3 つの**アクションタイプ**から選択できます。
+ **フィルターアクション** — ビジュアルまたはシート全体に含まれるデータをフィルタします。デフォルトでは、フィルターは親ビジュアルのすべてのフィールドで使用できます。カスケードフィルターは、デフォルトでは有効になっています。フィルターアクションは、自動的に生成されるフィールドマッピングを使用して、複数のデータセットにわたって機能します。
分析で複数のデータセットが使用されている場合、複数のデータセットに存在するフィールドに対して自動生成されたフィールドマッピングを表示できます。これを行うには、アクションを編集する際、アクション設定の最後に [****View field mapping (フィールドマッピングを表示)****] を選択します。アクションの一覧を表示している場合は、各アクションのメニューで [****View field mapping (フィールドマッピングを表示)****] を選択します。フィールドマッピングが新しい画面に表示されます。この画面には、ビジュアル内の初期データセットと他のすべてのデータセットとの間のマッピングが表示されます。自動的にマッピングされるフィールドがない場合は、[フィールドのマッピングと結合](mapping-and-joining-fields.md)へのリンクを含むメッセージが表示されます。
+ **ナビゲーションアクション** - 同じ分析内の異なるシート間でのナビゲーションを有効にします。
+ **URL アクション** — 別の Web ページへのリンクを開きます。別のダッシュボードを開く場合は、URL アクションを使用します。URL アクションを使用すると、データポイントとパラメータを他の URL に送信できます。使用可能な任意のフィールドまたはパラメータを含めることができます。
URL が `mailto` スキームを使用している場合、このアクションを実行するとデフォルトの E メールエディタが開きます。
**Topics**
+ [ワンクリックインタラクティブフィルターの追加](quick-actions.md)
+ [Amazon Quick Sight でのカスタムアクションの作成と編集](custom-actions.md)
+ [カスタムアクションの修復](repairing-custom-actions.md)
+ [Amazon Quick Sight のカスタムアクションのフィールドマッピングについて](quicksight-actions-field-mapping.md)
# ワンクリックインタラクティブフィルターの追加
ワンクリックインタラクティブフィルタリングでは、クリック可能なビジュアルから、シート上の他のすべてのビジュアルやインサイトへとカスケードする、ポイントアンドクリックフィルタリングが提供されます。これを分析に追加し、サマリーから始めてメトリクスにドリルダウンします。これらは、すべて同じダッシュボードシート内で行います。
これをセットアップした後にデータポイント (棒グラフの棒など) をクリックすると、そのシートの他のすべてのビジュアルにあるマップされたすべてのフィールドを使用して、すぐにフィルター処理が行えます。複数のデータセットがある場合にこれを機能させるには、すべてのターゲットフィールドをマップする必要があります。また、データポイントのクリックによって動作するアクションは 1 つに限られます。他のすべてのアクションは、コンテキストメニューから動作します。
分析でワンクリックフィルターを作成するには、以下の手順に従います。
**ビジュアルまたはインサイトに対してワンクリックフィルターを作成するには**
1. 分析で、対話型フィルタリングを追加するビジュアルまたはインサイトを選択します。
1. 右上隅の [メニューオプション] ドロップダウンから **[アクション]** を選択します。
1. [**Filter same-sheet visuals (同じシートのビジュアルをフィルタリング)**] を選択します。これにより、ワンクリックフィルタリングがただちに追加されます。
1. インタラクティブにするビジュアルごとに、このプロセスを繰り返します。
# Amazon Quick Sight でのカスタムアクションの作成と編集
ビジュアルに追加できるようにするタスクごとに、1 つのアクションを作成します。作成したアクションは、各ビジュアルまたはインサイトの機能の一部になります。
次の表では、各種類のアクションを使用する時期を定義しています。
| 実行するアクション | アクションのタイプ |
| --- | --- |
| ワンクリックフィルターを含む対話型フィルターアクションを追加またはカスタマイズする | フィルターアクション |
| 同じダッシュボードで別のシートを開く | ナビゲーションアクション |
| 同じ AWS アカウントアカウントの別のダッシュボードでシートを開く | URL アクション |
| URL を開く (`https`、`http`) | URL アクション |
| E メールを送信する (`mailto`) | URL アクション |
カスタムアクションには、次の属性とオプションを設定できます。
+ ****アクション名**** - アクションに対して選択するわかりやすい名前です。デフォルトでは、アクションには **Action 1**、**Action 2** などの名前が付けられます。カスタムアクションがコンテキストメニューからアクティブ化されている場合、データポイントを右クリックするとメニューにこの名前が表示されます。
アクション名をダイナミックにするには、アクション名をパラメータ化します。アクション名ヘッダーの近くにあるプラスアイコンを使用して、使用可能な変数のリストを表示します。変数は山括弧 `<< >>` で括られています。パラメータには、プレフィックス `$` がついています (例: `<<$parameterName>>`)。フィールド名にはプレフィックスはありません (例: `<>`)。
+ ****アクティベーション**** - 利用可能なオプションは、[**Select (選択)**] または [**Menu option (メニューオプション)**] です。アクションを使用するには、データポイントを*選択*する (左クリック) か、コンテキストメニューの*メニューオプション*に移動します (右クリック)。ナビゲーションアクションとURL アクションは、[**Color (色)**] オプションのすぐ上にあるコンテキストメニューの中央に表示されています。メニューでアクティブ化されたアクションは、ビジュアルの凡例からも使用できます。
+ ****アクションタイプ**** - 必要なアクションのタイプです。アクションタイプに固有の設定は、アクションタイプを選択した後にのみ表示されます。
+ **フィルターアクション**設定には、以下が含まれます。
+ ****フィルター範囲**** — フィルターが適用されるフィールドです。すべてのフィールドにフィルターを適用するには、[**All fields (すべてのフィールド)**] を選択します。それ以外の場合は [**Select fields (フィールドを選択)**] を選択し、ターゲットにしない項目をオフにします。
デフォルトは [**All fields (すべてのフィールド)**] です。
+ ****ターゲットビジュアル**** — ターゲットにするダッシュボードウィジェットです。すべてのビジュアルにフィルターを適用するには、[**All visuals (すべてのビジュアル)**] を選択します。それ以外の場合は [**Select visuals (ビジュアルを選択する)**] を選択し、ターゲットにしない項目をオフにします。他のビジュアルにフィルターアクションを適用した場合の効果は、*カスケードフィルターと*呼ばれます。
デフォルトは [**All visuals (すべてのビジュアル)**] です。
カスケードフィルターは、特定のフィルターアクションの [**Target visuals (ターゲットビジュアル)**] セクションで設定されたすべてのビジュアルを適用します。Amazon Quick Sight は、最初にビジュアルを評価し、設定を事前設定します。ただしユーザーが希望する場合、デフォルトを変更することが可能です。同じシートまたは分析の複数のビジュアルで複数のカスケードフィルターを設定できます。分析またはダッシュボードを使用している場合は、一度に複数のカスケードフィルターを使用できますが、これらのフィルターは 1 つずつアクティブにします。
フィルターアクションにはソースとターゲットが必要なため、少なくとも 1 つのターゲットビジュアルが必要です。現在のビジュアルのみをフィルタリングするには、左側の [**Filter (フィルター)**] を選択して、通常のフィルターを作成します。
+ **ナビゲーションアクション**設定には以下が含まれます。
+ ****ターゲットシート**** — ターゲットにするシートです。
+ ****パラメータ**** — ターゲットシートに送信するパラメータです。プラスアイコンを選択して、既存のパラメータを追加します。
+ **URL アクション**設定には以下が含まれます。
+ ****URL**** — 開く URL です。URL アクションは、別のアプリケーションへのディープリンクにすることができます。有効な URL スキームには、`https`、`http`、および `mailto` が含まれます。
+ ****\$1** (値)** – (オプション) ターゲット URL に送信するパラメータ。パラメータ名は `$` から始まります。送信側と受信側の両方のパラメータは、名前とデータ型が一致する必要があります。
+ ****展開**** - URL を開く場所です。[**New browser tab (新しいブラウザタブ)**]、[**Same browser tab (同じブラウザタブ)**]、または [**New browser window (新しいブラウザウィンドウ)**] を選択できます。
一部のタイプのアクションでは、ビジュアルまたはインサイトで使用できるパラメータまたはフィールドの値を含めることができます。これらを手動で入力するか、**\$1** を選択してリストから選択できます。カスタムアクションが機能するには、そのアクションが参照するすべてのフィールドとパラメータが親ウィジェットでアクティブに使用されている必要があります。
分析でカスタムアクションを作成、表示、または編集するには、次の手順に従います。
**カスタムアクションを作成、表示、または編集する**
1. 分析を開いた状態で、右上隅の **[メニューオプション]** ドロップダウンから **[アクション]** を選択します。
既存のアクション (存在する場合) は、アクティベーションタイプ別に表示されます。既存のアクションをオンまたはオフにするには、アクション名の右側にあるチェックボックスを使用します。
1. (オプション) 既存のアクションを編集または表示するには、アクションの名前の横にあるメニューアイコンを選択します。
アクションを編集するには、[**Edit (編集)**] を選択します。
アクションを削除するには、[**Delete (削除)**] を選択します。
1. 新しいアクションを作成するには、以下のいずれかを選択します。
+ Actions ****見出し近くの追加アイコン
+ [**Define a custom action (カスタムアクションを定義する)**] ボタン
1. [**Action name (アクション名)**]で、アクション名を定義します。アクション名を動的にするには、プラスアイコンを使用してパラメータ値またはフィールド値を追加します。
1. [**Activation (アクティベーション)**]で、アクションの実行方法を選択します。
1. [**Action type (アクションタイプ)**] で、使用するアクションを選択します。
1. [**Filter action (フィルターアクション)**] で、以下を実行します。
1. [**Filter scope (フィルター範囲)**] で、フィルターの範囲を選択します。
1. [**Target visuals (ターゲットビジュアル)**] で、フィルターがカスケードする距離を選択します
1. [**Navigation action (ナビゲーションアクション)**] で、以下を実行します。
1. [**Target sheet (ターゲットシート)**] で、ターゲットシートを選択します。
1. Parameters で****、**Parameters** 見出しの近くにあるプラスアイコンを選択し、パラメータを選択してから、パラメータ値を選択します。すべての値を選択したり、カスタム値を入力したり、特定のフィールドを選択したりできます。
1. [**URL action (URL アクション)**] で、以下を実行します。
1. [**URL**] で、ハイパーリンクを入力します。
1. **URL** 見出しの近くにあるプラスアイコンを選択します。次に、リストから変数を追加します。
1. [**Open in (展開)**] で、URL の展開の方法を選択します。
1. アクションの作業が完了したら、**アクション** パネルの下 (下までスクロールダウンします) で次のいずれかを選択します。
+ [**Save (保存)**] - 選択した内容を保存し、カスタムアクションを作成します。
+ [**Close (閉じる)**] — このカスタムアクションを閉じて変更を破棄します。
+ [**Delete (削除)**] - このアクションを削除します。
# カスタムアクションの修復
カスタムアクションが機能するには、そのアクションが参照しているすべてのフィールドとパラメータが、親ウィジェットでアクティブになっている必要があります。ソースウィジェットにフィールドがない場合、または分析でパラメータが欠落している場合、そのフィールドまたはパラメータのアクションは使用できなくなります。メニューアクションは、コンテキストメニューに含まれなくなりました。選択アクションは、対話の試みに応答しなくなりました。ただし、他のすべての方法では、ウィジェットは引き続き機能します。ユーザーにエラーは表示されません。破損したフィルターアクションと URL アクションを修正するには、欠落したフィールドを破損したビジュアルまたはインサイトに追加し直します。
以下の手順では、アクションを更新することなくフィールドまたはパラメータが削除されたために破損したアクションを修正する方法について説明します。この手順では、この問題を解決するための基本的なガイダンスを紹介しますが、分析の変更方法、および変更を施すべきかどうかについては、ご自分で判断してください。不明な場合は、変更する前に Amazon Quick 管理者にサポートを依頼することをお勧めします。例えば、分析の以前のバージョンを復元する方法があるかもしれません。分析に何が起きたのかがわからない場合、こちらの方が安全である可能性があります。
**破損したアクションからフィールドを削除する**
1. スタートページで、[**Analyses (分析)**] を選択します。次に、その分析を選択して修正します。
1. アクションが機能しなくなったビジュアルまたはインサイトを選択します。それがシート上でハイライト表示されていることを確認します。
1. 右上隅の [メニューオプション] ドロップダウンから **[アクション]** を選択します。
1. 修正するアクションを見つけ、**編集**を選択します。
1. アクションタイプが**フィルターアクション**で、[*the field used by this action was removed (このアクションで使用されたフィールドは削除されました)*] というエラーが表示された場合、[**Filter scope (フィルター範囲)**] の設定をチェックします。[**Selected fields (選択されたフィールド)**] に表示されるのは、ビジュアル内にあるフィールドのみです。削除された選択されたフィールドを無効にするには、次のいずれかを選択します。
+ [**Filter scope (フィルター範囲)**] の設定を [**All fields (すべてのフィールド)**] に変更します。これにより、ウィジェットはすべてのフィールドでフィルタリングできるようになります。
+ [**Selected fields (選択されたフィールド)**] の一覧を使用する場合は、フィールドの一覧を確認します。別のフィールドを含める必要がある場合は、先にビジュアルに追加しておく必要があります。
1. アクションタイプが**ナビゲーションアクション**の場合、エラーメッセージのガイダンスに従います。このメッセージには、エラーの原因となった変更のタイプが反映されています。
1. アクションタイプが**URL アクション**の場合、**URL** の設定で、二重山括弧で括られた変数 (`<`) をチェックします。プラスアイコンを選択して、使用可能な変数のリストを開きます。一覧にないフィールドまたはパラメータを削除します。一致する*URL パラメータ*とそのセパレータ (最初の URL パラメータは `?`、後続のパラメータは `&`) も忘れずに削除します。以下の例では、ビジュアルから `Product` という名前のフィールドを削除した場合、どの部分が削除されるかを (**太字**で) 示したものです。
```
https://www.example.com/examplefunction?q=<
```
```
https://www.example.com/examplefunction?q=<&uact=<<$CSN>
```
```
https://www.example.com/examplefunction?pass=yes&q=<+<&oq=<+<&uact=<<$CSN>
```
必ず、新しい URL をテストします。
1. (オプション) アクションを削除する場合は、最後までスクロールして **[Delete]** (削除) をクリックします。
1. 完了したら、アクションに対する変更を確認します。[**Action (アクション)**] ペインの一番下までスクロールし、[**保存**] を選択します。
関連付けられたダッシュボードにもエラーが存在する場合は、ダッシュボードを共有して公開し、修正を反映させます。
# Amazon Quick Sight のカスタムアクションのフィールドマッピングについて
自動フィールドマッピングは、同一のフィールドに基づいています。同じ名前とデータ型を持つフィールドは、データセット間で自動的にマッピングされます。それらのフィールドの名前およびデータ型は、完全に一致する必要があります。これは結合に似ていますが、名前とデータ型に基づいて一致するすべてのフィールドについて自動的に生成される点が異なります。フィールドが欠落している場合は、フィールドが欠落しているデータセットの計算フィールドを使用してフィールドを作成できます。フィールドの一部を相互にマッピングしたくない場合は、名前を変更するか、データセットから削除します。
すべてのターゲットフィールドが ([**Filter scope (フィルターの範囲)**] の) フィルターアクションで使用可能になっている場合は、必ずそれらがマップされていることを確認することが重要です。これにより、フィルタリングが自動的に適用されます。マップされていないターゲットフィールドがある場合、自動フィルタリングは機能しません。
マッピングは、カスタムアクションを作成または保存するときにのみ生成されます。このため、マッピングに影響を与える変更を行うたびに、アクションに戻って再度保存するようにしてください。アクションを作成するとき、その時点で存在するフィールドに基づいてマッピングが行われます。アクションを保存するとき、カスタムアクションの作成後に名前を変更したマッピング済みフィールドはすべてマッピングされたままになります。ただし、マップされたフィールドのデータ型を変更すると、マッピングは削除されます。
マッピングに一部のフィールドがない場合は、次のいずれかを実行して修正できます。
+ [**Filter scope (フィルターの範囲)**] からマッピングされていないフィールドを削除して、マッピングされたフィールドのみを対象とします。
+ 対象のビジュアルをターゲットビジュアルから削除します。
+ マッピングに欠落しているフィールドを提供する計算フィールドを作成し、カスタムアクションを再保存します。
+ データセットを編集し、フィールドの名前を変更するか、データ型を変更してから、カスタムアクションを再保存します。
+ データセットを編集し、フィールドの名前を変更するか、データ型を変更してから、カスタムアクションを再保存します。
**注記**
マッピング画面に表示される情報には、最後に保存した設定が表示されます。ビューをリフレッシュまたは更新するには、アクションを再度保存します。
データセットを追加または編集しても、データセットは自動的にマップおよび再マップされません。これにより、フィルタリングが正しく機能しなくなります。例えば、新しいデータセットを追加し、そのデータセットにビジュアルを作成するとします。新しいビジュアルは、それらを接続するためのフィールドマッピングがないため、フィルターアクションに応答しません。変更を行う場合は、カスタムアクションを再度保存してフィールドマッピングをやり直してください。
ソースビジュアルからパラメータ化されたフィールドまたはその他のターゲットフィールドを削除すると、そのフィールドを使用するアクションは中断されます。欠落しているフィールドのアクションは、データポイントを選択しても機能しないか、コンテキストメニューから非表示になります。
自動フィールドマッピング用のデータセットを準備する方法については、「[フィールドのマッピング](mapping-and-joining-fields.md#mapping-and-joining-fields-automatic)」を参照してください。