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

  • Article

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é).