Utilizzo dei servizi Web Microsoft Dynamics 365
Data di pubblicazione: gennaio 2017
Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
I servizi Web forniscono le API che utilizzi per scrivere i programmi per Microsoft Dynamics 365 (online e locale). In questo argomento vengono introdotti i servizi Web disponibili e offerte le informazioni di base per capirli e confrontarli.
In questo argomento
API Web
Servizio organizzazione
Servizio dati organizzazione
Servizi Web di individuazione
Servizio Web di distribuzione
API Web
L'API Web è nuova per Microsoft Dynamics 365 (online e locale) e fornisce la parità con il servizio Organization.
Nota
Per questa versione iniziale sono presenti diversi problemi da risolvere prima che la completa parità sia raggiunta. Per ulteriori informazioni sui problemi aperti, vedi Limitazioni API Web di Microsoft Dynamics 365.
Confrontata con il servizio Organization, Web API fornisce una maggiore compatibilità per una vasta gamma di linguaggi di programmazione, piattaforme e dispositivi. La Web API implementa il protocollo OData (Open Data Protocol) v4.OData è uno standard OASIS per la creazione e l'utilizzo di API RESTful in origini dati complete. Per ulteriori informazioni vedi i siti Web Protocollo OData e sullo standard OASIS.
Poiché la Web API è progettata per gli standard aperti, non devi utilizzare le librerie client specifiche di Microsoft Dynamics 365. Puoi scegliere di creare richieste HTTP per operazioni specifiche o utilizzare librerie di terze parti per generare classi per qualsiasi linguaggio o piattaforma che desideri utilizzare. Visualizza un elenco delle librerie disponibili.
La Web API sostituirà il servizio Organization e il servizio Organization Data, ma entrambi i servizi Web esistenti saranno disponibili per abilitare una transizione graduale a una singola Web API. La Web API deve essere la tua prima scelta per il nuovo sviluppo che supporterà Microsoft Dynamics 365 e le versioni future di Microsoft Dynamics 365 (online). Utilizza la Web API per tutti i progetti che accedono ai dati Microsoft Dynamics 365 con il codice che non viene eseguito sul server, inclusi gli elementi XmlHttpRequests dalle risorse Web e dagli script dei moduli che vengono eseguiti nei client dell'applicazione Microsoft Dynamics 365. Attualmente non puoi utilizzare facilmente la Web API per il codice in esecuzione nel server, ad esempio i plug-in o gli assembly del flusso di lavoro.
Ulteriori informazioni:Utilizzare l'API Web di Microsoft Dynamics 365.
Servizio organizzazione
Il servizio Organization, anche talvolta noto come "endpoint SOAP", è disponibile dalla versione Microsoft Dynamics CRM 2011. È il servizio Web che la maggior parte degli sviluppatori che utilizzano Microsoft Dynamics 365 già conosce. Il servizio Organization è ottimizzato per l'utilizzo con .NET.Microsoft Dynamics 365 SDK include un set di assembly e strumenti per consentirti di generiate le classi e i proxy fortemente tipizzati che migliorano il processo di sviluppo e l'esperienza di sviluppo tramite Microsoft Visual Studio. Se sei uno sviluppatore .NET senza i requisiti per supportare altre piattaforme, non devi passare all'API Web immediatamente. Dovrai utilizzare il servizio Organization per supportare le funzionalità che vuoi distribuire nelle organizzazioni tramite le versioni di Microsoft Dynamics 365 rilasciate prima di Microsoft Dynamics 365.
La logica di business che viene eseguita nei plug-in o negli assembly del flusso di lavoro sul server prevede l'utilizzo del servizio Organization. I parametri di input e output utilizzano le classi specifiche definite con gli assembly che supportano il servizio Organization.
Ulteriori informazioni:Usa il servizio di organizzazione di Microsoft Dynamics 365
Servizio dati organizzazione
Il servizio Organization Data, anche talvolta noto come "endpoint OData" o "REST", è disponibile dalla versione Microsoft Dynamics CRM 2011. Questo servizio ha implementato lo standard OData v2. Mentre questo servizio continuerà a essere disponibile così com'è per gli anni a venire, verrà deprecato con Microsoft Dynamics 365. Il servizio Organization Data è sempre stato limitato ad eseguire le operazioni per creare, leggere, aggiornare ed eliminare e non ha mai supportato la possibilità di chiamare i messaggi specializzati utilizzati nel servizio Organization, pertanto non è possibile raggiungere la parità con la funzionalità del servizio Organizzazione. Le modifiche implementate negli standard OData tra v2 e v4 non consentono l'aggiornamento del servizio per soddisfare le esigenze di un servizio che ha parità con i servizi Organizzazione. Siamo stati in grado di applicare molti commenti che abbiamo ricevuto sul Servizio dati organizzazione e applicarli per rendere migliore l'API Web.
Questa versione di Microsoft Dynamics 365 SDK non include le informazioni sul Servizio dati organizzazione. Ulteriori informazioni sul Servizio dati organizzazione sono disponibili nella documentazione per la versione Microsoft Dynamics CRM 2015 in Utilizzare l'endpoint OData con risorse Web.
Servizi Web di individuazione
Microsoft Dynamics 365 è un'applicazione multi-tenant. Questo significa che una singola distribuzione può ospitare più istanze di Dynamics 365, ognuna con i propri dati, ognuna disponibile tramite un URL diverso. Inoltre, soprattutto quando i server Microsoft Dynamics 365 sono ospitati in un data center, il server specifico può cambiare quando le risorse vengono spostate o sottoposte al bilanciamento del carico. I servizi Web di individuazione rappresentano un modo per un client di individuare i server e le organizzazioni che sono disponibili per un utente per la connessione in base al proprio account utente. Puoi scegliere di utilizzare il servizio Web API Discovery o il servizio Web IDiscoveryService. Il servizio Web API Discovery offre gli stessi vantaggi di Web API, è più semplice da utilizzare per una gamma più vasta di linguaggi di programmazione, piattaforme e dispositivi.
Ulteriori informazioni:Individuare l'URL dell'organizzazione utilizzando l'API Web o Individuare l'URL dell'organizzazione utilizzando il Servizio organizzazione
Servizio Web di distribuzione
Per Dynamics 365 (locale) puoi eseguire le azioni per gestire la distribuzione a livello di programmazione tramite i servizi Web di distribuzione. Sono essenzialmente le stesse operazioni che puoi eseguire nel server utilizzando il client dello strumento di gestione distribuzione installato nel server. Puoi creare, importare o eliminare le organizzazioni nonché applicare alcune impostazioni nel codice. Questa operazione può essere utile quando vuoi automatizzare specifici processi se stai fornendo un servizio host o se intendi automatizzare la creazione degli ambienti di test.
Ulteriori informazioni:Introduzione al servizio Web di distribuzione.
Vedere anche
Eseguire la connessione a Microsoft Dynamics 365
Autenticare gli utenti in Microsoft Dynamics 365
Use Microsoft Dynamics 365 web services
Compilare applicazioni client di Windows tramite gli strumenti XRM
Scrivere moderne applicazioni per dispositivi mobili
Microsoft Dynamics 365
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright