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
falseou IsIntersect est égaltrueet 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 |