言語とロケール
ナレッジ・ベースが複数のロケールで使用可能な場合は、ビジネス要件を満たすようにAPIレスポンスのロケールを制御できます。
複数のロケールで使用可能なリソースの場合、次のいずれかのオプションを使用してロケールを指定できます。 一覧表示されているオプションは、優先順位を下げたものです。
- q問合せ(「サポートされている問合せパラメータ」を参照)
ノート:
このオプションは、コンテンツ・リソースにのみ適用されます。 - localeId + localeOverride=true (「カスタムHTTPヘッダー」を参照)
- langpref (リスティング)
- localeIdのみ(「カスタムHTTPヘッダー」を参照)
- ユーザーの優先ナレッジ・ロケール。ロケールがリクエスト内のどこにも指定されておらず、優先ナレッジ・ロケールを持つ認証ヘッダーを介してAPIリクエストに関連付けられたユーザーが存在する場合。
- デフォルトのロケール。ロケールがリクエスト内のどこにも指定されておらず、リクエストが匿名の場合、またはユーザーに優先ナレッジ・ロケールがない場合。 ロケールが1つしかない場合は、デフォルトのロケールを使用するのが最善です。
たとえば、次のURIは、スペイン語(スペイン)ロケールのコンテンツのコレクションを返します:
GET http://<IM_REST_API_HOST>/km/api/latest/content?langpref=es_ES
ただし、次のkmauthtokenヘッダーをlocalIdおよびlocaleOverrideパラメータとともに含めると、レスポンスは優先度の高いためスウェーデン語でコンテンツを持ちます。
{"interfaceId":"1","localeId":"sv_SE","localeOverride": true}
Knowledgeの言語およびロケールの詳細は、ナレッジ管理の実装ガイドのロケールの実装の章を参照してください。
ロケールの指定: 例
次の例は、リクエストでロケールを指定して、Oracle Knowledgeリポジトリからすべてのスペイン語(スペイン)コンテンツ・レコード・オブジェクトを検索できるいくつかの方法を示しています。
curl -X GET "https://<IM_REST_API_HOST>/km/api/latest/content" -u "<username:password>" -H 'Accept: application/json' -H 'Content-Type: application/json' -H 'kmauthtoken: {"localeId":"es_ES","localeOverride":true,"interfaceId":"1"}'curl -X GET "https://<IM_REST_API_HOST>/km/api/latest/content?langpref=es_ES" -u "<username:password>" -H 'Accept: application/json' -H 'Content-Type: application/json'curl -X GET "https://<IM_REST_API_HOST>/km/api/latest/content" -u "<username:password>" -H 'Accept: application/json' -H 'Content-Type: application/json' -H 'kmauthtoken: {"localeId":"es_ES","interfaceId":"1"}'