Scribanテンプレートの組み込みコマース関数

実際の画像への参照を含むパラメーターとして渡されたCatalogProductImageオブジェクトから画像のURLを取得します。画像自体は、メディアライブラリまたはデジタルアセット管理システムに保存されます。sc_imagelink関数は、Commerce検索結果レンダリングのScribanテンプレートと、次のScribanコードに示すように、注文品目のScribanテンプレートで使用されます。これは、MVCモデルがCatalogProductImageオブジェクトを返すプロパティを公開している場所です。

<img src="{{ o_model.master_product_image | sc_imagelink 220 220 }}/>

バックエンドのデータオブジェクトをJSONにシリアル化して、フロントエンドのJavaScriptコンポーネントがデータを簡単に消費できるようにします。sc_xc_serialize関数は、次のコードに示すように、無料ギフト選択レンダリングのScribanテンプレートで使用されます。

{{ # The hidden <div> element contains serialized data in JSON format. }}
<div class="freegiftselection-data" style="display: none;">
    {{ sc_xc_serialize o_model.free_gift_selections | html.escape }}
</div>

無料ギフト オプションに関するデータは、最初のサーバー側レンダリングの一部としてHTMLマークアップにシリアル化されます。これは、レンダリングに付属するフロントエンドのJavaScriptで使用できるようにするためであり、これにより、データを取得するためにバックエンドを呼び出す必要がなくなり、パフォーマンスが向上します。

コンテンツ・アイテムのValueフィールドに格納されているテキストを、keyパラメーターで指定された入力ストリングと、ページがレンダリングされる現在の言語で返します。各キーの変換は、/sitecore/Commerce/Commerce Control Panel/Storefront Settings/Commerce Termsにあるルックアップテーブルに格納されます。

sc_xc_translate関数に必要な形式は次のとおりです。

sc_xc_translate ‘key’ ‘folder’

例

次の例では、関数はCommerce TermsでStorefront Dictionary Termsというフォルダーを検索し、Scriban Titleの値を抽出します。

RequestResponse

Copy

<div class="product-detail" data-bind="css:{'on-sale':promotion}">
   <span data-bind="text: price" class="product-price"></span>
    <a class="product-link" title="{{displayName}}"href="{{i_term.url}}">
    {{sc_xc_translate 'Scriban Title''Storefront Dictionary Terms'}}
    </a>
</div>

この例では、Scriban TitleはEN Titleです。

ライブストアフロントでは、Scriban Titleの値は次のように表示されます。

次の例では、関数はCommerce TermsでScribanタイトルを検索します。

RequestResponse

Copy

<span data-bind="text: price" class="product-price"></span>
    <a class="product-link" title="{{displayName}}"href="{{i_term.url}}">
    {{sc_xc_translate 'Scriban Title'}}
    </a>
</div>