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