Présentation des attributs d'entité dans Microsoft Dynamics 365
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Les entités incluent un ensemble d'attributs qui représentent les données pouvant être incluses dans chaque enregistrement. Les développeurs doivent connaître les différents types d'attributs et savoir les utiliser. Les métadonnées des attributs décrivent les opérations et les comportements valides des différents types d'attributs. Plusieurs types d'attributs peuvent être regroupés par des comportement courants.
L'expérience spécifique des développeurs dépendra du style de leur développement.Pour plus d'informations :0fcf59aa-d564-4c9b-9042-40df8664f831#entity_programming.
Notes
Cette rubrique inclut des références à plusieurs propriétés des métadonnées.Pour afficher les métadonnées d'entité pour votre organisation, installez la solution Navigateur de métadonnées décrite dans l'article Parcourir les métadonnées de votre organisation. Vous pouvez également afficher les métadonnées d'une organisation non personnalisée dans un fichier Excel appelé EntityMetadata.xlsx dans le dossier de niveau supérieur du téléchargement du Kit de développement logiciel (SDK).
Contenu de la rubrique
Opérations valides sur les attributs
Types d'attributs
Attributs de données de catégorisation
Attributs de collection de données
Attribut des données de date et heure.
Attributs des données d'image
Attributs de données de quantité
Attributs des données de référence
Attributs des données de chaîne
Attributs de données d'identificateur unique
Attributs virtuels
Attributs logiques
Opérations valides sur les attributs
Chaque attribut possède des métadonnées qui décrivent les opérations qu'il prend en charge. Vous devez être connaître les opérations valides pour les attributs que vous utilisez.
Propriété AttributeMetadata |
Description |
|---|---|
True si cet attribut est valide pour être défini lorsqu'un enregistrement est créé, sinon false. |
|
True si la valeur de cet attribut peut être récupérée, sinon false. |
|
True si cet attribut est valide pour être défini lorsqu'un enregistrement est mis à jour, sinon false. |
Types d'attributs
Les attributs sont définis dans les métadonnées et la propriété AttributeMetadata.AttributeTypeName contient la valeur décrivant le type. Les membres AttributeTypeDisplayName statiques fournissent la liste des types possibles.
Notes
La propriété AttributeType plus ancienne contient les données qui sont principalement alignées avec AttributeTypeName, sauf qu'elle affiche les attributs ImageType comme Virtual. Utilisez la propriété AttributeTypeName plutôt que la propriété AttributeType.
La section suivante regroupe les types d'attributs en catégories pour que vous puissiez les comparer plus facilement :
Attributs de données de catégorisation
Attributs de collection de données
Attribut des données de date et heure.
Attributs des données d'image
Attributs de données de quantité
Attributs des données de référence
Attributs des données de chaîne
Attributs de données d'identificateur unique
Attributs virtuels
Attributs de données de catégorisation
Chacun des cinq attributs de ce groupe hérite d'une classe de base EnumAttributeMetadata commune et utilise un ensemble prédéfini de valeurs valides pour regrouper les enregistrements en catégories.
Définissez les attributs Picklist, Status et State à l'aide d'un OptionSetValue avec une propriété Value définie sur un entier qui représente une option valide au sein des métadonnées.
Définissez les attributs booléens avec une valeur booléenne, mais sachez qu'il s'agit d'une catégorisation limitée à deux options uniquement.
Les attributs EntityName utilisent une valeur de chaîne contrainte pour être un nom logique d'entité valide dans l'organisation.
Les attributs personnalisés Picklist et Boolean peuvent être définis comme attributs calculés.Pour plus d'informations :26ada6f7-3e22-465c-90f8-19d326785eb4#BKMK_Calculated.
Type de métadonnées |
AttributeTypeName Valeur |
Description |
|---|---|---|
PicklistType |
Les valeurs valides sont définies dans OptionMetadata.Value correspondant à cet attribut défini au sein de OptionSetMetadata.Options. Dans les outils de personnalisation de l'application, ces attributs sont appelés champs duGroupe d’options. |
|
StatusType |
Ces attributs système sont généralement nommés StatusCode. Les valeurs valides sont définies dans StatusOptionMetadata.Value correspondant à cet attribut défini au sein de OptionSetMetadata.Options. La propriété StatusOptionMetadata.State de chaque option décrit la valeur valide pour la valeur StateCode correspondante. Avant de définir StatusCode , vous devez vérifier qu'il est valide pour la valeur StateCode actuelle. Utilisez le message SetStateRequest pour définir les valeurs d'attribut StatusCode et StateCode lorsque vous devez modifier le statut de l'enregistrement. Ces attributs peuvent avoir d'autres restrictions selon lesquelles les valeurs peuvent être définies. La propriété StatusOptionMetadata.TransitionData peut contenir des informations relatives aux options autorisées quand la valeur EntityMetadata.EnforceTransitions est true.Pour plus d'informations :Définir les transitions de modèles d’état personnalisés. |
|
StateType |
Ces attributs système sont généralement nommés StatusCode. Les valeurs valides sont définies dans StateOptionMetadata.Value correspondant à cet attribut défini au sein de OptionSetMetadata.Options. StateCode n'est pas valide pour la mise à jour Une fois l'enregistrement créé, StateCode peut être défini avec le message SetStateRequest. La propriété StateOptionMetadata.DefaultStatus de chaque option décrit le StatusCode par défaut qui sera utilisé s'il n'est pas défini comme paramètre dans SetStateRequest. |
|
BooleanType |
Les attributs booléens peuvent être définis directement avec une valeur booléenne, mais comme les autres ils ont aussi une propriété OptionSet avec les propriétés FalseOption et TrueOption correspondant aux options booléennes. Chacune de ces propriétés définit un ensemble d'étiquettes localisées représentant ce que les valeurs true et false signifient pour l'attribut. Dans les outils de personnalisation de l'application, ces attributs sont appelés champs Deux options, car la signification de chaque option peut être n'importe quelle paire d'options mutuellement exclusives, et pas simplement true et false. Par exemple, les options peuvent être « big » (grand) et « small » (petit). |
|
EntityNameType |
Ces attributs système sont généralement accouplés avec un attribut d'identificateur unique ou de référence valide pour plusieurs types. La valeur de cet attribut est une valeur de chaîne représentant le nom logique d'une entité. Si l'attribut de référence correspondant est EntityReference, la valeur de cet attribut est la même que la valeur de propriété EntityReference.Name. |
Attributs de collection de données
Ces attributs système retournent des collections de valeurs.
Valeur AttributeTypeName |
Description |
|---|---|
CalendarRulesType |
Aucun attribut réel n'utilise CalendarRulesType. Lorsque vous utilisez le style de liaisons anticipée, l'outil de génération de code crée les deux attributs simulés suivants, qui ne sont pas présents dans les métadonnées. Ces attributs représentent réellement une vue des enregistrements des règles du calendrier associée à une relation un-à-plusieurs à l'instance d'entité.
|
PartyListType |
Les attributs suivants permettent de définir plusieurs EntityReference pour différents types d'activités. ActivityPointer.allparties |
Attribut des données de date et heure.
Attributs avec la valeur AttributeTypeName de métadonnées de DateTimeType. Définissez ces attributs avec System.DateTime.
La propriété DateTimeAttributeMetadata.Format peut avoir l'une des valeurs DateTimeFormat suivantes :
DateAndTime : affiche la date et l'heure.
DateOnly : affiche la date uniquement.
Les attributs personnalisés Date et Time peuvent être définis comme attributs calculés ou attributs de report.Pour plus d'informations :Attributs calculés et attributs de report.
Attributs des données d'image
Pour les entités prenant en charge les attributs d'image, le SchemaName de l'attribut d'image de l'entité est toujours EntityImage.
Pour plus d'informations :Attributs d’image, 8597998f-764f-4c73-b63d-9f5e02c78061#BKMK_EntityImages et Exemple : Définir et récupérer des images d’entité.
Attributs de données de quantité
Les attributs de cette catégorie utilisent des données numériques. Chacun de ces attributs possède une propriété de métadonnées MaxValue et MinValue pour définir une plage de valeurs valides.
Les attributs personnalisés Decimal, Integer et Money peuvent être définis comme attributs calculés ou attributs de report.Pour plus d'informations :Attributs calculés et attributs de report.
Type de métadonnées |
Valeur AttributeTypeName |
Description |
|---|---|---|
BigIntType |
Les attributs sont réservés à une utilisation interne uniquement. |
|
DecimalType |
Utilisez les valeurs de type decimal. La propriété de métadonnées Precision définit la précision à utiliser pour l'attribut. |
|
DoubleType |
Utilisez les valeurs de type double. La propriété de métadonnées Precision définit la précision à utiliser pour l'attribut. |
|
IntegerType |
Utilisez les valeurs de type int (entier). |
|
MoneyType |
Utilisez Money qui possède une propriété decimalValue. Chaque attribut Money possède un attribut de devise monétaire de base calculé par le système correspondant et qui est utilisée pour calculer la valeur de la devise de base de l'organisation lorsque plusieurs devises ont été autorisées pour l'organisation. La propriété IsBaseCurrency identifie si l'attribut Money représente la devise de base.Pour plus d'informations :Entité Transaction Currency (devise). Les attributs Money ont également une propriété de métadonnées PrecisionSource qui peut spécifier le niveau de précision à utiliser. La valeur entière de cette propriété détermine si :
|
Attributs des données de référence
Ces attributs sont communément mentionnés comme attributs de recherche et chacun d'eux contient une valeur EntityReference. La différence entre ces attributs concerne les types d'entités auxquels ils peuvent s'associer. La propriété de métadonnées Targets contient un String[] contient des noms logiques d'entité valides représentant les cibles valides pour la recherche. Les attributs de recherche personnalisés peuvent avoir un seul type dans la propriété Targets.
Les PartyListType représentent également un type d'attribut de données de référence, mais comme ils contiennent un ensemble de références, ils sont inclus dans Attributs de collection de données.
Attributs des données de chaîne
Il existe deux types d'attributs qui utilisent les données de chaîne.
Type de métadonnées |
Valeur AttributeTypeName |
Description |
|---|---|---|
StringType |
Un attribut pour une valeur de chaîne à laquelle une mise en forme peut être appliquée.Pour plus d'informations :89969adc-8577-424c-bfcc-7f65c5d4bd19#BKMK_StringAttributeMetadataFormats. Les attributs String personnalisés peuvent être définis comme attributs calculés.Pour plus d'informations :26ada6f7-3e22-465c-90f8-19d326785eb4#BKMK_Calculated. |
|
MemoType |
Un attribut pour une valeur de chaîne conçu pour les notes. Cet attribut est équivalent aux attributs String avec la valeur de propriété FormatName définie sur TextArea. |
Attributs de données d'identificateur unique
Les attributs avec la valeur AttributeTypeName de métadonnées égale à UniqueidentifierType contiennent des valeurs Nullable System.Guid.
Chaque instance d'entité comprend un attribut qui représente l'identificateur unique de l'enregistrement. Cet attribut possède un nom de schéma qui suit la convention d'affectation de noms <nom_schéma_entité> + Id. Par exemple, le nom de schéma de l'entité Account pour l'attribut représentant l'identificateur unique est nommée est AccountId. Cette valeur est aussi directement accessible avec la propriété Entity.Id. Cet attribut est toujours renvoyé lorsque vous récupérez une entité, même si vous ne l'incluez pas dans le ColumnSet d'une requête. Cette valeur est null pour une entité nouvellement instanciée. Même si elle est valide pour spécifier une valeur GUID et définir l'identificateur unique lorsque vous créez un enregistrement, pour des raisons de performances, nous vous recommandons de la laisser comme null et d'autoriser le système à attribuer une valeur quand l'enregistrement est créé. Lorsqu'un enregistrement est enregistré, cette valeur devient en lecture seule.
Les entités peuvent inclure d'autres attributs d'identificateur unique, selon les fonctionnalités de l'entité. Par exemple, les entités activées pour les processus métier contiennent des attributs d'identificateur unique pour ProcessId et StageId afin de suivre le processus métier actif associé à l'enregistrement. Certaines relations système peuvent généralement utiliser une valeur d'EntityReference utilisent à la place un identificateur unique. Par exemple les entités Compte et Contact ont chacune deux attributs d'identificateur unique (Address1_AddressId et Address2_AddressId) qui correspondent aux enregistrements CustomerAddress créés lorsqu'un compte ou un contact est créé.
Attributs virtuels
Les métadonnées d'une entité incluent certains attributs avec la valeur AttributeTypeName de métadonnées de VirtualType. Ces attributs ne peuvent pas être utilisés dans le code.
Attributs logiques
Les attributs logiques contiennent des valeurs stockées dans des tables de base de données différentes de celles des autres attributs de l'entité. Dans la plupart des cas, cette implémentation interne n'est d'aucune utilité dans l'utilisation de Microsoft Dynamics 365. Lorsque vous utilisez des attributs logiques comme source pour un champ calculé, les valeurs de ce champ calculé ne peuvent pas être triées. Utilisez la propriété AttributeMetadata.IsLogical pour détecter si un attribut est un attribut logique.
Les attributs logiques communs sont ceux qui stockent les informations d'adresse dans plusieurs entités spéciales : CompetitorAddressCustomerAddressInternalAddressLeadAddress et PublisherAddress. Il existe 8 entités système qui incluent un ensemble complet d'attributs pour les deux adresses utilisant des attributs logiques. Chacun de ces attributs commence par « Address* », comme Address1_City ou Address2_Latitude.
Voir aussi
Présentation des entités dans Microsoft Dynamics 365
Attributs d’image
Attributs calculés et attributs de report
Exemple : Récupérer les transitions d’état valides
Exemple : Définir et récupérer des images d’entité
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright