Utiliser le point de terminaison OData avec les ressources Web
Date de publication : novembre 2016
S’applique à : Dynamics CRM 2015
Le point de terminaison OData contenant des ressources Web fournit une interface alternative pour utiliser des données Mise à jour de Microsoft Dynamics CRM 2015 et de Microsoft Dynamics CRM Online 2015. Vous pouvez utiliser le point de terminaison OData pour exécuter des demandes HTTP à l’aide d’un service basé sur un URI (Uniform Resource Identifier).
Contenu de la rubrique
Qu’est-ce qu’Odata ?
Implémentation d’ODATA par Microsoft Dynamics CRM
Outils tiers pour générer le code
Qu’est-ce qu’Odata ?
Le point de terminaison OData utilise le protocole Open Data. Ce protocole implémente un modèle de conception RESTful. REST signifie Representational State Transfer.REST est un style architectural dans lequel chaque ressource est interrogée à l’aide d’un URI unique. Dans Microsoft Dynamics 365, une ressource peut être une collection d’entités ou un enregistrement.
REST fonctionne de la même manière qu’Internet. Vous interagissez avec des ressources en utilisant des verbes HTTP, notamment GET, POST, MERGEet DELETE. Plusieurs bibliothèques peuvent être utilisées pour traiter les demandes et les réponses HTTP.REST fournit une interface standard que vous pouvez utiliser avec n’importe quel langage de programmation.REST autorise le traitement synchrone ou asynchrone des opérations. La fonctionnalité d’exécution d’opérations asynchrones rend REST parfaitement adapté pour les ressources et scripts Web utilisés dans Mise à jour de Microsoft Dynamics CRM 2015 et de Microsoft Dynamics CRM Online 2015.
Implémentation d’ODATA par Microsoft Dynamics CRM
Mise à jour de Microsoft Dynamics CRM 2015 et de Microsoft Dynamics CRM Online 2015 utilise la structure des Services de données Windows Communication Foundation (WCF) pour fournir un point de terminaison Open Data Protocol (OData) qui est un service de données REST. Ce point de terminaison est appelé le Organization Data Service. Dans Microsoft Dynamics 365, la racine de service URI est :
[Your Organization Root URL]/xrmservices/2011/organizationdata.svc
OData envoie et reçoit des données via ATOM ou JavaScript Object Notation (JSON).ATOM est un format XML utilisé généralement pour les flux RSS.JSON est un format de texte qui autorise la sérialisation d’objets JavaScript.
Pour fournir un ensemble logique d’URIs qui correspondent aux entités utilisées dans Microsoft Dynamics 365, un modèle de données d’entité (EDM) organise les données sous forme d’enregistrements de types d’entités et de leurs associations.
Modèle de données d’entité OData
L’EDM Microsoft Dynamics 365 est décrit dans un document de métadonnées de service OData disponible dans le chemin suivant :
[Your Organization Root URL]/xrmservices/2011/organizationdata.svc/$metadata
Ce document XML utilise le langage CSDL (Conceptual Schema Definition Language) pour décrire les données disponibles. Vous téléchargerez ce document et L’utiliserez pour générer des classes typées lorsque vous utiliserez du code géré ou comme référence pour les objets disponibles lorsque vous utiliserez JavaScript.
Limitations
Le point de terminaison OData fournit une alternative au point de terminaison SOAP, mais il existe actuellement certaines restrictions.
Seules les actions Créer, Extraire, Mettre à jour et Supprimer peuvent être effectuées sur les enregistrement d’entités.
Les messages qui nécessitent la méthode Execute ne peuvent pas être exécutés.
Les actions associées et dissociées peuvent être effectuées à l’aide des propriétés de navigation.
Le protocole OData n’est pas entièrement implémenté. Certaines options de requête système ne sont pas disponibles.
Pour plus d'informations, voir Options de requête système OData à l’aide du point de terminaison OData.Vous ne pouvez pas utiliser de liaison tardive avec le code géré sur les entités personnalisées, les attributs ou les relations qui n’existaient pas lorsque le code a été écrit.
Vous utiliserez généralement les classes de services de données clients de WCF Data Services lors de la programmation à l’aide de code géré. Ces classes autorisent la liaison tardive pour vous permettre d’obtenir des classes fortement typées au moment de la conception. Les seules entités disponibles sont celles définies dans le système lorsque les classes ont été générées. Cela signifie que vous ne pouvez pas utiliser la liaison tardive pour utiliser les entités personnalisées, les attributs ou les relations qui n’ont pas été inclus dans les classes des services de données clients de WCF Data Services lorsqu’ils ont été générés.
Outils tiers pour générer le code
La communauté des développeurs qui travaille avec Microsoft Dynamics 365 a créé des outils qui expliquent comment le point de terminaison OData fonctionne et peut générer du code vous pouvez utiliser. Les outils suivants permettent de générer du code à utiliser avec des données Dynamics 365 à l'aide du point de terminaison OData.
Générateur CRM REST
Utilisez cet outil pour créer des requêtes pour récupérer des données et effectuer des opérations à l'aide de plusieurs bibliothèques JavaScript.Merci à l'expert MVP Microsoft Dynamics 365Jason Lattimer d'avoir créer cet outil.
Concepteur de requête OData
Inclus dans le projet Dynamics XRM Tools, l'outil OData Query Designer vous permet de créer des requêtes pour récupérer des données à l'aide du point de terminaison OData.Merci à l'expert MVP Microsoft Dynamics 365Rhett Clinton d'avoir créer cet outil et d'autres.
Voir aussi
Utiliser des données du service Web dans les ressources Web (point de terminaison OData et SOAP d’applications modernes)
Utilisez le point de terminaison SOAP d’application moderne pour les applications modernes avec des ressources Web
Ressources Web pour Microsoft Dynamics CRM 2015
Télécharger les points de terminaison à l’aide de la page de ressources du développeur Microsoft Dynamics CRM 2015
Interrogation des données Microsoft Dynamics CRM 2015 à l'aide du point de terminaison OData
Exécuter des opérations de données de base utilisant le point de terminaison OData
Utiliser le point de terminaison OData avec les ressources Web Ajax et JScript
Exécuter des opérations de données supplémentaires en utilisant le point de terminaison OData
Exemple : créer, extraire, mettre à jour et supprimer le point de terminaison OData avec JavaScript et jQuery
Exemple : créer, extraire, mettre à jour et supprimer le point de terminaison OData avec JavaScript
Exemple : Éditeur de contact jQuery du point de terminaison OData
Vue d'ensemble d'Open Data Protocol
SDK OData
Article technique : Utilisation des options de groupe d’options avec le point de terminaison REST - JScript
© 2017 Microsoft. Tous droits réservés. Copyright