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

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

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

    注:
    次のプロパティは、コンポーネントプロパティ値 sn-search-result-evam-card を持つEVAMカードでのみサポートされています。他のコンポーネント値を持つEVAMカードには、これらのプロパティを設定しないでください。
    プロパティ 説明
    avatarURL imageTypeavatarに設定されている場合に、検索結果カードに表示する画像の 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 の値を設定し、detailValueTendetailLabelTen まで同様に設定します

    検索結果の詳細を検索結果カードに表示する方法の追加の構成については、detailLabelTypedetailLabelSeparatordetailPosition を参照してください。

    detailLabelSeparator インラインラベルと値のペアを区切るために使用する文字を定義します。detailLabelTypeinline に設定されている場合にのみ適用されます。
    • タイプ:文字列
    • デフォルト値:(値なし)
    注:
    このプロパティのリテラルテキストを指定するには、 プロパティを staticValues オブジェクトに含め、テキストを そのキー 値として指定します。AI 検索インデックス付きフィールドの現在の検索結果の値をこのプロパティに入力するには、フィールド名を値として持つ mappings オブジェクトにプロパティを含めます。AI 検索インデックス付きフィールド名のリストについては、「AI 検索 インデックスフィールド」を参照してください。
    detailLabelType 検索結果カードでラベルと値のペアをレンダリングする方法を定義します。
    • タイプ:選択リスト
    • デフォルト値:インライン
    • サポートされている値は次のとおりです。
      • inline[ラベルと値 (Label-value)] コンポーネントを使用して、ラベルと値のペアをレンダリングします。各ラベルはその値の文字列と同じ行に表示されます。
      • stacked[スタックされたラベル値] コンポーネントを使用してラベルと値のペアをレンダリングし、各ラベルがその値の文字列とは別の行に表示されるようにします。
    detailPosition 検索結果カードのサマリーフィールドに対する検索結果詳細のラベルと値のペアが表示される場所を定義します。
    • タイプ:選択リスト
    • デフォルト値:下
    • サポートされている値は次のとおりです。
      • above:検索結果の詳細がサマリーフィールドの上に表示されます。
      • below:検索結果の詳細がサマリーフィールドの下に表示されます。
    detailValueOne、detailValueTwo、detailValueThree、detailValueFour、detailValueFive、detailValueSix、detailValueSeven、detailValueEight、detailValueNine、および detailValueTen 検索結果カードの詳細ラベルと値のペアの値コンテンツを定義します。検索結果カードには、最大 10 個のラベルと値のペアを表示できます。
    • タイプ:文字列
    • デフォルト値:(値なし)
    注:
    これらのプロパティのいずれかにリテラルテキストを指定するには、 staticValues オブジェクトにプロパティを含め、テキストを そのキー 値として指定します。これらのプロパティの 1 つに、 AI 検索 インデックス付きフィールドの現在の検索結果の値を入力するには、フィールド名を値として 持つ mappings オブジェクトにプロパティを含めます。AI 検索インデックス付きフィールド名のリストについては、「AI 検索 インデックスフィールド」を参照してください。

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

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

    強制新規タブ [検索結果] カードでリンクを選択したときに、検索結果を新しいブラウザタブで開くか、現在のブラウザタブで開くかを定義します。
    • タイプ: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 検索結果カードに表示するマーカーのタイプを定義します。
    サポートされている値は次のとおりです。
    • アバター
    • アイコン
    • イメージ
    imageURL imageTypeimage に設定されている場合に、検索結果カードに表示する画像の 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 検索 インデックスフィールド」を参照してください。
    titleFontSize 検索結果カードのタイトルフィールドのフォントサイズを定義します。
    • タイプ:選択リスト
    • デフォルト値:lg
    • サポートされている値は次のとおりです。
      • sm:検索結果カードのタイトルフィールドを小さいフォントサイズで表示します。
      • md:検索結果カードのタイトルフィールドを中サイズのフォントで表示します。
      • lg:検索結果カードのタイトルフィールドを大きなフォントサイズで表示します。
      • xl:検索結果カードのタイトルフィールドを特大のフォントサイズで表示します。
    titleLabel 検索結果カードのタイトルフィールドの内容を定義します。
    • タイプ:文字列
    • デフォルト値:(値なし)
    注:
    このプロパティのリテラルテキストを指定するには、 プロパティを staticValues オブジェクトに含め、テキストを そのキー 値として指定します。AI 検索インデックス付きフィールドの現在の検索結果の値をこのプロパティに入力するには、フィールド名を値として持つ mappings オブジェクトにプロパティを含めます。AI 検索インデックス付きフィールド名のリストについては、「AI 検索 インデックスフィールド」を参照してください。
    useAttachmentViewer ドキュメントビューアーを使用して、[検索結果] カードに表示されるグループ化された添付ファイルを折りたたまれた形式で表示するオプション。

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

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