ダッシュボード変数を使用してください

ダッシュボード変数は、閲覧者が視覚化に表示するフィールドを切り替えられるように、一連のフィールドをグループ化します。執筆者は、例えば棒グラフのX軸など、ビジュアライゼーションのエンコーディングに変数を追加し、それをコントロールウィジェットにバインドします。ユーザーがコントロールで別のフィールドを選択すると、変数を使用するすべてのビジュアライゼーションが、選択したフィールドを表示するように更新されます。

ダッシュボード変数により、閲覧者はダッシュボードを編集したり、クエリーが再生成されるのを待ったりすることなく、慣れたポイントアンドクリック操作を通じて自身の質問に回答できます。例えば、閲覧者は折れ線グラフを**売上高**と**取引**の間で切り替えることができ、書式設定はそれに応じて更新されます。

defaultでは、閲覧者は一度に1つのフィールドを選択します。また、閲覧者が一度に複数のフィールドを選択できるようにして、1つの変数でビジュアライゼーションに複数の時系列、列、または行を追加することもできます。複数のフィールドの選択を閲覧者に許可するを参照してください。

ダッシュボード変数とパラメーターのどちらかを選択します

ダッシュボード変数とパラメーターはどちらもダッシュボードをインタラクティブにしますが、異なるレイヤーで動作します。ダッシュボード変数は、ダッシュボードレイヤーでビジュアリゼーションに表示されるフィールドを変更します。パラメーターは、ランタイム時にデータセット クエリに値を代入します。パラメーターの詳細については、ダッシュボード パラメーターの操作を参照してください。

ダッシュボード変数は、IDENTIFIER句をパラメーターと組み合わせて使用し、フィールドをスワップする以前のアプローチに代わるものです。IDENTIFIERとは異なり、ダッシュボード変数はメトリクスビューと連携し、各フィールドにアタッチされたセマンティックフォーマットを保持します。

ダッシュボード変数を作成する

ドラフト ダッシュボードに対するCAN EDIT権限以上が必要です。フィルター（コントロール）ウィジェットから変数を作成します：

1. 下書きダッシュボードのキャンバスで、 フィルター（フィールド/パラメーター）を追加 をクリックし、フィルター ウィジェットをページに配置します。
2. ウィジェットの構成パネルで、変数を作成し、閲覧者が選択できるフィールドを追加します。
3. 各フィールドについて、変換を指定します。変換は、フィールドが集計またはバケット化される方法（たとえば、メジャーの場合はSUM、日付の場合はDAILY）を定義します。変換は変数の一部として定義されており、変数が使用される場所で上書きすることはできません。

変数の最初のフィールドはデフォルトの選択です。変数を作成するのに使用したフィルターウィジェットは、ビューアがフィールドを切り替えるためのコントロールになります。

ダッシュボード変数の各フィールドオプションには、そのソースデータセットがサブタイトルとして表示されるため、データセット間で名前を共有するフィールドを区別できます。オプションに異なるラベルを表示する方法については、フィールドオプションの表示名を設定するを参照してください。

ダッシュボード変数に対する操作は、元に戻すおよびやり直しをサポートしています。

フィールドタイプとスケールタイプ

変数にはデータ型が異なるフィールドを含めることができます。可視化が使用するスケールタイプは、変数のフィールドオプションによって異なります。

• すべてのフィールドオプションが数値の場合、デフォルトのスケールタイプは数量です。ビジュアライゼーションエディタで、エンコードのスケールタイプをカテゴリカルに変更できます。
• すべてのフィールドオプションが日付またはdatetimeフィールドである場合、デフォルトのスケールタイプは連続です。ビジュアライゼーションエディタで、エンコードのスケールタイプをカテゴリカルに変更できます。
• そうでない場合（たとえば、文字列フィールド、または文字列と日付の組み合わせの場合）、スケールタイプはカテゴリカルのみです。

変数のスケールタイプは固定されています。閲覧者が選択するフィールドに基づいて、動的に変更されません。

変数は、そのフィールドの集計レベルがビジュアライゼーションが受け入れる集計レベルと一致する場合にのみ、ビジュアライゼーションに追加することが可能です。例えば、ヒートマップのX軸およびY軸のエンコーディングは集計解除されたフィールドのみを受け入れます。そのため、集計解除された変数のみをエンコードできます。

フィールドオプションの表示名を設定する

ダッシュボード変数の各フィールドオプションには、フィールド名と変換を組み合わせた生成済みラベル（ 売上の合計 や 平均価格 など）があります。そのラベルを、ビューアーに表示される 総収益 などの表示名に置き換えることができます。表示名はラベルのみを変更します。オプションのフィールドと変換は変わりません。

フィールド オプションの表示名を設定するには:

1. ドラフトダッシュボードで、変数を制御するフィルターウィジェットを選択します。

2. ウィジェットの設定パネルの 変数 で、変数をクリックします。

3. [フィールドオプション] で、名前を変更するフィールドオプションをクリックします。

4. [表示名] ボックスに名前を入力します。ボックスには、生成されたラベルがプレースホルダーとして表示されます。

   

入力すると、表示名が保存されます。生成されたラベルに戻すには、 表示名 欄を空にしてください。

表示名は、ダッシュボードがオプションを表示する場所（下書きダッシュボードと公開ダッシュボードの両方）に表示されます。

• フィルター ウィジェットのオプションのリスト。
• アクティブなフィルターバーとウィジェットフィルターインジケーター。
• 変数を使用する視覚化の軸のタイトル、凡例、系列名、ツールチップ。

視覚化エディターでフィールドの表示名を設定した場合、その視覚化では、その名前がオプションの表示名よりも優先されます。

Genie Codeによるダッシュボードオーサリングを使用すると、変数のフィールドオプションの表示名を設定、名前変更、クリアすることもできます。Genie Codeが変数を編集すると、設定した表示名が保持されます。

表示名には、次の制限があります：

• 表示名は最大500文字まで設定できます。先頭と末尾のスペースは削除されます。
• ダッシュボードを .lvdash.json ファイルに エクスポート またはインポートする場合、フィールド オプションの表示名は含まれません。エクスポートまたはインポートされたダッシュボードのオプションでは、生成されたラベルが使用されます。

変数をビジュアライゼーションに追加

変数を作成したら、それをビジュアライゼーションのエンコード（軸や列など）に追加します。複数のビジュアリゼーションに同じ変数を追加できます。視聴者が変数の選択フィールドを変更すると、その変数を使用するすべてのエンコーディングは、新しいフィールドを表示するように更新されます。

閲覧者が複数のフィールドを選択できるようにする

複数選択を使用すると、ダッシュボードの閲覧者は変数の複数のフィールドを一度に表示できるため、1 つの変数によって、選択されたフィールドごとに個別の系列、列、または行が追加されます。たとえば、閲覧者は同じグラフ上に個別の系列として Sales と Profit の両方を表示できます。By default, 変数は単一のフィールドを代入します。

有効にするには、変数を作成または編集するときに [複数選択を許可] をオンにします。閲覧者は複数選択コントロールを使用して変数のフィールドの任意の組み合わせを選択できます。変数を使用するすべての視覚化では、選択されたフィールドごとに 1 つのエントリが追加されます。

複数選択は、次のような複数のフィールドを表示できるエンコーディングでのみ機能します。

• 複数系列の棒グラフまたは折れ線グラフの Y 軸
• テーブルの列
• ピボットテーブルの行、列、または値

1つのフィールドのみを表示できるエンコーディング（カウンター値やグラフのX軸など）に複数選択変数を追加すると、ビジュアライゼーションは最初涯に選択されたフィールドのみを使用し、警告を表示します。