文字列 (RESX) Web リソース

これらの Web リソースを使用して、任意のユーザー インターフェイスで、定義するまたはエラー メッセージと共に表示するローカライズされた文字列を管理します。

Note

文字列 (RESX) Web リソースは、Dynamics 365 for Customer Engagement アプリ バージョン 9.0 で追加されました。

RESX Web リソースの使用

RESX Web リソースには、RESX XML 形式を使用して定義された単一言語のキーおよびローカライズされた文字列値が含まれます。 RESX XML 形式は Windows アプリケーション用のローカライズされるリソースを定義する一般的な形式で、この種類のファイルを操作するためのツールがあります。ローカライズ ベンダーはこれらの操作に慣れています。 ファイルが CRM で Web リソースとして公開される場合、必要であればアプリケーションにダウンロードされる JSON 形式に変換されます。

RESX Web リソースを作成するときには、言語値を明示的に設定して、Web リソースの名前に適切な言語のロケール ID (LCID) を含める必要があります。 たとえば、new_/strings/MyAppResources.1033.resx には英語のリソースが含まれます。 LCID 値のリストについては、「Microsoft ロケール ID 値」を参照してください。

ローカライズ値を抽出するには、Xrm.Utility.getResourceString 関数を使用します。 この関数は、WebResourceName と keyValue の 2 つのパラメーターを受け入れます。

たとえば、Xrm.Utility.getResourceString("new_/strings/MyAppResources","hello") は、ユーザーの優先言語が英語の場合は、new_/strings/MyAppResources.1033.resx Web リソース内でリソース キーのローカライズされた文字列値 hello を返します。 関数は特定の言語または RESX Web リソースのフル ネームを参照しないことに注意してください。 この機能は、依存関係として呼び出し JavaScript Web リソースに関連付けられている RESX Web リソースに依存します。 詳細情報: Web リソースの依存関係

適切な文字列値は、各ユーザーの言語設定と組織で使用可能な言語によって決まります。 ローカライズされた文字列がユーザーの言語設定と一致しない場合、ローカライズされた文字列が組織の基本言語に自動的にフォールバックします。 組織の基本言語に一致するローカライズされた文字列が見つからない場合、null 値が返されます。

関連項目

Dynamics 365 Customer Engagement (on-premises) の Web リソース
アクセス可能な Web リソースの作成
モバイル クライアント用 Dynamics 365 Customer Engagement (on-premises) で使用する Web リソースと IFrame の内容を作成する
Web リソースの依存関係
Webpage (HTML) の Web リソース
Silverlight (XAP) の Web リソース
スクリプト (JScript) Web リソース
画像 (JPG、PNG、GIF、ICO) の Web リソース
スタイルシート (XSL) Web リソース
データ (XML) Web リソース
CSS Web リソース
Web リソース (WebResource) エンティティのメッセージおよびメソッド
サンプル: データ パラメーターを使用した Web リソースへの複数の値の引き渡し
サンプル: Web リソースとしてファイルをインポート
サンプル: Web リソースのユーティリティ