Utiliser l'API Web avec les métadonnées Dynamics 365

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Vous pouvez exécuter les opérations de métadonnées avec l'API Web de la même manière qu'avec le service d'organisation. 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.

Quatre chemins d'accès à l'ensemble d'entités sont exposés pour exécuter des opérations avec les entités de métadonnées, comme décrit dans le tableau suivant.

Chemin d'accès à l'ensemble d'entités	Description
[URI de l'organisation]/api/data/v8.2/EntityDefinitions	Contient les entités EntityMetadata EntityType.
[URI de l'organisation]/api/data/v8.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/v8.2/GlobalOptionSetDefinitions	Contient les entités globalement définies BooleanOptionSetMetadata EntityType et OptionSetMetadata EntityType, car toutes les deux héritent de OptionSetMetadataBase EntityType.
[URI de l'organisation]/api/data/v8.2/ManagedPropertyDefinitions	Utilisation interne uniquement.

Chaque type d'entité de métadonnées utilise MetadataId comme propriété d'identificateur unique, qu'elle hérite de MetadataBase EntityType. Toutes les entités de métadonnées ont un MetadataId, mais vous ne pouvez pas toutes les interroger directement. Par exemple, vous pouvez interroger et exécuter des opérations sur les attributs uniquement dans le contexte de l'entité EntityMetadataqui les contient.

Ces entités sont sensiblement différentes des entités qui stockent les données d'entreprise et d'application, par exemple :

• Les propriétés des entités de métadonnées utilisent plusieurs types complexes et d'énumération définis dans la Web API ComplexType Reference et la Web API EnumType Reference au lieu des types de données primitifs utilisés pour les propriétés des entités qui héritent de crmbaseentity EntityType.

• Les entités de métadonnées suivent une convention d'affectation de noms différente et conservent le style d'affectation de noms Casse Pascal utilisé dans les assemblys du service d'organisation.

• Les entités de métadonnées utilisent davantage l'héritage, ce qui nécessite d'effectuer des casts pour extraire les données souhaitées.

Contenu de la section

• Interroger les métadonnées à l'aide de l'API Web
  Vous pouvez utiliser l'API Web pour interroger les métadonnées de la même manière que vous pouvez le faire avec RetrieveMetadataChangesRequest et les objets de l'espace de noms Microsoft.Xrm.Sdk.Metadata.Query à l'aide du service d'organisation.

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

• Créer et mettre à jour les définitions d'entité à l’aide de l'API Web
  Vous pouvez créer et mettre à jour des entités et des attributs à l'aide de l'API Web pour obtenir les mêmes résultats qu'avec les objets CreateEntityRequest, UpdateEntityRequest, CreateAttributeRequest et UpdateAttributeRequest du service d'organisation.

• Créer et mettre à jour les relations d'entité à l’aide de l'API Web
  Vous pouvez vérifier si les entités peuvent participer à une relation avec d'autres entités, puis créer ou mettre à jour ces relations à l'aide de l'API Web.

Voir aussi

Métadonnées et modèles de données dans Microsoft Dynamics 365
Parcourir les métadonnées de votre organisation
Utiliser le service d'organisation avec des métadonnées Dynamics 365
Utilisez l'API Web Microsoft Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright