レポートの閲覧者は、テキストコントロールでテキストフィールドの値を入力または選択することで、データを動的にフィルターおよびクエリできます。テキストクエリコントロールを使用すると、ダッシュボードの閲覧者は特定のテキスト条件に基づいてチャートデータをフィルターし、主要なコンテンツに集中できます。
テキストクエリコントロールの主な利点は次のとおりです。
高い柔軟性: ドロップダウンリスト、テキスト入力ボックス、ツリードロップダウンなど、3 つの表示タイプをサポートしています。また、さまざまなビジネスシナリオやユーザーのプリファレンスに対応する豊富な構成オプションも提供します。
高い精度: 含む、含まない、次で始まる、次で終わるなど、入力されたコンテンツに対して複数の照合条件をサポートしています。これにより、正確なデータ取得が可能になります。
Quick BI は、ドロップダウンリスト、テキスト入力ボックス、ツリードロップダウンの 3 種類のテキストコントロールをサポートしています。このトピックでは、各表示タイプのシナリオと構成手順について説明します。
前提条件
ダッシュボードを作成済みで、その上のチャートにテキストフィールドが含まれていること。
ダッシュボードに空のクエリコントロールを追加済みであること。詳細については、「クエリコントロールを作成する」をご参照ください。
クエリ条件の構成
ダッシュボードの編集ページに移動します。詳細については、「ダッシュボードを作成する」をご参照ください。
ダッシュボードリストで、対象のダッシュボードを見つけてクリックします。
ダッシュボード上のチャートには、テキストクエリコントロールを構成するためのテキストフィールドが含まれている必要があります。このトピックでは、折れ線グラフを例として使用します。詳細については、「折れ線グラフ」をご参照ください。

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

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

クエリ条件の名前を [レベルクエリ] に設定します。
[折れ線グラフ] と外部キーフィールドの オーダーレベル を選択します。
表示タイプを設定し、クエリ条件の構成を完了します。
[表示タイプ] を [ドロップダウンリスト] に設定した場合は、「ドロップダウンリスト」の例をご参照ください。
[表示タイプ] を [テキスト入力ボックス] に設定した場合は、「テキスト入力ボックス」の例をご参照ください。
[表示タイプ] を [ツリードロップダウン] に設定した場合は、「ツリードロップダウン」の例をご参照ください。
[OK] をクリックします。
ドロップダウンリスト
ドロップダウンリスト表示タイプを使用すると、レポート作成者は事前定義されたオプションのセットを定義し、閲覧者が選択できるようにリスト形式で表示できます。表示タイプを [ドロップダウンリスト] に設定すると、オプション値のソースは [自動解析]、[単一データセット]、または [手動入力] になります。

自動解析
自動解析を選択すると、Quick BI は関連付けられたすべての外部キーフィールドの値を自動的に識別し、クエリコントロールのオプションの和集合として表示します。
[関連チャートとフィールド] セクションのチャートが同じデータセットを使用している場合、値はそこから自動的に解析されます。
[関連チャートとフィールド] セクションで選択されたチャートが複数のデータセットを使用している場合、システムはそれらすべてから値を自動的に解析し、その和集合をドロップダウンリストに表示します。
構成項目 | 説明 | 例 |
[クエリモード] | [単一選択] と [複数選択] をサポートしています。 |
|
[クエリ時間] | [クリックしてクエリ] と [事前クエリ] をサポートしています。
| |
[デフォルトのフィルター値の設定] | このオプションを選択します。クエリ条件ボックスに [選択してください] と表示されます。クエリ条件ボックスをクリックして、[フィールド] ダイアログボックスでデフォルト値を構成します。 このダイアログボックスでは、次の操作を実行できます。
説明 フィルターアイテムの数が 1,000 を超える場合、デフォルトで最初の 1,000 のオプション値が表示されます。表示されていない値は直接検索できます。 |
この例では、
[関連チャートとフィールド] セクションで、複数のデータセットから異なるフィールドが選択されています。クエリコントロールのドロップダウンリストには、すべての外部キーフィールド値の和集合が表示されます。
[クエリモード] は [複数選択] に設定されており、クエリコントロールで複数のオプションを選択できることを意味します。
[クエリ時間] は [クリックしてクエリ] に設定されており、レポートの閲覧者が条件付きクエリをトリガーするにはクエリボタンをクリックする必要があることを意味します。
[デフォルトのフィルター値を設定] は [アドバンスト]、[広東省]、[家具製品] に設定されています。レポートの閲覧者がレポートを開くと、デフォルトでアドバンストオーダーレベル、広東省、および家具製品タイプのクエリ結果が表示されます。
次の図に結果を示します。
単一データセット
オプション値のソースが単一データセットの場合、クエリコントロールのオプションは、そのデータセット内の特定のフィールドの値に依存します。

構成項目 | 説明 | 例 |
[データセットの選択] | 現在のダッシュボードがあるワークスペース内の任意のデータセットを選択できます。チャートのデータソースであるデータセットを選択することをお勧めします。 |
|
[クエリ値フィールド] | 選択したデータセット内で、外部キーフィールドと一致する必要があるフィールドです。このフィールドは実際のクエリに使用されます。レポートの閲覧者は、このフィールドの値から 1 つ以上のオプションを選択してデータをクエリできます。 | |
[表示名フィールド] | クエリコントロールにオプションとして値が表示されるフィールドです。このフィールドは通常、クエリコントロールのユーザーエクスペリエンスを向上させ、レポートの閲覧者がオプション値の意味をよりよく理解できるようにするために使用されます。
| |
[並べ替えフィールド] | 選択したフィールドによるソートをサポートします。このパラメーターはオプションです。このパラメーターを指定しない場合、データはデータセットのデフォルトの順序でソートされます。 特定のフィールドでソートするには、ドロップダウンリストでソートフィールドを選択できます。たとえば、メジャーや日付でソートできます。サポートされているソート方法は、[昇順]、[降順]、[カスタムソート] です。カスタムソートを選択すると、[カスタムソート] ダイアログボックスでフィールド値をドラッグして順序を変更できます。 設定が有効になると、クエリコントロールのドロップダウンリストのソートに影響しますが、チャートのディメンション値のソートには影響しません。チャートのディメンション値のソートは、引き続き各チャートのデータセットまたはデータパネルによって管理されます。 | |
[クエリモード] | [単一選択] と [複数選択] をサポートしています。 | |
[クエリ時間] | [クリックしてクエリ] と [事前クエリ] をサポートしています。
| |
[デフォルトのフィルター値の設定] | このオプションを選択します。プリセット値がクエリ条件に表示されます。 説明 フィルターアイテムの数が 1,000 を超える場合、デフォルトで最初の 1,000 のオプション値が表示されます。表示されていない値は直接検索できます。
|
この例では、
[データセット] は、現在のチャートのソースデータセットである company_sales_record に設定されています。
[クエリ値フィールド] は [オーダーレベル] に設定されており、これは外部キーフィールドと同じで、実際のクエリに使用されます。
[表示名フィールド] も [オーダーレベル] に設定されています。
[ソートフィールド] は [オーダー日] に設定されており、コントロール内のオプション値をソートします。
[クエリモード] は [複数選択] に設定されており、レポートの閲覧者がクエリコントロールで複数のオプション値を選択できることを意味します。
[クエリ時間] は [クリックしてクエリ] に設定されており、レポートの閲覧者が条件付きクエリをトリガーするにはクエリボタンをクリックする必要があることを意味します。
[デフォルトのフィルター値を設定] は [アドバンスト] に設定されています。レポートの閲覧者がレポートを開くと、デフォルトでアドバンストオーダーレベルのクエリ結果が表示されます。
次の図に結果を示します。

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

構成項目 | 説明 | 例 |
[手動入力] | [手動入力] をクリックします。[手動入力] ダイアログボックスで、[クエリ値] と [表示名] を入力します。
説明
|
|
[クエリモード] | [単一選択] と [複数選択] をサポートしています。 | |
[デフォルトのフィルター値の設定] | このオプションを選択します。プリセット値がクエリ条件に表示されます。 |
この例では、
[手動入力] では、[オーダーレベル] フィールド値が表示値にマッピングされます: [アドバンスト] は [A レベル]、[中間] は [B レベル]、[低] は [C レベル]、[その他] は [D レベル] です。
[クエリモード] は [複数選択] に設定されており、レポートの閲覧者が複数のオプションを選択できます。
[デフォルトのフィルター値を設定] は [アドバンスト] に設定されています。レポートの閲覧者がレポートを開くと、デフォルトでアドバンストオーダーレベルのクエリ結果が表示されます。
次の図に結果を示します。

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

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

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

データベースからの検索は、[表示タイプ] が [ドロップダウンリスト] に設定され、オプション値のソースが [自動解析] または [単一データセット] の場合にのみサポートされます。
テキスト入力ボックス
テキスト入力ボックス表示タイプを使用すると、レポートの閲覧者はクエリボックスにキーワードを入力することで、必要なデータをすばやく取得できます。これにより、データクエリがより正確かつ柔軟になります。表示タイプを [テキスト入力ボックス] に設定すると、サポートされる条件は [単一条件]、[Or 条件]、および [And 条件] です。次の例では、[Or 条件] を使用します。

構成項目 | 説明 | 例 |
[条件付きフォーム] | [単一条件]、[Or 条件]、[And 条件] をサポートします。
|
|
[デフォルト値の設定] | 値は、選択した条件付きフォームによって異なります。 たとえば、製品タイプ フィールドにデフォルト値を設定する場合、ルールと対応する SQL 構文は次のようになります。
| |
[フィルター条件のロック] | このオプションを有効にすると、プレビューページで条件付きのフォームを切り替えることができなくなります。 説明 このオプションは、[デフォルト値の設定] が選択されている場合にのみ表示されます。 |
この例では、
[条件付きフォーム] が [Or 条件] に設定されている場合、クエリ条件のいずれかを満たすデータが表示されます。
[デフォルト値を設定] は、「定規」という文字を [含む]、または「テーブル」という文字で [始まる] ように構成されています。レポートの閲覧者がレポートを開くと、デフォルトで「定規」を含むか「テーブル」で始まる製品タイプのクエリ結果が表示されます。
[フィルター条件をロック] が選択されています。これにより、レポートの閲覧者はレポートページのクエリコントロールで条件付きフォームを切り替えることができなくなります。
次の図に結果を示します。

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

関連付けられたチャートが データセットユニオン を使用しており、複数の外部キーフィールドが選択されている場合、表示タイプをツリードロップダウンに設定することはできません。
構成項目 | 説明 | 例 | |
[データセットの選択] | 現在のダッシュボードがあるワークスペース内の任意のデータセットを選択できます。チャートのデータソースであるデータセットを選択することをお勧めします。 |
| |
[ツリー構造の設計] | [構成を開始] をクリックします。[ツリー構造の設計] ダイアログボックスで、クエリコントロールの各レベルの [クエリフィールド] と [表示フィールド] を構成します。
説明
| ||
[表示形式] | [ツリー表示] と [タイル表示] をサポートします。 説明 データが 1,000 エントリを超える場合は、表示フォームとして [タイル表示] を選択することをお勧めします。 |
| |
[クエリモード] | [単一選択] と [複数選択] をサポートします。 | ||
[クエリ時間] | [クリックしてクエリ] と [事前クエリ] をサポートしています。
| ||
[デフォルト値の設定] | このオプションを選択し、関連する値を設定します。レポートページが読み込まれると、プリセット値がクエリコントロールに表示されます。 説明 ここでのデフォルト値は、ツリー構造の設計における表示名フィールドです。 | ||
[クイック関連付け] | [クイック関連付け] を選択すると、ツリー構造のサブレベルフィールドが、同じデータセットのチャートの [関連チャートとフィールド] セクションに自動的に追加されます。これにより、クエリコントロール構成の効率と精度が向上します。 たとえば、次の図では、第 2 レベルの [省] の関連チャートとフィールドを構成すると、システムは自動的に省フィールドを、同じデータセットの [折れ線グラフ] と [縦棒グラフ] の外部キーフィールドに入力します。異なるデータセットの [円グラフ] の外部キーフィールドは、手動で入力する必要があります。
説明 メインレベルの [関連チャートとフィールド] セクションで選択されたチャートのみが、サブレベルフィールドの自動同期をサポートします。 ツリー構造の [関連チャート] をクリックするか、左側のクエリアイテムのサブレベルの名前をクリックして、サブレベルを他のデータセットのチャートやフィールドに関連付けることができます。 | ||
この例では、
[データセットの選択] は、現在のチャートのソースデータセットである company_sales_record に設定されています。
[ツリー構造の設計] では、レベル 1 に地域フィールド、レベル 2 に province フィールドが構成されています。クエリフィールドの値が明確で理解しやすいため、クエリフィールドと表示名フィールドは同じフィールドに設定されています。
[表示フォーム] は [タイル表示] に設定されています。
[クエリモード] は [複数選択] に設定されており、レポートの閲覧者がクエリコントロールで複数のオプション値を選択できることを意味します。
[クエリ時間] は [クリックしてクエリ] に設定されており、レポートの閲覧者が条件付きクエリをトリガーするにはクエリボタンをクリックする必要があることを意味します。
[デフォルト値を設定] は [東北] > [遼寧] に設定されています。レポートの閲覧者がレポートを開くと、デフォルトで東北地域と遼寧省のクエリ結果が表示されます。
[クイック関連付け] が選択されています。
次の図に結果の例を示します。
























