フィールド設定

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：15分

    • フィールド設定で、インデックス付きソースからのすべてのレコードの指定されたフィールド (列) のインデックスの動作が制御されます。

    フィールド設定の使用例は次のとおりです。
    • ソーステーブルレコードで見つかったフィールドのテキストインデックス作成または検索機能を無効にします。
    • ソーステーブルのフィールドと AI 検索 インデックスのフィールド間のデフォルトのマッピングを変更します。
    • ソーステーブルレコードの参照フィールドからドット連結することで、参照テーブルフィールドをインデックスに追加します。

    インデックス付きソースのフィールド設定は、そのソースの「フィールド設定とマッピング」関連リストに表示されます。

    インデックス付きソースのフィールド設定の作成

    インデックス付きソースフィールド設定を定義して、ソーステーブルレコードの AI 検索 のコンテンツインデックス作成動作を設定します。

    始める前に

    必要なロール：ais_admin

    このタスクについて

    使用可能なフィールド設定および値の詳細については、「AI 検索 インデックス付きソースフィールド設定のリスト」を参照してください。

    手順

    1. 移動先 すべて > AI 検索 > AI 検索 インデックス > インデックス付きソース.
    2. フィールド設定を定義するインデックス付きソースを開きます。
    3. 「フィールド設定とマッピング」関連リストで、[新規] を選択します。
    4. 「フィールド設定」フォームで、フィールドに記入します。
    5. [送信] を選択します。

    タスクの結果

    新しいフィールド設定が、「フィールド設定とマッピング」関連リストに表示されます。

    次のタスク

    新しいフィールド設定を有効にするには、インデックス付きソースのテーブル全体の再インデックスを実行します。この手順の詳細については、「単一のインデックス付きソースに対して完全なテーブルインデックス作成を実行するか、インデックス再作成を実行する」を参照してください。

    インデックス付きソースの参照されるテーブルフィールドのインデックス作成を有効にする

    ソーステーブルのフィールドによって参照されるテーブルのフィールド値にインデックスを付けるために、インデックス付きソースを構成します。これらのフィールド値のインデックスは、フィルターおよび EVAM の検索結果の構成で使用するために作成することも、検索用に作成することもできます。

    始める前に

    必要なロール：ais_admin

    このタスクについて

    インデックス付きソーステーブルに参照フィールドが含まれている場合、AI 検索 のデフォルトは参照フィールドのインデックス値になりますが、参照するテーブルの他のフィールドには設定されません。これらの参照テーブルの値のインデックスを作成するために、インデックス作成したソーステーブルに dot_walk_fields および searchable_dot_walk_fields フィールドの設定を作成することができます。
    • 検索ソースフィルター、ファセットフィルター、EVAM 検索結果構成で参照テーブルのフィールド値を使用するには、dot_walk_fields フィールド設定を作成します。
    • 参照テーブルのフィールド値を検索可能にするには、searchable_dot_walk_fields フィールド設定を作成します。

    いずれかのフィールド設定の値として、インデックスを作成する参照テーブルフィールドの名前を、カンマ区切りの形式でリストします。たとえば、インデックス付きソーステーブルの [company] フィールドで参照されるテーブルから [name] フィールドと [customer] フィールドにインデックスを付けるには、 [company] フィールドを選択し、値「name、customer」を入力します。

    複数のテーブル間をドット連結するために、ドット区切りの参照フィールドプリフィックスを使用してフィールド名の値を入力できます。たとえば、インデックス付きソーステーブルの [company] 参照フィールドによって参照されるテーブルの [contact] フィールドによって参照されるテーブルの [name] フィールドにインデックスを付けるには、「company.contact.name」という値を入力します。
    注:
    各ドット連結参照レベルで、インデックス作成のパフォーマンスが影響を受けます。必要な場合を除き、マルチレベル参照の使用は避けてください。

    同じ参照フィールドに対して、dot_walk_fields と searchable_dot_walk_fields の両方のフィールド設定を作成できます。

    手順

    1. 移動先 すべて > AI 検索 > AI 検索 インデックス > インデックス付きソース.
    2. 「フィールド設定とマッピング」関連リストで、[新規] を選択します。
    3. 「フィールド設定」フォームに、自社のユースケースに対して示されたフィールド値を入力します。
      • 検索ソースフィルター、ファセットフィルター、および EVAM 検索結果構成に使用する参照テーブルのフィールド値にインデックスを付けるには、 次のフィールド値を入力します。
        フィールド 値
        属性 dot_walk_fields
        フィールド <name of indexed source table reference field that you want to use to dot-walk to another table>
        値

        <comma-separated list of names for fields that you want to index from the referenced table>
      • 参照テーブルのフィールド値を検索可能なテキストとしてインデックス化するには、次のフィールド値を入力します。
        フィールド 値
        属性 searchable_dot_walk_fields
        フィールド <name of indexed source table reference field that you want to use to dot-walk to another table>
        値

        <comma-separated list of names for fields that you want to index from the referenced table>
      注:
      dot_walk_fields および searchable_dot_walk_fields 属性が [属性] 選択リストに表示されない場合は、[フィールド] の選択内容が参照フィールドであることを確認してください。
    4. [送信] を選択します。
      属性と値がフィールドの設定とマッピング関連リストに表示されます。

    AI 検索 インデックス付きソースフィールド設定のリスト

    AI 検索 インデックス付きソースレコードフィールドのインデックス付き動作を調整するには、フィールド設定属性と値を設定します。

    フィールド設定の作成の詳細については、「インデックス付きソースのフィールド設定の作成」を参照してください。

    属性 説明
    dot_walk_fields

    検索ソースフィルター、ファセットフィルター、および EVAM 検索結果構成への使用のために選択した参照フィールドのソーステーブルで、フィールドの参照値と表示値にインデックスを付けます。

    AI 検索 は、参照先テーブルのフィールド値に加えられた変更を反映して、インデックス付きフィールドの値を自動的に更新します。

    検索ソースフィルターの詳細については、「検索ソース」を参照してください。ファセットフィルターの詳細については、「AI 検索 アプリケーション構成のファセットを作成」を参照してください。
    • フィールド：インデックスが付いたソーステーブル内の参照フィールドの名前。
    • タイプ：文字列
    • 値：検索ソースで使用するためのインデックスを付ける参照テーブルフィールドのカンマ区切りリスト
    注:
    このフィールド設定でインデックスを付けたフィールド値は検索できません。参照テーブルのフィールド値に検索用のインデックスを付けるには、searchable_dot_walk_fields フィールド設定を作成します。同じ参照フィールドに対して、dot_walk_fields と searchable_dot_walk_fields の両方のフィールド設定を作成できます。

    インデックス付きソースのフィールドのこの設定の値を変更した場合、その変更は、インデックス付きソースからコンテンツのインデックスを再作成するまで有効になりません。インデックスの再作成の手順については、「単一のインデックス付きソースに対して完全なテーブルインデックス作成を実行するか、インデックス再作成を実行する」を参照してください。
    index_calculated_field

    計算されたフィールド値から検索可能なコンテンツのインデックス作成を有効にするオプション。

    インデックス付きソースに計算フィールドが含まれている場合、その値に正しくインデックスを付けるには、そのフィールドのこのフィールド設定を true に設定する必要があります。フィールド設定値が false または値なしの場合、AI 検索 はコンテンツのインデックス作成時に計算フィールドの値を無視します。
    • フィールド：インデックスが付いたソーステーブル内の計算されたフィールドの名前。(計算されていないフィールドを指定すると、フィールド設定の送信は却下され、警告メッセージが表示されます)。
    • タイプ：ブーリアン
    • 値：
      • true：選択したフィールドから計算されたフィールド値を正しくインデックス化するために、特別な処理を適用する。
      • false：選択したフィールドのフィールド値にインデックスを付けるときに、特別な処理を適用しない。計算されたフィールド値はインデックス化されません。

    インデックス付きソースのフィールドのこの設定の値を変更した場合、その変更は、インデックス付きソースからコンテンツのインデックスを再作成するまで有効になりません。インデックスの再作成の手順については、「単一のインデックス付きソースに対して完全なテーブルインデックス作成を実行するか、インデックス再作成を実行する」を参照してください。
    map_to

    選択したフィールドを、インデックス付きソーステーブルから AI 検索 インデックスフィールドにマッピングします。ソーステーブルのレコードにインデックスを付ける際、AI 検索 は指定されたインデックスフィールドに、選択されたソースフィールドの値を入力します。

    たとえば、ベースシステムの「ナレッジテーブル」というインデックスが付いたソースは、 kb_knowledge.short_description ソースフィールドを title というインデックスフィールドにマッピングします。AI 検索 がナレッジ [kb_knowledge] テーブルのレコードにインデックスを付けると、インデックスが付いたレコードの検索可能なタイトルに、ソースレコードの short_description フィールドの値が入力されます。
    • フィールド：インデックスが付いたソーステーブル内のフィールドの名前。
    • タイプ：文字列
    • 値：選択したフィールドの表示値をマップする AI 検索 フィールドの名前。AI 検索 インデックスフィールドの詳細については、「AI 検索 インデックスフィールド」を参照してください。
    注:
    インデックス付きソースフィールドに対して定義できるのは、map_to フィールド設定の 1 つだけです。同じフィールドに複数の map_to 設定を定義しようとすると、エラーメッセージが表示されます。

    インデックス付きソースのフィールドのこの設定の値を変更した場合、その変更は、インデックス付きソースからコンテンツのインデックスを再作成するまで有効になりません。インデックスの再作成の手順については、「単一のインデックス付きソースに対して完全なテーブルインデックス作成を実行するか、インデックス再作成を実行する」を参照してください。
    no_text_index
    インデックス付きソースのレコードで、選択したフィールドの検索可能コンテンツのインデックス作成を無効にするオプション。
    • フィールド：インデックスが付いたソーステーブル内のフィールドの名前。
    • タイプ：ブーリアン
    • 値：
      • true：選択したフィールドの検索可能なコンテンツのインデックス作成を無効にします。検索とフィルターはフィールドの値とマッチできません。
      • false：選択したフィールドの検索可能なコンテンツのインデックス作成を有効にします。検索とフィルターはフィールドの値とマッチできます。
    • デフォルト値：false

    インデックス付きソースのフィールドのこの設定の値を変更した場合、その変更は、インデックス付きソースからコンテンツのインデックスを再作成するまで有効になりません。インデックスの再作成の手順については、「単一のインデックス付きソースに対して完全なテーブルインデックス作成を実行するか、インデックス再作成を実行する」を参照してください。

    さまざまなフィールドタイプの [no_text_index] オプションの設定に関する カスタマーサービス & サポート ガイドラインについては、Now Support サイトの KB0859922 を参照してください。
    not_searchable
    選択したフィールドのインデックス作成されたコンテンツの検索マッチングを無効にするオプション。
    • フィールド：インデックスが付いたソーステーブル内のフィールドの名前。
    • タイプ：ブーリアン
    • 値：
      • true：選択したフィールドのインデックス作成されたコンテンツの検索マッチングを無効にします。検索はフィールドの値とマッチできません。フィルター (コンテンツセキュリティ、ナビゲーションタブ、ファセットなど) は、フィールドの値とマッチできます。
      • false：選択したフィールドのインデックス作成されたコンテンツの検索マッチングを有効にします。検索とフィルターはフィールドの値とマッチできます。
    • デフォルト値：false
    サポートされている値は次のとおりです。

    インデックス付きソースのフィールドのこの設定の値を変更した場合、その変更は、インデックス付きソースからコンテンツのインデックスを再作成するまで有効になりません。インデックスの再作成の手順については、「単一のインデックス付きソースに対して完全なテーブルインデックス作成を実行するか、インデックス再作成を実行する」を参照してください。
    searchable_dot_walk_fields

    選択した参照フィールドのソーステーブルのフィールドの参照値と表示値を、検索可能なテキストとしてインデックス付けします。

    AI 検索 は、参照先テーブルのフィールド値に加えられた変更を反映してインデックス付きフィールドの値を自動的に更新しません。インデックス付きフィールド値を更新するには、インデックス付きソースにインデックスを付け直す必要があります。この手順の詳細については、「単一のインデックス付きソースに対して完全なテーブルインデックス作成を実行するか、インデックス再作成を実行する」を参照してください。
    • フィールド：インデックスが付いたソーステーブル内の参照フィールドの名前。
    • タイプ：文字列
    • 値：検索可能コンテンツとしてインデックスを付ける参照テーブルフィールドのカンマ区切りリスト
    注:
    このフィールド設定でインデックスを付けたフィールド値は、検索ソースフィルターには使用できません。参照テーブルのフィールド値に検索ソースフィルターで使用するためのインデックスを付けるには、dot_walk_fields フィールド設定を作成します。同じ参照フィールドに対して、dot_walk_fields と searchable_dot_walk_fields の両方のフィールド設定を作成できます。

    インデックス付きソースのフィールドのこの設定の値を変更した場合、その変更は、インデックス付きソースからコンテンツのインデックスを再作成するまで有効になりません。インデックスの再作成の手順については、「単一のインデックス付きソースに対して完全なテーブルインデックス作成を実行するか、インデックス再作成を実行する」を参照してください。
    注:
    フィールド設定は、[適用先 (Applies to)] フィールド値として [列] を持つ AI 検索構成属性 [ais_configuration_attribute] テーブルのレコードです。[適用先] フィールド値として [テーブル] を持つこのテーブルのレコードは インデックス付きソースの属性 です。

    この例では、ベースシステムの「Catalog Item Table」というインデックス付きソースで、カタログアイテム [sc_cat_item] テーブルの [short_description] というフィールド値を、AI 検索 インデックスのインデックス付きレコードに対する [text] フィールドにマッピングする様子を示しています。


    AI 検索ソースがカタログアイテム [sc_cat_item]、属性が map_to、フィールドが short_description、値が text と表示されている [フィールド設定] フォーム。

    検索可能な参照先テーブルのフィールド値のセキュリティ

    searchable_dot_walk_fields フィールド設定で検索用のインデックスを付けられた参照先テーブルのフィールド値をユーザーが検索すると、ユーザー側に表示可能なフィールド値のみが検索結果に表示されます。システムでは、フィールド値のロールベースのアクセス制御リストルール (ACL) を使用して、検索ユーザー側にそのフィールド値を表示できるかどうかを判断します。

    条件ベースまたはスクリプトベースの ACL やユーザー基準がある検索可能な参照先テーブルのフィールド値は、検索結果に表示されません。

    複数のドット連結参照レベルでインデックス付けされた検索可能なフィールド値の場合、システムでは最終的なフィールド値に対してのみロールベースの ACL が考慮されます。たとえば、company.contact.name という参照先テーブルのフィールド値に検索のためのインデックスを付けると、[名前] フィールド値に対するユーザーのアクセスは、[連絡先] フィールド値のロールベース ACL の影響を受けません。

    すべての ACL をバイパスして、ユーザーがすべての検索可能な参照先テーブルフィールド値を検索できるようにするには、glide.ais.query.allow_indexlookup_for_dotwalk システムプロパティを true に設定します。これにより、dot_walk_fields および searchable_dot_walk_fields フィールド設定でインデックス付けされたフィールド値の ACL 評価がバイパスされます。

    ACL のタイプと構成の詳細については、「アクセス制御リストのルール」を参照してください。