スターターキットから検索コンポーネントをコピーしてください
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
!重要機能の利用可能性は段階的に展開される一部です。組織ではまだ検索体験機能が見られない場合があります。導入時に環境が導入されると利用可能になります。
SitecoreAIで検索体験の作業を始める前に、最新のスターターキットバージョンを使うか、検索コンポーネントをプロジェクトにコピーする必要があります。
このトピックでは、最新のスターターキットテンプレートから検索コンポーネントをコピーし、自分のSitecoreAIプロジェクトに追加する方法を説明します。
このスターターキットを有効にして新しいプロジェクトを始めたい場合は、source-mainブランチから「フォーク・オブ・スターターズ」リポジトリを作成してください。
!注基礎となる検索機能や、React・Next.jsプロジェクトでの検索実装に関するSearchフックについては、Content SDKのSearch APIを参照してください。
スターターキットから検索コンポーネントを既存のプロジェクトにコピーします
スターターキットmainブランチから、フォルダ構造を変えずに以下の内容をレンダリングホストプロジェクトにコピーしてください:
- Reactコンポーネントとそのサブコンポーネント: /src/components/search-experience/
コンポーネントは追加されると自動的に登録されるため、手動登録は不要です。
著者検索項目のテンプレートを作成する
作成済みデータを保持し、Search Configuration Manager Marketplaceアプリを有効にするSitecoreテンプレートを作成するには:
- 検索経験項目のテンプレートを作成する:
- 例えば、/Templates/Project/<YOUR_PROJECT>/Components/Search Experienceで:Search Experienceを右クリックしてから「新しいテンプレート>挿入」をクリックします。
- 名前を入力し Search Experience 、 Baseテンプレート をデフォルトのままにします(Templates/System/Templates/Standard template)。
- 「次へ」をクリックしてテンプレートの場所を選択してください。現在いるSearch Experienceフォルダを選択します。
- 「次へ」をクリックしてテンプレートを作成します。
- 新たに作成されたテンプレートを選択し、検索ソースIDやコンポーネントで使用されるフィールドマッピングを保存するための Search フィールド(または同名)を追加します。
- Marketplace Typesセクションで「Plugin」に設定してください。
- Source値をSearch Configuration Manager MarketplaceのアプリケーションIDに設定します。これによりコンポーネントインスタンスを編集時にSearch Configuration Managerタブが有効になります。
- 次に、レンダリングパラメータのテンプレートを作成します:
- 例えば、/Templates/Project/<YOUR_PROJECT>/Components/Search Experience/Rendering Parametersで「レンダリングパラメータ」を右クリックして「新しいテンプレート>挿入」をクリックします。
- 名前 Search Experience Parameters を入力し、 Baseテンプレート を /Templates/Foundation/Headless Experience Accelerator/Presentation/Rendering Parameters/Base Rendering Parameters
- 「次へ」をクリックしてテンプレートの場所を選択してください。現在いるRendering Parametersフォルダを選択します。
- 「次へ」をクリックしてテンプレートを作成します。
- 新しく作成されたテンプレートを選択し、 カラムズ フィールドを追加します。これにより、ページビルダー内で設定可能な カラムパラメータ が得られます。
SearchExperienceレンダリングアイテムを作成する
SitecoreAIがどのようにReactコンポーネントをインスタンス化すべきかを説明するレンダリングアイテムを作成すること。
- コンテンツエディターの/sitecore/layout/Renderings/Project/<YOUR_PROJECT>/Search Experienceで、SearchExperienceというレンダリングを作成します。
- パラメータ テンプレート フィールドに、前の手順で作成した Search Experience Parameters パラメータテンプレートを入力します。
- データソースの位置フィールドに、固定パスやクエリを入力します。例えば./ancestor-or-self::*@@templatename='Home'/*@@templatename='Search Experiences'
- Datasourceテンプレートフィールドに、上記で作成したSearch Experienceテンプレートを入力します。
- コンポーネント名欄にSearchExperience、または上で登録した正確な名前を入力してください。
- 「保存」をクリックします。
レンダリングをコンテンツ作成者に提供してください
ページ ビルダーにレンダリング画像を追加し、作者が挿入できるようにするには:
- サイトのホームアイテム(またはサイト定義アイテム)を開きます。
- 「プレゼンテーション」>利用可能なレンダリングをクリックしてください。
- 適切なグループに SearchExperience を追加します。例えば、 コンポーネント > Search。
- 「 保存 」をクリックしてから **「公開」**をクリックします。
検索コンポーネントをプロジェクトにコピーした後、ソース作成に進めます。