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

  • Article

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

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.2/EntityDefinitions Contient un collection de EntityMetadata EntityType.
[URI de l’organisation]/api/data/v9.2/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.2/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.2/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 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 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 SDK pour .NET.

  • 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 le SDK pour .NET CreateEntityRequest et UpdateEntityRequest.

Créer et mettre à jour des définitions de colonne à l’aide de l’API Web
Vous pouvez créer et mettre à jour des colonnes à l’aide de l’API Web pour obtenir le SDK pour .NET 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.

Recherches multi-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 soumise à la colonne de type multi-tables est mise en correspondance avec un enregistrement dans l′une des tables associées. Des recherches dans plusieurs tables peuvent être créées à la fois avec des tables locales et des tables virtuelles comme tables référencées.

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

Voir aussi

Parcourir les définitions de table pour votre environnement
Utiliser l’API web Microsoft Dataverse Exemple des opérations de métadonnées de l’API web
Exemple d’opérations de schéma de table de l’API web (C#)

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