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

Cette référence permet de connaître les opérations disponibles qui peuvent être effectuées pour des tables spécifiques, les colonne par défaut de chaque table ainsi que les relations entre les tables.

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

• IsPrivate est égal à false

  • Cela exclut les tables où aucun cas d’utilisation externe n’existe.

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

  • La plupart des tables d’intersection contiennent uniquement les 4 colonnes nécessaires pour prendre en charge la relation plusieurs-à-plusieurs. Ils ne sont pas utiles. Les tableaux d’intersection avec plus de quatre colonnes sont plus intéressants.

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

Propriétés

Cette section contient certaines propriétés d’entité, mais pas toutes. Seules les propriétés censées être les plus utiles pour les développeurs sont incluses. Certaines valeurs des propriétés d’entité peuvent être modifiées.

Colonnes

Les colonnes sont répertoriées dans deux sections distinctes : Colonnes/attributs accessibles en écriture et Colonnes/attributs en lecture seule. L’objectif de cette séparation est de vous concentrer sur les colonnes qu’un développeur peut définir lorsqu’il crée ou met à jour des lignes dans une table. Connaître ces colonnes permet à un développeur de savoir ce qu’il peut faire avec la table au-delà de la simple récupération des valeurs.

Les colonnes de la section Colonnes/attributs inscriptibles renvoient true pour les propriétés IsValidForCreate ou IsValidForUpdate (généralement les deux). Si l’une de ces propriétés renvoient la valeur false, cela est indiqué.

Les colonnes/attributs en lecture seule renvoient toujours false pour les propriétés IsValidForCreateetIsValidForUpdate .

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 se rapprochent davantage des options qui conviennent le mieux à la langue ou à la culture. Vous êtes libre de personnaliser ces options en modifiant les étiquettes ou en ajoutant et supprimant des options selon vos besoins.

Relations

La classe EntityMetadata inclut trois propriétés pour représenter 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

Il est important de garder à l’esprit que chaque table répertorie les relations qui lui sont appliquées, mais chaque relation est partagée par les deux tables associées. Les Relations existent entre les tables. Bien que les relations un-à-plusieurs Relations existent, les relations plusieurs-à-un Relations sont simplement une vue d’une relation un-à-plusieurs à partir de la table de référence.

Plusieurs à un Relations

Inclut ces OneToManyRelationship propriétés :

Property	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	Les données qui décrivent les opérations effectuées sur l’entité parente sont mises en cascade vers les entités associées. Plus d’informations : Configuration en cascade

Relations 1 à N (un-à-plusieurs)

Inclut ces OneToManyRelationship propriétés :

Property	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 les propriétés de la relation peuvent être modifiées.
ReferencedEntityNavigationPropertyName	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	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 suivantes 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 les propriétés de la relation peuvent être modifiées.
SchemaName	Le nom du schéma de la relation.
IntersectAttribute	Le nom de la colonne dans la table d’intersection qui est la clé primaire pour les enregistrements de ce type.
NavigationPropertyName	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	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é.

Property	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 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 deuxième table