Personnaliser les Étiquettes pour prendre en charge plusieurs langues

Article
04/19/2023

Lorsque vous créez des personnalisations dans Microsoft Dataverse, vous pouvez prendre en charge plusieurs langues en utilisant des Étiquettes.

Utilisation des Étiquettes

Microsoft.Xrm.Sdk.dll	API web
Classe Label	Label ComplexType
Classe LocalizedLabel	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 ou les options peuvent être stockées dans plusieurs langues. Les utilisateurs peuvent sélectionner la langue d’affichage des formulaires et des vues dans Dataverse.

Le tableau suivant répertorie toutes les définitions de table qui utilisent la classe Label.

Propriété des définitions de la table	Description
AttributeMetadata.Description	Description d’une colonne.
AttributeMetadata.DisplayName	Nom complet d’une colonne.
EntityMetadata.Description	Description d’une table.
EntityMetadata.DisplayCollectionName	Nom complet pluriel d’une table.
EntityMetadata.DisplayName	Nom complet d’une table.
AssociatedMenuConfiguration.Étiquette	Libellé utilisé pour une table dans une relation de table.
OptionMetadata.Étiquette	Libellé utilisé pour une valeur dans une colonne de choix, d’état ou 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 Importer une solution non gérée.

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

Personnaliser les Étiquettes dans la langue de base

Les outils de personnalisation permettent de modifier les noms complets. Vous pouvez personnaliser ces propriétés par programme. Vous pouvez également modifier les messages. 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 table.

Traduire le texte de table et de colonne personnalisé

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.

Exporter 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.

Importer un texte traduit

Après avoir exporté le texte de table ou de colonne 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.

Notes

Dataverse 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’est possible que dans la langue de base. C’est pourquoi vous serez peut-être amené à travailler dans Dataverse avec la langue de base définie comme préférence. Pour vérifier que le texte traduit s’affiche, vous devez changer de langue dans l’interface utilisateur Dataverse. Si vous souhaitez effectuer des personnalisations supplémentaires, vous devez revenir dans la langue de base.

Gérer les langues pour votre organisation

Dataverse 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 Kit de développement logiciel (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 mettre en service une nouvelle langue.	ProvisionLanguage Action	ProvisionLanguageRequest
`RetrieveAvailableLanguages` Récupère la liste des langues disponibles.	RetrieveAvailableLanguages Function	RetrieveAvailableLanguagesRequest
`RetrieveDeprovisionedLanguages` Récupère la liste des modules linguistiques installés sur le serveur qui ont été désactivés.	RetrieveDeprovisionedLanguages Function	RetrieveDeprovisionedLanguagesRequest
`RetrieveInstalledLanguagePacks` Contient les données nécessaires pour récupérer la liste des modules linguistiques installés sur le serveur.	RetrieveInstalledLanguagePacks Function	RetrieveInstalledLanguagePacksRequest
`RetrieveInstalledLanguagePackVersion` Contient les données nécessaires pour récupérer la version d’un module linguistique installé.	RetrieveLicenseInfo Function	RetrieveInstalledLanguagePackVersionRequest
`RetrieveProvisionedLanguages` Récupère la liste des modules linguistiques installés sur le serveur qui sont activés.	RetrieveProvisionedLanguages Function	RetrieveProvisionedLanguagesRequest
`RetrieveProvisionedLanguagePackVersion` Récupère la version des modules linguistiques installés sur le serveur.	RetrieveProvisionedLanguagePackVersion Function	RetrieveProvisionedLanguagePackVersionRequest

Voir aussi

Personnaliser les définitions de table
AttributeMetadata
EntityMetadata
OptionMetadata