Utilizzare l'endpoint OData con risorse Web
Data di pubblicazione: novembre 2016
Si applica a: Dynamics CRM 2015
L'endpoint OData con risorse Web fornisce un'interfaccia alternativa da utilizzare con i dati di Aggiornamento di Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015. È possibile utilizzare l'endpoint OData per eseguire richieste HTTP tramite un servizio che è basato su un URI (Uniform Resource Identifier).
In questo argomento
Che cos'è OData?
Implementazione di OData in Microsoft Dynamics CRM
Strumenti di terze parti per generare codice
Che cos'è OData?
L'endpoint OData utilizza il protocollo Open Data. Il protocollo applica un modello di progettazione "RESTful". REST è l'acronimo di Representational State Transfer.RESTREST è uno stile architettonico software in cui a ogni risorsa viene fatto riferimento mediante un URI univoco. In Microsoft Dynamics 365 una risorsa può essere un insieme di entità o un record.
REST funziona allo stesso modo in cui funziona Internet. Si interagisce con risorse utilizzando verbi HTTP quali GET, POST, MERGE e DELETE. Varie librerie possono essere utilizzate per elaborare le richieste e le risposte HTTP.REST fornisce un'interfaccia standard che è possibile utilizzare con qualsiasi linguaggio di programmazione.REST consente l'elaborazione sincrona o asincrona di operazioni. La funzionalità per eseguire operazioni asincrone rende REST molto adatto alle risorse Web e agli script utilizzati in Aggiornamento di Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015.
Implementazione di OData in Microsoft Dynamics CRM
Aggiornamento di Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015 utilizza il framework di Servizi dati di Windows Communication Foundation (WCF) per fornire un endpoint protocollo Open Data (OData) che è un servizio dati basato su REST. Questo endpoint è denominato Organization Data Service. In Microsoft Dynamics 365, la radice di servizio URI è:
[Your Organization Root URL]/xrmservices/2011/organizationdata.svc
OData invia e riceve i dati utilizzando ATOM o JavaScript Object Notation (JSON).ATOM è un formato basato su XML in genere utilizzato per feed RSS.JSON è un formato di testo che consente la serializzazione degli oggetti di JavaScript.
Per fornire un set consistente di URIs che corrisponda alle entità utilizzate in Microsoft Dynamics 365, un Entity Data Model (EDM) organizza i dati nel modulo di record di "tipi di entità" e le associazioni tra loro.
Entity Data Model (EDM) di OData
L'EDM di Microsoft Dynamics 365 è descritto in un documento sul servizio metadati di OData disponibile nel percorso seguente:
[Your Organization Root URL]/xrmservices/2011/organizationdata.svc/$metadata
Questo documento XML utilizza il linguaggio CSDL (Conceptual Schema Definition Language) per descrivere i dati disponibili. È possibile scaricare questo documento e utilizzarlo per generare le classi tipizzate quando si utilizza il codice gestito o come riferimento per oggetti disponibili quando si utilizza JavaScript.
Limitazioni
L'endpoint OData fornisce un'alternativa all'endpoint SOAP, ma esistono attualmente alcune limitazioni.
Nei record dell'entità è possibile eseguire solo azioni di creazione, recupero, aggiornamento ed eliminazione.
I messaggi che richiedono il metodo Execute non possono essere eseguiti.
Azioni di associazione e di annullamento dell'associazione possono essere eseguite mediante le proprietà di navigazione.
Il protocollo OData non è completamente implementato. Alcune opzioni di query di sistema non sono disponibili.
Per ulteriori informazioni, vedere Opzioni query di sistema OData utilizzando l'endpoint OData.Non è possibile utilizzare l'associazione tardiva con il codice gestito rispetto a entità personalizzate, attributi o relazioni che non esistevano quando il codice è stato scritto.
In genere si utilizzeranno le classi di servizi dati client di Servizi dati WCF durante la programmazione tramite codice gestito. Queste classi consentono l'associazione anticipata in modo che si ottengano classi fortemente tipizzate in fase di progettazione. Le sole entità disponibili sono quelle definite nel sistema quando le classi sono state generate. Ciò significa che non è possibile utilizzare l'associazione tardiva per lavorare con entità personalizzate, attributi o relazioni non incluse nelle classi di servizi dati client di Servizi dati WCF quando sono stati generati.
Strumenti di terze parti per generare codice
La community degli sviluppatori che operano con Microsoft Dynamics 365 ha creato alcuni strumenti che illustrano come l'endpoint OData funziona e può generare il codice da utilizzare. I seguenti strumenti forniscono le funzionalità per creare il codice da utilizzare i dati di Dynamics 365 tramite l'endpoint OData.
Generatore di REST CRM
Utilizzare questo strumento per compilare le richieste per recuperare dati ed eseguire operazioni con più librerie JavaScript.Grazie a Microsoft Dynamics 365 MVP Jason Lattimer per aver compilato questo strumento.
Progettazione query OData
Incluso nel progetto Strumenti XRM di Dynamics, Progettazione query OData consente di creare query per recuperare i dati tramite l'endpoint OData.Grazie a Microsoft Dynamics 365 MVP Rhett Clinton per aver compilato questo e altri strumenti.
Vedere anche
Utilizzare i dati del servizio Web nelle risorse Web (OData ed endpoint SOAP moderno dell'app)
Utilizzare l'endpoint SOAP applicazioni moderne per applicazioni moderne con risorse Web
Risorse Web per Microsoft Dynamics CRM 2015
Scaricare gli endpoint usando la pagina delle risorse per sviluppatori Microsoft Dynamics CRM 2015
Eseguire una query sui dati di Microsoft Dynamics CRM 2015 tramite l'endpoint OData
Eseguire operazioni sui dati di base utilizzando l'endpoint OData
Utilizzare l'endpoint OData con risorse Web Ajax e JScript
Eseguire operazioni sui dati aggiuntive utilizzando l'endpoint OData
Esempio: creare, recuperare, aggiornare e eliminare utilizzando l'endpoint OData con JavaScript e jQuery
Esempio: creare, recuperare, aggiornare e eliminare utilizzando l'endpoint OData con JavaScript
Esempio: editor contatti jQuery endpoint OData
Panoramica di Open Data Protocol
OData SDK
Articolo tecnico: Utilizzo delle opzioni Set di opzioni con l'endpoint REST - JScript
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright