• 関連ドキュメント

「ドロップダウン」コントロールをセットアップする

"ドロップダウン" コントロールを使用すると、クエリの値を検索可能なリストにして表示できます。

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

  1. "ドロップダウン" コントロールを作成します。

  2. 「ドロップダウン」コントロールをチャートに接続します。


「ドロップダウン」コントロールを作成する

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

  1. 「ドロップダウン」コントロールを追加するダッシュボードを開きます。

  2. ダッシュボードのサイドバーから [Add control] > [Dropdown] を選択します。ポップアップが表示されます。

  3. オプションで、コントロールの [Name] を変更します。

  4. コントロール内の複数の値を一度にフィルタリングする場合は、[複数選択] を選択します。

  5. [データ ソース] と [] を選択します。"ドロップダウン" コントロールは、選択した列の値をオプションのリストとして表示します。

  6. オプションで、[Connect this control to new and existing charts (このコントロールを新しいチャートや既存のチャートに接続する)] を選択します。チャートへのコントロールの接続に関する詳細をご確認ください。

  7. 追加 を選択します 。

  8. 新しく作成した「ドロップダウン」コントロールをダッシュボードのどこかに配置します。

コントロール エディターで "ドロップダウン" コントロールを作成する

コントロール エディターを使用すると、「ドロップダウン」コントロールをより柔軟に定義できます。Visual SQL でクエリを作成したり、「ドロップダウン」のオプションに他の変換を適用したりできます。

  1. 「ドロップダウン」コントロールを追加するダッシュボードを開きます。

  2. ダッシュボードのサイドバーから [Add control] > [Dropdown] を選択します。ポップアップが表示されます。

  3. [Switch to control editor (コントロール エディターに切り替える)] を選択します。コントロール エディターの詳細をご確認ください。
    注意: ポップアップで行った変更は、コントロール エディターには引き継がれません。

  4. カテゴリーに使用する列をクエリの [Columns] セクションに追加します。その列の値が「ドロップダウン」コントロールのオプションに入力されます。

  5. [Run query (クエリを実行)] を選択します。プレビュー ペインが更新されて、コントロールを設定できます。

  6. 必要に応じてコントロールの設定を編集します。"ドロップダウン" 設定の詳細をご確認ください。

  7. オプションで、コントロールの [Background color] を選択します。初期設定では、ダッシュボード テーマの色が使用されます。

  8. ダッシュボードに保存 を選択します。

  9. 新しく作成した「ドロップダウン」コントロールをダッシュボードのどこかに配置します。

「ドロップダウン」コントロールには、最大で 1,000 個のみの値が表示されますが、引き続きリストに表示されていない値も検索できます。


「ドロップダウン」コントロールの設定

「ドロップダウン」コントロールでは次の設定を編集できます。

名前

コントロールの名前

データ タイプ

「ドロップダウン」の結果のデータ型は次のとおりです。

  • テキスト

  • 数値

  • ブーリアン

  • 日付

複数選択

一度に複数の値を使用するフィルタリングを許可します。このオプションの選択を解除すると、「ドロップダウン」コントロールで一度に選択できる値は 1 つだけになります。

値が選択されていない場合

[複数選択] が選択されている場合にのみ利用できます。

「ドロップダウン」コントロールで値が選択されていない場合の動作を指定します。次の 2 つのオプションがあります。

  • Show unfiltered chart data (フィルターされていないチャート データを表示): 接続されたチャートをフィルターしません

  • Show no chart data (チャート データを表示しない): 接続されたチャートのデータを表示しません

Initial values (既定値)

ダッシュボードを開くときに選択する既定値を設定します。


"ドロップダウン" コントロールをチャートに接続する

"ドロップダウン" コントロールの作成後、フィルターに使い始める前に、そのコントロールをチャートに接続する必要があります。コントロールがどのように作成されたかに基づき、ダッシュボードにあるすべての新しいチャートや既存のチャートに対する自動での接続、またはチャートに対する手動での接続のいずれかの方法を利用できます。

新しいチャートや既存のチャートに自動で接続する

"ドロップダウン" がチャートに自動で接続するには、チャート内のクエリが次の条件を満たす必要があります。

  • ビジュアル モードで構築されている

  • コントロールと同じデータ ソースを使用している

コントロール エディターで作成された "ドロップダウン" コントロールは、すべてのチャートに自動で接続できません。

チャートのクエリがこれらの基準を満たしている場合は、ビジュアル モードのクエリにクエリ フィルターが自動で適用されます。

ビジュアル モード クエリで「ドロップダウン」コントロールに自動的に適用されたクエリ フィルター

