Personnaliser les étiquettes pour prendre en charge plusieurs langues

Lorsque vous créez des personnalisations dans Dynamics 365 Customer Engagement (on-premises), vous pouvez prendre en charge plusieurs langues en utilisant des étiquettes.

Utilisation des étiquettes

Microsoft.Xrm.Sdk.dll	API Web
Label classe	Label ComplexType
LocalizedLabel classe	LocalizedLabel ComplexType

Les étiquettes sont des chaînes localisées affichées pour les utilisateurs dans les applications clientes. Elles sont implémentées à l’aide de Label (classe Label ComplexType ou Label), qui prend en charge les modules linguistiques. Les chaînes qui s’affichent pour les utilisateurs, comme les noms complets des entités ou les options d’un groupe d’options, peuvent être stockées dans plusieurs langues. Les utilisateurs peuvent sélectionner la langue d’affichage des formulaires et des vues dans Dynamics 365 Customer Engagement (on-premises).

Le tableau suivant répertorie toutes les métadonnées qui utilisent la classe Label.

Propriété de métadonnées	Description
AttributeMetadata.Description	Description d’un attribut.
AttributeMetadata.DisplayName	Nom complet d’un attribut.
EntityMetadata.Description	Description d’une entité.
EntityMetadata.DisplayCollectionName	Nom complet au pluriel d’une entité.
EntityMetadata.DisplayName	Nom complet d’une entité.
AssociatedMenuConfiguration.Label	Étiquette utilisée pour une entité dans une relation d’entité.
OptionMetadata.Label	Étiquette utilisée pour une option d’une liste déroulante, d’un rapport ou d’un attribut de statut.

La classe Label peut stocker une chaîne pour chaque langue installée. Cet ensemble est la propriété LocalizedLabels. Une Étiquette doit toujours être stockée pour la langue de base. Les étiquettes pour les autres langues peuvent être null. Si l’utilisateur souhaite afficher l’interface utilisateur dans une langue et qu’une Étiquette ne dispose pas de chaîne pour cette langue, l’étiquette de la langue de base est utilisée.

Vous pouvez utiliser la propriété UserLocalizedLabel pour récupérer l’étiquette de la langue sélectionnée par l’utilisateur.

Messages à utiliser avec les Étiquettes

Le tableau suivant répertorie les messages qui vous permettent d’utiliser des Étiquettes localisées pour prendre en charge plusieurs langues. Lorsque vous importez des traductions, vous pouvez générer un rapport en fonction de la tâche d’importation de la même manière que lorsque vous importez une solution. Pour plus d’informations, voir Installer ou mettre à niveau une solution.

Message	Opération de l’API web	Assembly du SDK
ExportTranslation Exporte toutes les traductions pour une solution spécifique vers un fichier compressé.	Action ExportTranslation	ExportTranslationRequest
ImportTranslation Importe toutes les traductions depuis un fichier compressé.	Action ImportTranslation	ImportTranslationRequest
RetrieveFormattedImportJobResults Récupère les résultats d’une ImportJob en tant que document XML conçu peut être ouvert avec Office Excel.	Fonction RetrieveFormattedImportJobResults	RetrieveFormattedImportJobResultsRequest
RetrieveLocLabels Récupère les étiquettes localisées pour l’attribut spécifié.	Fonction RetrieveLocLabels	RetrieveLocLabelsRequest
SetLocLabels Définit les étiquettes localisées pour l’attribut spécifié.	Action SetLocLabels	SetLocLabelsRequest

Personnaliser les étiquettes dans la langue de base

Les outils de personnalisation permettent de modifier les noms complets d’une entité. Vous pouvez personnaliser ces propriétés par programme. Vous pouvez également modifier les messages d’entité. Mais tous les messages ne sont pas exposés. Pour rechercher et personnaliser le texte qui apparaît dans l’application, il est également possible d’exporter les traductions, de modifier les valeurs de la langue de base et d’importer à nouveau les traductions. Bien que ce ne soit pas l’objectif prévu de cette fonctionnalité, il s’agit d’une solution prise en charge pour identifier et personnaliser le texte qui apparaît dans l’application. Pour plus d’informations, voir Modifier les messages pour une entité.

Convertir une entité personnalisée et le texte d’un attribut

Vous ne pouvez effectuer de personnalisations dans l’application qu’en utilisant la langue de base. Par conséquent, si vous souhaitez fournir des étiquettes localisées pour ces personnalisations, vous devez exporter le texte des étiquettes pour qu’elles puissent être localisées dans les autres langues activées pour l’organisation.

Exportation d’un texte personnalisé en vue d’une traduction

Vous pouvez exporter les traductions dans l’application web ou en utilisant le message ExportTranslation (classe ExportTranslation Action ou ExportTranslationRequest).

Le texte exporté est enregistré en tant que fichier compressé contenant un fichier CrmTranslations.xml que vous ouvrez à l’aide d’Office Excel. Vous pouvez envoyer ce fichier à un linguiste, à une agence de traduction ou à une société de localisation.

Pour plus d’informations, voir Schémas de référence Office 2003 XML.

Importer un texte traduit

Après avoir exporté le texte d’entité ou d’attribut personnalisé et l’avoir fait traduire, vous pouvez importer les chaînes de texte traduites dans l’application web en utilisant le message ImportTranslation (classe ImportTranslation Action ou ImportTranslationRequest). Le fichier à importer doit être un dossier compressé contenant le fichier CrmTranslations.xml et le fichier [Content_Types].xml tels qu’ils ont été exportés.

Après avoir importé les traductions terminées, le texte personnalisé s’affiche pour les utilisateurs qui travaillent dans les langues dans lesquelles le texte a été traduit.

Note

Dynamics 365 Customer Engagement (on-premises) ne peut pas importer du texte traduit dépassant 500 caractères. Si un des éléments de votre fichier de traductions dépasse 500 caractères, le processus d’importation échoue. Dans ce cas, vérifiez la ligne du fichier à l’origine de l’échec, réduisez le nombre de caractères et réessayez.

La personnalisation n’étant possible que dans la langue de base, vous serez peut-être amené à travailler dans Dynamics 365 Customer Engagement (on-premises) avec la langue de base définie comme préférence de langue. Pour vérifier que le texte traduit s’affiche, vous devez changer de préférence de langue pour l’interface utilisateur de Dynamics 365 Customer Engagement (on-premises). Si vous souhaitez effectuer des personnalisations supplémentaires, vous devez revenir dans la langue de base.

Gérer les langues pour votre organisation

Dynamics 365 Customer Engagement (on-premises) vous permet d’installer plusieurs modules linguistiques sur un serveur et permet à l’utilisateur de sélectionner un module linguistique. Pour plus d’informations sur l’installation des modules linguistiques, voir Activation des langues. Cette section contient des informations sur les messages utilisés pour gérer les langues installées pour votre organisation.

Le tableau suivant répertorie les messages que vous utilisez avec les modules linguistiques. Utilisez ces messages avec la méthode IOrganizationService.Execute.

Message	Opération de l’API web	Assembly du SDK
DeprovisionLanguage Contient les données nécessaires pour annuler la mise en service d’une langue	DeprovisionLanguage Action	DeprovisionLanguageRequest
ProvisionLanguage Contient les données nécessaires pour configurer une nouvelle langue.	ProvisionLanguage Action	ProvisionLanguageRequest
RetrieveAvailableLanguages Récupère la liste des langues disponibles.	Fonction RetrieveAvailableLanguages	RetrieveAvailableLanguagesRequest
RetrieveDeprovisionedLanguages Récupère la liste des modules linguistiques installés sur le serveur qui ont été désactivés.	Fonction RetrieveDeprovisionedLanguages	RetrieveDeprovisionedLanguagesRequest
RetrieveInstalledLanguagePacks Contient les données nécessaires pour récupérer la liste des modules linguistiques installés sur le serveur.	Fonction RetrieveInstalledLanguagePacks	RetrieveInstalledLanguagePacksRequest
RetrieveInstalledLanguagePackVersion Contient les données nécessaires pour récupérer la version d’un module linguistique installé.	Fonction RetrieveLicenseInfo	RetrieveInstalledLanguagePackVersionRequest
RetrieveProvisionedLanguages Récupère la liste des modules linguistiques installés sur le serveur qui sont activés.	Fonction RetrieveProvisionedLanguages	RetrieveProvisionedLanguagesRequest
RetrieveProvisionedLanguagePackVersion Récupère la version des modules linguistiques installés sur le serveur.	Fonction RetrieveProvisionedLanguagePackVersion	RetrieveProvisionedLanguagePackVersionRequest

Voir aussi

Étendre le modèle de métadonnées pour Dynamics 365 Customer Engagement (on-premises)
PersonnaliserDynamics 365 Customer Engagement (on-premises)
Modifier les messages pour une entité
AttributeMetadata
EntityMetadata
OptionMetadata