Recherchez les valeurs de propriété de produit

Les noms de produits peuvent être localisés pour différentes régions. Avec Dynamics 365 Sales, vous pouvez fournir les étiquettes localisées pour certains attributs de produit de telle sorte que les utilisateurs puissent voir les noms localisés qui correspondent à leurs préférences linguistiques. Cette rubrique concerne la façon dont les développeurs peuvent interagir avec cette fonctionnalité. Pour obtenir des instructions détaillées sur l’utilisation de cette fonctionnalité dans l’application, voir la documentation des versions précédentes sur Traduction des noms et propriétés de produits dans plusieurs langues.

Attributs qui prennent en charge les valeurs de propriété localisées

La liste suivante contient les attributs qui prennent en charge les valeurs localisables :

• Product.Name

• DynamicProperty.Name

• DynamicPropertyOptionSetItem.DynamicPropertyOptionName

• DynamicPropertyOptionSetItem.DynamicPropertyOptionDescription

  Les classes StringAttributeMetadata et MemoAttributeMetadata contiennent une propriété booléenne IsLocalizable en lecture seule qui est false pour tous les attributs sauf les quatre du tableau précédent.

Extraire les valeurs de propriété localisées

Vous n’avez rien à faire différemment pour récupérer la valeur localisée qui correspond à la préférence de l’utilisateur. Si une valeur localisée existe pour la langue préféré de l’utilisateur, elle sera retournée. Si une valeur localisée n’existe pas, la valeur de la langue de base de l’organisation sera retournée. Ce comportement conserve la compatibilité descendante ; tout le code que vous avez actuellement et qui utilise l’attribut du nom de produit continuera à fonctionner avec les valeurs localisées. Si l’emplacement des valeurs de propriété est incomplet, les utilisateurs peuvent voir des valeurs de langue mixtes.

Pour récupérer les étiquettes localisées d’un attribut localisable spécifique, utilisez le message RetrieveLocLabelsRequest.

Requête utilisant des valeurs localisées

Lorsque vous interrogez des tables avec des conditions à l’aide de valeurs pour les attributs localisés, les conditions sont évaluées avec votre langue par défaut d’abord et sont rétablies à la langue de base s’il n’existe aucune valeur localisée pour cet attribut. Les résultats de la requête pour les valeurs d’attribut localisées sont ceux de votre langue par défaut s’ils existent. Sinon, les résultats utilisent les valeurs de la langue de base.

Créer ou mettre à jour les enregistrements avec attributs localisables

Les enregistrements avec des attributs localisés sont en lecture seule à moins que votre langue par défaut ne soit la langue de base de l’organisation. Vous pouvez uniquement créer des enregistrements avec des valeurs de propriété localisées à l’aide de la langue de base de l’organisation. Si vous mettez à jour la valeur de la langue de base d’un attribut localisable, les valeurs localisées de cet attribut ne sont pas modifiées, sauf si vous effacez la valeur de la langue de base. Si vous définissez la valeur de la langue de base sur null ou comme chaîne vide, toutes les valeurs localisées de cette propriété sont également effacées.

Pour ajouter ou mettre à jour les étiquettes localisées d’un attribut localisé spécifique, utilisez le message SetLocLabelsRequest ou importez les valeurs traduites. Toutes les modifications apportées aux attributs localisables apparaissent dans l’historique d’audit de l’enregistrement. Le LCID (language code identifier) de la valeur localisée trouve apparaît dans l’historique d’audit.

Traduire les attributs localisables

Le processus de localisation des attributs localisables par programmation est similaire au processus utilisé pour traduire les étiquettes de solution localisées. [!INCLUDE[proc_more_information]Traduire le texte de table et de colonne personnalisé

Contrairement à la traduction des valeurs des métadonnées, l’utilisateur exportant et important des valeurs d’attributs localisées n’a pas à avoir le rôle de sécurité administrateur système. Le rôle de sécurité directeur commercial a les privilèges nécessaires pour traduire les attributs localisables. La personne traduisant les valeurs de propriété localisées peut uniquement exporter ces enregistrements auxquels elle a accès pour afficher et mettre à jour ces enregistrements à jour pour lesquels elle a les privilèges de mise à jour.

Pour traduire les attributs localisables par programmation, vous devez d’abord exporter les définitions d’étiquette localisées actives à l’aide de ExportFieldTranslationRequest. Le ExportFieldTranslationResponse. la propriété contient un ExportTranslationFile pour un fichier byte[] pour un fichier crmFieldTranslations.zip contenant un fichier [Content_types].xml et un fichier crmFieldTranslations.xml pouvant être ouvert à l’aide d’Office Excel. La feuille de calcul Étiquettes localisées contient une colonne avec une valeur LCID pour chaque langue mise en service de l’organisation. La colonne avec les valeurs de la langue de base sera renseignée et les colonnes de chaque langue mise en service contiendront toutes les valeurs précédemment localisées. Ce fichier peut être modifié par un traducteur pour fournir les étiquettes localisées des propriétés localisables.

Après la modification du fichier crmFieldTranslations.xml pour fournir les étiquettes localisées, compressez-le avec le fichier [Content_types].xml et définissez ce fichier en tant que propriété TranslationFile de la ImportFieldTranslationRequest.

Modifier les valeurs incluses lors de l’exportation des valeurs de propriété traduites

Les valeurs incluses dans les traductions exportées sont contrôlées par des vues personnalisables associées aux tables prenant en charge les valeurs de propriété localisables. Seule la table produit affiche cette vue dans l’interface utilisateur de personnalisation. Ces vues sont intitulées Exporter les traductions de champ. Le tableau suivant présente le SavedQueryId de ces vues.

Vous pouvez modifier la propriété FetchXml de ces vues pour filtrer toutes les valeurs de propriété d’attribut que vous ne souhaitez pas inclure. Par exemple, vous voudrez peut-être exclure les enregistrements archivés ou inclure uniquement ceux mis à jour après une certaine date.

Surveiller la progression des tâches d’importation de traduction de champ

La table de tâche système contient les vues suivantes pour surveiller la progression des tâches d’importation de traduction de champ :

• Tâches d’importation de traduction de tous les champs

• Tâches d’importation de traduction de champ terminées

• Tâches d’importation de traduction de champ en cours

• Tâches d’importation de traduction de mon champ

• Tâches d’importation de traduction de champ non commencées

  Les conditions suivantes provoqueront des erreurs lors de l’importation de tâches de traduction :

Désinstaller une langue

Les étiquettes localisées fournies pour une langue qui est désinstallée demeurent dans le système afin qu’elles demeurent en place si la langue est réinstallée.

Informations associées

Tables du catalogue de produits
Traduire le texte de table et de colonne personnaliséTraduction des noms et propriétés de produits dans plusieurs langues