1. 開発ウォークスルー

チュートリアル: SXAでの入門テンプレートの使用

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

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

大事な

September 2024より前にASP.NET Coreアプリを統合した場合は、従来の ASP.NET CoreレンダリングSDKバージョン22以前が使用されています。このSDKは更新プログラムを受け取らなくなったため、新しい ASP.NET Core SDKの最新バージョンにアップグレードすることをお勧めします。

このチュートリアルでは、SXAで 入門テンプレート を使用する方法について説明します。ヘッドレス サイトのSXAコレクションを使用して、マルチサイト、デザイン、その他のプラットフォーム拡張機能などのSXA機能を有効にできます。

SXAで入門テンプレートを使用するには:

環境を準備する

ヘッドレス サイトのSXAコレクションを作成する前に、環境を設定する必要があります。

環境を準備するには:

  1. init.ps1スクリプトを呼び出すまでは、Getting Startedテンプレートをインストールして実行しますが、up.ps1スクリプトはdo not実行します。その場合は、続行する前にdocker-compose downコマンドと.\docker\clean.ps1スクリプトを実行する必要があります。

  2. Sitecore PowerShell ExtensionsとSXAをコンテナ環境に追加するには、Sitecoreモジュール リファレンスのガイダンスに従ってください。

  3. Visual Studioで、Platform\App_Config\Include\Sites.configファイルを削除します。Visual Studio外部からファイルを削除する場合は、からも削除する必要がありますPlatform.csproj。

  4. コンテナを起動するには、docker-compose up -dを実行します。

  5. src\items\contentフォルダの内容を削除します。

  6. ファイルItems.module.jsonからcontentインクルードを削除します。

    {
    "name": "content",
    "path": "/sitecore/content/MyProject"
},

  7. Sitecoreコマンド ライン インターフェイス (CLI) を使用してログインします。

    dotnet sitecore login --cm https://cm.myproject.localhost/ --auth https://id.myproject.localhost/ --allow-write true

  8. dotnet sitecore ser pushを実行して、サンプル項目をSitecoreインスタンスにプッシュします。

MyProjectソリューションを作成する

この手順では、MyProjectというヘッドレス サイトのSXAコレクションを作成し、SXA機能を有効にします。

大事な

MyProjectというヘッドレス サイトのSXAコレクションを作成し、cm.myproject.localhostホスト名の下にMyProjectというJSSサイトを作成する方法については、SXAの指示に従ってください。残りのSXAオプションはデフォルト値のままにしておくことができます。

MyProjectソリューションを作成するには、次のようにします。

  1. コンテンツ エディターで、/sitecore/Content/MyProject/MyProject/Settingsをクリックし、次の操作を行います。

    • Import userをsitecore\JssImportに設定します。

    • Server side rendering engineをhttpに設定します。

    • Server side rendering engine endpoint URLをhttp://rendering/jss-renderに設定します。

  2. コンテンツ ツリーで /sitecore/Content/MyProjectをクリックし、SecurityタブのPresetsグループでJSS Import - No overwriteをクリックします。[OK]をクリックします。

  3. コンテンツ ツリーで /sitecore/Layout/Layouts/Project/MyProject/Mainをクリックし、ConfigureタブのTemplateグループでChangeをクリックして、テンプレートを /sitecore/Templates/Foundation/JSS Experience Accelerator/Presentation/SXA JSS Layoutに設定します。

  4. 「/sitecore/Templates/Project/MyProject/App Route 」をクリックし、「 Content 」タブの「 Base templates 」フィールドに「 /sitecore/Templates/Project/MyProject/Page」を追加します。

  5. /sitecore/Templates/Project/MyProject/App Route/__Standard Valuesをクリックし、PresentationタブのLayoutグループでDetailsをクリックします。

  6. Layout Detailsダイアログ ボックスで 既定のデバイス レイアウトを編集するには、Editをクリックし、LayoutタブでLayouts/Project/MyProject/Mainを選択し、OKをクリックしてDevice Editorダイアログ ボックスを閉じ、OKをクリックしてLayout Detailsダイアログ ボックスを閉じます。

  7. /sitecore/Layout/Renderings/Project/MyProject/ContentBlockをクリックし、エクスペリエンス エディタ で次のOther propertiesを編集します。

    • IsAutoDatasourceRenderingをtrueの値で加算します。

    • Datasource locationを空に設定します。

  8. /sitecore/Layout/Placeholder Settings/Project/MyProject/MyProject-mainを/sitecore/content/MyProject/MyProject/Presentation/Placeholder Settingsにドラッグします。

  9. MyProject-mainプレースホルダー設定で、許可されたコントロールにRenderings\Project\MyProject\ContentBlockを追加します。

  10. /sitecore/Content/MyProject/MyProject/Homeを選択し、タイトルとバナーを入力します。

  11. /sitecore/content/MyProject/MyProject/Homeを右クリックし、Experience Editorをクリックして、エクスペリエンス エディターでHomeページを開きます。

  12. ページの中央にあるプレースホルダーにContentBlockを追加します。SXAはデータソース アイテムを自動的に作成します。

すべてをパブリッシュし、レンダリング ホストで作業内容を表示します。

アイテムの復元とシリアル化

アイテムを復元およびシリアル化するには:

  1. Items.module.configファイルに含めたcontentを復元します。

    {
  "name": "content",
  "path": "/sitecore/content/MyProject"
},
    メモ

    この手順は、「 環境の準備 」セクションの関連する手順の逆です。

  2. 項目をディスクにシリアル化するには、dotnet sitecore ser pullを実行します。

  3. Content Managementロールを更新するには、Platformプロジェクトを発行します。

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