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