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

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

最終更新日:Jun 17, 2026

テキストフィルターバーを使用すると、レポートの閲覧者はテキスト値を入力または選択してデータをフィルタリングできます。これにより、チャート内の主要な情報に焦点を絞ることができます。

テキストフィルターバーの主な利点は次のとおりです。

  • 高い柔軟性:ドロップダウンリスト、テキスト入力ボックス、ツリードロップダウンの 3 つの表示形式をサポートし、さまざまなシナリオに対応する柔軟な設定オプションを提供します。

  • 高い精度:「含む」、「含まない」、「次で始まる」、「次で終わる」など、複数の一致条件を提供し、正確なデータフィルタリングを実現します。

Quick BI は、ドロップダウンリストテキスト入力ボックスツリードロップダウンの 3 種類のテキストフィルターバーをサポートします。本トピックでは、それぞれのタイプの使用例と設定手順について説明します。

前提条件

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

  • ダッシュボードに空のフィルターバーが追加されていること。詳細については、「フィルターバーの作成」をご参照ください。

フィルター条件の設定

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

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

    テキストフィルターバーを設定するには、ダッシュボードのチャートにテキストフィールドが含まれている必要があります。本トピックでは、折れ線グラフを例として使用します。詳細については、「折れ線グラフ」をご参照ください。

    image.png

  3. 図の手順に従ってフィルターバーを追加します。

    image.png

  4. フィルターバーを設定します。image.png

    1. フィルター条件名を「[Level Query]」に設定します。

    2. 関連するチャート「[折れ線グラフ]」と関連フィールド「order_level」を選択します。

    3. 表示形式を設定し、フィルター条件の設定を完了します。

      1. [表示形式]として [ドロップダウンリスト] を選択した場合は、「ドロップダウンリスト」の例をご参照ください。

      2. [表示形式]として [テキスト入力ボックス] を選択した場合は、「テキスト入力ボックス」の例をご参照ください。

      3. [表示形式]として [ツリードロップダウン] を選択した場合は、「ツリードロップダウン」の例をご参照ください。

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

ドロップダウンリスト

ドロップダウンリスト表示タイプでは、レポート閲覧者が選択できるように、事前定義されたオプションのリストが表示されます。表示タイプが [ドロップダウンリスト] の場合、オプション値ソースでは [自動解析][単一データセット]、および [手動入力] がサポートされています。

画像

自動解析

オプション値のソースとして自動解析を選択すると、Quick BI は関連するすべてのフィールドの値を自動的に識別し、それらの値の和集合をフィルターバーに設定します。image

説明
  • [Related Charts and Fields] セクションで選択したチャートが同じデータセットを使用している場合、自動解析はそのデータセットから値を取得します。

  • [Related Charts and Fields] セクションで選択したチャートが複数のデータセットを使用している場合、ドロップダウンリストのオプションは、関連するすべてのデータセットからの値の和集合になります。

パラメーター

説明

[選択モード]

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

image

  • 選択モード複数選択 を選択します。

  • クエリ時間クリック時のクエリ を選択します。

  • デフォルト値を設定:注文レベルを Advanced、省を 広東省、製品タイプを 家具 に設定します。

[クエリ時間]

[クリック時のクエリ]と [事前クエリ] をサポートします。

  • [クリック時のクエリ]:デフォルト値です。ユーザーがクエリボタンをクリックしたときにのみクエリが実行されます。

  • [事前クエリ]:ドロップダウンリストの値は、ダッシュボードが読み込まれる前に取得されます。これにより、各ユーザーの行レベルの権限に基づいてオプションを表示し、ユーザー固有のデフォルト値を有効にすることができます。

    [事前クエリ] オプションは、行レベルの権限があり、データ量が少ないデータセットに最適です。それ以外の場合、レポートの読み込み時間が長くなる可能性があります。

フィルターオプションのNULL値を表示

image

