• 製品
  • 関連ドキュメント
  • リソース

「テキスト入力」コントロールをセットアップする

「テキスト入力」コントロールを使用すると、クエリの値を検索可能なリストにして表示できます。

「テキスト入力」コントロールのセットアップには、主に次の 2 つの手順が必要です。

  1. ダッシュボードに「テキスト入力」コントロールを作成します。

  2. 「テキスト入力」コントロールをチャートに接続します。

「テキスト入力」コントロールを作成する

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

  1. 「テキスト入力」コントロールを追加するダッシュボードを開きます。

  2. ダッシュボードのサイドバーから [Add control] > [Text input] を選択します。コントロールを設定するためのポップアップが表示されます。

  3. 必要に応じてコントロールの設定を編集します。「テキスト入力」設定の詳細に関しては、次のセクションをご覧ください。

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

  5. 追加 を選択します 。

  6. 新しく作成した「テキスト入力」コントロールをダッシュボードのどこかに配置します。


「テキスト入力」コントロールの設定

「テキスト入力」では次の設定を編集できます。

名前

コントロールの名前

複数の値

一度に複数の検索語を使用するフィルタリングを許可します。このオプションの選択を解除すると、「テキスト入力」コントロールで一度に入力できる検索語は 1 つだけになります。

それぞれの検索語は一重引用符で囲まれるため、1 つの入力フィールドに複数の検索語を入力しないでください。

データ タイプ

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

  • テキスト

  • 数値

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

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

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

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

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

デフォルト値

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


「テキスト入力」コントロールをチャートに接続する

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

「テキスト入力」コントロールを使用してフィルタリングするには、文字列の完全一致が求められることにご注意ください。ワイルドカードを使用して文字列を部分一致で検索する方法をご確認ください。

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

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

「テキスト入力」が自動的にチャートに接続するには、チャート内のクエリが次の条件を満たす必要があります。

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

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

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

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

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

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

  3. [データ ソース] と [] を選択します。「テキスト入力」コントロールが選択された列を絞り込みます。

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

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

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

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

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

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

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

    1. コントロールでフィルタリングする列を追加します。「テキスト入力」コントロールと同じデータ型でなければなりません。

    2. 適切なフィルター演算子を選択します。「テキスト入力」設定で [Multi-value] を選択した場合は、[is one of] を使用します。

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

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

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

「テキスト入力」コントロールを使用して、ビジュアル モード クエリで [Project Type] 列をフィルタリングします。
SQL モード クエリの場合

SQL クエリで「テキスト入力」コントロールを接続する構文は、コントロールの設定で [Multi-value] を選択したかどうかによって異なります。

単一選択の「テキスト入力」

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

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

これは、選択した「テキスト入力」の値とプロジェクト タイプが等しい場合の 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" = {TEXT_INPUT_NAME}

複数選択の「テキスト入力」

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

  • 選択した「テキスト入力」値を持つデータを含める場合: {TEXT_INPUT_NAME.IN('"table_name"."column_name"')}

  • 選択した「テキスト入力」値を持つデータを除外する場合: {TEXT_INPUT_NAME.NOT_IN('"table_name"."column_name"')}

TEXT_INPUT_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 {TEXT_INPUT_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 {TEXT_INPUT_NAME.IN('"Jira Project"."project_type"')}

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

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

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

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

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

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

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

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

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

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

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

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

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