Scribanテンプレート用の埋め込みされたCommerceアイテムとオブジェクト
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
組み込み関数や埋め込みオブジェクト・アイテムを使ってSXA Storefront Scribanテンプレートをカスタマイズできます。
Commerce Foundationレイヤーは、通常のScriban変数と同様に使用可能な埋め込みオブジェクトをScribanのレンダリングコンテキストに注入します。これらの埋め込みオブジェクトは、標準的なURLを使用する場合に特に有用で、以下の図に示すようにStorefrontContextおよびSiteContextのプロパティへのアクセスを提供します。
これらのオブジェクトは、以下のコードを使ってScribanテンプレートからアクセスできます。
o_storefrontcontext.is_storefront_site o_sitecontext.current_catalog_item
SXA Storefrontはワイルドカードナビゲーションをサポートしており、これはカタログアイテムの標準URLを扱う際に使われます。抽象化として、現在のカタログアイテムにアクセスしたいときにこのo_sitecontext.current_catalog_itemを使えば、URLにワイルドカードやダイレクトナビゲーションが使われていてもカタログアイテムを解決します。また、現在のアイテムがカタログアイテム(カテゴリや製品)か、通常のページアイテムかを素早く判別することもできます。
埋め込み項目
Sitecoreはアイテム内にコンテンツを保存し、Scribanランタイム内にコンテンツアイテムを埋め込みます。これらのアイテムを使ってフィールドの内容にアクセスしたり、子項目や親オブジェクトを取得してアイテム構造をトラバースできます。 Scribanのコンテキストで埋め込まれたアイテムとオブジェクトを参照してください。
コンテキストオブジェクト
複雑な論理はコンテキストオブジェクトを使って実装できます。これはレンダリング時に有用です:
- 閲覧される状況に応じて異なる内容を選びます。
- 編集者向けの追加データですが、店舗サイトの訪問者には隠しています。
- ページの言語によって異なるテキストが使われています。
以下の表は利用可能なコンテキストオブジェクトを一覧にしています。
コンテキストオブジェクト
種類
価値
o_storefrontcontext
Sitecore。Commerce.XA.Foundation.Common.コンテキスト.IStorefrontContext
現在のストアフロントのプロパティ、設定、設定へのアクセスを可能にするプロパティや設定です。
o_sitecontext
Sitecore。コマース.XA.Foundation.Common。コンテキスト.ISiteコンテキスト
現在のカタログ項目および関連するプロパティ。また、現在のHTTPコンテキストも含んでいます。
o_storefrontcontext
o_storefrontcontextオブジェクトはストアフロントのコンテキストを決定し、コンポーネントがレンダリングされるリクエストに関する情報を含みます。
以下の表はo_storefrontcontextコンテキストオブジェクトのプロパティを示しています。
財産
種類
使用例
背景
Sitecore.Commerce.XA.Foundation.Common. Context. IContext
HttpContextプロパティにアクセスするインターフェースを提供します。
カレントストアフロント
Sitecore.Commerce.XA.Foundation. Common.Models. CommerceStorefront
現在の店舗の跡地を確立しました。
IsStorefrontApiCallResponseContext
ブール値
現在のコンテキストがAJAXコールリクエストかどうかを示します。
IsStorefrontSite
ブール値
現在のサイトが店舗サイトかどうかを示します。
o_sitecontext
o_sitecontextオブジェクトはサイトやページ固有のプロパティへのアクセスを提供し、現在のストアフロントサイトを決定し、カタログ項目およびHTTPコンテキストを解決します。
以下の表は、o_sitecontextコンテキストオブジェクトの注目すべきプロパティを一覧にしています。
財産
種類
使用例
背景
Sitecore。Commerce.XA.Foundation.Common.コンテキスト。IContext。
HttpContextプロパティにアクセスするインターフェースを提供します。
現在のカタログ項目
Sitecore。データ。アイテム。アイテム
ワイルドカード方式を使っていても、現在選択されているカタログアイテムにアクセスできます。
CurrentItem
Sitecore。データ。アイテム。アイテム
現在のコンテキスト項目を取得したり設定したりします。直接ナビゲーションの場合、 CurrentCatalogItemと同じです。
IsCategory
ブール値
CurrentCatalogItemのインスタンスがカテゴリかどうかを示す値が付与されます。
IsProduct
ブール値
CurrentCatalogItemのインスタンスが製品かどうかを示す値が付与されます。
アイテム
System.Collections.IDictionary
Httpリクエストキャッシュアイテムのコレクションへのアクセスを提供します。
UrlContainsCategory
ブール値
現在のURLにカテゴリが含まれているかどうかを判定します。
VirtualFolder
ストリング
サイトの仮想フォルダを入手します