すべてのプロダクト
Search
ドキュメントセンター

Quick BI:テキストクエリコントロール

最終更新日:Oct 31, 2025

レポートの閲覧者は、テキストコントロールでテキストフィールドの値を入力または選択することで、データを動的にフィルターおよびクエリできます。テキストクエリコントロールを使用すると、ダッシュボードの閲覧者は特定のテキスト条件に基づいてチャートデータをフィルターし、主要なコンテンツに集中できます。

テキストクエリコントロールの主な利点は次のとおりです。

  • 高い柔軟性: ドロップダウンリスト、テキスト入力ボックス、ツリードロップダウンなど、3 つの表示タイプをサポートしています。また、さまざまなビジネスシナリオやユーザーのプリファレンスに対応する豊富な構成オプションも提供します。

  • 高い精度: 含む、含まない、次で始まる、次で終わるなど、入力されたコンテンツに対して複数の照合条件をサポートしています。これにより、正確なデータ取得が可能になります。

Quick BI は、ドロップダウンリストテキスト入力ボックスツリードロップダウンの 3 種類のテキストコントロールをサポートしています。このトピックでは、各表示タイプのシナリオと構成手順について説明します。

前提条件

  • ダッシュボードを作成済みで、その上のチャートにテキストフィールドが含まれていること。

  • ダッシュボードに空のクエリコントロールを追加済みであること。詳細については、「クエリコントロールを作成する」をご参照ください。

クエリ条件の構成

  1. ダッシュボードの編集ページに移動します。詳細については、「ダッシュボードを作成する」をご参照ください。

  2. ダッシュボードリストで、対象のダッシュボードを見つけてクリックします。

    ダッシュボード上のチャートには、テキストクエリコントロールを構成するためのテキストフィールドが含まれている必要があります。このトピックでは、折れ線グラフを例として使用します。詳細については、「折れ線グラフ」をご参照ください。

    image.png

  3. 次の図に示すように、クエリコントロールを追加します。

    image.png

  4. クエリコントロールを構成します。image.png

    1. クエリ条件の名前を [レベルクエリ] に設定します。

    2. [折れ線グラフ] と外部キーフィールドの オーダーレベル を選択します。

    3. 表示タイプを設定し、クエリ条件の構成を完了します。

      1. [表示タイプ][ドロップダウンリスト] に設定した場合は、「ドロップダウンリスト」の例をご参照ください。

      2. [表示タイプ][テキスト入力ボックス] に設定した場合は、「テキスト入力ボックス」の例をご参照ください。

      3. [表示タイプ][ツリードロップダウン] に設定した場合は、「ツリードロップダウン」の例をご参照ください。

  5. [OK] をクリックします。

ドロップダウンリスト

ドロップダウンリスト表示タイプを使用すると、レポート作成者は事前定義されたオプションのセットを定義し、閲覧者が選択できるようにリスト形式で表示できます。表示タイプを [ドロップダウンリスト] に設定すると、オプション値のソースは [自動解析][単一データセット]、または [手動入力] になります。

image

自動解析

自動解析を選択すると、Quick BI は関連付けられたすべての外部キーフィールドの値を自動的に識別し、クエリコントロールのオプションの和集合として表示します。image

説明
  • [関連チャートとフィールド] セクションのチャートが同じデータセットを使用している場合、値はそこから自動的に解析されます。

  • [関連チャートとフィールド] セクションで選択されたチャートが複数のデータセットを使用している場合、システムはそれらすべてから値を自動的に解析し、その和集合をドロップダウンリストに表示します。

構成項目

説明

[クエリモード]

[単一選択][複数選択] をサポートしています。

image

  • [クエリモード][複数選択] を選択します。

  • [クエリ時間][クリックしてクエリ] を選択します。

  • デフォルトのフィルター値を設定: オーダーレベルを [アドバンスト]、省を [広東省]、製品タイプを [家具製品] に設定します。

[クエリ時間]

