---
title: "Scribanテンプレート用の組み込みCommerce関数"
slug: "the-embedded-commerce-functions-for-scriban-templates"
abstract: "SXA Storefront特有のScriban機能の概要。"
---
# Scribanテンプレート用の組み込みCommerce関数

[組み込み関数](https://doc.sitecore.com/xp/ja/developers/102/sitecore-experience-commerce/the-embedded-commerce-functions-for-scriban-templates.html "The embedded Commerce functions for Scriban templates")や[埋め込みオブジェクト・アイテム](https://doc.sitecore.com/xp/en/developers/sxa/100/sitecore-experience-accelerator/item-and-field-extensions.html)を使ってSXA Storefront Scribanテンプレートをカスタマイズできます。

## sc\_imagelink

CatalogProductImageオブジェクトから画像URLを取得し、実際の画像への参照を含むパラメータとして取得します。画像自体はメディアライブラリまたはデジタル資産管理システムに保存されます。sc\_imagelink関数は、Commerce Search Resultsレンダリング用の[Scriban](https://doc.sitecore.com/xp/ja/developers/102/sitecore-experience-commerce/customizing-the-commerce-search-results-rendering.html "Customizing the Commerce Search Results rendering")テンプレートや、以下のScribanコードで示されているように、MVCCatalogProductImageオブジェクトを返すプロパティを公開するOrder Linesの[Scriban](https://doc.sitecore.com/xp/ja/developers/102/sitecore-experience-commerce/customizing-the-order-lines-rendering.html "Customizing the Order Lines rendering")テンプレートで使用されます。

<img src="{{ o\_model.master\_product\_image | sc\_imagelink 220 220 }}/>

### パラメータ

パラメータ

種類

オプション

例

目的

productImage

CatalogProductImage

いいえ

カタログ製品画像

実際の画像項目への参照を含みます。これはメディアライブラリ内の画像またはデジタル資産管理システム内の画像です。

width

Int

はい

700

画像のサイズ変更に使いました。

height

Int

はい

700

画像のサイズ変更に使いました。

> !注画像を取得Sitecore DAM時、幅と高さの値は使用されず、将来の使用のために予約されます。

## sc\_xc\_serialize

バックエンドのデータオブジェクトをJSONにシリアライズし、フロントエンドJavaScriptコンポーネントが簡単にデータを消費できるようにします。sc\_xc\_serialize関数は、以下のコードに示されているように、[Scriban](https://doc.sitecore.com/xp/ja/developers/102/sitecore-experience-commerce/customizing-the-free-gift-selection-rendering.html "Customizing the Free Gift Selection rendering")テンプレートのFree Gift Selectレンダリングで使用されます。

{{ # 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で利用できるようにするためで、バックエンドへの呼び出しを省き、パフォーマンスを向上させます。

## sc\_xc\_translate

キーパラメータで指定された入力文字列に従い、コンテンツアイテムのValueフィールドに格納されたテキストを、現在の言語で表示します。各キーの翻訳は *、/sitecore/Commerce/Commerce Control Panel/Storefront Settings/Commerce Terms*にある検索テーブルに保存されます。

sc\_xc\_translate関数の必要な形式は以下の通りです:

sc\_xc\_translate ‘key’ ‘folder’

### パラメータ

パラメータ

種類

オプション

例

目的

key

string

いいえ

Scriban Title

現在の言語に基づいて店舗のCommerce Termsから翻訳を取得するために使われました。

folder

string

はい

Storefront Dictionary Terms

翻訳をサブフォルダに分類し、メンテナンスや検索を容易にするために使用されます。フォルダが指定されていない場合、機能はデフォルトのフォルダ「Storefront Dictionary Terms」(*/sitecore/Commerce/Commerce Control Panel/Storefront Settings/Commerce Terms/Storefront Dictionary Terms*)を参照します。

### 例

以下の例では、関数がCommerce Termsの中から「Storefront Dictionary Terms」というフォルダを探し、Scribanタイトルの値を抽出します。

<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="https://doc.sitecore.com/xp/ja/developers/102/sitecore-experience-commerce/%7B%7Bi/_term.url%7D%7D">
 {{sc\_xc\_translate 'Scriban Title''Storefront Dictionary Terms'}}
 </a>
</div>

この例では、スクリバンタイトルはEN Titleです。

![Example of a Scriban title.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/102/sitecore-experience-commerce/images/ScribanTemplateExample1.png)

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

![Example on the live storefront of the Scriban Title.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/102/sitecore-experience-commerce/images/ScribanTitleExample.png)

以下の例では、関数はScribanタイトルのCommerce Termsを参照します。

<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>