Référence d’entité/de table Dataverse

Utilisez cette référence pour comprendre les opérations disponibles pour des tables spécifiques, les colonnes par défaut de chaque table et les relations entre les tables. Les définitions de table utilisent la classe EntityMetadata.

Cette référence inclut uniquement ces tables où :

• EntityMetadata.IsPrivate Égale false

  Cette condition exclut les tables sans cas d’usage externe.

• EntityMetadata.IsIntersect false est égal ou IsIntersect égal true et la table contient plus de quatre colonnes.

  La plupart des tables d’intersection contiennent uniquement les quatre colonnes nécessaires pour prendre en charge la relation plusieurs-à-plusieurs. Ils ne sont pas utiles. Les tables intersectées avec plus de quatre colonnes ne sont pas courantes et plus intéressantes.

Pour afficher des informations sur toutes les tables de votre aligner, consultez Parcourir les définitions de tables dans votre aligner.

Informations de référence sur la table des produits Dynamics 365

Les produits Dynamics 365 utilisent Dataverse. Lorsque vous créez un environnement pour les produits Dynamics 365, l’environnement a un ensemble commun de tables pour tous les produits Dynamics 365. Consultez la Dynamics 365 informations de référence sur la table/l’entité des applications activées.

Chaque produit Dynamics 365 spécifique peut ajouter d’autres tables. Le tableau suivant présente la référence de table pour des produits Dynamics 365 spécifiques :

Documentation du produit	Référence de la table de produits
Ventes	Référence de table/entité de vente
Service sur le terrain	Référence de table/entité Field Service
Customer Service	Référence de table/entité Customer Service

Propriétés

Cette section contient certaines propriétés d’entité, mais pas toutes. Il inclut uniquement les propriétés les plus utiles pour les développeurs. Vous pouvez modifier certaines valeurs de propriété d’entité.

Colonnes

Les colonnes sont répertoriées dans deux sections distinctes :

Section	Description
Colonnes/attributs accessibles en écriture	Les colonnes que vous pouvez définir lors de la création ou de la mise à jour de lignes dans une table. Ces colonnes retournent true la ou AttributeMetadata.IsValidForUpdate les AttributeMetadata.IsValidForCreate propriétés, généralement les deux. Si l’une ou l’autre propriété retourne false, cette condition est indiquée.
Colonnes/attributs en lecture seule	Les colonnes que vous pouvez récupérer mais ne peuvent pas définir lors de la création ou de la mise à jour de lignes dans une table. Ces colonnes retournent false toujours pour les propriétés et AttributeMetadata.IsValidForUpdate les AttributeMetadata.IsValidForCreate propriétés.

Choisir des options de colonne

Les options de colonne de choix dans cette documentation de référence proviennent d’un déploiement où l’anglais est la langue de base. Certaines options de choix peuvent varier en fonction de la langue de base sélectionnée lors de la création du environnement. Ces différences s’alignent davantage sur les options qui conviennent le mieux à la langue ou à la culture. Vous pouvez personnaliser ces options en modifiant les étiquettes ou en ajoutant et en supprimant des options selon les besoins.

Relations

La classe EntityMetadata comprend trois propriétés pour représenter des relations :

Propriété	Type	Description
Relations un-à-plusieurs	Métadonnées de relation un-à-plusieurs[]	Obtient le tableau des relations un-à-plusieurs pour l’entité.
Relations plusieurs à un	Métadonnées de relation un-à-plusieurs[]	Obtient le tableau des relations plusieurs-à-un pour l’entité.
Relations plusieurs à plusieurs	Métadonnées de relation plusieurs à plusieurs[]	Obtient le tableau des relations plusieurs-à-plusieurs pour l’entité.

Note

Bien que chaque table répertorie les relations qui s’y appliquent, chaque relation est partagée par les deux tables. Les Relations existent entre les tables. Bien que des relations un-à-plusieurs existent, les relations plusieurs-à-un sont simplement une vue d’une relation un-à-plusieurs à partir de la table de référencement.

Relations plusieurs-à-un

Inclut ces OneToManyRelationshipMetadata propriétés de classe :

