Partager via


Personnaliser les métadonnées d’attribut d’entité

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Utilisez la classe AttributeMetadata pour récupérer les attributs existants. Cette classe est retournée par le message RetrieveAttributeRequest. La classe AttributeMetadata hérite de la classe abstraite MetadataBase.

Utilisez la classe spécifique pour chaque type d’attribut avec le message CreateAttributeRequest pour mettre à jour des attributs ou créer des attributs personnalisés.

Notes

Vous pouvez accéder par programme aux attributs personnalisés après les avoir créés, mais vous devez les ajouter à un formulaire d’entité et les publier pour que les utilisateurs puissent les voir.

Types d’attributs

Le tableau suivant répertorie chaque type de Attribute que vous pouvez utiliser. Chaque attribut hérite de la classe AttributeMetadata.

Classe

Étiquette de l’application

Description

BooleanAttributeMetadata

Deux options

Attribut booléen. Vous pouvez spécifier le texte pour les deux options. Une fois ajoutées à un formulaire, les propriété du champ contrôlent si l’attribut s’affiche sous la forme de deux cases d’option, d’une case à cocher ou d’une liste.

DateTimeAttributeMetadata

Date et heure

Attribut de date et heure. Vous pouvez spécifier le comportement permettant de stocker les valeurs de date et d'heure avec ou sans fuseau horaire, ainsi que le format permettant de définir le format d'affichage des valeurs. Pour plus d'informations, voir Comportement et format de l'attribut Date et heure

Notes

Si vous utilisez Mise à jour 1 de Microsoft Dynamics CRM Online 2015 ou Microsoft Dynamics 365 (local), tous les attributs de date et d'heure prendront désormais en charge les valeurs à partir du 01/01/1753 minuit.

DecimalAttributeMetadata

Nombre décimal

Attribut décimal. Vous pouvez spécifier le niveau de précision jusqu’à dix chiffres et les valeurs minimum et maximum de -100 000 000 000 à 100 000 000 000.

DoubleAttributeMetadata

Nombre à virgule flottante

Attribut double. Vous pouvez spécifier le niveau de précision jusqu’à cinq chiffres et les valeurs minimum et maximum de -100 000 000 000 à 100 000 000 000.

Notes

DoubleAttributeMetadata remplace FloatAttributeMetadata utilisé dans Microsoft Dynamics CRM 4.0.

ImageAttributeMetadata

Image

Attribut d’image. Chaque entité peut comporter un attribut d’image. Certaines entités système possèdent des attributs d’image. De nouveaux attributs d’image ne peuvent pas être ajoutés aux entités système qui n’en possèdent pas. Vous pouvez ajouter un attribut d’image à des entités personnalisées

Tous les attributs d’image possèdent « EntityImage » SchemaName et « entityimage » LogicalName. Les attributs d’image n’utilisent pas le préfixe de personnalisation de l’éditeur de solutions dans le nom.Pour plus d'informations :Images d'entité.

IntegerAttributeMetadata

Nombre entier

Attribut de nombre entier. Vous pouvez spécifier les valeurs maximales et minimales entre -2 147 483 648 et 2 147 483 647.

Cet attribut peut être formaté pour créer les types de champs suivants à l’aide de l’énumération IntegerFormat :

  • Durée : affiche une liste déroulante qui contient des intervalles de temps. Un utilisateur peut sélectionner une valeur dans la liste ou taper une valeur entière qui représente le nombre de minutes.

  • Fuseau horaire : affiche une liste déroulante qui contient la liste des fuseaux horaires.

  • Langue : affiche une liste déroulante qui contient la liste des langues qui ont été activées pour l’organisation. Si aucune autre langue n’a été activée, la langue de base est la seule option. La valeur enregistrée est la valeur LCID pour la langue.

LookupAttributeMetadata

Recherche

Attribut créé lorsqu’une relation d’entité est créée à l’aide du message CreateOneToManyRequest.

MemoAttributeMetadata

Plusieurs lignes de texte

Attribut de mémo. S’affiche sous forme de champ de zone de texte dans un formulaire. La longueur maximale est de 1 048 576 caractères.

MoneyAttributeMetadata

Devise

Attribut de devise. Vous pouvez spécifier les valeurs maximales et minimales entre - 922 337 203 685 477 et 922 337 203 685 477.

Le niveau de précision peut être défini à l’aide de la propriété PrecisionSource :

  • Lorsque la précision est définie sur zéro (0), la valeur MoneyAttributeMetadata.Precision est utilisée.

  • Lorsque la précision est définie sur un (1), la valeur Organization.PricingDecimalPrecision est utilisée.

  • Lorsque la précision est définie sur deux (2), la valeur TransactionCurrency.CurrencyPrecision est utilisée.

PicklistAttributeMetadata

Groupe d’options

Attribut de liste de choix. Cet attribut propose un ensemble d’options affichées dans une liste déroulante. Vous pouvez créer l’attribut de liste déroulante afin qu’il puisse contenir ses propres options ou utiliser un groupe d’options globales.

StateAttributeMetadata

Statut 

L’attribut d’état est créé automatiquement lorsque l’entité est créée.

Notes

Les options disponibles pour cet attribut sont en lecture seule.

StatusAttributeMetadata

Raison du statut

L’attribut de statut est créé automatiquement lorsque l’entité est créée. Chacune des options doit être associée à l’attribut StateAttributeMetadata de l’entité. Utilisez le message InsertStatusValueRequest pour mettre à jour les options pour cet attribut.

Notes

Chaque StatusOption doit référencer une valeur d’attribut d’état spécifique car les valeurs de statut dépendent d’une valeur d’état spécifique.

StringAttributeMetadata

Une seule ligne de texte

Pour plus d'informations, consultez Formats StringAttributeMetadata.

Formats StringAttributeMetadata

Les attributs de chaîne peuvent être formatés pour autoriser des liens à lancer des appels téléphoniques via Lync ou Skype. Ce changement exige qu'une nouvelle propriété FormatName soit ajoutée à la classe StringAttributeMetadata et que la propriété Format soit dépréciée.

Notes

Lync a été renommé Skype Entreprise. Actuellement, Microsoft Dynamics 365 contient toujours des références à « Lync », mais Dynamics 365 fonctionne avec Skype Entreprise.

L’utilisation de l’énumération StringFormat pour définir le format de StringAttributeMetadata.Format est obsolète. Au lieu de cela, utilisez la classe StringFormatName pour définir la valeur de StringAttributeMetadata.FormatName.

Cela permet de définir la valeur de format de PhoneNumber, qui n’existe pas dans l’énumération StringFormat.

Pour la compatibilité descendante, vous pouvez définir une valeur pour contrôler la façon dont l’attribut est formaté en utilisant la propriété Format ou la propriété FormatName. Votre code existant continuera à fonctionner si vous utilisez uniquement Format, mais vous ne pourrez pas formater d’attribut sous forme de numéro de téléphone si vous n’utilisez pas FormatName. Si les deux propriétés sont définies, la valeur définie à l’aide de FormatName sera appliquée.

La classe StringFormatName contient les membres suivants ; chaque membre renvoie une chaîne avec la même valeur que le nom du membre :

Nom et valeur du membre

Description

Email

Le champ de formulaire validera la valeur de texte comme adresse e-mail et créera un lien de messagerie dans le champ.

PhoneNumber

Le champ de formulaire contiendra un lien pour lancer des appels téléphoniques via Lync ou Skype.

PhoneticGuide

Utilisation interne uniquement.

Text

Le formulaire affichera une zone de texte.

TextArea

Le formulaire affichera un champ de zone de texte.

TickerSymbol

Le formulaire affichera un lien qui s’ouvrira pour afficher un devis pour le symbole boursier.

URL

Le formulaire affichera un lien pour ouvrir l’URL.

VersionNumber

Utilisation interne uniquement.

Voir aussi

Utiliser le service d'organisation avec des métadonnées Dynamics 365
Utilisation des métadonnées d’attributs
Comportement et format de l'attribut Date et heure
Messages de métadonnées d’attribut d’entité
Exemple : Utilisation des métadonnées d’attributs
Article technique : Utilisation des options de groupe d’options avec le point de terminaison REST - JScript
Exemple : Vidage des métadonnées d’attribut dans un fichier
Exemple : Vider les métadonnées de liste déroulante d’attributs dans un fichier
Exemple : Convertir le comportement de date et d'heure

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright