検索結果 EVAM カードプロパティのリスト

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:12分
  • アプリケーションの検索結果EVAM (エンティティビューアクションマッピング) カードでこれらのプロパティを変更することで、AI 検索アプリケーションの標準検索結果の外観をカスタマイズできます。

    検索結果 EVAM カードのプロパティの構成については、「 AI 検索 アプリケーションで検索結果のEVAM表示設定を構成する」を参照してください。

    注:
    次のプロパティは、コンポーネントプロパティ値 sn-search-result-evam-card を持つEVAMカードでのみサポートされています。他のコンポーネント値を持つEVAMカードには、これらのプロパティを設定しないでください。
    プロパティ 説明
    アバター URL

    imageTypeアバターに設定されている場合に検索結果カードに表示する画像の URL を定義します。

    • タイプ: 文字列
    • デフォルト値:(値なし)
    注:
    このプロパティのリテラルテキストを指定するには、 プロパティを staticValues オブジェクトに含め、テキストを そのキー 値として指定します。AI 検索インデックス付きフィールドの現在の検索結果の値をこのプロパティに入力するには、フィールド名を値として持つ mappings オブジェクトにプロパティを含めます。AI 検索インデックス付きフィールド名のリストについては、「AI 検索 インデックスフィールド」を参照してください。
    カスタムアイコン
    検索結果カードのカスタムアイコンとして表示する画像 [db_image] テーブルの画像の名前を指定します。指定した場合、 このプロパティは icon プロパティの icon 設定を上書きします。
    注:
    このプロパティは、 imageTypeicon に設定されている場合にのみ効果があります。imageType が他の値に設定されている場合、customIcon 設定は無視されます。

    カスタムアイコン画像のサイズは、24 ピクセル× 24 ピクセルまたは 32 ピクセル× 32 ピクセルである必要があります。

    • タイプ: 文字列
    • デフォルト値:(値なし)
    customIconSize

    customIcon プロパティとして指定された画像のサイズを指定します。指定するサイズは、画像 [db_image] テーブルのカスタムアイコン画像のサイズと一致する必要があります。

    • タイプ: 文字列
    • デフォルト値:24px
    • サポートされている値は次のとおりです。
      • 24px:カスタムアイコン画像を 24 ピクセル× 24 ピクセルのサイズでレンダリングします。
      • 32px:カスタムアイコン画像を 32 ピクセル× 32 ピクセルのサイズでレンダリングします。
    detailLabelOne、detailLabelTwo、detailLabelThree、detailLabelFour、detailLabelFive、detailLabelSix、detailLabelSeven、detailLabelEight、detailLabelNine、および detailLabelTen

    検索結果カードの詳細ラベルと値のペアのラベルコンテンツを定義します。[検索結果] カードには、最大 10 個のラベルと値のペアを表示できます。

    • タイプ: 文字列
    • デフォルト値:(値なし)
    注:
    これらのプロパティのいずれかにリテラルテキストを指定するには、 staticValues オブジェクトにプロパティを含め、テキストを そのキー 値として指定します。これらのプロパティの 1 つに、 AI 検索 インデックス付きフィールドの現在の検索結果の値を入力するには、フィールド名を値として 持つ mappings オブジェクトにプロパティを含めます。AI 検索インデックス付きフィールド名のリストについては、「AI 検索 インデックスフィールド」を参照してください。

    これらのラベルと値のペアの値コンテンツを定義するには、detailValueOne から detailValueTenを参照してください。detailValueOnedetailLabelOne の値を設定し、detailValueTwodetailLabelTwo の値を設定します

    検索結果の詳細が [検索結果] カードにどのように表示されるかの追加構成については、「 detailLabelType」、「 detailLabelSeparator」、および 「detailPosition」を参照してください。

    詳細ラベルセパレーター

    インラインのラベルと値のペアを区切るために使用される文字を定義します。detailLabelTypeinline に設定されている場合にのみ適用されます。

    • タイプ: 文字列
    • デフォルト値:(値なし)
    注:
    このプロパティのリテラルテキストを指定するには、 プロパティを staticValues オブジェクトに含め、テキストを そのキー 値として指定します。AI 検索インデックス付きフィールドの現在の検索結果の値をこのプロパティに入力するには、フィールド名を値として持つ mappings オブジェクトにプロパティを含めます。AI 検索インデックス付きフィールド名のリストについては、「AI 検索 インデックスフィールド」を参照してください。
    detailLabelType

    検索結果カードでラベルと値のペアをレンダリングする方法を定義します。

    • タイプ:選択リスト
    • デフォルト値:インライン
    • サポートされている値は次のとおりです。
    detailPosition
    検索結果カードのサマリーフィールドに対する検索結果詳細のラベルと値のペアが表示される場所を定義します。
    • タイプ:選択リスト
    • デフォルト値:下
    • サポートされている値は次のとおりです。
      • above:検索結果の詳細は、サマリーフィールドの上に表示されます。
      • below:検索結果の詳細が [サマリー] フィールドの下に表示されます。
    detailValueOne、detailValueTwo、detailValueThree、detailValueFour、detailValueFive、detailValueSix、detailValueSeven、detailValueEight、detailValueNine、および detailValueTen

    検索結果カードの詳細ラベルと値のペアの値コンテンツを定義します。[検索結果] カードには、最大 10 個のラベルと値のペアを表示できます。

    • タイプ: 文字列
    • デフォルト値:(値なし)
    注:
    これらのプロパティのいずれかにリテラルテキストを指定するには、 staticValues オブジェクトにプロパティを含め、テキストを そのキー 値として指定します。これらのプロパティの 1 つに、 AI 検索 インデックス付きフィールドの現在の検索結果の値を入力するには、フィールド名を値として 持つ mappings オブジェクトにプロパティを含めます。AI 検索インデックス付きフィールド名のリストについては、「AI 検索 インデックスフィールド」を参照してください。

    これらのラベルと値のペアのラベルコンテンツを定義するには、detailLabelOne から detailLabelTenを参照してください。detailLabelOnedetailValueOne のラベルを設定し、detailLabelTwodetailValueTwo のラベルを設定します。

    検索結果の詳細が [検索結果] カードにどのように表示されるかの追加構成については、「 detailLabelType」、「 detailLabelSeparator」、および 「detailPosition」を参照してください。

    forceNewTab

    [検索結果] カードでリンクを選択したときに、検索結果を新しいブラウザタブで開くか、現在のブラウザタブで開くかを定義します。

    • タイプ:true | false
    • デフォルト値:true
    • サポートされている値は次のとおりです。
      • false:[検索結果] カードでリンクを選択すると、現在のブラウザタブで検索結果が開きます。
      • true:[検索結果] カードでリンクを選択すると、新しいブラウザタブで検索結果が開きます。
    非表示アイコン

    [検索結果] カードのアイコンを表示するか非表示にするかを定義します。

    • タイプ:true | false
    • デフォルト値:false
    • サポートされている値は次のとおりです。
      • false:[検索結果] カードに構成済みのアイコンを表示します。
      • true:検索結果カードにアイコンを表示しません。
    アイコン

    imageTypeicon に設定されている場合に検索結果カードに表示するアイコンを定義します。このアイコンは、 imageTypeimage に設定されていても imageURL 値が指定されていない場合の代替としても表示されます。

    • タイプ: 文字列
    • デフォルト値:(値なし)
    注:
    このプロパティのリテラルテキストを指定するには、 プロパティを staticValues オブジェクトに含め、テキストを そのキー 値として指定します。AI 検索インデックス付きフィールドの現在の検索結果の値をこのプロパティに入力するには、フィールド名を値として持つ mappings オブジェクトにプロパティを含めます。AI 検索インデックス付きフィールド名のリストについては、「AI 検索 インデックスフィールド」を参照してください。

    使用可能なアイコン名のセットについては、ServiceNow® 開発者サイトの「ネクストエクスペリエンスリファレンス」セクションのアイコンギャラリーを参照してください。

    アイコンサイズ

    検索結果カードに表示されるアイコンまたはアバター画像のサイズを定義します。

    • タイプ:選択リスト
    • デフォルト値:xl ( imageTypeicon に設定されている場合) または md ( imageTypeavatar に設定されている場合)
    • サポートされている値は次のとおりです。
      • sm:検索結果カードに小さなアイコンまたはアバター画像を表示します。
      • md:検索結果カードに中サイズのアイコンまたはアバター画像を表示します。
      • lg:検索結果カードに大きなアイコンまたはアバター画像を表示します。
      • xl:検索結果カードに特大のアイコンまたはアバター画像を表示します。
    imageType

    検索結果カードに表示するマーカーのタイプを定義します。

    サポートされている値は次のとおりです。
    • アバター
    • アイコン
    • イメージ
    画像 URL

    imageType画像に設定されている場合に検索結果カードに表示する画像の URL を定義します。

    • タイプ: 文字列
    • デフォルト値:(値なし)
    注:
    このプロパティのリテラルテキストを指定するには、 プロパティを staticValues オブジェクトに含め、テキストを そのキー 値として指定します。AI 検索インデックス付きフィールドの現在の検索結果の値をこのプロパティに入力するには、フィールド名を値として持つ mappings オブジェクトにプロパティを含めます。AI 検索インデックス付きフィールド名のリストについては、「AI 検索 インデックスフィールド」を参照してください。
    まとめ

    検索結果カードのサマリーフィールドの内容を定義します。

    • タイプ: 文字列
    • デフォルト値:(値なし)
    注:
    このプロパティのリテラルテキストを指定するには、 プロパティを staticValues オブジェクトに含め、テキストを そのキー 値として指定します。AI 検索インデックス付きフィールドの現在の検索結果の値をこのプロパティに入力するには、フィールド名を値として持つ mappings オブジェクトにプロパティを含めます。AI 検索インデックス付きフィールド名のリストについては、「AI 検索 インデックスフィールド」を参照してください。
    summaryFontSize

    検索結果カードのサマリーフィールドのフォントサイズを定義します。

    • タイプ:選択リスト
    • デフォルト値:sm
    • サポートされている値は次のとおりです。
      • sm:検索結果カードのサマリーフィールドを小さいフォントサイズで表示します。
      • md:検索結果カードのサマリーフィールドをミディアムフォントサイズで表示します。
      • lg:検索結果カードのサマリーフィールドを大きなフォントサイズで表示します。
      • xl:検索結果カードのタイトルの概要を特大フォントサイズで表示します。
    textHeaderLabelOne、textHeaderLabelTwo、および textHeaderLabelThree

    検索結果カードのテキストヘッダーラベルのコンテンツを定義します。複数のテキストヘッダーラベルを指定すると、パイプ | 文字で区切って表示されます。

    • タイプ: 文字列
    • デフォルト値:(値なし)
    注:
    これらのプロパティのいずれかにリテラルテキストを指定するには、 staticValues オブジェクトにプロパティを含め、テキストを そのキー 値として指定します。これらのプロパティの 1 つに、 AI 検索 インデックス付きフィールドの現在の検索結果の値を入力するには、フィールド名を値として 持つ mappings オブジェクトにプロパティを含めます。AI 検索インデックス付きフィールド名のリストについては、「AI 検索 インデックスフィールド」を参照してください。
    タイトルフォントサイズ

    検索結果カードのタイトルフィールドのフォントサイズを定義します。

    • タイプ:選択リスト
    • デフォルト値:lg
    • サポートされている値は次のとおりです。
      • sm:検索結果カードのタイトルフィールドを小さいフォントサイズで表示します。
      • md:検索結果カードのタイトルフィールドをミディアムフォントサイズで表示します。
      • lg:検索結果カードのタイトルフィールドを大きなフォントサイズで表示します。
      • xl:検索結果カードのタイトルフィールドを特大フォントサイズで表示します。
    titleLabel

    検索結果カードのタイトルフィールドの内容を定義します。

    • タイプ: 文字列
    • デフォルト値:(値なし)
    注:
    このプロパティのリテラルテキストを指定するには、 プロパティを staticValues オブジェクトに含め、テキストを そのキー 値として指定します。AI 検索インデックス付きフィールドの現在の検索結果の値をこのプロパティに入力するには、フィールド名を値として持つ mappings オブジェクトにプロパティを含めます。AI 検索インデックス付きフィールド名のリストについては、「AI 検索 インデックスフィールド」を参照してください。
    useAttachmentViewer

    ドキュメントビューアーを使用して、[検索結果] カードに表示されるグループ化された添付ファイルを折りたたまれた形式で表示するオプション。

    ドキュメントビューアー の詳細については、「Enable Document Viewer」を参照してください。グループ化された添付ファイルの詳細と、[検索結果] カードでの表示方法については、「 添付ファイルの検索結果を親の結果とグループ化する」を参照してください。

    • タイプ:true | false
    • デフォルト値:false
    • サポートされている値は次のとおりです。
      • true: ドキュメントビューアー を使用して、[検索結果] カードから選択した添付ファイルを表示します。
        注:
        インスタンスで ドキュメントビューアー が有効になっていない場合、または検索結果のソーステーブルで有効になっていない場合、[検索結果] カードから添付ファイルを選択すると、添付ファイルを表示できないことを示すメッセージが表示されます。
      • false:検索結果カードから選択した添付ファイルをダウンロードします。