Personnaliser les Étiquettes pour prendre en charge plusieurs langues

Lorsque vous créez des personnalisations dans Microsoft Dataverse, vous pouvez prendre en charge plusieurs langues à l’aide d’étiquettes.

Utilisation des Étiquettes

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 affichées aux utilisateurs, telles que les noms d’affichage ou les choix, peuvent être stockées dans plusieurs langues. Les utilisateurs peuvent sélectionner la langue souhaitée dans les formulaires et les affichages dans Dataverse.

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

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 du travail d’importation de la même façon que lors de l’importation d’une solution. Pour plus d’informations, consultez Importer une solution non managée.

Personnaliser les Étiquettes dans la langue de base

Les outils de personnalisation permettent de modifier les noms d’affichage et vous pouvez personnaliser ces propriétés par programmation. Vous pouvez également modifier des 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, consultez Modifier les messages de table système (préversion).

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 à l’aide du ExportTranslation message (Action ou classe ExportTranslationRequest).

Le texte exporté est enregistré sous forme de fichier compressé qui contient un CrmTranslations.xml fichier 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

Une fois que vous avez exporté le texte de table ou de colonne personnalisé et que vous l’avez traduit, vous pouvez importer les chaînes de texte traduites dans l’application web à l’aide du ImportTranslation message (action ou classe ImportTranslationRequest). Le fichier que vous importez doit être un fichier compressé qui contient le CrmTranslations.xml fichier et le [Content_Types].xml fichier tout comme 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.

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.

Voir aussi

Personnaliser les définitions de table
AttributeMetadata
EntityMetadata
OptionMetadata