Ressources web de chaîne (RESX)

Utilisez ces ressources Web pour gérer les chaînes localisées dans n’importe quelle interface utilisateur que vous définissez ou avec des messages d’erreur que vous allez afficher.

Utilisation des ressources Web RESX

Les ressources Web RESX contiennent les valeurs des clés et des chaînes localisées pour une langue unique définie au format RESX XML. RESX est un format commun utilisé pour définir des ressources localisées pour les applications de fenêtre ; il existe donc des outils usuels pour exploiter ce type de fichiers et les prestataires de localisation les connaissent bien. Lorsque le fichier est publié comme une ressource web dans le CRM, il sera converti à un format JSON qui sera chargé dans l’application si nécessaire.

Lorsque vous créez des ressources web RESX, vous devez explicitement définir la valeur de la langue et inclure l’identificateur de langue (LCID) adapté dans le nom de la ressource Web. Par exemple, new_/strings/MyAppResources.1033.resx contient des ressources pour l’anglais. Voir Valeurs d’ID de paramètres régionaux Microsoft pour une liste de valeurs LCID.

Pour extraire la valeur localisée, utilisez la fonction Xrm.Utility.getResourceString. Cette fonction accepte deux paramètres : WebResourceName et keyValue.

Par exemple, Xrm.Utility.getResourceString("new_/strings/MyAppResources","hello") renvoie la valeur de chaîne localisée pour la clé de ressource Hello dans la ressource web new_/strings/MyAppResources.1033.resx si la langue par défaut de l’utilisateur est l’anglais. Notez que la fonction ne référencie aucune langue spécifique ou nom complet d’aucune ressource web RESX. Cette fonctionnalité dépend de la ressource web RESX associée à la ressource web appelante en JavaScript en tant que dépendance. Pour plus d’informations, voir Dépendances des ressources web.

La valeur de chaîne appropriée sera déterminée par la politique de la langue de l’utilisateur individuel et les langues disponibles dans l’organisation. S’il n’est pas possible de trouver une chaîne qui correspond à la politique de la langue de l’utilisateur, la chaîne revient automatiquement dans la langue de base de l’organisation. Si aucune chaîne localisée correspondante n’est détectée pour la langue de base des organisations, une valeur nulle sera retournée.

Voir aussi

Ressources web pour Dynamics 365 Customer Engagement (on-premises)
Créer des ressources web accessibles
Créer des ressources web et du contenu IFrame à utiliser avec les clients Dynamics 365 Customer Engagement (on-premises) pour mobile
Dépendances des ressources web
Ressources web Webpage (HTML)
Ressources web (XAP) Silverlight
Ressources Web de script (JScript)
Ressources web image (JPG, PNG, GIF, ICO)
Ressources web de feuille de style (XSL)
Ressources web de données (XML)
Ressources Web CSS
Messages et méthodes de l’entité WebResource
Exemple : Transmettre plusieurs valeurs à une ressource web via le paramètre de données
Exemple : Importer des fichiers en tant que ressources web
Exemple : utilitaire de ressources web