クエリ結果変数

クエリ結果変数を使用すると、テキスト要素にデータを直接挿入できます。たとえば、データポイントを説明するテキストをレポートに追加し、そのデータポイントをチップとしてテキストに含めることができます。クエリ結果チップは、新しいデータが利用可能になると値を更新します。

クエリ結果変数を作成する

クエリ結果変数を作成する手順は次のとおりです。

  1. レポートを編集します。
  2. レポートにテキストを追加するか、既存のテキスト要素を編集します。
  3. @ を入力して、変数挿入メニューを開きます。
  4. [変数を追加] をクリックして、[変数を作成] ダイアログを開きます。
  5. 変数に一意の名前を付けます。
  6. [データソース] セクションで、クエリの開始元となるデータソースを選択します。
  7. 表示するデータポイントを返すクエリを作成します。
    • [ディメンション] セクションで、ディメンションを追加または削除できます。
    • [指標] セクションで、選択した指標を変更または削除できます。選択できる指標は 1 つまでです。
    • [フィルタ] セクションで、フィルタを追加または削除できます。
    • [並べ替え] セクションで、テーブルの並べ替えを変更できます。
  8. [列] フィールドと [行] フィールドに、返すデータポイントを含む列と行を入力します。データテーブルのセルを直接クリックして選択することもできます。
  9. 必要に応じて、クエリ結果チップの [フォントの色] と [背景色] の設定を編集します。[プレビュー] セクションに、チップの表示方法が表示されます。チップに条件付き書式を適用することもできます。
  10. [保存] をクリックします。

データポータルは、クエリ結果チップをテキスト要素に挿入します。ユーザーがこのテキスト要素を表示するたびに、データ値が更新されます。

クエリ結果変数に条件付き書式を適用する

主要なインサイトを視覚化して解釈しやすくするために、指定したルールに基づいて条件付き書式を適用して、クエリ結果変数のデータをハイライト表示できます。

条件付き書式を適用するには、変数を作成または編集するときに [条件付き書式] をクリックします。次に、[色のタイプ] セクションで次のいずれかのオプションを選択します。

テキストの編集中に [テキストのプロパティ] パネルから条件付き書式を適用することはできません。

単一色の条件付き書式

クエリ結果変数に単一色の書式を適用する手順は次のとおりです。

  1. [書式ルール] セクションで、書式ルールを定義します。
    • 値を確認するフィールド を選択します。
    • 条件 を選択します（例: [次に大きい]、[次に小さい]、[次に等しい]）。
    • 入力値 を入力します。この値は別のフィールドにすることもできます。
    • 必要に応じて、書式ルールに OR 条件または AND 条件を追加できます。
  2. [色とスタイル] セクションで、書式ルールを満たした場合にデータポータルがクエリ結果変数に適用するフォントの色と背景色を設定します。

異なる色とスタイルの設定で複数の書式ルールを作成できます。

カラースケールの条件付き書式

クエリ結果変数にカラースケールを適用する手順は次のとおりです。

  1. [書式設定の基準] セクションで、カラースケールを適用する指標を選択します。
  2. [色とスタイル] セクションで、カラースケールを選択します。[カラースケールを反転させる] をクリックして、カラースケールを反転させることもできます。
  3. いくつかのポイント 値を選択して、カラースケールの開始と終了の色を定義します。ポイントを追加または削除して、カラースケールの中間点を定義できます。
    • 少なくとも 2 つのポイントを定義する必要がありますが、最大 5 つのポイントを定義できます。
  4. [保存] をクリックして、条件付き書式ルールを適用します。

条件付き書式ルールを編集、管理する

クエリ結果変数に適用されているすべての書式ルールを表示するには、[X 個のルールが適用されています] をクリックします。データポータルには、適用されているすべての書式ルールのリストが数値リストで表示されます。

書式ルールは編集、削除、並べ替えが可能です。

数値リストの値が大きい書式ルールは、リスト内の前の書式ルールよりも優先されます。たとえば、最初の書式ルールで値が 0 より大きい場合に青色の背景色を適用し、2 番目の書式ルールで値が 1 より大きい場合に赤色の背景色を適用し、値が 0 と 1 の両方より大きい場合、データポータルは赤色の背景色を適用します。

クエリ結果変数を編集、管理する

レポートページからクエリ結果変数を直接編集する手順は次のとおりです。

  1. レポートを編集します。
  2. 変数を含むテキスト フィールドを選択し、変数をクリックします。
  3. [変数を編集] アイコンをクリックします。
  4. クエリ結果変数のクエリまたは書式に変更を加えます。
  5. [保存] をクリックします。

すべての変数のリストからクエリ結果変数を編集する手順は次のとおりです。

  1. レポートを編集します。
  2. [リソース] メニューをクリックし、[変数を管理（パラメータ）] を選択します。
  3. 編集するクエリ結果変数の横にある [編集] をクリックします。
  4. 変数のクエリまたは書式に変更を加えます。
  5. [保存] をクリックします。

クエリ結果変数を複製する

クエリ結果変数を複製する手順は次のとおりです。

  1. レポートを編集します。
  2. [リソース] メニューをクリックし、[変数を管理（パラメータ）] を選択します。
  3. 複製するクエリ結果変数の横にある [複製] をクリックします。
  4. 変数のクエリまたは書式に変更を加えます。
  5. [保存] をクリックします。

クエリ結果変数を削除する

レポートページからクエリ結果変数を直接削除する手順は次のとおりです。

  1. レポートを編集します。
  2. クエリ結果チップをクリックするか、ポインタを合わせて、[削除] アイコンをクリックします。

すべての変数のリストからクエリ結果変数を削除する手順は次のとおりです。

  1. レポートを編集します。
  2. [リソース] メニューをクリックし、[変数を管理（パラメータ）] を選択します。
  3. 削除するクエリ結果変数の横にある [削除] をクリックします。
  4. 確認ダイアログで [変数を削除] をクリックします。