[フィルターオプションのNULL値を表示] を選択すると、ドロップダウンリストの NULL 値はレポートの閲覧者に (Null) として表示されます。

image

このオプションが選択されていない場合、NULL 値はリストから除外されます。

image

説明

このパラメーターは、組織レベルの [Report Configurations][各フィルター条件でNULL値を表示するかどうかを設定] が選択されている場合にのみ使用できます。

image

[デフォルト値を設定]

このオプションを選択すると、フィルターボックスに [Please select] と表示されます。ボックスをクリックして [Field] ダイアログボックスを開き、デフォルト値を設定します。image

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

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

  • [Add all field values on the left] をクリックして、左側のすべてのフィールド値を右側の [Added] リストに追加します。

  • 左側のフィールド値の横にあるチェックボックスを選択して、右側の [Added] リストに追加します。

  • [Exclude] をクリックして、[Added] リストの値を「除外」します。

    説明
    • フィールド値をデフォルトとして除外した後、ドロップダウンリストのスタイルをタイルに切り替えると、フィルターバーでそのフィールド値を選択すると結果から除外されます。

    • タイルスタイルを最初に設定し、その後フィールド値をデフォルトとして除外すると、スタイルは通常のタイルからタイル除外スタイルに変わります。

  • [Clear] をクリックして、[Added] リストからすべてのフィールド値を削除します。

説明

フィルターオプションが 1,000 件を超える場合、デフォルトで最初の 1,000 件のみが表示されます。この上限を超えるオプションは検索できます。

この例の要約:

  • [Related Charts and Fields] セクションには、複数のデータセットのフィールドが含まれています。フィルターのドロップダウンリストには、関連するすべてのフィールド値の和集合が表示されます。

  • 選択モード複数選択 に設定されているため、ユーザーは一度に複数のオプションを選択できます。

  • クエリ時間クリック時のクエリ に設定されているため、レポートの閲覧者はフィルターを適用するためにクエリボタンをクリックする必要があります。

  • デフォルト値 は、Advanced広東省家具 に設定されています。レポートの閲覧者がレポートを開くと、デフォルトでこれらの選択に対する結果が表示されます。

結果は次の図のとおりです。112

単一データセット

オプション値のソースとして単一データセットを選択すると、フィルターバーのオプションはそのデータセット内の特定のフィールドから取得されます。

image

パラメーター

説明

[データセットの選択]

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

image

  • データセットの選択:この例では、データソースデータセット company_sales_record が選択されています。

  • クエリ値フィールドorder_level

  • 表示名フィールドorder_level

  • ソートフィールド注文日

  • 選択モード複数選択 を選択します。

  • クエリ時間クリック時のクエリ を選択します。

  • デフォルト値を設定:このオプションを選択し、デフォルト値を Advanced に設定します。

[クエリ値フィールド]

選択したデータセットのこのフィールドは、関連フィールドと照合されます。その値は実際のクエリに使用され、レポートの閲覧者はその値の中から1つ以上を選択してデータをフィルタリングできます。

[表示名フィールド]

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

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

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

[ソートフィールド]

選択したフィールドでソートできます。これはオプションのパラメーターです。空白のままにすると、オプションはデータセットの順序に従ってソートされます。

メジャーや日付などの特定のフィールドでソートする必要がある場合は、ドロップダウンリストから選択します。ソートオプションには、昇順降順カスタム があります。カスタムを選択した場合、[Custom Sort] ダイアログボックスでフィールド値をドラッグアンドドロップして順序を並べ替えることができます。111

この設定は、フィルターのドロップダウンリストのオプションの順序にのみ影響します。チャート内のディメンション値のソート順は変更されず、データセットまたは各チャートのデータパネルによって制御されます。

[選択モード]

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

[クエリ時間]

[クリック時のクエリ]と [事前クエリ] をサポートします。

  • [クリック時のクエリ]:デフォルト値です。ユーザーがクエリボタンをクリックしたときにのみクエリが実行されます。

  • [事前クエリ]:ドロップダウンリストの値は、ダッシュボードが読み込まれる前に取得されます。これにより、各ユーザーの行レベルの権限に基づいてオプションを表示し、ユーザー固有のデフォルト値を有効にすることができます。

    説明

    [事前クエリ] オプションは、行レベルの権限があり、データ量が少ないデータセットに最適です。それ以外の場合、レポートの読み込み時間が長くなる可能性があります。

フィルターオプションのNULL値を表示

image

image

このオプションが選択されていない場合、NULL 値はリストから除外されます。

image

説明

このパラメーターは、組織レベルの [Report Configurations][各フィルター条件でNULL値を表示するかどうかを設定] が選択されている場合にのみ使用できます。

image

[デフォルト値を設定]

このオプションを選択すると、フィルターに事前設定された値が表示されます。

説明

フィルターオプションが 1,000 件を超える場合、デフォルトで最初の 1,000 件のみが表示されます。この上限を超えるオプションは検索できます。

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

    image

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

    image

    動的関数を使用すると、デフォルト値を クエリフィールドの最大値クエリフィールドの最小値、または クエリフィールドの最初の項目 に設定できます。

    説明
    • ソートフィールド が設定されている場合、クエリフィールドの最初の項目 はそのソート順に従った最初の値になります。image.png

    • ソートフィールドが設定されていない場合、クエリフィールドの最初の項目データセット 内のそのフィールドの最初の値になります。フィールドにデータセットで定義されたソート順 (昇順、降順、またはカスタムなど) がある場合、最初の値はその順序によって決まります。

この例の要約:

  • データセット は、現在のチャートのソースである推奨データセット company_sales_record です。

  • クエリ値フィールド は関連フィールドと同じであるため、実際のクエリには order_level が使用されます。

  • 表示名フィールド はクエリ値フィールドと同じで、両方とも order_level です。

  • ソートフィールド は、フィルターオプションのソート順を決定するために 注文日 に設定されています。

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

  • クエリ時間クリック時のクエリ に設定されているため、レポートの閲覧者はフィルターを適用するためにクエリボタンをクリックする必要があります。

  • デフォルト値Advanced に設定されているため、レポートを開くとデフォルトで Advanced 注文レベルの結果が表示されます。

結果は次の図のとおりです。

112

手動入力

オプション値のソースとして手動入力を選択すると、レポート作成者がフィルターバーのオプションを明示的に定義します。

image

パラメーター

説明

[手動入力]

[Manual Input] をクリックし、[Manual Input] ダイアログボックスに [クエリ値] と [表示名] を入力します。image

  • クエリ値: グラフのフィールドの実際の値です。 この例では、選択されたフィールドは order_level で、値には「上級」、「中級」、「基本」、「その他」などがあります。

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

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

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

  • 2回目以降の手動入力では、クエリ値と表示名の両方を入力する必要があります。クエリ値のみを入力すると、エラーメッセージが表示されます。

    image.png

image

  • 手動入力:この例では、フィールド値とそれに対応する表示名は次のとおりです:Advanced - Grade AIntermediate - Grade BBasic - Grade COther - Grade D

  • 選択モード複数選択

  • デフォルト値を設定:このオプションを選択し、デフォルト値を Grade A (Advanced に対応) に設定します。

[選択モード]

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

[デフォルト値を設定]

このオプションを選択すると、フィルターに事前設定された値が表示されます。

この例の要約:

  • 手動入力 を使用して、注文レベルのフィールド値を表示値にマッピングします:AdvancedGrade AIntermediateGrade BBasicGrade COtherGrade D に。

  • 選択モード複数選択 に設定されています。

  • デフォルト値Grade A に設定されているため、レポートを開くとデフォルトで Grade A の結果が表示されます。

結果は次の図のとおりです。

112

検索

フィルタリング時に、検索バーを使用して必要なデータをすばやく見つけることができます。

