Brug OData-slutpunktet med webressourcer
Udgivet: november 2016
Gælder for: Dynamics CRM 2015
Slutpunktet OData med webressourcer giver en alternativ grænseflade til at arbejde med Microsoft Dynamics CRM 2015 og opdatering til Microsoft Dynamics CRM Online 2015-data. Du kan bruge OData-slutpunktet til at udføre HTTP-anmodninger vha. en webtjeneste, der er baseret på et URI (Uniform Resource Identifier).
Dette emne indeholder
Hvad er OData?
Microsoft Dynamics CRM-implementering af OData
Tredjepartsværktøjer til oprettelse af kode
Hvad er OData?
Slutpunktet OData bruger Open Data-protokollen. Denne protokol implementerer et "RESTful"-designmønster. REST står for Representational State Transfer (overførsel af repræsentationstilstand).REST er en type arkitektur, hvor alle ressourcer adresseres ved hjælp af entydige URI'er. I Microsoft Dynamics 365 kan en ressource være en objektsamling eller en post.
REST fungerer på samme måde, som internettet arbejder på. Du kan arbejde med ressourcer vha. HTTP-verber som GET, POST, MERGE og DELETE. Forskellige biblioteker kan bruges til at behandle HTTP-anmodningerne og svarene.REST indeholder en standardgrænseflade, som du kan bruge sammen med et hvilket som helst programmeringssprog.REST giver mulighed for synkron eller asynkron behandling af handlinger. Muligheden for at udføre asynkrone handlinger gør REST velegnet til webressourcer og scripts, der bruges i Microsoft Dynamics CRM 2015 og opdatering til Microsoft Dynamics CRM Online 2015.
Microsoft Dynamics CRM-implementering af OData
Microsoft Dynamics CRM 2015 og opdatering til Microsoft Dynamics CRM Online 2015bruger WCF (Windows Communication Foundation) Data Services-strukturen til at levere et OData (Open Data Protocol)-slutpunkt, der er en REST-baseret datatjeneste. Dette slutpunkt kaldes Organization Data Service. I Microsoft Dynamics 365er URI-serviceroden:
[Your Organization Root URL]/xrmservices/2011/organizationdata.svc
OData sender og modtager data ved hjælp af enten ATOM eller JavaScript Object Notation (JSON).ATOMer et XML-baseret format, der normalt bruges til RSS-feeds.JSON er et tekstformat, der giver mulighed for serialisering af JavaScript-objekter.
En EDM (Entity Data Model) organiserer data i form af "objekttyper" og tilknytninger mellem dem for at give et ensartet sæt URIs, der svarer til de objekter, som bruges i Microsoft Dynamics 365.
OData Entity Data Model (EDM)
Microsoft Dynamics 365 EDM'en er beskrevet i et OData-servicemetadatadokumentet på følgende sti:
[Your Organization Root URL]/xrmservices/2011/organizationdata.svc/$metadata
Dette XML-dokument bruger CSDL (Conceptual Schema Definition Language) til at beskrive de tilgængelige data. Du kan downloade dette dokument og bruge det til at generere skrevne klasser, når du bruger administreret kode, eller som en reference til tilgængelige objekter, når du bruger JavaScript.
Begrænsninger
OData-slutpunktet er et alternativ til SOAP-slutpunktet, men der er visse begrænsninger.
Kun Opret-, Hent-, Opdater- og Slet-handlinger kan udføres på objektposter.
Meddelelser, der kræver metoden Execute, kan ikke udføres.
Handlinger til tilknytning og fjernelse af tilknytninger kan udføres vha. navigeringsegenskaber.
OData-protokollen ikke er fuldt implementeret. Nogle forespørgsler til systemet er ikke tilgængelige.
Du kan finde flere oplysninger under OData-systemforespørgsler ved hjælp af OData-slutpunkt.Du kan ikke bruge sen binding med administreret kode mod brugerdefinerede objekter, attributter eller relationer, der ikke fandtes, da koden blev skrevet.
Du vil normalt bruge WCF Data Services Client Data Service-klasser under programmering vha. administreret kode. Disse klasser giver mulighed for tidlig binding, så du får sikre typeklasser i designfasen. De eneste objekter, der er tilgængelige for dig, er defineret i systemet, da klasserne blev genereret. Det betyder, at du ikke kan bruge sen binding til at arbejde med brugerdefinerede objekter, attributter eller relationer, der ikke indgår i WCF Data Services Client Data Service-klasser, da de blev genereret.
Tredjepartsværktøjer til oprettelse af kode
Fællesskabet af udviklere, der arbejder med Microsoft Dynamics 365, har oprettet nogle værktøjer, der viser, hvordan OData-slutpunktet fungerer og kan generere kode, som du kan bruge. Følgende værktøjer indeholder funktioner til at generere kode til at arbejde med Dynamics 365-data ved hjælp af OData-slutpunktet.
CRM REST Builder
Brug dette værktøj til at opbygge anmodninger til at hente data og udføre handlinger ved hjælp af en række JavaScript-biblioteker.Tak til Microsoft Dynamics 365 MVP Jason Lattimer for opbygning af dette værktøj.
OData-forespørgselsdesigner
OData-forespørgselsdesigneren følger med projektet Dynamics XRM Tools og giver dig mulighed for at oprette forespørgsler for at hente data ved hjælp af OData-slutpunktet.Tak til Microsoft Dynamics 365 MVP Rhett Clinton for opbygning af dette og andre værktøjer.
Se også
Bruge webtjenestedata i webressourcer (OData og moderne App SOAP-slutpunkt)
Bruge det moderne apps SOAP-slutpunkt til moderne programmer med webressourcer
Webressourcer til Microsoft Dynamics CRM 2015
Downloade slutpunkterne ved hjælp af siden Udviklerressourcer i Microsoft Dynamics CRM 2015
Forespørge på Microsoft Dynamics CRM 2015-data ved hjælp af OData-slutpunkt
Udfør grundlæggende datahandlinger, der bruger OData-slutpunkt
Brug OData-slutpunktet med Ajax og JScript-webressourcer
Udføre yderligere datahandlinger, der bruger OData-slutpunkt
Eksempel: Oprette, hente, opdatere og slette ved hjælp af OData-slutpunktet med JavaScript og jQuery
Eksempel: Oprette, hente, opdatere og slette vha. OData-slutpunktet med JavaScript
Eksempel: JQuery-kontakteditor for OData-slutpunkt
Oversigt over OData (Open Data Protocol)
OData SDK
Teknisk artikel: Brug af grupperede indstillinger sammen med slutpunktet REST – JScript
© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret