「隠し変数」コントロールをセットアップする

Analytics is now Insights

All of the Analytics capabilities of the app remain unchanged. You can continue using your existing dashboards, charts, and smart links alongside the new Rovo-powered features. These features combine work and data context to provide reliable answers, create a shared understanding of data, and build dashboards that your team can depend on.

Read about this change

「隠し変数」コントロールを使用すると、ダッシュボードで直接アクセスできないフィルター値を設定できます。

「隠し変数」コントロールのセットアップには、主に次の 2 つの手順が必要です。

ダッシュボードに「隠し変数」コントロールを作成します。
「隠し変数」コントロールをチャートに接続します。

「隠し変数」コントロールを作成する

「隠し変数」コントロールをダッシュボードに追加する方法は次のとおりです。

「隠し変数」コントロールを追加するダッシュボードを開きます。
ダッシュボードのサイドバーから [Add control] > [Hidden variable] を選択します。コントロールを設定するためのポップアップが表示されます。
必要に応じてコントロールの設定を編集します。「隠し変数」設定の詳細に関しては、次のセクションをご覧ください。
追加を選択します。

「隠し変数」コントロールの設定

「隠し変数」では次の設定を編集できます。

名前

コントロールの名前

データタイプ

コントロールのデータ型は次のとおりです。

日付範囲
日付
テキスト
数値

Default start and end dates (既定の開始日と終了日)

[データタイプ] が [日付範囲] の場合にのみ使用可能

固定の日付を使用するか、動的なフィルタリングの場合は相対日付変数と日付と時刻の関数を組み合わせて使用します。

複数の値

[データタイプ] が [数値] または [テキスト] の場合のみ使用可能

コントロールが数値または文字列のリストかどうかを指定します。このオプションを選択すると、複数の既定値を追加できます。

デフォルト値

ダッシュボードを開くときに選択する既定値を設定します。リストされた値をカンマ区切りのリストに変換します。テキストリストの値は引用符で囲まれていますが、数値リストの値は引用符で囲まれません。

「隠し変数」コントロールをチャートに接続する

「隠し変数」コントロールを作成したら、フィルターに使い始める前に、そのコントロールをチャートに接続する必要があります。クエリで対応するダッシュボード変数を使用することで、チャートに接続します。

ビジュアルモードクエリの場合

ビジュアルモードクエリを使用して「隠し変数」コントロールをチャートに接続する方法は次のとおりです。

新しいチャートを作成するか、ダッシュボードの既存チャートを編集して、チャートエディターを開きます。
ビジュアルモードクエリの [Filters] セクションで以下を実行します。
1. コントロールでフィルタリングする列を追加します。「隠し変数」コントロールと同じデータ型でなければなりません。
2. 適切なフィルター演算子を選択します。
3. コントロールのダッシュボード変数を指定します。
[Run query (クエリを実行)] を選択します。結果テーブルは、データに新しいフィルターが適用された状態で更新されます。
チャートを保存するには、[Save to dashboard] を選択します。

「隠し変数」コントロールを使用して、ビジュアルモードクエリで特定の作業項目キーをフィルターします。

SQL モードクエリの場合

SQL モードクエリで「隠し変数」コントロールを接続する構文は、コントロールの設定で選択したデータ型によって異なります。

日付または日付範囲
単一値
複数選択

日付または日付範囲の「隠し変数」

「カレンダー」コントロールや「日付スライダー」コントロールと同じように、次の構文を使用してコントロールの開始日と終了日のプロパティを参照できます。

コントロールの [データタイプ] が [日付] の場合は、{HIDDEN_VARIABLE_NAME} を使用します。
コントロールの [データタイプ] が [日付範囲] の場合、開始日に {HIDDEN_VARIABLE_NAME.START}、終了日に {HIDDEN_VARIABLE_NAME.END} を使用します。
HIDDEN_VARIABLE_NAME をコントロールの名前に置き換えます。

これは「隠し変数」コントロールの選択した日付の間に作成された Jira 作業項目の総数を取得する方法の例です。

SELECT COUNT(DISTINCT `Work item`.`issue_id`) AS `Count of unique Work item ID`
FROM `jira_issue` AS `Work item`
WHERE `Work item`.`created_at` BETWEEN {HIDDEN_VARIABLE_NAME.START} AND {HIDDEN_VARIABLE_NAME.END};

単一値の「隠し変数」

[Multi-value] が選択解除されている場合、構文はシンプルで、{HIDDEN_VARIABLE_NAME} になります。HIDDEN_VARIABLE_NAME を自分のコントロールの名前に置き換えます。

データ型がテキストの「隠し変数」コントロールの場合は、値をクエリに渡すときに値を一重引用符で囲みます。一重引用符を削除するには、コントロール名の後に .RAW を追加して {HIDDEN_VARIABLE_NAME.RAW} とします。

これは、選択した「隠し変数」値とプロジェクトタイプが等しい Jira 作業項目の総数を取得する方法の例です。

SELECT COUNT(DISTINCT `Work item`.`issue_id`) AS `Count of unique Work item ID`
FROM `jira_issue` AS `Work item`
INNER JOIN `jira_project` AS `Project` 
  ON `Work item`.`project_id` = `Project`.`project_id`
WHERE `Jira Project`.`project_type` = {HIDDEN_VARIABLE_NAME}

複数選択の「隠し変数」

[Multi-value] を選択した場合は、次の構文を使用します。

選択した「隠し変数」の値を持つデータを含める場合: {HIDDEN_VARIABLE_NAME.IN('"table_name"."column_name"')}
選択した「隠し変数」の値を持つデータを除外する場合: {HIDDEN_VARIABLE_NAME.NOT_IN('"table_name"."column_name"')}

HIDDEN_VARIABLE_NAME を自分のコントロールの名前に置き換え、テーブル列の参照は一重引用符で囲む必要があります。Atlassian Data Lake にクエリを実行する場合は、さらに、二重引用符 (") をバッククォート (`) に変更してください。

これは、「隠し変数」コントロールで選択されたすべてのプロジェクトタイプの Jira 作業項目の総数を取得する方法の例です。

SELECT COUNT(DISTINCT `Work item`.`issue_id`) AS `Count of unique Work item ID`
FROM `jira_issue` AS `Work item`
INNER JOIN `jira_project` AS `Project` 
  ON `Work item`.`project_id` = `Project`.`project_id`
WHERE {HIDDEN_VARIABLE.IN('`Project`.`project_type`')}

これは反対に、「隠し変数」コントロールで選択されていないすべてのプロジェクトタイプの Jira 作業項目の総数を取得する方法の例です。

SELECT COUNT(DISTINCT `Work item`.`issue_id`) AS `Count of unique Work item ID`
FROM `jira_issue` AS `Work item`
INNER JOIN `jira_project` AS `Project` 
  ON `Work item`.`project_id` = `Project`.`project_id`
WHERE {HIDDEN_VARIABLE.NOT_IN('`Project`.`project_type`')}

チャートがコントロールに接続されていることを確認する

チャートがコントロールに正しく接続されていることを確認するには、コントロールの値を更新し、接続されているチャートがその値に応じてフィルタリングされるかどうかを見ることで、接続が適切かを確認できます。

または、次の手順に沿ってコントロールに接続されているすべてのチャートを確認できます。

ダッシュボードのサイドバーで [設定] を選択します。
[Controls (コントロール)] タブに移動します。
[Highlight connections (接続をハイライト)] を選択します。

これによって、その特定のコントロールに接続されているダッシュボード上のすべての要素が強調表示されます。

この内容はお役に立ちましたか?

正確ではなかった明確ではなかった関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問