コントロールをすべてのチャートに自動で接続するには、次の手順に従います。

  1. 「ドロップダウン」コントロールを作成するか、既存のドロップダウン コントロールにカーソルを合わせて [その他のアクション ()] > [Edit control (コントロールを編集)] を選択して、編集します。

  2. [Connect to new and existing charts (新しいチャートと既存のチャートに接続する)] を選択します。

  3. 自動的に適用されるクエリ フィルターで使用する [フィルター演算子] を選択します。使用可能なフィルター演算子の詳細をご確認ください。

  4. [追加] または [保存] を選択して、コントロールへの変更を適用します。

チャートに手動で接続する

コントロールをすべてのチャートに自動で接続できない場合、または接続しないことを選択した場合は、コントロールに対応するダッシュボード変数をクエリで使用することで、コントロールを個々のチャートに手動で接続できます。

他の Visual SQL ステップでコントロールを接続することもできます。クエリ以外でコントロールを接続する方法の詳細をご確認ください。

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

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

  1. 新しいチャートを作成するか、ダッシュボードの既存チャートを編集して、チャート エディターを開きます。

  2. ビジュアル モード クエリの [Filters] セクションで以下を実行します。

    1. コントロールでフィルタリングする列を追加します。「ドロップダウン」コントロールと同じデータ型でなければなりません。

    2. 適切なフィルター演算子を選択します。"ドロップダウン" 設定で [複数選択] を選択した場合は、[次のうちの 1 つ] を使用します。

    3. コントロールのダッシュボード変数を選択します。

  3. [Run query] を選択します。結果テーブルは、データに新しいフィルターが適用された状態で更新されます。

  4. チャートを保存するには、[Save to dashboard] を選択します。

ビジュアル モード クエリで「ドロップダウン」コントロールを使用して、特定のプロジェクト タイプの課題数をフィルタリングします。

SQL モード クエリの場合

SQL モード クエリで "ドロップダウン" コントロールを接続する構文は、コントロールの設定で [複数選択] を選択したかどうかに応じて異なります。

単一選択の「ドロップダウン」

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

これは、選択した「ドロップダウン」の値とプロジェクト タイプが等しい場合の Jira 課題の総数を取得する方法の例です。

1 2 3 4 5 SELECT COUNT(DISTINCT `Jira Issue`.`issue_id`) AS `Count of distinct Issue Id` FROM `jira _issue` AS `Jira Issue` INNER JOIN `jira_project` AS `Jira Project` ON `Jira Project`.`project_id` = `Jira Issue`.`project_id` WHERE `Jira Project`.`project_type` = {DROPDOWN_NAME}

複数選択の "ドロップダウン"

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

  • 選択した「ドロップダウン」値を持つデータを含める場合: {DROPDOWN_NAME.IN('"table_name"."column_name"')}

  • 選択した「ドロップダウン」の値を持つデータを除外する場合: {DROPDOWN_NAME.NOT_IN('"table_name"."column_name"')}

Replace DROPDOWN_NAME with the name of your control, and make sure to wrap the table-column reference in single quotes. If you’re querying the Atlassian Data Lake, also change the double quotes (") to backticks (`).

これは、「ドロップダウン」コントロールで選択されたすべてのプロジェクト タイプの Jira 課題の総数を取得する方法の例です。

1 2 3 4 5 SELECT COUNT(DISTINCT `Jira Issue`.`issue_id`) AS `Count of distinct Issue Id` FROM `jira_issue` AS `Jira Issue` INNER JOIN `jira_project` AS `Jira Project` ON `Jira Project`.`project_id` = `Jira Issue`.`project_id` WHERE {DROPDOWN_NAME.IN('`Jira Project`.`project_type`')}

これは反対に、「ドロップダウン」コントロールで選択されていないすべてのプロジェクト タイプの Jira 課題の総数を取得する方法の例です。

1 2 3 4 5 SELECT COUNT(DISTINCT `Jira Issue`.`issue_id`) AS `Count of distinct Issue Id` FROM `jira_issue` AS `Jira Issue` INNER JOIN `jira_project` AS `Jira Project` ON `Jira Project`.`project_id` = `Jira Issue`.`project_id` WHERE {DROPDOWN_NAME.NOT_IN('`Jira Project`.`project_type`')}

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

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

他にも、コントロールに接続されているすべてのチャートを確認する方法が 2 つあります。

1 つ目のオプションは次のとおりです。

  1. コントロールにカーソルを合わせます。

  2. [その他のアクション]() メニュー > [Highlight connections (接続をハイライト)] の順に選択します。

2 つ目のオプションは次のとおりです。

  1. ダッシュボードのサイドバーで [設定] を選択します。

  2. [Controls (コントロール)] タブに移動します。

  3. [Highlight connections (接続をハイライト)] を選択します。

どちらの方法でも、その特定のコントロールに接続されているダッシュボード上のすべての要素が強調表示されます。

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

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