サーバー側レンダリングビューバッグにデータを追加する

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

統合モードでJSSアプリを実行、例えば サーバーサイドでSitecore管理Node.jsレンダリングエンジンを使ってJSSアプリをレンダリングする場合、レンダリングエンジンはJSSアプリケーションのサーバーバンドルから公開されたrenderView関数を呼び出します。

関数署名は次の通りです:

export const renderView = (callback, path, data, viewBag) => { ... }

data引数で関数に渡される主なモデル/データは、ルートおよびコンテキストデータを含むSitecoreレイアウトサービスの出力です。これにより、アプリはREST呼び出しなしで初期化とレンダリングを行い、サーバー側でのレンダリングが可能になります。

サーバー側レンダリングに追加データが必要な場合は、getRenderingEngineViewBagパイプラインを利用して関数のviewBag引数に追加データを入力できます。デフォルトでは、JSSレンダリングされた項目の言語をviewBag.languageとして、アプリケーション用の翻訳辞書をviewBag.dictionaryとして含めて、サーバー側での辞書項目のレンダリングを容易にします。

viewBag論にさらに多くのデータを加えるには、getRenderingEngineViewBagパイプラインを拡張する必要があります。

viewBagの議論にさらにデータを加えると:

  1. Sitecoreソリューションでは、新しいプロセッサを作成します。例えば:

    public class AddExampleData : IGetRenderingEngineViewBagProcessor { public void Process(GetRenderingEngineViewBagArgs args) { // would be accessible in renderView as viewBag.hello args.ViewBag.hello = "world"; } }

  2. SitecoregetRenderingEngineViewBagパイプラインのデフォルトプロセッサではなくカスタムプロセッサAddExampleDataを使用するよう指示します。例えばApp_Config/Include/CustomViewBagPipeline.config設定パッチを作成し、以下の構成を追加します。

  3. JSSアプリケーションでは、追加データを操作することができます。例えば:

    !注引数dataとviewBagに含まれるデータは、JSONシリアライズプロセスを制御するためのJSON文字列です。

    const renderView = (callback, path, data, viewBag) => { data = JSON.parse(data); viewBag = JSON.parse(viewBag);

    //console output server-side will be routed to Sitecore logs console.log(`Hello ${viewBag.hello}`);

    // ... }

この記事を改善するための提案がある場合は、 お知らせください!