[クリックしてクエリ][事前クエリ] をサポートしています。

  • [クリックしてクエリ]: デフォルト値です。クエリボタンをクリックすると、条件付きクエリがトリガーされます。

  • [事前クエリ]: ダッシュボードが開く前にドロップダウンリストの値を事前クエリします。これにより、各アカウントに構成された行レベルの権限に基づいてドロップダウンリストの値が表示されます。各人のデフォルト値も、行レベルの権限に基づいて異なります。

    [事前クエリ] は、ターゲットデータセットに行レベルの権限が構成されており、データ量が少ないシナリオに適しています。そうでない場合、レポート全体の読み込み時間に影響します。

[デフォルトのフィルター値の設定]

このオプションを選択します。クエリ条件ボックスに [選択してください] と表示されます。クエリ条件ボックスをクリックして、[フィールド] ダイアログボックスでデフォルト値を構成します。image

このダイアログボックスでは、次の操作を実行できます。

  • 検索ボックスにキーワードを入力し、下のキーワードをクリックして、左側から対象のフィールド値を右側の [追加済み] リストに追加します。

  • [左側のすべてのフィールド値を追加] をクリックして、左側のすべてのフィールド値を右側の [追加済み] リストに追加します。

  • 左側のフィールド値を選択して、右側の [追加済み] リストに追加します。

  • [除外] をクリックして、右側の [追加済み] リストに追加されたフィールド値を除外します。

    説明
    • デフォルト値を構成する際に除外するフィールド値を選択し、その後ドロップダウンリストのスタイルをタイルに切り替えると、クエリコントロールでそのフィールド値を選択することは、そのフィールドを除外することを意味します。

    • 最初にタイルスタイルを構成し、その後デフォルト値を構成する際に除外するフィールド値を選択すると、通常のタイルスタイルはタイル除外スタイルに置き換えられます。

  • [削除] をクリックして、右側の [追加済み] リストに追加されたフィールド値をクリアします。

説明

フィルターアイテムの数が 1,000 を超える場合、デフォルトで最初の 1,000 のオプション値が表示されます。表示されていない値は直接検索できます。

この例では、

  • [関連チャートとフィールド] セクションで、複数のデータセットから異なるフィールドが選択されています。クエリコントロールのドロップダウンリストには、すべての外部キーフィールド値の和集合が表示されます。

  • [クエリモード][複数選択] に設定されており、クエリコントロールで複数のオプションを選択できることを意味します。

  • [クエリ時間][クリックしてクエリ] に設定されており、レポートの閲覧者が条件付きクエリをトリガーするにはクエリボタンをクリックする必要があることを意味します。

  • [デフォルトのフィルター値を設定][アドバンスト][広東省][家具製品] に設定されています。レポートの閲覧者がレポートを開くと、デフォルトでアドバンストオーダーレベル、広東省、および家具製品タイプのクエリ結果が表示されます。

次の図に結果を示します。112

単一データセット

オプション値のソースが単一データセットの場合、クエリコントロールのオプションは、そのデータセット内の特定のフィールドの値に依存します。

image

構成項目

説明

[データセットの選択]

現在のダッシュボードがあるワークスペース内の任意のデータセットを選択できます。チャートのデータソースであるデータセットを選択することをお勧めします。image

image

  • データセットの選択: この例では、データソースとして使用されるデータセット company_sales_record を選択します。

  • [クエリ値フィールド]:注文レベル。

  • [表示名フィールド]:注文レベル。

  • [並べ替えフィールド]:注文日。

  • [クエリモード][複数選択] を選択します。

  • [クエリ時間][クリックしてクエリ] を選択します。

  • [デフォルトのフィルター値の設定]:このオプションを選択し、デフォルト値を上級に設定します。

[クエリ値フィールド]

選択したデータセット内で、外部キーフィールドと一致する必要があるフィールドです。このフィールドは実際のクエリに使用されます。レポートの閲覧者は、このフィールドの値から 1 つ以上のオプションを選択してデータをクエリできます。

