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 |
|---|---|---|
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. |
|
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. |
|
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. |
|
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. |
|
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é. |
|
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 :
|
|
Recherche |
Attribut créé lorsqu’une relation d’entité est créée à l’aide du message CreateOneToManyRequest. |
|
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. |
|
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 :
|
|
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. |
|
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. |
|
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. |
|
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 |
|---|---|
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