SXA レイアウト サービスを使ってページを JSON でモデリングする

Current version: 10.1

SXA を使用すると、データを JSON (JavaScript Object Notation) でモデルリングできます。たとえば、モバイル アプリを作成し、このアプリに SXA コンテンツをフィードする場合、ページの JSON コンテンツを編集して、コンテンツを HTML ではなく JSON で出力できます。特別なレンダリングを使用して JSON レイアウトを構築できますが、Web サイトでデフォルトのレンダリングを使用している場合は、SXA レイアウト サービスを使用して、プレースホルダーとデータ ソース アイテムを JSON で返すことができます。

SXA レイアウト サービスは、シリアライザーを使用して JSON コンテンツをレンダリングします。バリアントを使用するすべてのレンダリングには汎用シリアライザーがあり、一部のレンダリングには特定のシリアライザーがあります。設定は、レンダリングの [レイアウト サービス] セクションで確認できます。たとえば、Navigation レンダリングには Navigation シリアライザーがあります。

ページを JSON で表示する

JSON デバイスに切り替えるには:

  1. エクスペリエンス エディターのリボンにある [エクスペリエンス] タブで、[デフォルト]、[JSON] の順にクリックします。

  2. JSON を表示するには、リボンの [エクスペリエンス] タブで、[その他]、[プレビュー] の順にクリックします。

JSON のフラット リストは、ページのツリー構造を表します。たとえば、ページにページ リスト レンダリングが含まれている場合は次のように表示されます。

画像が含まれている場合は次のように表示されます。

注記

Web ページにパーソナライゼーション ルールを適用した場合、これらも JSON で表示されます (特定の条件下でレンダリングを非表示にするルールを追加した場合など)。

検索パラメーターを使用して JSON データをフィルタリングする

URL を介してすべてのページに返される JSON データは、表示・アクセスすることができます。

検索パラメーターを使用して JSON データをフィルタリングする:

  • プレビュー モードで JSON データ検索の呼び出しを行うには、ブラウザーのアドレス バーにクエリ パラメーターを追加します。各クエリは疑問符 "?" で開始し、各クエリ パラメーターはアンパサンド "&" 文字で区切る必要があります。値はコンマで区切られます。

検索はコンポーネント タイプ (sc_filter_name)、プレースホルダー (sc_filter_path)、コンポーネント ID (sc_filter_id) でフィルタリングできます。

例:

検索

説明

RequestResponse
= /home?sc_device=json&sc_filter_path=/leftph/menu

プレースホルダーを基にレンダリングを返します。

RequestResponse
= /home?sc_device=json&sc_filter_id=content,spot1

/home ページからcontentspot1 の ID を持つレンダリングを返します。

RequestResponse
= /home?sc_device=json&sc_filter_name=richtext

/home ページからrichtext タイプのレンダリングを返します。

RequestResponse
= /home?sc_device=json&sc_filter_path=content&sc_filter_name=richtext

/home ページから content プレースホルダーにある richtext タイプのレンダリングを返します。

Do you have some feedback for us?

If you have suggestions for improving this article,