Recherchez les valeurs de propriété de produit

Les noms de produits peuvent être localisés pour différentes régions. En utilisant Dynamics 365 Sales, vous pouvez fournir des étiquettes localisées pour certains attributs de produit afin que les utilisateurs voient les noms localisés qui correspondent à leurs préférences linguistiques. Cet article explique comment 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 pas besoin de faire quoi que ce soit différemment pour récupérer la valeur localisée qui correspond à la préférence de langue de l’utilisateur. Si une valeur localisée existe pour la langue préférée de l’utilisateur, le système le retourne. S’il n’existe pas de valeur localisée, le système retourne la valeur de la langue de base de l’organisation. Ce comportement maintient la compatibilité descendante ; tout code qui utilise actuellement l’attribut product name continue de fonctionner à l’aide de toutes 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.

Interroger à l’aide de valeurs localisées

Lorsque vous interrogez des tables à l’aide de valeurs pour les attributs localisés dans des conditions, le système évalue les conditions en utilisant votre langue préférée en premier. 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 retourné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 localisables sont en lecture seule, sauf si votre langue préférée est 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 langue de base d’un attribut localisable, les valeurs localisées pour cet attribut ne changent pas, sauf si vous effacez la valeur de la langue de base. Si vous définissez la valeur de 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 des étiquettes localisées pour tout attribut localisable spécifique, utilisez le SetLocLabelsRequest message ou importez des 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 de valeurs de métadonnées, l’utilisateur exporte et importe des valeurs d’attribut localisées n’a pas besoin du 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 des attributs localisables par programmation, vous devez d’abord exporter les définitions d’étiquette localisées actuelles à l’aide de ExportFieldTranslationRequest. L’attribut ExportFieldTranslationResponse. ExportTranslationFile propriété contient une byte[] pour un fichier de crmFieldTranslations.zip compressé contenant un fichier [Content_types].xml et un fichier crmFieldTranslations.xml qui peut ê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 langue de base est remplie et les colonnes de chaque langue provisionnée contiennent toutes les valeurs précédemment localisées. Un traducteur peut modifier ce fichier pour fournir des étiquettes localisées pour les propriétés localisables.

Après avoir modifié le fichier crmFieldTranslations.xml pour fournir des étiquettes localisées, compressez-le avec le fichier [Content_types].xml et définissez ce fichier comme TranslationFile propriété du ImportFieldTranslationRequestfichier .

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

Les vues personnalisables associées aux tables qui prennent en charge les valeurs de propriété localisables contrôlent les valeurs incluses dans les traductions exportées. 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 tables des tâches système incluent les vues suivantes, qui permettent de surveiller la progression des tâches d’importation de traduction de champs.

• 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

Le système conserve toutes les étiquettes localisées pour une langue que vous désinstallez. Si vous réinstallez la langue, les étiquettes sont déjà en place.

Informations connexes

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