検索バーの設定と管理

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

このページの内容

ページに検索要素を追加・管理し、スタンドアロンのレポート、またはページに埋め込まれたレポートコンポーネントのデータを、クエリー検索で素早く絞り込む方法を説明します。

提供状況

検索バーは、Creator のすべてのプランで作成できます。
スーパー管理者、管理者、開発者のみが、検索バーを作成および管理できます。

1. 検索要素の設定

検索要素は、次の 2 つのコンポーネントを基に設定できます。

1。1. レポートを基に検索要素を設定する

1. 対象ページのページビルダーに移動し、左ペインの検索をクリックします。右側に検索バーのテンプレート一覧が表示されます。

2. 一覧から検索テンプレートをドラッグ＆ドロップして、作成スペースに配置します。検索の設定ペインが開き、初期状態ではプロパティタブが表示されます。

メモ: すでに検索要素が作成済みの場合は、ページビルダー上でその要素を選択し、設定をクリックして検索の設定ペインを開きます。あるいは、検索バーをダブルクリックして設定を開くこともできます。

3. 検索バーを基にするレポートコンポーネントを選択します。この設定により、検索入力に応じてフィルタリングされたレポートが、同じウィンドウ、新しいウィンドウ、またはポップアップで表示されます。

4. 検索入力に基づいてデータを絞り込む対象レポートを選択します。

メモ: ドロップダウンには、現在作業しているアプリケーション内のすべてのレポートが表示されます。他のアプリケーションのレポートを選択するには、ドロップダウンのフッターにあるアプリを変更をクリックします。別のアプリケーションを選択し、完了をクリックすると、そのアプリケーション内のすべてのレポートが表示されます。

5. 対象レポートのデータを絞り込むための条件を設定します。

項目を選択ドロップダウンから、評価対象となる項目を選択します。
演算子を選択ドロップダウンから、適切な演算子を選択します。
値フィールドには、入力値のプレースホルダーとして機能するシステム変数「input.searchString」が自動入力されます。これは作成したすべての条件で編集不可として表示されます。

必要に応じて条件を追加し、設定が完了したら完了をクリックします。

メモ: 保存済みの条件を編集するには、検索条件ボックスをクリックします。

4. レポートを新しいウィンドウ（初期値）、同じウィンドウ、またはポップアップのいずれで開くかを選択します。ポップアップを選択した場合は、幅と高さをピクセル単位でカスタマイズできます。

5. 対象レポートに対して公開アクセスを許可を有効にするかどうかを選択します。検索バーを含むページが公開されている場合、フィルタリングされた結果にアクセスできるようにするには、対象レポートも公開されている必要があります。さらに、公開済みレポートを表示できるようにするには、検索バーの設定で公開アクセスを許可オプションを有効にしておく必要があります。

メモ: 初期状態では、公開アクセスを許可は無効になっています。必要に応じて有効に切り替えてください。

6. 検索バーに自動入力される初期値を入力します。特定の検索入力が頻繁に使用される場合に便利です。

7. プレースホルダーとして表示する値を入力します。この値は検索バーの入力欄に表示されます。

設定は自動保存され、運用モードに反映されます。

1。2. ページコンポーネントを基に検索要素を設定する

検索要素を設定するには、次の操作を行います。

対象ページにレポートを埋め込みます（すでにレポートが埋め込まれている場合は、次の手順に進みます）。
検索要素を追加するページに移動します。

ページコンポーネントを基にした検索バーを設定する前に、次の手順を実行します。

1. 対象ページコンポーネントの編集モードに移動し、ページに対象レポートを埋め込みます。

2. ページビルダーのヘッダー部分にあるページ変数とスクリプトアイコンをクリックします。

3. 変数を追加をクリックし、検索入力と照合して結果を返す項目にリンクする変数を作成します。

メモ: この画面ですでにページ変数を追加済みの場合は、新しい変数を作成するために新規追加をクリックします。

4. 対象項目のフィールドリンク名を、変数名として入力します。運用モードでは、この項目の値が、検索要素に入力されたキーワードと照合されます。

5. 評価対象となる項目に応じてデータ型を選択します。たとえば、対象がドロップダウン項目の場合、選択するデータの種類はテキストです。その後、追加をクリックします。

アイコンをクリックして、ページビルダーに戻ります。

7. 埋め込まれたレポートを選択し、設定をクリックしてレポート埋め込みの設定ペインを開きます。

7. 右側ペインのフィルタータブを選択し、フィルターを追加をクリックします。

8. 埋め込みレポートのデータをどのような条件でフィルタリングするかを指定する条件を設定します。

項目を選択ドロップダウンから、値を評価する対象の項目を選択します。
演算子を選択ドロップダウンから、適切な演算子を選択します。
対象レポートの項目リンク名を名前に持つ、設定済みのページ変数を、値として 'input.<page variable>' という形式で指定します。

必要に応じて他の条件も追加し、完了をクリックします。

メモ: 条件を保存した後、再度編集するにはフィルターボックスをクリックします。

9. 完了をクリックして、埋め込みレポートの設定を保存します。

上記の設定が完了したら、検索バーを挿入するページの編集モードに移動し、次の手順に従います。

1. 対象ページのページビルダーに移動し、左ペインの検索をクリックします。

2. 表示される一覧から検索テンプレートをドラッグ＆ドロップしてビルダー領域に配置します。検索設定ペインが開き、初期設定ではプロパティタブが表示されます。

メモ: すでに検索要素が作成されている場合は、ページビルダーでその要素を選択し、設定をクリックして検索設定ペインを開きます。あるいは、検索バーをダブルクリックして設定を開くこともできます。

3. ページコンポーネントを選択し、それに基づいて検索バーを設定します。この設定により、検索入力に基づいて埋め込みレポートを含むページが表示されます。

4. データが検索入力に基づいて動的にフィルタリングおよび表示される、埋め込みレポートを含むページを選択します。

メモ: 対象ページドロップダウンには、現在作業しているアプリケーション内のすべてのページが一覧表示されます。他のアプリケーションのページを選択するには、ドロップダウンのフッターにあるアプリを変更をクリックします。別のアプリケーションを選択し、完了をクリックすると、そのアプリケーション内のすべてのページが表示されます。

5. 対象ページを選択すると、そのページに追加された最初のページ変数が初期設定で表示されます。検索フィルターを機能させるには、ここで指定するページ変数が、値を評価する対象項目（手順 4 を参照）の項目リンク名で設定されたものになっている必要があります。レポートの項目に基づいて同様のページ変数を複数設定しており、それらも含める必要がある場合は、+ 新規追加をクリックします。

このページ変数の値には、ユーザーの検索入力を保持するシステム変数 input.searchString が自動入力され、編集不可として表示されます。したがって、ユーザーが検索バーに値を入力すると、その値がページ変数に渡され、レポートのフィルターにリンクされたページ変数を通じて、埋め込みレポートのデータが評価されます。

メモ:

追加済みのものとは別のページ変数を選択するには、その変数をクリックし、対象項目リンク名に基づいて事前に作成・命名しておいた必要なページ変数を選択します。
この設定からページ変数を削除するには、その上にカーソルを合わせてごみ箱アイコンをクリックします。

6. 対象ページを新しいウィンドウ（初期設定値）、同じウィンドウ、またはポップアップのいずれで開くかを選択します。ポップアップを選択した場合は、幅と高さをピクセル単位でカスタマイズできます。

7. 対象ページ内の埋め込みレポートに対して公開アクセスを許可を有効にするかどうかを選択します。これにより、対象ページが公開されている場合に、レポートも公開されていれば、埋め込みレポートが表示されるようになります。

8. 検索バーに自動入力される初期設定値を入力します。特定の検索入力が頻繁に使用される場合に便利です。

9. プレースホルダーとして表示する値を入力します。この値は検索バーの入力欄に表示されます。

設定は自動保存され、有効モードに反映されます。

1。3. スタイルを設定する

以下のように、検索バーとそのコンテナのスタイル設定を行うことができます:

1. 対象ページのページビルダーに移動し、左ペインで検索をクリックします。

2. 表示される一覧から検索テンプレートをドラッグ＆ドロップして、作成スペースに配置します。検索設定ペインが開きます。

メモ: すでに検索バーが作成されている場合は、ページビルダーでその検索バーを選択し、設定をクリックして検索設定ペインを開きます。あるいは、検索バーをダブルクリックして設定ペインを開くこともできます。

3. 右側セクションのStyleタブに移動し、以下の設定を使用して検索バーをカスタマイズします:

次の表では、パネルおよびパネルコンテナのすべてのスタイルプロパティと、その設定手順を一覧で示します。

Property		Steps
一般	検索の形状	検索要素の形状として、Rectangular（初期設定）またはRoundedのいずれかを選択します。
	フォントファミリー	ユーザー入力と検索ボタンのラベルに使用するフォントを選択します。
検索ボタン検索バー（上記それぞれの要素に対して、プロパティを個別に設定できます）	Style	入力テキストおよび検索ボタンのスタイルプロパティ（太字や斜体など）をカスタマイズします。
	Color	Aアイコンをクリックし、検索入力欄とボタンのフォントカラーを選択します。バケツアイコンをクリックし、背景色を選択します。
	フォントサイズ	ドロップダウンをクリックし、入力テキストおよび検索ボタンに使用する、12〜40 px のプリセットフォントサイズを選択します。数値をクリックすると、1〜99 ピクセルの任意のカスタム値を設定できます。
Padding		検索バーの四辺すべてのパディング値を入力し、バーとコンテナのマージンとの間隔を調整します。初期設定値は以下の画像のとおりです。
Background color		検索バーが配置されているコンテナの背景色をカスタマイズします。
Background		検索バーのコンテナに設定する背景画像を、My libraryまたはWeb リンクから指定します。さらに、次の項目をカスタマイズできます: Scaling - 次のいずれかを選択できます: Fill - 画像を拡大して、スペース全体を埋めます。 Fit - コンテナの枠内に収まるように画像サイズを変更し、画像が切れないようにします。 Tile - スペースを埋めるために、画像を水平方向または垂直方向に繰り返し表示します。メモ: FillまたはFitを選択した場合は、画像の位置を左・右・上・下・中央のいずれかに設定できます。 Tileを選択した場合は、画像を水平方向、垂直方向、または両方に繰り返すかを指定できます。初期設定では、水平方向・垂直方向の両方が選択されています。どちらも選択しない場合は、直前に選択されていた設定が自動的に適用されます。 Overlay - 背景画像に任意の色のオーバーレイを有効にします。オーバーレイカラーの濃さは 0%〜99% の範囲で調整できます。

2. 検索要素の管理

［検索］設定ペインでできること:

検索バーの作成に加えて、次の操作を行うことができます。

要素名の追加 - ［検索］設定ペイン右上の鉛筆アイコン（）をクリックして、要素名を編集します。この名前は、ページビルダー内で他の要素の中から該当の要素を探す際に使用できます。
検索要素タイプの矢印アイコン（）をクリックして、別のテンプレートを選択し、設定完了後にタイプを変更します。検索バーの種類を切り替えても、設定内容は保持されます。