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 a la valeur
false
- Cela exclut les tables où aucun cas d’utilisation externe n’existe.
- IsIntersect a la valeur
false
- Cela exclut les tables utilisées pour définir les relations plusieurs-à-plusieurs.
- L’entité prend en charge un certain type d’opération de modification directe des données.
- Cela exclut les tables que vous ne pouvez pas utiliser directement.
Pour afficher des informations sur toutes les tables de votre environnement, reportez-vous à la rubrique Parcourir les définitions de tables dans votre environnement.
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 accessibles en écriture renvoient la valeur true pour soit 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 la valeur false pour les propriétés IsValidForCreate et IsValidForUpdate.
Relations
La classe EntityMetadata compte trois propriétés pour représenter les relations :
Propriété | Type | Description |
---|---|---|
OneToManyRelationships | OneToManyRelationshipMetadata[] | Obtient le tableau des relations un-à-plusieurs pour l’entité. |
EntityMetadata.ManyToOneRelationships | OneToManyRelationshipMetadata[] | Obtient le tableau des relations plusieurs-à-un pour l’entité. |
EntityMetadata.ManyToManyRelationships | ManyToManyRelationshipMetadata[] | Obtient le tableau des relations plusieurs-à-plusieurs pour l’entité. |
Notes
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. Les relations un-à-plusieurs existent, mais les relations plusieurs-à-un sont une simple vue des relations un-à-plusieurs à partir de la table de référencement.
Relations 1 à N (un-à-plusieurs)
Pour montrer qu’il n’existe pas de relation plusieurs-à-un réelle avec un minimum de confusion, les détails de chaque relation ne sont documentés qu’une seule fois. Chaque relation un-à-plusieurs est répertoriée avec la table référencée et comprend certains détails de la relation et un lien vers la relation plusieurs-à-un correspondante. Chaque relation plusieurs-à-un répertoriée inclut uniquement un lien vers la relation un-à-plusieurs correspondante.
Pour chaque relation un-à-plusieurs, les propriétés suivantes sont incluses :
Propriété | Description |
---|---|
ReferencingEntity |
Nom logique de la table de référence. |
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. |
IsHierarchical |
Indique si les relations représentent une relation hiérarchique auto-référentielle. |
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. Informations complémentaires : 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. |
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. Pour plus d’informations : Configuration en cascade |
Relations plusieurs-à-plusieurs
Chaque relation plusieurs-à-plusieurs inclut Entity1LogicalName et Entity2LogicalName. Pour cette documentation, les détails de la relation sont inclus dans la rubrique uniquement pour Entity1. Chaque relation plusieurs-à-plusieurs où l’entité est Entity2 contient uniquement un lien vers les détails disponibles dans la rubrique pour Entity1.
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 |
Entity1LogicalName |
Le nom logique de la première table de la relation. |
Entity1IntersectAttribute |
Le nom logique de la colonne dans la table d’intersection qui inclut une référence à la clé primaire de la première table. |
Entity1NavigationPropertyName |
Nom de la propriété de navigation avec une valeur de collection prise en charge par l’API web pour cette relation. Informations complémentaires : Propriétés de navigation de l’API web |
Entity1AssociatedMenuConfiguration |
Données utilisées par les applications pilotées par modèle pour contrôler si et comment les données de la première table sont accessibles dans l’interface utilisateur à partir de la deuxième table. |
Entity2LogicalName |
Le nom logique de la deuxième table de la relation. |
Entity2IntersectAttribute |
Le nom logique de la colonne dans la table d’intersection qui inclut une référence à la clé primaire de la deuxième table. |
Entity2NavigationPropertyName |
Ce champ est généralement le même que Entity1NavigationPropertyName . |
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 la première table. |
IsCustomizable |
Indique si les propriétés de la relation peuvent être modifiées. |
Notes
Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)
Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).