1. Search user guide

Attributes

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Sitecore Searchでは、サイトのすべてのコンテンツがcontent itemsに関する重要な情報を含む 属性 の集合で表現されます。このメタデータは検索の実行、結果の表示、分析の収集に使用されます。特定のアイテムに関する属性の集合を エンティティと呼びます。

あなたのcontent itemsにはすでに、Sitecore Searchが検索結果を最適化・表示するために利用できるデータがあります。ウェブサイトのmetaタグに記載されている情報など、SEO目的で特にタグ付けされたメタデータであるデータもあります。また、h1 HTMLタグのタイトルやPDFの最初の段落から取られた説明など、content item自体に存在するデータもあります。

一部の属性はドメインContent設定時にデフォルトで含まれますが、データをインデックス化するために必要なカスタム属性 は必ず作成 する必要があります。属性リストはAdministrationクリック> Domain Settings > Attributesで確認できます。

Sitecore Searchが利用可能にしたいすべてのメタデータの属性を作成したら、ソースを設定し 、content itemsのメタデータから 属性値を抽出 する方法を設定する必要があります。

!注属性はすべてのcontent itemに必ずしも必要ありません。 必須とマークされている場合を除きます。属性 を作成 または 編集 する際に、すべてのcontent itemsに属性が必要かどうか設定できます。

既存の属性を編集し、新しい属性を追加するには、属性編集ダイアログを使用します。既存の属性の属性編集ダイアログを開くには、Attributesタブのリスト内の属性をクリックします。属性編集ダイアログには、各属性ごとに入力やカスタマイズできるフィールドやオプションがいくつかあります。

The attribute editing dialog.

複合属性

複合属性は、他の属性を含む属性であり、これらは内部属性と呼ばれます。複合属性は関連する属性をまとめるために使われます。例えば、Searchは複合属性rfk_statsを用いて、サイト統計に関連する属性をまとめます。

rfk_statsの内部属性は統計属性とも呼ばれます。これらは1日閲覧、7日間検索、90日間クリックなどのデータを表現しています。

どの属性が合成かは、Domain SettingsのAttributesタブにある属性リストのDatatype列を見ることで確認できます。

新しいコンポジット属性は追加できません。既存の内部属性を編集 できます 。例えば、トップビューでソートするオプションを追加したい場合など、これができます。

!注複合属性の内部属性は、表形式リストのcomposite属性をクリックすると表示されます。次に、「 Inner Attributes」をクリックします。

動的属性

エンティティのあらゆる可能な属性を定義したくない場合は、動的属性を使うことができます。動的属性は、エンティティに関する動的な情報を含むキーと値のペアの集合です。使い始めるには動的 属性を作成し 、ソースを設定する必要があります。

範囲

現在の属性は**、AdministrationページのDomain SettingsセクションのAttributesタブで閲覧できます。属性は表示名順にアルファベット順に表形式のリストに表示されます。リストはDisplay NameおよびAttribute Nameで検索可能です。上部の検索バーから。エンティティのドロップダウンメニュー**で選択することで、特定のエンティティの属性リストのみに制限できます。

Entity and attributes

このビューの各属性に対して 、スコープ が表示されます。以下は可能な スコープ 値の一覧です。

  • 継承済み - 基本 - エンティティの基本属性の集合に含まれています。
  • 継承 - 垂直 - エンティティが使用するテンプレートによって定義された属性の集合に含まれます。
  • Overridden - Inherited に含まれている - ベースまたは Inherited - 縦方向ですが、その後テック管理者によって編集されます。
  • Local - 技術管理者によってエンティティに追加された場合。

!注 複合属性 の内部属性は、表形式リストのcomposite属性をクリックすると表示されます。次に、「 Inner Attributes」をクリックします。

性質

編集ダイアログで属性プロパティを指定することができます。属性が受け入れられる値の種類を定義するだけでなく、以下のプロパティが表示形式や使用方法を制御します:

  • Entity - 属性が関連付けられるエンティティ。これはContentのような標準的なエンティティでも、カスタムエンティティでもよい。

  • Display Name - UIに表示される属性の記述名。

  • Attribute Name - 空欄のない英数字属性の名前。アンダースコア(_)付きの単語を別々に。この名前は、Return in API responseプロパティが有効であればAPIのレスポンスで使用されます。

    !重要これは ソース設定で使う名前と同じです。

  • Placement - 属性を基盤となるデータ構造に配置すること。現在、Sitecore Searchに利用可能な唯一の選択肢はStandardであり、ドメインに複数のロケージがある場合はLocale。

  • Data Type - 属性のデータ型。データ型を選択した後、オプションで属性のデフォルト値を追加できます。

    !ヒント属性に選ぶデータ型は、その属性が使える特徴に影響します。利用できない特徴は「 Use For Features 」タブでグレーアウトされています。

  • Default Value - 属性のデフォルト値。クローラーが文書内でこの属性の値を見つけられない場合は、デフォルト値が使用されます。

  • Description - 属性の内部ディスクリプタ。この値は属性編集ダイアログでのみ表示されます。

  • Icon - 属性を表すアイコン。

  • Mark as - 属性に対してオンにできるラベル。 Sitecore LearnedとSitecore Computedは内部利用用に予約されています。 Requiredを選択した場合、この属性を持たない文書はインデックスされません。

    • Sitecore Learned**Sitecore Computedは内部使用に予約されています。
    • Requiredを選択した場合、この属性を持たない文書はインデックスされません。
    • Localeチェックボックスを使ってファセットローカライズを有効にしてください。ローカのチェックボックスを選択し、「機能使用」メニューでFacetを選択すると、属性を使って属性の表示テキストを異なる言語向けにカスタマイズできます。

  • Properties - 属性に対してオンにできるさまざまなプロパティ。データ型によっては、これらのオプションの一部が利用できず、グレーアウトされる場合があります。

    以下のリストは、属性の使い方を示しています。新しい属性を作成したり既存の属性を編集したりする際には、その属性を使いたいプロパティを指定できます。

    • API応答で返す - 検索結果に属性とその値を含めるように選択します。

      !重要このプロパティを選択して、検索結果に属性と値を含める必要があります。

    • ルールおよびページのハードフィルターで利用可能 - ウィジェットルール やページ設定で属性を利用可能にするために選択してください。

    • サイトコンテキストで利用 可能 - ルールのコンテキストを設定するために属性を使用する選択。

    • クイックView(Sitecore Search年)で利用可能 - Sitecore Searchでページをプレビューする際、クイックビューのポップアップウィンドウで属性とそれに関連する値を表示する選択。

    • レシピのランキング用 - カスタムレシピで属性を使う選択

      !注レシピ機能はまだSitecore Searchで利用できません。

    • リクエストコンテキストに含める - APIリクエストで属性を選択して結果を絞り込みます。

    • ユニークな値の列挙をビルド する - 該当する場合は自動的に選択されます。

      選択すると、Sitecore Searchで利用可能なすべての属性値が利用可能になります。例えば、ルールを作成する際には、入力する代わりに属性値を選択できます。

!注Request URL設定のAliasと エイリアス は後方互換性のみのためであり、新しいドメインには関係ありません。

データ型とフォーマット

Searchで属性を作成する際は、その属性にデータ型を割り当てます。 属性の値を抽出する際は、指定されたデータ型に対してSearchが認識する形式で値を抽出することが重要です。

!重要抽出した属性値が指定されたデータ型と互換性のない形式であれば、Searchはインデックス文書全体を削除し、URLはインデックスされません。

以下の表は、各タイプに対応しているデータ型とフォーマットを示しています。

データ型

受け入れられたフォーマット

整数

標準整数値。例

ダブル

標準ダブルバリュー。例

.14159

整数の配列

標準整数値の配列。例:[1, 2, 3, 4, 5]

フロート

標準フロート数元数。例

.718

フロート配列

標準的なfloat値の配列です。例:[1.2, 3.4, 5.6]

ブール

標準ブール値。例

ストリング

標準文字列の値。例:「ハロー、ワールド!」

文字列の配列

標準文字列値の配列。例:「apple」「banana」「cherry」

Geo

以下のいずれかの形式での地理的位置:[lon, lat]例: [ -71.34, 41.12 ]"lat, lon"例: "41.12, -71.34" {"lat": , "long": }例: {"lat": 41.12, "lon": -71.34}"geohash" 例: "drm3btev3e86"

Object

JSONオブジェクト。例:{ "name": "Alice", "age": 30 }

オブジェクトの配列

JSONオブジェクトの配列。例:[ { "name": "Bob", "age": 25 }, { "name": "Carol", "age": 28 } ]

タイムスタンプ

以下のいずれかの形式での時刻と日付

HH:mm
['Z']例
08:45
'T'HH:mm
['Z']例:2023-12-15T08:45
'T'HH:mm
.SSSSSSZExample: 2023-12-15T08:45
.123456Zyyyy-MM-dd例
(秒単位)例

検索結果に属性値を含める

APIで属性を返すようにした後、Administration > Domain Settings > Feature Configuration > API応答を設定できます。

属性の「 Return in api response 」チェックボックスを選択するだけで、検索結果にその属性を含めることができます。オプションで、属性値の返還にカスタムフォーマットを設定することもできます。例えば、価格を表すタイプのfloat属性があるとします。この属性の値は 例えば15.6のようなものかもしれません。サイト訪問者に通貨価値として表示するには、文字列に変換し通貨記号を追加すれば、15.60ドルになります。

API応答の属性のタイプ変換は、以下の設定オプションを使って設定します:

  • Conversion type - 属性値を変換するためのデータ型。可能な値は String、 Integer、 Float、 Booleanです。
  • Conversion format - 変換された属性値に使うためのフォーマット( Go文字列のフォーマット 慣例に従います)。例えば、このフィールドに 「$%.2f」 と入力すると、Searchは数字 14.5 をドル記号と小数点以下の2桁の文字列に変換し、 14.50ドルになります。
この記事を改善するための提案がある場合は、 お知らせください!