image

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

    image

  • フィルターオプションが 1,000 件を超える場合、デフォルトで最初の 1,000 件のみが表示されます。この上限を超えるオプションは直接検索できます。目的のオプションがそれでも見つからない場合は、データベースから検索 を試すことができます。image

説明

データベースから検索オプションは、表示形式ドロップダウンリスト で、オプション値のソース自動解析 または 単一データセット に設定されている場合にのみ使用できます。

テキスト入力ボックス

テキスト入力ボックスを使用すると、レポートの閲覧者はキーワードを入力してデータをすばやく取得できるため、データクエリがより正確かつ柔軟になります。[表示形式] がテキスト入力ボックスの場合、[条件タイプ] を [単一条件]、[OR 条件]、または [AND 条件] に設定できます。このセクションでは、[OR 条件] を例として使用します。

image

パラメーター

説明

[条件タイプ]

[単一条件]、[OR 条件]、[AND 条件] をサポートします。

  • 単一条件:単一の基準を満たします。例:製品タイプが定規。

  • OR 条件:2つの基準のうち少なくとも1つを満たします。例:製品タイプが定規または鉛筆。

  • AND 条件:2つの基準を同時に満たします。例:注文金額が100より大きく、かつ200より小さい。

image

  • 条件タイプ: [OR 条件] を選択します。

  • デフォルト値の設定: 条件を[含む]に設定してテキストをrulerにするか、または条件を[次で始まる]に設定してテキストを[テーブル]にします。

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

[デフォルト値を設定]

利用可能なルールは、選択した条件タイプによって異なります。

product_sub_type フィールドのデフォルト値を設定する際に利用可能なルールと、それに対応する 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'

  • Null である: product_sub_type IS NULL

  • NULL ではない: product_sub_type IS NOT NULL

  • 空文字列product_sub_type = ''

  • 空文字列ではないproduct_sub_type != ''

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

このオプションを有効にすると、レポートの閲覧者はプレビューページで条件タイプを変更できなくなります。image

説明

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

この例の要約:

  • 条件タイプ[OR 条件]に設定されており、指定されたいずれかのフィルター条件を満たす場合にデータが表示されます。

  • デフォルト値 は、テキスト ruler含む、またはテキスト pencil始まる ように設定されています。閲覧者がレポートを開くと、デフォルトで製品タイプに「ruler」が含まれるか、「pencil」で始まる結果が表示されます。

  • フィルター条件をロック が有効になっているため、レポートの閲覧者はレポートページで条件タイプを変更できません。

結果は次の図のとおりです。

112

ツリードロップダウン

ツリードロップダウンを使用すると、レポートの閲覧者は、組織構造、地理的地域 (国-省-市)、製品カテゴリ (カテゴリ-サブカテゴリ) など、親子階層を持つデータをフィルタリングできます。この構造により、ユーザーはオプションを展開して選択することで、データを特定し、フィルタリングできます。

image

説明

関連するチャートがデータセットの組み合わせを使用し、複数の関連フィールドが選択されている場合、ツリードロップダウンは利用できません。

パラメーター

説明

データセットの選択

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

image

  • データセットの選択:この例では、チャートのソースデータセット company_sales_record が選択されています。

  • ツリー構造の設計:レベル 1 に region フィールド、レベル 2 に province フィールドを設定します。

  • 表示フォーマットタイル表示 を選択します。

  • 選択モード複数選択 を選択します。

  • クエリ時間クリック時のクエリ を選択します。

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

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

ツリー構造の設計

[Start Configuration] をクリックします。[Tree Structure Design] ダイアログボックスで、フィルターの各レベルの クエリフィールド表示名フィールドソートフィールドソートルール を設定します。image

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

  • 表示名フィールド:クエリフィールドに理解しにくいビジネスIDやコードが含まれている場合、表示名フィールドを設定してフィルターオプションをより分かりやすくすることができます。

  • ソートフィールド:選択したフィールドでソートできます。これはオプションのパラメーターです。空白のままにすると、オプションはデータセットの順序に従ってソートされます。

  • ソートルール:ソートオプションには、昇順降順カスタム があります。カスタムを選択した場合、[Custom Sort] ダイアログボックスでフィールド値をドラッグアンドドロップして順序を並べ替えることができます。

たとえば、「地域-省-市」の階層を持つツリーフィルターを作成し、各クエリフィールドに昇順のソートルールを設定した場合:

image

フィルターオプションは、各レベル (地域、省、市) で昇順にソートされます。

image

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

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

  • ツリードロップダウンは、最大 10 レベルのフィルタリングをサポートします。

表示フォーマット

ツリー表示タイル表示 から選択できます。

説明

1,000 件を超えるデータエントリがある場合は、[タイル表示] 形式を使用することを推奨します。

  • ツリー単一選択表示image

  • ツリー複数選択表示image

  • タイル単一選択表示image

  • タイル複数選択表示image

選択モード

単一選択複数選択 から選択できます。

クエリ時間

クリック時のクエリ事前クエリ をサポートします。

  • クリック時のクエリ:ユーザーがクエリボタンをクリックしたときにのみクエリが実行されます。

  • 事前クエリ:ドロップダウンリストの値は、ダッシュボードページが読み込まれるときに取得されます。これにより、各ユーザーの行レベルの権限に基づいてオプションを表示でき、各ユーザーのデフォルト値もそれに応じて変わることがあります。

    説明

    事前クエリ オプションは、行レベルの権限があり、データ量が少ないデータセットに最適です。それ以外の場合、レポートの読み込み時間が長くなる可能性があります。

フィルターオプションのNULL値を表示

image

[フィルターオプションのNULL値を表示] を選択すると、ドロップダウンリストの NULL 値はレポートの閲覧者に (Null) として表示されます。

image

このオプションが選択されていない場合、NULL 値は除外されます。

説明

ツリーの中間ノードに NULL 値がある場合、子ノードにNULLでない値があっても、ブランチ全体 (NULLノードとそのすべての子を含む) は表示されません。

image

説明

このパラメーターは、組織レベルの [Report Configurations][各フィルター条件でNULL値を表示するかどうかを設定] が選択されている場合にのみ使用できます。

image

デフォルト値を設定

このオプションを選択して値を設定すると、レポートページが読み込まれるときにフィルターバーに事前設定された値が表示されます。

説明

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

クイック関連付け

[クイック関連付け] を選択すると、同じデータセットを使用するチャートの場合、ツリー構造のサブレベルフィールドが [Related Charts and Fields] セクションに自動的に追加されます。これにより、フィルターバーの設定が効率化されます。

たとえば、下の図では、2 階層目の [都道府県] フィールドに関連するグラフとフィールドを設定すると、システムは同じデータセットの [折れ線グラフ][縦棒グラフ] の都道府県フィールドに自動的に入力します。ただし、別のデータセットの [円グラフ] の関連フィールドは、手動で入力する必要があります。

image

説明

メインレベルの [Related Charts and Fields] セクションで選択したチャートのみが、サブレベルフィールドの自動同期の対象となります。image

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

この例の要約:

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

  • ツリー構造の設計 は、レベル 1 に region フィールド、レベル 2 に province フィールドで設定されています。クエリフィールドの値は自明であるため、クエリフィールドと表示名フィールドは同じです。

  • 表示フォーマットタイル表示 に設定されています。

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

  • クエリ時間クリック時のクエリ に設定されているため、レポートの閲覧者はフィルターを適用するためにクエリボタンをクリックする必要があります。

  • デフォルト値東北 > 遼寧 に設定されているため、レポートを開くとデフォルトでこの地域と省の結果が表示されます。

  • クイック関連付け が有効になっています。

結果は次の図のとおりです。

112