1. 自分の部品を持ってきてください

スターターキットから検索コンポーネントをコピーしてください

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

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

重要

機能の利用可能性は段階的に展開される一環です。あなたの組織はまだ検索体験機能が表示されていないかもしれません。環境が導入された際に利用可能になります。

SitecoreAIで検索体験の作業を始める前に、最新のスターターキットバージョンを使うか、検索コンポーネントをプロジェクトにコピーする必要があります。

このトピックでは、最新のスターターキットテンプレートから検索コンポーネントをコピーし、自分のSitecoreAIプロジェクトに追加する方法を説明します。

このスターターキットを有効にして新しいプロジェクトを始めたい場合は、source-devブランチから「フォーク・オブ・スターター」リポジトリを作成してください。

注記

基礎となる検索機能や、React・Next.jsプロジェクトでの検索実装に関するSearchフックについては、Content SDKのSearch APIをご覧ください。

スターターキットから検索コンポーネントを既存のプロジェクトにコピーします

スターターキットのsearch-devブランチから、フォルダ構造を変えずに以下の内容をレンダリングホストプロジェクトにコピーしてください:

  • Reactコンポーネントとそのサブコンポーネント: /src/components/SearchExperience/

コンポーネントをレンダリングホストに登録してください

Reactコンポーネントを登録して、Page Builderがレンダリングできるようにしたいです。

  1. Openレンダリングホストのコンポーネントレジストリ、通常はsrc/temp/componentFactory.tsかsrc/components/componentFactory.tsです。

  2. コンポーネントをインポートする:

    import SearchExperience from './components/SearchExperience/SearchExperience';

  3. 工場地図に登録してください:

    const components = {  
    // ...  
    SearchExperience,
};
export default components;
重要

SitecoreレンダリングアイテムのComponent Nameは、このエクスポートされたキー(デフォルトでSearchExperience )と正確に一致しなければなりません。名前を変更する場合は、レンダリングアイテムと工場出荷時マップの両方を更新してください。

著者検索項目のテンプレートを作成する

作成済みデータを保持し、Search Configuration Manager Marketplaceアプリを有効にするSitecoreテンプレートを作成するには:

  1. 例えば、検索経験項目のテンプレートを作成し /Templates/Project/<YOUR_PROJECT>/Search/Search Experience。

  2. 検索ソースIDやコンポーネントで使用されるフィールドマッピングを格納するためのSearchフィールド(または同名)を追加します。

  3. Search ExperienceテンプレートでMarketplace Types値をPluginに設定します。

  4. Source値をSearch Configuration Manager MarketplaceアプリケーションIDに設定してください。これにより、コンポーネントインスタンスの編集時にSearch Configuration Managerタブが有効になります。

SearchExperienceレンダリングアイテムを作成する

SitecoreAIがどのようにReactコンポーネントをインスタンス化すべきかを説明するレンダリングアイテムを作成すること。

  1. Content Editorでは /sitecore/layout/Renderings/Project/<YOUR_PROJECT>/Search/SearchExperienceでレンダリングを作成します。

  2. Parameters Template欄に、前の手順で作成したパラメータテンプレートを入力してください。

  3. Datasource Locationフィールドに固定パスまたはクエリを入力します。例えば./ancestor-or-self::*@@templatename='Home'/*@@templatename='Search Experiences'

  4. Datasource Template欄に、上記で作成したSearch経験テンプレートを入力してください。

  5. Component Name欄にSearchExperience、または上で登録した正確な名前を入力してください。

  6. クリックSave。

レンダリングをコンテンツ作成者に提供してください

作者がPage builderに挿入できるようにレンダリング画像を追加するために:

  1. Openあなたのサイトのホームアイテム(またはサイト定義アイテム)。

  2. Presentation > Available Renderingsをクリックしてください。

  3. SearchExperienceを適切なグループに追加してください。例えば、Components > Search。

  4. SaveをクリックしてからPublish。

検索コンポーネントをプロジェクトにコピーした後、ソース作成に進めます。

この記事を改善するための提案がある場合は、 お知らせください!