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

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

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

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

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

「ドロップダウン」コントロールを追加するダッシュボードを開きます。
ダッシュボードのサイドバーから [Add control] > [Dropdown] を選択します。ポップアップが表示されます。
オプションで、コントロールの [Name] を変更します。
コントロール内の複数の値を一度にフィルタリングする場合は、[複数選択] を選択します。
[データソース] と [列] を選択します。"ドロップダウン" コントロールは、選択した列の値をオプションのリストとして表示します。
オプションで、[Connect this control to new and existing charts (このコントロールを新しいチャートや既存のチャートに接続する)] を選択します。チャートへのコントロールの接続に関する詳細をご確認ください。
追加を選択します。
新しく作成した「ドロップダウン」コントロールをダッシュボードのどこかに配置します。

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

「ドロップダウン」コントロールを追加するダッシュボードを開きます。
ダッシュボードのサイドバーから [Add control] > [Dropdown] を選択します。ポップアップが表示されます。
[Switch to control editor (コントロールエディターに切り替える)] を選択します。コントロールエディターの詳細をご確認ください。
注意: ポップアップで行った変更は、コントロールエディターには引き継がれません。
カテゴリーに使用する列をクエリの [Columns] セクションに追加します。その列の値が「ドロップダウン」コントロールのオプションに入力されます。
[Run query (クエリを実行)] を選択します。プレビューペインが更新されて、コントロールを設定できます。
必要に応じてコントロールの設定を編集します。"ドロップダウン" 設定の詳細をご確認ください。
オプションで、コントロールの [Background color] を選択します。初期設定では、ダッシュボードテーマの色が使用されます。
ダッシュボードに保存 を選択します。
新しく作成した「ドロップダウン」コントロールをダッシュボードのどこかに配置します。

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

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

名前

コントロールの名前

データタイプ

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

テキスト
数値
ブーリアン
日付

複数選択

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

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

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

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

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

Initial values (既定値)

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

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

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

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

ビジュアルモードで構築されている
コントロールと同じデータソースを使用している

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

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

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

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

「ドロップダウン」コントロールを作成するか、既存のドロップダウンコントロールにカーソルを合わせて [その他のアクション ()] > [Edit control (コントロールを編集)] を選択して、編集します。
[Connect to new and existing charts (新しいチャートと既存のチャートに接続する)] を選択します。
自動的に適用されるクエリフィルターで使用する [フィルター演算子] を選択します。使用可能なフィルター演算子の詳細をご確認ください。
[追加] または [保存] を選択して、コントロールへの変更を適用します。

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

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

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

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

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

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

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

SQL モードクエリの場合

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

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

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

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"')}

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

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

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 課題の総数を取得する方法の例です。

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 つ目のオプションは次のとおりです。

コントロールにカーソルを合わせます。
[その他のアクション]() メニュー > [Highlight connections (接続をハイライト)] の順に選択します。

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

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

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

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

正確ではなかった

明確ではなかった

関係なかった

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

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

コミュニティに質問

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

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

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

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

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

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

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

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

SQL モード クエリの場合

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

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

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

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

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

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

SQL モードクエリの場合