Utiliser l’API web avec les définitions de table

Notes

Vous n’êtes pas sûr de l’entité par rapport à la table ? Voir Développeurs : Comprendre la terminologie dans Microsoft Dataverse.

Vous pouvez exécuter les opérations de définition de table et de colonne (métadonnées) avec l’API web de la même manière qu’avec le service Organization. Cette section fournit des instructions sur l’utilisation de l’API web avec les types d’entités inclus dans la Web API Metadata EntityType Reference.

Il y a quatre chemins d'accès à l'ensemble d'entités exposés pour effectuer des opérations avec des entités de définition, comme décrit dans le tableau suivant.

Chemin d'accès à l'ensemble d'entités	Description
[URI de l'organisation]/api/data/v9.0/EntityDefinitions	Contient un collection de EntityMetadata EntityType/.
[URI de l'organisation]/api/data/v9.0/RelationshipDefinitions	Contient les entités ManyToManyRelationshipMetadata EntityType/ et OneToManyRelationshipMetadata EntityType/, car toutes les deux héritent de RelationshipMetadataBase EntityType/.
[URI de l'organisation]/api/data/v9.0/GlobalOptionSetDefinitions	Contient une collection de BooleanOptionSetMetadata EntityType/ et OptionSetMetadata EntityType/, car les deux héritent de OptionSetMetadata EntityType/.
[URI de l'organisation]/api/data/v9.0/ManagedPropertyDefinitions	Utilisation interne uniquement

Chaque type d'entité de définition utilise MetadataId comme propriété d'identificateur unique, dont il hérite de MetadataBase EntityType/. Alors que toutes les entités de définition ont un MetadataId, et vous ne pouvez pas toutes les interroger directement. Par exemple, vous pouvez interroger et effectuer des opérations sur des attributs (colonnes de table) uniquement dans le contexte de l'entité EntityMetadata qui les contient.

Ces entités de définition présentent des différences substantielles par rapport aux tables qui stockent les données d'entreprise et d'application, par exemple :

• Les propriétés des entités de définition utilisent de nombreux types complexes et enum définis dans Web API ComplexType Reference et Web API EnumType Reference plutôt que les types de données primitifs utilisés pour les propriétés dans les entités qui héritent de crmbaseentity EntityType/.

• Les entités de définition suivent une convention de dénomination différente et conservent le style de dénomination Pascal Case utilisé dans les assemblys du service Organisation.

• Les entités de définition utilisent plus largement l'héritage, par conséquent vous devrez peut-être effectuer des transtypages pour récupérer les données souhaitées.

Contenu de la section

Requête des définitions de table à l'aide de l'API Web
Vous pouvez utiliser l'API Web pour interroger les définitions de table ou de colonne à l'aide d'un style de requête RESTful.

Récupérer les définitions de table par nom ou MetadataId
Vos applications peuvent s'adapter aux changements de configuration en interrogeant les définitions de table et de colonne. Lorsque vous connaissez l'une des propriétés clés d'un élément de définition, vous pouvez récupérer des définitions à l'aide de l'API Web.

Créer et mettre à jour les définitions de table à l’aide de l’API web
Vous pouvez créer et mettre à jour des tables et des colonnes à l'aide de l'API Web pour obtenir les Organisation CreateEntityRequest,UpdateEntityRequest,CreateAttributeRequest, et UpdateAttributeRequest.

Créer et mettre à jour les relations de table à l’aide de l’API web
Vous pouvez vérifier si les tables sont éligibles à une relation avec d'autres tables, puis créer ou mettre à jour ces relations à l'aide de l'API Web.

Voir aussi

Parcourir les définitions de table pour votre environnement
Utiliser l'API Web Microsoft Dataverse

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