チュートリアル: SXA と開始テンプレートの使用

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

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

このチュートリアルでは、開始テンプレートを SXA で使用する方法を説明します。JSS Tenant を使用して、マルチ サイト、デザイン、その他のプラットフォーム拡張などの SXA 機能を有効にすることができます。

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

環境を準備する

JSS Tenant を作成する前に、環境を設定する必要があります。

環境を準備するには:

  1. "開始" テンプレートをインストールして、init.ps1 スクリプトを起動するまでは実行しますが、up.ps1 スクリプトは実行しません。その場合は、docker-compose down コマンドと .\docker\clean.ps1 スクリプトを実行してから進めてください。

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

  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 のインクルードを削除します。

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

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

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

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

MyProject ソリューションの作成

この手順では、MyProject という JSS Tenant を作成し、SXA 機能を有効にします。

重要

SXA の手順に従って、MyProject という JSS Tenant と MyProject という JSS サイトを cm.myproject.localhost というホスト名の下に作成します。SXA の残りのオプションは既定値のままで構いません。

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

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

    • [ユーザーをインポート] を sitecore\JssImport に設定します。

    • [サーバー サイド レンダリング エンジン] を http に設定します。

    • [サーバー サイド レンダリング エンジン エンドポイント URL] を http://rendering/jss-render に設定します。

  2. コンテンツ ツリーで、/sitecore/Content/MyProject をクリックし、[セキュリティ] タブの [プリセット] グループで、[JSS インポート - 上書きなし] をクリックします。続いて、[OK] をクリックします。

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

  4. /sitecore/Templates/Project/MyProject/App Route をクリックし、[コンテンツ] タブで、"ベース テンプレート" フィールドに /sitecore/Templates/Project/MyProject/Page を追加します。

  5. /sitecore/Templates/Project/MyProject/App Route/__Standard Values をクリックし、[プレゼンテーション] タブの [レイアウト] グループで、[詳細] をクリックします。

  6. [レイアウト詳細] ダイアログ ボックスで、既定のデバイス レイアウトを編集するために [編集] をクリックし、[レイアウト] タブで Layouts/Project/MyProject/Main を選択します。[OK] をクリックして [デバイス エディター] を閉じます。次に [OK] をクリックして、[レイアウト詳細] のダイアログ ボックスを閉じます。

  7. /sitecore/Layout/Renderings/Project/MyProject/ContentBlock をクリックし、エクスペリエンス エディターで、次の [その他のプロパティ] を編集します。

    • true の値を IsAutoDatasourceRendering に追加します。

    • [データソースの場所] を "空" に設定します。

  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 を右クリックし、[エクスペリエンス エディター] をクリックして、エクスペリエンス エディターの Home ページを開きます。

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

すべてをパブリッシュし、レンダリング ホストで仕上がりを確認します。

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

アイテムの復元とシリアル化をするには:

  1. Items.module.config ファイルの content インクルードを復元します。

    RequestResponse
    {
  "name": "content",
  "path": "/sitecore/content/MyProject"
},
    注記

    このステップは、「環境を準備する」セクションにある関連するステップの逆です。

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

  3. Content Management ロールを更新するには、Platform プロジェクトをパブリッシュします。

何かフィードバックはありますか?

この記事を改善するための提案がある場合は、