--- title: "Attributes" slug: "attributes" abstract: "インデックス作成に用いられるコンテンツ属性の概念を説明Sitecore Search。" --- # Attributes Sitecore Searchでは、サイトのすべてのコンテンツがcontent itemsに関する重要な情報を含む *属性* の集合で表現されます。このメタデータは検索の実行、結果の表示、分析の収集に使用されます。特定のアイテムに関する属性の集合を *エンティティ*と呼びます。 あなたのcontent itemsにはすでに、Sitecore Searchが検索結果を最適化・表示するために利用できるデータがあります。ウェブサイトのmetaタグに記載されている情報など、SEO目的で特にタグ付けされたメタデータであるデータもあります。また、h1 HTMLタグのタイトルやPDFの最初の段落から取られた説明など、content item自体に存在するデータもあります。 一部の属性はドメイン*Content*設定時にデフォルトで含まれますが、データをインデックス化するために必要なカスタム属性 [は必ず作成](https://doc.sitecore.com/search/ja/users/search-user-guide/configure-entities/add-an-attribute.html "Add an attribute") する必要があります。属性リストは**Administration**クリック> **Domain Settings** **\> Attributes**で確認できます。 Sitecore Searchが利用可能にしたいすべてのメタデータの属性を作成したら、[ソースを設定し](https://doc.sitecore.com/search/ja/users/search-user-guide/index-items.html "Index items") 、content itemsのメタデータから [属性値を抽出](https://doc.sitecore.com/search/ja/users/search-user-guide/index-items/additional-configurations-and-settings/configuring-document-extractors.html "Configuring document extractors") する方法を設定する必要があります。 > !注属性はすべてのcontent itemに必ずしも必要ありません。 *必須*とマークされている場合を除きます。属性 [を作成](https://doc.sitecore.com/search/ja/users/search-user-guide/configure-entities/add-an-attribute.html "Add an attribute") または [編集](https://doc.sitecore.com/search/ja/users/search-user-guide/configure-entities/edit-an-attribute.html "Edit an attribute") する際に、すべてのcontent itemsに属性が必要かどうか設定できます。 [既存の属性を編集](https://doc.sitecore.com/search/ja/users/search-user-guide/configure-entities/edit-an-attribute.html "Edit an attribute")し、[新しい属性を追加する](https://doc.sitecore.com/search/ja/users/search-user-guide/configure-entities/add-an-attribute.html "Add an attribute")には、属性編集ダイアログを使用します。既存の属性の属性編集ダイアログを開くには、**Attributes**タブのリスト内の属性をクリックします。属性編集ダイアログには、各属性ごとに入力やカスタマイズできるフィールドやオプションがいくつかあります。 ![The attribute editing dialog.](https://doc.sitecore.com/api/markdown-image/search/ja/users/search-user-guide/images/attribute-editing-dialog.png) ## 複合属性 複合属性は、他の属性を含む属性であり、*これらは内部属性*と呼ばれます。複合属性は関連する属性をまとめるために使われます。例えば、Searchは複合属性*rfk\_stats*を用いて、サイト統計に関連する属性をまとめます。 *rfk\_stats*の内部属性は*統計属性*とも呼ばれます。これらは*1日閲覧*、*7日間検索*、*90日間クリック*などのデータを表現しています。 どの属性が合成かは、**Domain Settings**の**Attributes**タブにある属性リストの**Datatype**列を見ることで確認できます。 新しいコンポジット属性は追加できません。既存の内部属性を編集 *できます* 。例えば、[トップビューでソートするオプションを追加](https://doc.sitecore.com/search/ja/users/search-user-guide/refine-search-results/configure-a-sorting-option.html "Configure a sorting option")したい場合など、これができます。 > !注複合属性の内部属性は、表形式リストのcomposite属性をクリックすると表示されます。次に、「 **Inner Attributes**」をクリックします。 ## 動的属性 エンティティのあらゆる可能な属性を定義したくない場合は、動的属性を使うことができます。動的属性は、エンティティに関する動的な情報を含むキーと値のペアの集合です。使い始めるには動的 [属性を作成し](https://doc.sitecore.com/search/ja/users/search-user-guide/configure-entities/attributes/configure-a-dynamic-attribute.html#UUID-4d381142-7c08-761f-6a37-05a24b678d27_section-idm235013529675006 "Create a dynamic attribute") 、[ソースを設定する](https://doc.sitecore.com/search/ja/users/search-user-guide/configure-entities/attributes/configure-a-dynamic-attribute.html#UUID-4d381142-7c08-761f-6a37-05a24b678d27_section-idm23501353341805 "Configure your source")必要があります。 ## 範囲 現在の属性は**、Administration**ページの**Domain Settings**セクションの**Attributes**タブで閲覧できます。属性は表示名順にアルファベット順に表形式のリストに表示されます。リストは*Display Name*および*Attribute Name*で検索可能です。上部の検索バーから。エンティティ**のドロップダウンメニュー**で選択することで、特定のエンティティの属性リストのみに制限できます。 ![Entity and attributes](https://doc.sitecore.com/api/markdown-image/search/ja/users/search-user-guide/images/attr-list.png) このビューの各属性に対して *、スコープ* が表示されます。以下は可能な *スコープ* 値の一覧です。 - *継承済み - 基本* - エンティティの基本属性の集合に含まれています。 - *継承 - 垂直* - エンティティが使用するテンプレートによって定義された属性の集合に含まれます。 - *Overridden* - *Inherited* に含まれている - ベースまたは *Inherited - 縦方向*ですが、その後テック管理者によって編集されます。 - *Local* - 技術管理者によってエンティティに追加された場合。 > !注 [複合属性](https://doc.sitecore.com/search/ja/users/search-user-guide/configure-entities/attributes.html#UUID-f348b6c6-5c2d-7b63-3734-1c65f9f6732a_section-idm4587585184910433726659813053 "Composite attributes") の内部属性は、表形式リストのcomposite属性をクリックすると表示されます。次に、「 **Inner Attributes**」をクリックします。 ## 性質 編集ダイアログで属性プロパティを指定することができます。属性が受け入れられる値の種類を定義するだけでなく、以下のプロパティが表示形式や使用方法を制御します: - *Entity* - 属性が関連付けられるエンティティ。これは*Content*のような標準的なエンティティでも、カスタムエンティティでもよい。 - *Display Name* - UIに表示される属性の記述名。 - *Attribute Name* - 空欄のない英数字属性の名前。アンダースコア(\_)付きの単語を別々に。この名前は、*Return in API response*プロパティが有効であればAPIのレスポンスで使用されます。 > !重要これは [ソース設定](urn:resource:component:1008083)で使う名前と同じです。 - *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応答で返す* - 検索結果に属性とその値を含めるように選択します。 > !重要このプロパティを選択して、検索結果に属性と値を含める必要があります。 - *ルールおよびページのハードフィルターで利用可能* - [ウィジェットルール](https://doc.sitecore.com/search/ja/users/search-user-guide/display-relevant-results/add-or-edit-widget-variations.html "Add or edit widget variations") やページ設定で属性を利用可能にするために選択してください。 - *サイトコンテキストで利用* 可能 - ルールのコンテキストを設定するために属性を使用する選択。 - *クイックView(Sitecore Search年)で利用可能* - Sitecore Searchで[ページをプレビューする](https://doc.sitecore.com/search/ja/users/search-user-guide/display-relevant-results/understanding-context-in-search/preview-a-page-in-context.html "Preview a page in context")際、**クイックビュー**のポップアップウィンドウで属性とそれに関連する値を表示する選択。 - *レシピのランキング用* - カスタムレシピで属性を使う選択 > !注レシピ機能はまだSitecore Searchで利用できません。 - *リクエストコンテキストに含める* - APIリクエストで属性を選択して結果を絞り込みます。 - *ユニークな値の列挙をビルド* する - 該当する場合は自動的に選択されます。 選択すると、Sitecore Searchで利用可能なすべての属性値が利用可能になります。例えば、ルールを作成する際には、入力する代わりに属性値を選択できます。 > !注Request URL設定の*Alias*と *エイリアス* は後方互換性のみのためであり、新しいドメインには関係ありません。 ## データ型とフォーマット Searchで属性を作成する際は、その属性にデータ型を割り当てます。 [属性の値を抽出](https://doc.sitecore.com/search/ja/users/search-user-guide/index-items/additional-configurations-and-settings/configuring-document-extractors.html "Configuring document extractors")する際は、指定されたデータ型に対してSearchが認識する形式で値を抽出することが重要です。 > !重要抽出した属性値が指定されたデータ型と互換性のない形式であれば、Searchはインデックス文書全体を削除し、URLはインデックスされません。 以下の表は、各タイプに対応しているデータ型とフォーマットを示しています。 データ型 受け入れられたフォーマット 整数 標準整数値。例:42 ダブル 標準ダブルバリュー。例:3.14159 整数の配列 標準整数値の配列。例:\[1, 2, 3, 4, 5\] フロート 標準フロート数元数。例:2.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 } \] タイムスタンプ 以下のいずれかの形式での時刻と日付:yyyy-MM-dd HH:mm:ss\['Z'\]例:2023-12-15 08:45:30Zyyyy-MM-dd'T'HH:mm:ss\['Z'\]例:2023-12-15T08:45:30Zyyyy-MM-dd'T'HH:mm:ss.SSSSSSZExample: 2023-12-15T08:45:30.123456Zyyyy-MM-dd例:2023-12-15エポック(秒単位)例:1703078327 ## 検索結果に属性値を含める 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文字列のフォーマット](https://zetcode.com/golang/string-format/) 慣例に従います)。例えば、このフィールドに *「$%.2f」* と入力すると、Searchは数字 *14.5* をドル記号と小数点以下の2桁の文字列に変換し、 *14.50ドル*になります。