変数とは

The Analytics app provides convenient variables that you can use to dynamically update values in your charts and dashboards. There are three types of variables:

• ダッシュボード変数

• 相対日付変数

• 現在ユーザー変数

変数を参照する際は、名前を波括弧 { } で囲んで表します。

変数は次の場所に使用できます。

• ビジュアル モードと SQL モード クエリ

• 列の名前

• その他の Visual SQL ステップ

• 組み込み数式とカスタム数式

• チャートのタイトル

• テキスト要素

ダッシュボード変数

コントロールをダッシュボードに追加するたびに、コントロールと同じ名前の対応するダッシュボード変数が作成されます。このダッシュボード変数は、チャートやダッシュボードで対応するコントロールを参照するために使用します。コントロールに関する詳細をご確認ください。

たとえば、ダッシュボードに「ドロップダウン」コントロールを追加し、そのコントロールに PROJECTS という名前を付けると、対応する変数 {PROJECTS} が作成されます。

ダッシュボード変数は 1 つのダッシュボードのみを対象とするため、ダッシュボードごとに新しい変数を作成する必要があります。

相対日付変数

相対日付変数は、それぞれが 1 つの日付文字列に変換される組み込み変数です。日付の値を入力する場所ならどこにでも使用できます。たとえば、次のような目的や場所で使用できます。

• 「カレンダー」と「日付スライダー」コントロールの既定日付を設定する

• Visual SQL ステップのカスタム数式で使用する

• SQL モード クエリで使用する

• ビジュアル モード クエリ フィルターで使用する

Relative date variables are global variables, so you can use them across Analytics. When they’re used to filter charts on a dashboard, they follow the time zone that the dashboard uses. When they’re used in queries that aren’t tied to a dashboard, they follow the time zone of the data source that you’re querying.

利用できる相対日付変数をすべてご確認ください。

相対日付変数の使用例

次の画像は、「フィルター」ステップで相対日付変数 {TODAY} を使用する例を示しています。データがフィルタリングされ、今日の日付より前の日付のみが結果として表示されます。{TODAY} 変数を使用すると、今日の日付として返される日付が自動的に変わるため、静的な日付値を使用して手動でチャートを変更する必要がありません。

現在ユーザー変数

現在ユーザー変数を使用すると、特定のビューアーに応じたダッシュボードを作成することができます。

構文 {CURRENT_USER} を使用して参照します。

この変数には、現在ダッシュボードを表示している人のユーザー ID が格納されます。この変数をクエリに使用することで、現在ダッシュボードを表示しているユーザーに合わせてダッシュボードやチャートのデータをフィルタリングすることができます。

相対日付変数と同じように、現在ユーザー変数もグローバル変数です。これを使用してクエリをフィルタリングしたり、テキスト要素内の変数を参照することで現在ユーザーの ID をダッシュボードに表示したりできます。

現在ユーザー変数の使用例

現在ユーザー変数をビジュアル モード クエリのフィルターで使用する方法は次のとおりです。

1. フィルターを適用する列を選択します。列にはユーザー ID が含まれている必要があります。

2. フィルター演算子に = を選択します。

3. 値として {CURRENT_USER} を入力します。

たとえば、現在のダッシュボード ビューアーがそれらの作業項目の担当者である Jira 作業項目のみを表示する場合は、クエリ フィルターに次の条件を追加できます。[作業項目] テーブルで [Assignee アカウント ID (担当者 ID)] を {CURRENT_USER} と等しい値に設定します。