Propriété	Description
ReferencedEntity	Le nom logique de la table associée.
ReferencedAttribute	Le nom logique de la clé primaire de la table associée.
ReferencingEntity	Le nom logique de la table associée qui contient la colonne de recherche.
ReferencingAttribute	Le nom logique de la colonne de recherche dans la table associée qui contient une référence à la clé primaire de la table primaire.
IsHierarchical	Indique si les relations représentent une relation hiérarchique auto-référentielle.
CascadeConfiguration	Données qui décrivent les opérations effectuées sur l’entité parente cascadent vers les entités associées. Pour plus d’informations, consultez Configuration cascade.

Relations 1 à N (un-à-plusieurs)

Inclut ces OneToManyRelationshipMetadata propriétés de classe :

Propriété	Description
ReferencingEntity	Le nom logique de la table associée.
ReferencingAttribute	Le nom logique de la colonne dans la table associée qui contient une référence à la clé primaire de la table primaire.
IsCustomizable	Indique si vous pouvez modifier les propriétés de la relation.
ReferencedEntityNavigationPropertyName	Nom de la propriété de navigation avec une valeur de collection prise en charge par l’API web pour cette relation. Pour plus d’informations, consultez Propriétés de navigation de l’API web.
AssociatedMenuConfiguration	Données utilisées par les applications basées sur un modèle pour contrôler si et comment les données de l’entité associée sont accessibles dans l’interface utilisateur depuis l’entité principale.

Relations plusieurs-à-plusieurs

Chaque relation plusieurs-à-plusieurs inclut Entity1LogicalName et Entity2LogicalName. Pour cette documentation, les détails de la relation sont fournis dans le contexte de la table actuelle. Que ce soit Entity1 ou Entity2 n’est pas vraiment important.

Pour chaque relation plusieurs-à-plusieurs, les propriétés de classe suivantes ManyToManyRelationshipMetadata sont incluses :

Propriété	Description
IntersectEntityName	Le nom logique de la table d’intersection qui prend en charge cette relation plusieurs-à-plusieurs.
IsCustomizable	Indique si vous pouvez modifier les propriétés de la relation.
SchemaName	Le nom du schéma de la relation.
IntersectAttribute (Entity1IntersectAttribute ou Entity2IntersectAttribute)	Le nom de la colonne dans la table d’intersection qui est la clé primaire pour les enregistrements de ce type.
NavigationPropertyName (Entity1NavigationPropertyName ou Entity2NavigationPropertyName)	Nom de la propriété de navigation avec une valeur de collection prise en charge par l’API web pour cette relation. Plus d’informations : Propriétés de navigation de l’API Web
AssociatedMenuConfiguration (Entity1AssociatedMenuConfiguration ou Entity2AssociatedMenuConfiguration)	Données utilisées par les applications pilotées par modèle pour contrôler si et comment les données de la deuxième table sont accessibles dans l’interface utilisateur à partir de cette table.

Dans le cas rare où une relation plusieurs-à-plusieurs est auto-référencée, comme pour le rôle de connexion (ConnectionRole) connectionroleassociation_association, Entity1 ou Entity2 est ajouté à la propriété.

Propriété	active
Entity1IntersectAttribute	Le nom de la colonne dans la table d’intersection qui est la clé primaire pour les enregistrements de ce type comme première table.
Entity2IntersectAttribute	Le nom de la colonne dans la table d’intersection qui est la clé primaire pour les enregistrements de ce type comme deuxième table.
Entity1NavigationPropertyName	Le nom de la propriété de navigation à valeur de collection de l’API Web pour cette relation en tant que première table.
Entity2NavigationPropertyName	Le nom de la propriété de navigation à valeur de collection de l’API Web pour cette relation en tant que deuxième table.
Entity1AssociatedMenuConfiguration	Données utilisées par les applications pilotées par modèle pour contrôler si et comment les données de la deuxième table sont accessibles dans l’interface utilisateur à partir de cette table en tant que première table.
Entity2AssociatedMenuConfiguration	Données utilisées par les applications basées sur des modèles pour contrôler si et comment les données de la deuxième table sont accessibles dans l’interface utilisateur de cette table en tant que deuxième table.