JSS辞書API
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
多くの場合、多言語アプリには、翻訳が必要な静的フレーズの辞書が必要です。一般的に、これらはフォーム ラベル、グローバル ナビゲーション アイテム、フッターなどのアイテムです。
Sitecore JavaScriptレンダリングSDK (JSS) は、Sitecoreディクショナリ サービスを使用してアプリケーション固有の翻訳辞書を取得するのに役立つAPIを提供します。
JSSを使用すると、データ取得の実装の詳細を気にすることなく、複数のエンドポイントからディクショナリ データを取得できます。JSS Dictionary APIは、データ取得の実装の詳細を、RESTエンドポイントとGraphQLエンドポイントのサービス、クライアント、およびデータフェッチャーに抽象化します。いくつかの使用例を参照してください。
ディクショナリ データがフロントエンド アプリケーションで利用可能になったら、そのデータの使用方法と、優先する国際化ライブラリを選択できます。たとえば、React JSSアプリケーションは、カスタムプラグインでi18nextモジュールを利用します。
ディクショナリ データのSitecoreエンドポイント
Sitecoreから辞書のフレーズを取得するには、いくつかのオプションがあります。
-
Sitecore Headless Servicesによって提供されるRESTディクショナリ サービス エンドポイントを呼び出します。Sitecoreディクショナリ サービス エンドポイントは、アプリ固有のディクショナリ データを提供するRESTエンドポイントです。
-
ヘッドレス サービスが提供するSitecore Edge Preview GraphQLエンドポイントをクエリします。Sitecore Edge Preview GraphQL APIは、Sitecore上のGraphQLサーバーの実装です。Sitecore GraphQLスキーマは、Experience Edgeスキーマを反映しています。
-
Sitecore Experience Edge for XMが提供するGraphQLエンドポイントをクエリします。Sitecore Experience Edge for XMには、ヘッドレスSitecore開発の一般的なフロントエンドユースケースに対応するように設計された読み取り専用のGraphQLスキーマが付属しています。Experience Edgeスキーマについてお読みください。
-
Sitecore GraphQLエンドポイント (JSS Server Componentsによって導入された初めてのGraphQLエンドポイント) をクエリします。このエンドポイントは現在、React、Angular、およびVueのサンプル アプリケーションversions 18.0.0 and earlierでonly使用されています。
JSSアプリケーションを作成するときに、パラメータ --fetchWith RESTまたは --fetchWith GraphQLを使用して、RESTエンドポイントとGraphQLエンドポイントのどちらを使用するかを選択できます。