コマースのテナントおよびサイトの足場をカスタマイズする

コンテンツエディターで、更新したい足場計画に行きます。例えば、Storefrontコンポーネントの足場計画を変更するには、/sitecore/System/Settings/Feature/Commerce Experience Accelerator/Storefront Components/Storefront Components Scaffolding Planに行ってください。

足場設計図を右クリックし、「 スクリプト」→「足場計画を編集」をクリックします。

プランで管理される項目はPowerShellスクリプト結果 ダイアログボックスに表示されます。

足場計画エディタ(PowerShellスクリプト結果 ダイアログボックス)では、以下のいずれかのコマンドを使用します。

• View - フィールドおよび関連する値を表示するため。以下の例は、Habitat Catalog Scaffolding Planのカタログ構成ソースアイテムを示しています。 参照値 列は分岐テンプレートノード下の元のフィールド値を示します。 動的価値 列は参照値のトークン化された形を示します。トークン化は相対的なリンクや値を解決するために使われます。

  

• Add - 新しいスナップショットアイテムを追加する。ソースアイテム(ブランチテンプレート内のアイテム)と参照アイテム(サイト内の対応するアイテム)を定義する必要があります。例えば、「 追加 」を使って新しいページを足場に追加します。 「追加」をクリックすると、ソースと参照項目を指定するほか、標準フィールドを含めるか、スナップショットからどのフィールドを含めるか・除外するかを指定するよう促されます。

• Remove - スナップショット項目を削除すること。

• Update Item - 既存のスナップショット項目のフィールドおよび関連値を更新するためです。例えば、ログインページ(参照項目)を変更し、プラン(ソース項目)で新しいバージョンに置き換えたい場合は、Update itemを使用します。

• Update Plan - 既存のプランに含まれる項目を更新すること。 「プランを更新」をクリックすると、プランを更新したいテナントまたはサイトを選択するよう促されます。

• Deploy Plan - 計画内の項目を実行すること、つまり新しいサイトに追加したり、既に存在する場合は置き換えることを意味します。 「Deploy Plan」をクリックすると、プランを展開したいテナントまたはサイトを選択するよう促されます。

コンテンツエディターでsitecore/Content//Storefront/Home/Landing Pagesに行き、ランディングページを右クリックして挿入、テンプレートから、*/sitecore/templates/Project/*に移動して使いたいページテンプレートを選択し、最後に挿入をクリックします。

新しいページをブランチテンプレートにコピーするには、ツリービューで新しいページを右クリックし、「 コピー」「コピー先」をクリックし、/sitecore/Templates/Branches/Project/Commerce Experience Accelerator// Pages/ Pages/Home/Landing Pagesに行き、「 **コピー」**をクリックします。

この新たにコピーした項目のテンプレートを /sitecore/Templates/Branches/Foundation/Commerce Experience Accelerator/Commerce Foundation/Tenant Templates/Pageに変更してください。

新しいページをサイトの足場に追加するには、コンテンツエディターで /sitecore/System/Settings/Project/Commerce Experience Acceleratorに行き、右クリックで 「Storefront Template Scaffolding Plan 」を右クリックし、「 スクリプト」→「Edit Scaffolding Plan」をクリックしてください。

新しいページの場所( Foundation、Feature、またはProjectフォルダ内)はHelix原則によって決まります。

Powershellスクリプト結果ダイアログボックスのリボンメニューで**「追加**」をクリックします。

「 新しいアイテムスナップショットを作成 」ダイアログボックスで、「 ソースアイテム 」フィールドをクリックし、「 ブランチ/プロジェクト/コマース体験アクセラレーター」→「ストアフロント/ページ/ストアフロントページ/ホーム/ランディングページ/」へ進みます。

参照項目欄をクリックし、sitecore/Content/Sitecore/Storefront/Home/Landing Pages/に行って「作成**」をクリックします。

次に新しいサイトを作成すると、その新しいページが自動的にサイトに追加されます。

コンテンツエディターで*sitecore/System/Settings//Project/*へ行ってください。

/sitecore/Templates/Foundation/Commerce Experience Accelerator/Scaffolding/Scaffolding Planテンプレートに基づいて足場計画の定義項目を作成します。

計画に一般的な特徴や目的を示す関連名称を必ず付けてください。以下の例では、デモ足場計画図はCommerce Experience Acceleratorフォルダにあります。

計画展開スクリプトを作成し、/sitecore/System/Modules/PowerShell/Script Library/Commerce Experience Accelerator/Functions/Commerce Site Features/Scriptsフォルダに入れます。

次のコードをプランデプロイメントスクリプトに貼り付けます。

!注コード内の*[ID of Scaffolding plan definition]*を作成したプラン定義項目のIDに置き換えてください。

Import-Function Deploy-ScaffoldingPlan

function Invoke-ModuleScriptBody { CmdletBinding() param( Parameter(Mandatory = $true, Position = 0 ) Item$Tenant,

Parameter(Mandatory = $true, Position = 1 ) Item$TenantTemplates )

begin { Write-Verbose "Cmdlet Invoke-ModuleScriptBody - Begin" }

process { Write-Verbose "Cmdlet Invoke-ModuleScriptBody - Process" $Plan = Get-Item master: -ID ID of Scaffolding plan definition $result = Deploy-ScaffoldingPlan $Plan $Tenant }

end { Write-Verbose "Cmdlet Invoke-ModuleScriptBody - End" } }

足場計画の定義のIDは、以下の画像に示すように展開スクリプトで処理されます。

このアクションの一部にしたい足場計画の下でタイプExecuteScriptの新しい足場アクションを作成するには、モジュールを右クリックして「Insert, Execute Site Script」をクリックします。

次の画像では、新しい足場計画はDemo Scaffolding Moduleと呼ばれ、新しいアクションは 「足場展開計画」と呼ばれています。

ツリービューで足場アクション(例

変更を保存してください。