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 des étiquettes localisées pour certains attributs de produit afin que les utilisateurs puissent voir les noms localisés qui correspondent à leurs préférences linguistiques. Cet article traite de 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 est retournée. Si une valeur localisée n’existe pas, la valeur de la langue de base de l’organisation est retournée. Ce comportement maintient la compatibilité descendante ; tout code qui utilise actuellement l’attribut de nom de produit continuera à fonctionner avec les valeurs localisées. Si la localisation des valeurs de propriété est incomplète, 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 dont les conditions utilisent des valeurs pour des attributs localisés, les conditions sont évaluées en premier lieu dans la langue de votre choix. S’il n’y a pas de valeurs localisées pour l’attribut, la requête revient à la langue de base. Les résultats de la requête pour les valeurs d’attribut localisées sont renvoyés dans votre langue préférée, s’ils existent. Sinon, les résultats sont renvoyés dans votre 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 pour un attribut localisable, toutes les valeurs localisées pour 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 une chaîne vide, toutes les valeurs localisées pour 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. L’identificateur du code de langue (LCID) pour la valeur localisée 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, il n’est pas nécessaire que l’utilisateur exportant et important des valeurs d’attributs localisées dispose du rôle de sécurité d’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. L’attribut ExportFieldTranslationResponse. La propriété ExportTranslationFile contient un 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 est renseignée et les colonnes pour chaque langue approvisionnée contiennent 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. Seules les tables du produit affichent 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 les enregistrements mis à jour après une certaine date.

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

Les table de tâches système contiennent 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 provoquent des erreurs lors de l’importation de tâches de traduction :

Désinstaller une langue

Les étiquettes localisées fournies pour une langue désinstallée demeurent dans le système afin qu’elles soient disponibles 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