[表示名フィールド]

クエリコントロールにオプションとして値が表示されるフィールドです。このフィールドは通常、クエリコントロールのユーザーエクスペリエンスを向上させ、レポートの閲覧者がオプション値の意味をよりよく理解できるようにするために使用されます。

  • クエリ値フィールドと同じ: クエリ値フィールドの値が明確で理解しやすい場合、表示名フィールドをクエリフィールドと同じに設定できます。この場合、クエリ値フィールドを選択すると、システムが自動的に表示名フィールドを入力します。

  • クエリ値フィールドと異なる: クエリ値フィールドの値が数値コードや理解しにくいコードである場合、データテーブル内で理解しやすい表示名フィールドを設定し、クエリコントロールの表示オプション値として使用できます。実際のクエリは引き続きクエリ値フィールドに基づきます。この場合、クエリ値フィールドを選択した後、手動で表示名フィールドを修正する必要があります。

[並べ替えフィールド]

選択したフィールドによるソートをサポートします。このパラメーターはオプションです。このパラメーターを指定しない場合、データはデータセットのデフォルトの順序でソートされます。

特定のフィールドでソートするには、ドロップダウンリストでソートフィールドを選択できます。たとえば、メジャーや日付でソートできます。サポートされているソート方法は、[昇順][降順][カスタムソート] です。カスタムソートを選択すると、[カスタムソート] ダイアログボックスでフィールド値をドラッグして順序を変更できます。111

設定が有効になると、クエリコントロールのドロップダウンリストのソートに影響しますが、チャートのディメンション値のソートには影響しません。チャートのディメンション値のソートは、引き続き各チャートのデータセットまたはデータパネルによって管理されます。

[クエリモード]

[単一選択][複数選択] をサポートしています。

[クエリ時間]

[クリックしてクエリ][事前クエリ] をサポートしています。

  • [クリックしてクエリ]: デフォルト値です。クエリボタンをクリックすると、条件付きクエリがトリガーされます。

  • [事前クエリ]: ダッシュボードが開く前にドロップダウンリストの値を事前クエリします。これにより、各アカウントに構成された行レベルの権限に基づいてドロップダウンリストの値が表示されます。各人のデフォルト値も、行レベルの権限に基づいて異なります。

    説明

    [事前クエリ] は、ターゲットデータセットに行レベルの権限が構成されており、データ量が少ないシナリオに適しています。そうでない場合、レポート全体の読み込み時間に影響します。

[デフォルトのフィルター値の設定]

このオプションを選択します。プリセット値がクエリ条件に表示されます。

説明

フィルターアイテムの数が 1,000 を超える場合、デフォルトで最初の 1,000 のオプション値が表示されます。表示されていない値は直接検索できます。

  • [クエリ時間] が [クリックしてクエリ] に設定されている場合、デフォルトのフィルター値を設定できます。

    image

  • [クエリ時間] が [事前クエリ] に設定されている場合、[手動設定][動的関数] を使用できます。事前クエリは、各訪問者の行レベルの権限に基づいて異なるフィルターオプションを表示するなど、事前にデータを取得する必要があるシナリオに適しています。

    image

    動的関数は、[最大クエリ フィールド値][最小クエリ フィールド値][最初のクエリ フィールド値] の設定をサポートしています。

    説明
    • [ソートフィールド] を設定した場合、[最初のクエリ値フィールド] はそのフィールドでソートされ、ソート結果の最初の値が使用されます。image.png

    • ソートフィールドを設定しない場合、[最初のクエリ値フィールド] はそのクエリ値フィールドの最初の値をデータセットから取得します。フィールドがデータセット内でソートされている場合 (たとえば、昇順、降順、またはカスタムソートを使用)、そのソート順に従った最初の値が使用されます。

この例では、

  • [データセット] は、現在のチャートのソースデータセットである company_sales_record に設定されています。

  • [クエリ値フィールド][オーダーレベル] に設定されており、これは外部キーフィールドと同じで、実際のクエリに使用されます。

  • [表示名フィールド][オーダーレベル] に設定されています。

  • [ソートフィールド][オーダー日] に設定されており、コントロール内のオプション値をソートします。

  • [クエリモード][複数選択] に設定されており、レポートの閲覧者がクエリコントロールで複数のオプション値を選択できることを意味します。

  • [クエリ時間][クリックしてクエリ] に設定されており、レポートの閲覧者が条件付きクエリをトリガーするにはクエリボタンをクリックする必要があることを意味します。

  • [デフォルトのフィルター値を設定] は [アドバンスト] に設定されています。レポートの閲覧者がレポートを開くと、デフォルトでアドバンストオーダーレベルのクエリ結果が表示されます。

次の図に結果を示します。

112

手動入力

オプション値のソースが手動入力の場合、レポート作成者はチャートで使用されるフィールド値に基づいてクエリコントロールのオプションをカスタマイズできます。

image

構成項目

説明

[手動入力]

[手動入力] をクリックします。[手動入力] ダイアログボックスで、[クエリ値][表示名] を入力します。image

  • クエリ値: チャートで選択されたフィールドの値。たとえば、この例で選択されたフィールドは [オーダーレベル] であり、対応する値は [アドバンスト]、[中間]、[低]、[その他] です。

  • 表示名: クエリ値に対応するドロップダウンリストに表示されるテキスト。

説明
  • 初めて手動入力を行い、クエリ値が表示名と同じ場合は、クエリ値を入力して [OK] をクリックします。システムが自動的に表示名を入力します。

  • 初めて手動入力を行い、クエリ値が表示名と異なる場合は、クエリ値と表示名を手動で入力する必要があります。クエリ値と表示名の行数が同じであることを確認し、1 対 1 で対応できるようにしてください。

  • その後の手動入力では、新しいクエリ値と表示名の両方を入力する必要があります。クエリ値のみを入力すると、プロンプトが表示されます。

    image.png

image

  • [手動入力]:この例では、フィールド値と対応する表示名は次のとおりです。上級 - A レベル、中級 - B レベル、低級 - C レベル、その他 - D レベル。

  • [クエリモード]:複数選択

  • デフォルトのフィルター値を設定: このオプションを選択し、デフォルト値を A レベル (つまり、アドバンスト) に設定します。

[クエリモード]

[単一選択][複数選択] をサポートしています。

[デフォルトのフィルター値の設定]

このオプションを選択します。プリセット値がクエリ条件に表示されます。

この例では、

  • [手動入力] では、[オーダーレベル] フィールド値が表示値にマッピングされます: [アドバンスト] は [A レベル]、[中間] は [B レベル]、[低] は [C レベル]、[その他] は [D レベル] です。

  • [クエリモード][複数選択] に設定されており、レポートの閲覧者が複数のオプションを選択できます。

  • [デフォルトのフィルター値を設定] は [アドバンスト] に設定されています。レポートの閲覧者がレポートを開くと、デフォルトでアドバンストオーダーレベルのクエリ結果が表示されます。

次の図に結果を示します。

112

検索

フィルタークエリを実行する際、特定の条件を検索して必要なデータをすばやく見つけることができます。

image

  • 目的のオプション値が見つからない場合は、[データベースから検索] を選択できます。

    image

  • フィルターアイテムが 1,000 を超える場合、デフォルトで最初の 1,000 件のみが表示されます。表示されていないアイテムは検索できます。それでも目的のオプション値が見つからない場合は、[データベースから検索] を選択します。image

説明

データベースからの検索は、[表示タイプ] が [ドロップダウンリスト] に設定され、オプション値のソースが [自動解析] または [単一データセット] の場合にのみサポートされます。

テキスト入力ボックス

テキスト入力ボックス表示タイプを使用すると、レポートの閲覧者はクエリボックスにキーワードを入力することで、必要なデータをすばやく取得できます。これにより、データクエリがより正確かつ柔軟になります。表示タイプを [テキスト入力ボックス] に設定すると、サポートされる条件は [単一条件][Or 条件]、および [And 条件] です。次の例では、[Or 条件] を使用します。

image

構成項目

説明

[条件付きフォーム]

[単一条件][Or 条件][And 条件] をサポートします。

  • 単一条件: 単一の条件を満たします。たとえば、製品タイプが「定規」である。

  • Or 条件: 2 つの条件のいずれかを満たします。たとえば、製品タイプが「定規」または「鉛筆」である。

  • And 条件: 両方の条件を同時に満たします。たとえば、注文金額が 100 より大きく、200 より小さい。

image

  • [条件付きフォーム][または条件] を選択します。

  • デフォルト値を設定: 含める文字を「定規」に設定するか、[次で始まる] の文字を [テーブル] に設定します。

  • [フィルター条件のロック]:このオプションを選択します。

[デフォルト値の設定]

値は、選択した条件付きフォームによって異なります。

たとえば、製品タイプ フィールドにデフォルト値を設定する場合、ルールと対応する SQL 構文は次のようになります。

  • 完全一致: product_sub_type='Ruler'

  • 不一致: product_sub_type!='Ruler'

  • 含む: product_sub_type like '%Ruler%'

  • 含まない: product_sub_type not like '%Ruler%'

  • 次で始まる: product_sub_type like 'Ruler%'

  • 次で終わる: product_sub_type like '%Ruler'

  • 空である: product_sub_type is null

  • 空でない: product_sub_type is not null

  • 空のテキスト: product_sub_type=''

  • 空でないテキスト: product_sub_type!=''

[フィルター条件のロック]

このオプションを有効にすると、プレビューページで条件付きのフォームを切り替えることができなくなります。image

説明

このオプションは、[デフォルト値の設定] が選択されている場合にのみ表示されます。

この例では、

  • [条件付きフォーム][Or 条件] に設定されている場合、クエリ条件のいずれかを満たすデータが表示されます。

  • [デフォルト値を設定] は、「定規」という文字を [含む]、または「テーブル」という文字で [始まる] ように構成されています。レポートの閲覧者がレポートを開くと、デフォルトで「定規」を含むか「テーブル」で始まる製品タイプのクエリ結果が表示されます。

  • [フィルター条件をロック] が選択されています。これにより、レポートの閲覧者はレポートページのクエリコントロールで条件付きフォームを切り替えることができなくなります。

次の図に結果を示します。

112

ツリードロップダウン

ツリードロップダウン表示タイプを使用すると、レポートの閲覧者は、組織構造、地理的エリア (国-都道府県-市)、または製品カテゴリ (メインカテゴリ-サブカテゴリ) などの親子関係を持つデータをフィルターできます。これにより、ユーザーは各レベルのアイテムを展開して選択することで、階層構造内のデータを特定し、フィルターできます。

image

説明

関連付けられたチャートが データセットユニオン を使用しており、複数の外部キーフィールドが選択されている場合、表示タイプをツリードロップダウンに設定することはできません。

構成項目

説明

[データセットの選択]

現在のダッシュボードがあるワークスペース内の任意のデータセットを選択できます。チャートのデータソースであるデータセットを選択することをお勧めします。image

image

  • [データセットの選択]:この例では、現在のチャートソース データセット company_sales_recordを選択します。

  • ツリー構造の設計: レベル 1 に地域フィールド、レベル 2 に省フィールドを構成します。

  • [表示形式][タイル表示] を選択します。

  • [クエリモード][複数選択] を選択します。

  • [クエリ時間][クリックしてクエリ] を選択します。

  • [デフォルト値の設定]:デフォルト値を [東北] > [遼寧省] に設定します。

  • クイック関連付け: このオプションを選択します。

[ツリー構造の設計]

[構成を開始] をクリックします。[ツリー構造の設計] ダイアログボックスで、クエリコントロールの各レベルの [クエリフィールド][表示フィールド] を構成します。image

  • [クエリ フィールド]:このフィールドは実際のクエリに使用されます。レポート閲覧者は、このフィールドの値から 1 つ以上のオプションを選択してデータをクエリできます。

  • [表示名フィールド]:クエリ フィールドが理解しにくいビジネス ID またはコードである場合、表示名フィールドを設定して、クエリ フィールドのオプションを理解しやすくすることができます。

説明
  • [クエリ値フィールド] を選択すると、システムが自動的に [表示名フィールド] を入力します。

  • [表示名フィールド] は、デフォルトで [クエリ値フィールド] と同じです。異なる場合は、手動で修正する必要があります。

  • ツリードロップダウンは、最大 4 つのクエリレベルをサポートします。

[表示形式]

[ツリー表示][タイル表示] をサポートします。

説明

データが 1,000 エントリを超える場合は、表示フォームとして [タイル表示] を選択することをお勧めします。

  • ツリー単一選択表示image

  • ツリー複数選択表示image

  • タイル単一選択表示image

  • タイル複数選択表示image

[クエリモード]

[単一選択][複数選択] をサポートします。

[クエリ時間]

[クリックしてクエリ][事前クエリ] をサポートしています。

  • [クリックしてクエリ]:クエリ ボタンをクリックした場合にのみ、条件付きクエリがトリガーされます。

  • 事前クエリ: ダッシュボードページが開くときにドロップダウンリストの値を事前クエリします。これにより、各アカウントに構成された行レベルの権限に基づいてドロップダウンリストの値が表示されます。各人のデフォルト値も、行レベルの権限に基づいて異なります。

    説明

    [事前クエリ] は、ターゲットデータセットに行レベルの権限が構成されており、データ量が少ないシナリオに適しています。そうでない場合、レポート全体の読み込み時間に影響します。

[デフォルト値の設定]

このオプションを選択し、関連する値を設定します。レポートページが読み込まれると、プリセット値がクエリコントロールに表示されます。

説明

ここでのデフォルト値は、ツリー構造の設計における表示名フィールドです。image

[クイック関連付け]

[クイック関連付け] を選択すると、ツリー構造のサブレベルフィールドが、同じデータセットのチャートの [関連チャートとフィールド] セクションに自動的に追加されます。これにより、クエリコントロール構成の効率と精度が向上します。

たとえば、次の図では、第 2 レベルの [省] の関連チャートとフィールドを構成すると、システムは自動的に省フィールドを、同じデータセットの [折れ線グラフ][縦棒グラフ] の外部キーフィールドに入力します。異なるデータセットの [円グラフ] の外部キーフィールドは、手動で入力する必要があります。

image

説明

メインレベルの [関連チャートとフィールド] セクションで選択されたチャートのみが、サブレベルフィールドの自動同期をサポートします。image

ツリー構造の [関連チャート] をクリックするか、左側のクエリアイテムのサブレベルの名前をクリックして、サブレベルを他のデータセットのチャートやフィールドに関連付けることができます。image

この例では、

  • [データセットの選択] は、現在のチャートのソースデータセットである company_sales_record に設定されています。

  • [ツリー構造の設計] では、レベル 1 に地域フィールド、レベル 2 に province フィールドが構成されています。クエリフィールドの値が明確で理解しやすいため、クエリフィールドと表示名フィールドは同じフィールドに設定されています。

  • [表示フォーム][タイル表示] に設定されています。

  • [クエリモード][複数選択] に設定されており、レポートの閲覧者がクエリコントロールで複数のオプション値を選択できることを意味します。

  • [クエリ時間][クリックしてクエリ] に設定されており、レポートの閲覧者が条件付きクエリをトリガーするにはクエリボタンをクリックする必要があることを意味します。

  • [デフォルト値を設定][東北] > [遼寧] に設定されています。レポートの閲覧者がレポートを開くと、デフォルトで東北地域と遼寧省のクエリ結果が表示されます。

  • [クイック関連付け] が選択されています。

次の図に結果の例を示します。

112