Delen via

Het OData-eindpunt gebruiken met webresources

  • Artikel

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Het OData-eindpunt met webresources biedt een alternatieve interface om met Microsoft Dynamics CRM 2015 en Microsoft Dynamics CRM Online 2015 Update-gegevens te werken. U kunt het OData-eindpunt gebruiken om aanvragen HTTP uit te voeren door een service te gebruiken die is gebaseerd op een URI (Uniform Resource Identifier).

In dit onderwerp

Wat is OData?

Microsoft Dynamics CRM-implementatie van OData

Hulpprogramma's van derden om code te genereren

Wat is OData?

Het OData-eindpunt maakt gebruik van het Open Data-protocol. Dit protocol implementeert een "RESTful" ontwerppatroon. REST staat voor Representational State Transfer.REST is een architectuurstijl waarin elke resource wordt benaderd door een unieke URI. In Microsoft Dynamics 365 kan een resource een entiteitsverzameling of een record zijn.

REST werkt op dezelfde manier als waarop internet werkt. U werkt met resources door HTTP-woorden te gebruiken als GET, POST, MERGE en DELETE. Er kunnen diverse bibliotheken worden gebruikt om aanvragen en reacties van HTTP te verwerken.REST biedt een standaardinterface die u met de programmeertaal kunt gebruiken.REST zorgt voor asynchrone of synchrone verwerking van bewerkingen. De capaciteit voor het uitvoeren van asynchrone bewerkingen zorgt ervoor dat REST zeer geschikt is voor scripts en webresources die worden gebruikt in Microsoft Dynamics CRM 2015 en Microsoft Dynamics CRM Online 2015 Update.

Microsoft Dynamics CRM-implementatie van OData

Microsoft Dynamics CRM 2015 en Microsoft Dynamics CRM Online 2015 Update maakt gebruik van het Windows Communication Foundation (WCF)-raamwerk voor Gegevensservices om een Open Gegevensprotocol (OData)-eindpunt te bieden die een op REST gebaseerde gegevensservice is. Dit eindpunt wordt de Organization Data Service genoemd. In Microsoft Dynamics 365 wordt de URI voor de hoofdmap van de service gevormd door:

[Your Organization Root URL]/xrmservices/2011/organizationdata.svc

OData verzendt en ontvangt gegevens door ATOM of JavaScript Object Notation (JSON) te gebruiken.ATOM is een op XML gebaseerde indeling die meestal wordt gebruikt voor RSS-feeds.JSON is een tekstindeling die serialisatie van JavaScript-objecten mogelijk maakt.

Teneinde een consistente set URIs te bieden die overeenkomt met de entiteiten die worden gebruikt in Microsoft Dynamics 365, ordent een entiteitgegevensmodel (EDM) de gegevens in de vorm van records van "entiteitstypen" en de koppelingen hiertussen.

ODATA-entiteitsgegevensmodel

Het EDM van Microsoft Dynamics 365 wordt beschreven in een document met OData-servicemetagegevens dat beschikbaar is via het volgende pad:

[Your Organization Root URL]/xrmservices/2011/organizationdata.svc/$metadata

Dit XML-document maakt gebruik van CSDL (conceptuele schemadefinitietaal) om de beschikbare gegevens te beschrijven. U downloadt dit document en gebruikt het om getypeerde klassen te genereren bij het gebruik van beheerde code of als referentie voor beschikbare objecten bij gebruik van JavaScript.

Beperkingen

Het OData-eindpunt biedt u een alternatief voor het SOAP-eindpunt, maar er gelden momenteel enkele beperkingen.

  • Alleen de acties Maken, Ophalen, Bijwerken en Verwijderen kunnen worden uitgevoerd op entiteitsrecords.

    • Berichten die de methode Execute vereisen kunnen niet worden uitgevoerd.

    • Acties Koppelen en Scheiden kunnen worden uitgevoerd door navigatie-eigenschappen te gebruiken.

  • Het OData-protocol het niet volledig geïmplementeerd. Sommige systeemqueryopties zijn niet beschikbaar.
    Zie Queryopties van het OData-systeem die het OData-eindpunt gebruiken voor meer informatie.

  • U kunt niet latere binding gebruiken met beheerde code voor aangepaste entiteiten, kenmerken of relaties die niet bestonden toen de code werd geschreven.
    U gebruikt gewoonlijk clientgegevensserviceklassen van WCF-gegevensservices bij het programmerern met beheerde code . Deze klassen staan vroegtijdige binding toe zodat u sterk getypeerde klassen in ontwerptijd krijgt. De enige entiteiten die beschikbaar voor u zijn, zijn de entiteiten die in het systeem werden gedefinieerd bij het genereren van de klassen. Dit betekent dat u geen gebruik kunt maken van late binding bij het werken met aangepaste entiteiten, kenmerken of relaties, die niet waren opgenomen in de clientgegevensserviceklassen van de WCF-gegevensservices toen deze werden gegenereerd.

Hulpprogramma's van derden om code te genereren

De community voor ontwikkelaars die met Microsoft Dynamics 365 werken heeft enkele tools gemaakt die laten zien hoe het OData-eindpunt werkt en code kan genereren die u kunt gebruiken. De volgende hulpmiddelen bieden mogelijkheden om code te genereren om te werken met Dynamics 365-gegevens, met behulp van het OData-eindpunt.

  • CRM REST Builder
    Gebruik dit hulpprogramma om aanvragen te maken om gegevens op te halen en bewerkingen uit te voeren met een verscheidenheid van JavaScript-bibliotheken.

    Met dank aan Microsoft Dynamics 365 MVP Jason Lattimer voor het maken van dit hulpprogramma.

  • OData Query Designer
    OData Query Designer maakt deel uit van het Dynamics XRM Tools-project en biet u de mogelijkheid query's te maken om gegevens op te halen met het OData-eindpunt.

    Met dank aan Microsoft Dynamics 365 MVP Rhett Clinton voor het maken van deze en andere programma's.

Zie ook

Gebruik webservicegegevens in webresources (OData en het SOAP-eindpunt voor moderne toepassingen)
Het SOAP-eindpunt voor moderne toepassingen gebruiken voor moderne toepassingen met webresources
Webresources voor Microsoft Dynamics CRM 2015
De eindpunten downloaden met de pagina Resources voor ontwikkelaars van Microsoft Dynamics CRM 2015
Query's op Microsoft Dynamics CRM 2015-gegevens uitvoeren met het OData-eindpunt
Basisgegevensbewerkingen uitvoeren met behulp van het OData-eindpunt
Het OData-eindpunt gebruiken met Ajax- en JScript-webresources
Aanvullende gegevensbewerkingen uitvoeren met behulp van het OData-eindpunt
Voorbeeld: Maken, ophalen, bijwerken en verwijderen via het OData-eindpunt met JavaScript en jQuery
Voorbeeld: Maken, ophalen, bijwerken en verwijderen via het OData-eindpunt met JavaScript
Voorbeeld: OData-eindpunt jQuery-contactpersoneneditor
Overzicht Open Data-Protocol
OData SDK
Technisch artikel: Optiesetopties gebruiken met het REST-eindpunt - JScript

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht