1. アプリケーション・ビルダー・ユーザーズ・ガイド
  2. 共有コンポーネントの管理
  3. アプリケーションへの検索の追加
  4. ユビキタス検索の作成

16.9.5 ユビキタス検索の作成

ユビキタス・データベース検索を作成することで、スキーマ全体で複数のオブジェクトを検索します。

ノート:

Oracleユビキタス検索索引を使用する検索には、Oracle Database 23ai以降が必要です。また、この索引はアプリケーションの解析対象スキーマに存在する必要もあります。

このトピックでは、ユビキタス検索索引がある複数の表に対する検索ページを作成する方法について説明します。このトピックでは、シンプルなユビキタス検索索引と、そのユビキタス検索索引を使用する検索構成を作成してから、ページの作成ウィザードを使用して検索ページを作成します。

親トピック: アプリケーションへの検索の追加

16.9.5.1 ユビキタス検索索引の作成

複数の表に対するユビキタス検索索引を作成する方法について説明します。

ノート:

Oracleユビキタス検索索引を使用する検索には、Oracle Database 23ai以降が必要です。また、この索引はアプリケーションの解析対象スキーマに存在する必要もあります。

Oracle Database 23ai以降では、単一の索引で複数のスキーマ・オブジェクトの索引付けにDBMS_SEARCH PL/SQLパッケージを使用できます。詳細は、『Oracle Textアプリケーション開発者ガイド』のDBMS_SEARCH APIを使用したユビキタス検索の実行を参照してください。

ユビキタス検索索引(すなわちDBMS_SEARCH索引)は、複数の列、表またはビューに対する全文検索を実行できるようにする、一連のプリファレンスと設定が事前定義されているJSON検索索引です。これらの索引の作成、管理および問合せには、DBMS_SEARCH PL/SQLパッケージを使用します。

このトピックでは、サンプル・データセット「プロジェクト・データ」で使用可能なEBA_PROJECT_TASKS表に、とてもシンプルなユビキタス検索索引を作成する方法について説明します。

ユビキタス検索索引を作成するには:

  1. 「SQLコマンド」をクリックします。

    「SQLコマンド」ホームページが表示されます。

  2. コマンド・エディタに次のSQLコマンドを入力します。
    BEGIN
    DBMS_SEARCH.CREATE_INDEX( 'MY_SEARCH_INDEX' );
    DBMS_SEARCH.ADD_SOURCE ( 'MY_SEARCH_INDEX', 'EBA_PROJECT_TASKS' );
END;
/
  3. 「実行」([Ctrl]+[Enter])をクリックして、コマンドを実行します。

    「結果」ペインに結果が表示されます。

親トピック: ユビキタス検索の作成

16.9.5.2 ユビキタス検索構成の作成

既存のユビキタス検索索引に対する検索構成を作成します。

検索構成には、検索可能なデータ・ソースに関する情報が含まれます。このタスクでは、EBA_PROJECT_TASKS表に作成された既存のユビキタス検索索引を使用して、検索構成を作成します。

ノート:

このタスクでは、アプリケーションと、サンプル・データセット「プロジェクト・データ」で使用可能なEBA_PROJECT_TASKS表を基にした対話モード・レポートが事前に作成されていることを前提にしています。

ユビキタス検索構成を作成するには:

  1. 「構成の検索」ページにアクセスします。
    1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
    2. アプリケーションを選択します。
    3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
    4. 「ナビゲーションと検索」で、「構成の検索」をクリックします。
      「構成の検索」ページが表示されます。
  2. 「構成の検索」ページで、「作成」をクリックします。
    1. 名前 - 検索構成の名前を入力します(例: Projects Tasks - Ubiquitous)。
    2. 検索タイプ - 検索のタイプを選択します。オプションは次のとおりです。

      • 標準 - 表、SQL問合せ、RESTデータ・ソースなど、検索可能なデータ・ソースを定義します。検索は、LIKE式を使用してSQL問合せによって実行されます。

      • Oracle TEXT - すでにOracle TEXT索引が作成されている検索可能な表またはSQL問合せを定義します。検索は、言語およびファジー検索機能を提供するOracle TEXT機能を使用して実行されます。

      • Oracleユビキタス検索 - Oracleユビキタス検索索引を使用して検索します(Oracle Database 23ai以降が必要)。索引は、アプリケーションの解析スキーマに存在する必要があります。

      • リスト - 共有コンポーネントから選択されたリスト内で検索します。

      この例では、「Oracleユビキタス検索」を選択して、「次」をクリックします。

  3. ソース:
    1. 検索索引名 - Oracleユビキタス検索索引を選択します。この索引は、すでに解析対象スキーマに存在する必要があります。

      この例では、MY_SEARCH_INDEXを選択します。

    2. ソース名の検索 - 選択したOracleユビキタス検索索引の一部である解析スキーマからOracleユビキタス検索索引ソースを選択します。この例では、EBA_PROJECT_TASKSを選択します。
    3. 「次」をクリックします。
  4. 列のマッピング:
    1. 主キー列 - 検索構成のデータ・ソースの主キー列を選択します(例: ID)。
    2. 説明列 - 説明として使用する列を選択します。
    3. Oracleユビキタス索引列 - Oracleユビキタス対応の列を選択します(例: NAME)。
    4. 説明列 - 説明として使用する列を選択します(例: DESCRIPTION)。
    5. アイコン・ソース - 検索結果のヘッダーに表示されるアイコンを構成します。オプションは次のとおりです。
      • イニシャル - タイトル列を使用して、アイコンをイニシャルとして表示します。
      • CSSクラス - 入力したCSSクラスを使用してアイコンを表示します。
      • クラス列 - アイコンのCSSクラスを含む選択した列を使用して、アイコンを表示します。

      この例では、デフォルトの「イニシャル」を受け入れます。

  5. 「検索構成の作成」をクリックします。

    検索構成が作成されます。「検索構成」、「編集」ページが表示され、「検索構成が作成されました。」というメッセージが表示されます。

  6. レポートにリンクするように検索構成を編集します。
    1. リンク、リンク・タイプ - リンクのタイプを選択します(「このアプリケーションのページにリダイレクト」など)。
    2. ページ - リダイレクト先のページを選択または入力します(例: 2)。
    3. 「変更の適用」をクリックします。
      「検索構成が更新されました。」というメッセージとともに「構成の検索」ページが表示されます。
  7. 「アプリケーションID」ブレッドクラムをクリックして、アプリケーションのホームページに戻ります。

親トピック: ユビキタス検索の作成

16.9.5.3 ユビキタス検索ページの作成

ページの作成ウィザードを実行して、検索ページを作成します。

標準検索を作成する場合でも、Oracleユビキタス検索を作成する場合でも、ページの作成ウィザードを実行することによる検索ページの作成には、同じステップが含まれます。ページの作成ウィザードによって検索フィールドが作成され、検索構成を選択するよう求められます。後でページ・デザイナで検索構成を追加することもできます。

検索ページには、検索フィールドと「検索結果」リージョンがあります。ページ・デザイナでは、「検索結果」リージョンに、共有コンポーネントで定義された検索構成にマップされる検索ソースが含まれています。

ページの作成ウィザードを実行して検索ページを作成するには:

  1. アプリケーションのホームページにナビゲートします。
    1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
    2. アプリケーションを選択します。
  2. 「アプリケーション」ホームページで、「ページの作成.」をクリックします
    「ページの作成」が表示され、「コンポーネント」、「機能」および「レガシー・ページ」の3つのタブがあります。
  3. 「コンポーネント」で、「検索ページ」を選択します。
  4. ページ定義:
    1. ページ番号 - ページ番号はアプリケーション内のページを識別する整数値です。
    2. 名前 - このページのテキスト名を指定します(例: Search Projects - Ubiquitous)。

      このテキストは、レポート・タイトルにも使用されます。ページの作成後は、ページ・デザイナでタイトルを変更できます。

    3. ページ・モード - ページ・モードを指定します。デフォルトの「標準」を受け入れます。
  5. 構成の検索 - このページで使用する検索構成を選択します(たとえば、Projects Tasks - Ubiquitousを選択します)。
  6. ナビゲーション - デフォルトを受け入れ、「ブレッドクラムの使用」を有効にします。
  7. 「ページの作成」をクリックします。

    ページ・デザイナが表示されます。

    「レンダリング」タブでは、ページ・アイテムPX_SEARCH (Xはページ番号)および「検索結果」リージョンに注意します。PX_SEARCHは、ユーザーが検索文字列を送信できる検索フィールドです。「検索結果」リージョンには、検索結果と、共有コンポーネントに保持されている検索構成にマップされる検索ソースの両方が含まれています。プロパティ・エディタで属性を編集することにより、検索の表示や動作をさらに微調整および制御できます。

  8. ページを実行してテストします。
    1. 「ページの保存と実行」をクリックします。
      検索ページが表示されます。
    2. 検索フィールドに、検索を入力し(例: bug)、[Enter]を押します。

    検索結果が表示されます。


    ubiquitous_run_page.pngの説明が続きます
    図ubiquitous_run_page.pngの説明

親トピック: ユビキタス検索の作成