Recherchez les valeurs de propriété de produit
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Les noms de produits peuvent être localisés pour différentes régions. Avec Microsoft Dynamics 365 (Online et local), 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 Aide et formation : Traduction des noms et propriétés de produits dans plusieurs langues.
Contenu de la rubrique
Attributs qui prennent en charge les valeurs de propriété localisées
Extraire les valeurs de propriété localisées
Requête utilisant des valeurs localisées
Créer ou mettre à jour les enregistrements avec attributs localisables
Traduire les attributs localisables
Désinstaller une langue
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 entités 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.Pour plus d'informations :Convertir une entité personnalisée et le texte d’un attribut
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. La propriété ExportFieldTranslationResponse.ExportTranslationFile contient un byte[] pour un fichier compressé crmFieldTranslations.zip contenant un fichier [Content_types].xml et un fichier crmFieldTranslations.xml qui peuvent être ouverts avec Microsoft 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.
Conseil
Si vous souhaitez effectuer une mise à jour en bloc des seuls noms de la langue de base, vous pouvez également modifier les valeurs de la langue de base.
Après que le fichier crmFieldTranslations.xml a été modifié pour fournir les étiquettes localisées, compressez-le avec le fichier [Content_types].xml et définissez ce fichier comme propriété TranslationFile de 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 entités prenant en charge les valeurs de propriété localisables. Seule l'entité 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.
Entité |
SavedQueryId |
FetchXml par défaut |
|---|---|---|
product |
9cfe2a9f-13c4-e311-8f2e-00155d9d2505 |
<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false"> <entity name="product"> <attribute name="name" /> </entity></fetch> |
dynamicproperty |
4833cf48-1ac4-e311-8f2e-00155d9d2505 |
<fetch version="1.0" output-format="xml-platform" mapping="logical"> <entity name="dynamicproperty"> <attribute name="name" /> </entity></fetch> |
dynamicpropertyoptionsetitem |
d64cce30-1fc4-e311-8f2e-00155d9d2505 |
<fetch version="1.0" output-format="xml-platform" mapping="logical"> <entity name="dynamicpropertyoptionsetitem"> <attribute name="dynamicpropertyoptionname" /> <attribute name="dynamicpropertyoptiondescription" /> </entity></fetch> |
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
L'entité 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 :
Message |
Description |
|---|---|
Avertissement : vous n'avez pas les autorisations en écriture sur une ou plusieurs des lignes spécifiées dans le fichier d'importation pour le classeur {0}, ligne {1}. |
La personne exécutant l'importation peut ne pas disposer des autorisations d'écriture sur une ligne incluse dans le fichier importé. Le traitement des autres lignes se poursuit. |
Avertissement : la chaîne de traduction de la langue de base présente dans la feuille de calcul {0}, ligne {1}, colonne {2}, a la valeur null. |
Une valeur de langue de base ne peut pas être effacée par l'importation de traductions. Le traitement des autres lignes se poursuit. |
Avertissement : le nombre de cellules de la ligne {0} ne correspond pas au nombre de cellules de la ligne 1 de la feuille de calcul {1}. |
Toutes les lignes de la feuille de calcul doivent avoir le même nombre de cellules. Le traitement des autres lignes se poursuit. |
Avertissement : une entité valide a été trouvée dans la feuille de calcul {0}, ligne {1}, colonne A. |
Aucune entité valide dans le système avec un nom dans la feuille de calcul. Le traitement des autres lignes se poursuit. |
Avertissement : un nom de colonne d'objet non valide a été trouvé dans la feuille de calcul {0}, ligne {1}, colonne C. |
Aucun attribut localisable valide dans le système avec un nom dans la feuille de calcul. Le traitement des autres lignes se poursuit. |
Avertissement : un ID d'objet non valide a été trouvé dans la feuille de calcul {0}, ligne {1}, colonne B. |
Aucun enregistrement correspondant dans l'organisation pour l'élément de cette ligne. Le traitement des autres lignes se poursuit. |
Erreur : aucune ligne n'a été détectée dans la feuille de calcul {0}. |
La feuille de calcul à importer est vide. |
Erreur : l'ID d'organisation présent dans la feuille de calcul {0} ne correspond pas à l'ID d'organisation actuel. |
Vous pouvez uniquement des traductions dans la même organisation d’où elles ont été exportées. |
Avertissement : un code de langue non valide a été trouvé dans la feuille de calcul {0}, colonne {1}. | Détails : {2} |
Le LCID de la colonne n'est pas un entier valide ou le module linguistique de la langue n'est pas installé. Les traductions de la colonne sont ignorées. Les valeurs d'ID de paramètres régionaux valides sont disponibles sur la page Tableau des ID de paramètres régionaux (LCID). |
Erreur : un code de langue dupliqué a été trouvé dans la feuille de calcul {0}, colonne {1}. |
Chaque colonne doit avoir un code de langue différent. |
Erreur : fichier de traduction non valide. Le fichier compressé doit contenir les fichiers suivants à sa racine : CrmFieldTranslations.xml, [Content_Types].xml |
Le fichier compressé (zip) à importer doit contenir uniquement les fichiers décrits dans l'erreur. |
Erreur : le fichier de traductions n'est pas valide ou n'est pas conforme au schéma requis. |
Le CrmFieldTranslations.xml file inclus dans le fichier compressé (zip) doit être un fichier qui a été exporté depuis le système et uniquement modifié pour fournir des valeurs localisées. D'autres modifications peuvent rendre le fichier non valide. |
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.
Voir aussi
Entités de catalogue de produits
Convertir une entité personnalisée et le texte d’un attribut
Aide et formation : Traduction des noms et propriétés de produits dans plusieurs langues
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright