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

Vous pouvez effectuer n’importe quelle opération de définition de table et de colonne (métadonnées) à l’aide de l’API web que vous pouvez effectuer à l’aide du Kit de développement logiciel (SDK) pour .NET. Cette section fournit des instructions sur l’utilisation de l’API web avec les types d’entités inclus dans la Web API Metadata Entity Type Reference.

L’API web expose quatre chemins d’accès de jeu d’entités pour effectuer des opérations avec des entités de définition, comme décrit dans le tableau suivant.

Chemin de l’ensemble d’entités	Descriptif
[URI de l’organisation]/api/data/v9.2/EntityDefinitions	Contient une collection d'entités de type EntityMetadata EntityType.
[URI de l’organisation]/api/data/v9.2/RelationshipDefinitions	Contient ManyToManyRelationshipMetadata EntityType et OneToManyRelationshipMetadata EntityType car ils héritent de RelationshipMetadataBase EntityType.
[URI de l’organisation]/api/data/v9.2/GlobalOptionSetDefinitions	Contient une collection d’EntityType BooleanOptionSetMetadata et d’EntityType OptionSetMetadata définis globalement, comme tous deux héritentd’EntityType OptionSetMetadata.
[URI de l’organisation]/api/data/v9.2/ManagedPropertyDefinitions	Utilisation interne uniquement

Chaque type d’entité de définition utilise MetadataId comme propriété d’identificateur unique, qu’il hérite de MetadataBase EntityType. Bien que toutes les entités de définition aient un MetadataId, vous ne pouvez pas 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 entre les tables qui stockent les données métier et d’application, par exemple :

• Les propriétés des entités de définition utilisent la plupart des types complexes et enum définis dans Web API Complex Type Reference et Web API Enum Type Reference plutôt que les types de données primitifs utilisés pour les propriétés dans les entités qui héritent d’EntityType crmbaseentity.

• Les entités de définition suivent une convention d’affectation de noms différente et conservent le style d’affectation de noms Pascal Case utilisé dans les assemblys du Kit de développement logiciel (SDK) pour .NET.

• Les entités de définition utilisent plus largement l’héritage, ce qui nécessite que vous deviez réaliser des conversions pour récupérer les données souhaitées.

Contenu de cette section

Requête des définitions de table à l’aide de l’API web
Utilisez l’API web pour interroger des 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 modifications 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
Utilisez l’API web pour créer et mettre à jour des tables. Vous obtenez donc les mêmes résultats que le SDK pour .NET CreateEntityRequest et UpdateEntityRequest.

Créer et mettre à jour des définitions de colonnes à l’aide de l’API web
Utilisez l’API web pour créer et mettre à jour des colonnes. Vous obtenez donc les mêmes résultats que le SDK pour .NET CreateAttributeRequest et UpdateAttributeRequest.

Créer et mettre à jour des relations de table à l’aide de l’API web
Utilisez l’API web pour vérifier si les tables peuvent participer à une relation avec d’autres tables, puis créer ou mettre à jour ces relations.

Recherches dans plusieurs tables
Les colonnes de type de recherche multi-tables permettent d’utiliser une table spécifique qui a plusieurs relations un-à-plusieurs (1:N) avec d’autres tables de l’environnement. Une colonne de type de recherche unique peut faire référence à plusieurs autres tables. Une valeur de recherche envoyée à la colonne de type multi-table correspond à un enregistrement dans l’une des tables associées. Vous pouvez créer des recherches multitables à l’aide de tables locales et de tables virtuelles comme tables référencées.

Créer et mettre à jour des choix (ensembles d’options) à l’aide de l’API web
Explique comment utiliser des colonnes de choix globaux et locaux. Comment récupérer des valeurs d’option, ajouter, mettre à jour, supprimer et réorganiser des options.

Voir aussi

Parcourir les définitions de table de votre environnement
Utiliser l’API Web Microsoft Dataverse
Exemple d’opérations de schéma de table HTTP de l’API web
Exemple d’opérations de schéma de table C# de l’API web
Exemple d’opérations de schéma de table PowerShell de l’API web