RESX web resources

Artikel
12/16/2022

Use these web resources to manage localized strings in any user interface you define or with error messages you will display.

Using RESX web resources

RESX web resources contain the keys and localized string values for a single language defined using the RESX XML format. RESX is a common format for defining localized resources for windows applications, so there is common tooling available to work with this type of file and localization vendors will be familiar with working with them. When the file is published as a web resource in CRM it will be converted to a JSON format which will be downloaded to the application when needed.

When you create RESX web resources you must explicitly set the language value and include the locale identifier (LCID) for the appropriate language in the name of the web resource. For example, new_/strings/MyAppResources.1033.resx would contain resources for English language. See Microsoft locale ID values for a list of LCID values.

Note

If you have multiple RESX web resources with the same name for multiple languages, ensure there is a localized string value for each resource key.

The appropriate string value will be determined by the individual user’s language preference and the languages available in the organization. This is done in two steps.

Determining the right RESX web resource: If there is a RESX web resource for user’s preferred language, that RESX will be used. If a RESX web resource for user’s preferred language is not found, then the RESX web resource for base language is chosen.
Returning the string value: Within the chosen RESX web resource in Step 1, the string corresponding to the resource key is returned. If the RESX web resource that matches the user’s preferred language does not have the resource key, a null response is returned.

For example, Xrm.Utility.getResourceString("new_/strings/MyAppResources","hello") will return the localized string value for the resource key hello within the new_/strings/MyAppResources.1033.resx web resource if the user’s preferred language is English. If the user’s preferred language is Spanish/Spain, then the localized string value for the resource key hello within the new_/strings/MyAppResources.1034.resx web resource is returned. If there is no resource key hello in new_/strings/MyAppResources.1034.resx web resource, then a null response is returned. You can see that the function doesn’t refer to any specific language or full name of any RESX web resource. This functionality depends on the RESX web resource being associated to the calling JavaScript web resource as a dependency. More information: Web resource dependencies

Delen via

RESX web resources

Using RESX web resources

See also

Feedback

Aanvullende resources