Scegliere il proprio stile di sviluppo per Dynamics 365

Articolo
09/22/2017

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

In Microsoft Dynamics 365 SDK sono disponibili diversi metodi e tecnologie da utilizzare quando si scrive il codice per accedere ai servizi Web di Microsoft Dynamics 365 (online e locale) oppure per estendere l'applicazione. Questo argomento include le linee guida per lo stile di sviluppo da scegliere in base all'area di tecnologia.

In questo argomento

Sviluppo .NET e non .NET

Sviluppo .NET: utilizzare gli assembly Dynamics 365 SDK

Sviluppo .NET: utilizzare gli assembly di strumenti XRM

Scegliere come connettersi a Dynamics 365

Sviluppo .NET e non .NET

La prima cosa da considerare quando si scrive il codice per estendere Dynamics 365 è se il codice viene scritto utilizzando .NET Framework.

Se il codice è scritto in .NET Framework, è possibile utilizzare una delle operazioni seguenti a secondo di ciò che si sta creando:
- Se stai creando plug-in, attività flusso di lavoro personalizzate o flussi di lavoro XAML personalizzati, usa gli assembly SDK Dynamics 365. Ulteriori informazioni:Sviluppo .NET: utilizzare gli assembly Dynamics 365 SDK
- Se stai creando applicazioni Windows per Dynamics 365 utilizza gli assembly di strumenti XRM.Ulteriori informazioni:Sviluppo .NET: utilizzare gli assembly di strumenti XRM
- Se stai creando applicazioni non Windows per Dynamics 365 utilizza l'API Web.Ulteriori informazioni:Utilizzare l'API Web di Microsoft Dynamics 365
Se il codice non è scritto in .NET Framework, utilizza l'API Web.Ulteriori informazioni:Utilizzare l'API Web di Microsoft Dynamics 365

Nel seguente diagramma di flusso viene illustrato lo stile di sviluppo da scegliere quando si sviluppa per Dynamics 365:

Flusso stile di sviluppo per Dynamics 365

Sviluppo .NET: utilizzare gli assembly Dynamics 365 SDK

Gli assembly Dynamics 365 SDK ti forniscono le classi utilizzabili per connetterti ai servizi Web Dynamics 365 per identificare l'organizzazione ed eseguire le operazioni aziendali comuni come creare, recuperare, aggiornare ed eliminare i dati in Dynamics 365. Gli assembly SDK sono disponibili come pacchetti NuGet e sono anche inclusi nel pacchetto per il download di Dynamics 365 SDK.Ulteriori informazioni:Iscriversi agli aggiornamenti dell'assembly SDK tramite NuGet e Assembly incluse in SDK di Microsoft Dynamics 365.

Importante

Se utilizzi .NET Framework 4.5.2 o versione successiva per scrivere il codice, devi utilizzare la versione più recente degli assembly Dynamics 365 SDK per creare plug-in, attività flusso di lavoro personalizzate o flussi di lavoro XAML.

Tuttavia, se utilizzi .NET Framework 4 e la classe CrmConnection delle estensioni SDK (obsolete) per la connessione a Dynamics CRM 2016 Update 1 (locale) e Aggiornamento 1 di CRM Online 2016 (versione 8.1.0 o successiva), dovrai usare la versione 6.1.2 degli assembly Dynamics 365 SDK. In caso contrario non ti sarà possibile connettersi. Per ulteriori informazioni sulla compatibilità con le versioni precedenti, vedere Blog: compatibilità con le versioni precedenti di Dynamics 365 SDK

Quando si utilizzano gli assembly SDK per scrivere il codice, lavori con i servizi Web dell'organizzazione (endpoint SOAP) per la connessione a un'istanza di Microsoft Dynamics 365 e l'esecuzione delle operazioni dei servizi Web supportati.Ulteriori informazioni:Usa il servizio di organizzazione di Microsoft Dynamics 365

Nota

Gli assembly SDK verranno eventualmente migrati per utilizzare internamente l'API Web anziché l'endpoint di 2011 SOAP. In questo modo, qualsiasi codice scritto con gli assembly SDK continuerà a essere supportato in quanto automaticamente trasferito dall'endpoint 2011 SOAP per utilizzare l'API Web. Questo aggiornamento sarà completamente trasparente per te; ulteriori dettagli verranno pubblicati nelle prossime versioni di SDK.Ulteriori informazioni:Endpoint Microsoft Dynamics CRM 2011

Creare e distribuire i plug-in o le attività personalizzate del flusso di lavoro: i plug-in e le classi di attività del flusso di lavoro personalizzate ti consentono di creare i gestori eventi per eseguire le regole business che puoi integrare con Microsoft Dynamics 365 per modificare o aumentare il comportamento standard della piattaforma.

Se si scrivono i plug-in e le attività personalizzate del flusso di lavoro partendo da zero, è necessario utilizzare lo strumento per la registrazione dei plug-in per registrarli. Tale strumento fornisce un'interfaccia utente grafica e supporta la registrazione di plug-in e attività flusso di lavoro personalizzate con Microsoft Dynamics 365.Ulteriori informazioni:Sviluppo dei plug-in e Attività personalizzate del flusso di lavoro (assembly del flusso di lavoro)
Creare e distribuire flussi di lavoro XAML personalizzati: Microsoft Dynamics 365 locale e IFD supportano la possibilità di creare flussi di lavoro XAML personalizzati. Utilizzando la funzione Progettazione flussi di lavoro di Microsoft Visual Studio, puoi creare flussi di lavoro XAML personalizzati, chiamati anche flussi di lavoro dichiarativi, trascinando attività del flusso di lavoro dalla casella degli strumenti nell'area di progettazione, creando variabili e impostando le proprietà di queste attività per implementare la funzionalità del flusso di lavoro. Puoi utilizzare le attività predefinite di Windows Workflow Foundation oppure le attività di processo specifiche di Microsoft Dynamics 365.Ulteriori informazioni:Flussi di lavoro XAML personalizzati

Modelli di programmazione ad associazione anticipata e ad associazione tardiva per entità Dynamics 365: quando si utilizzano gli assembly SDK, puoi scegliere tra due modelli di programmazione:

Associazione anticipata	Associazione tardiva
Utilizza lo strumento di generazione del codice (CrmSvcUtil) per creare classi di entità con associazione anticipata derivate dalla classe Entity che puoi utilizzare per accedere ai dati aziendali in Microsoft Dynamics 365. Tali classi includono una classe per ogni entità dell'installazione, incluse le entità personalizzate.Ulteriori informazioni:Utilizzare le classi di entità con associazione anticipata nel codice	La classe Entity contiene il nome logico di un'entità e una matrice del delle proprietà degli attributi delle entità. Ciò consente l'utilizzo di un'associazione tardiva in modo che sia possibile utilizzare i tipi come le entità personalizzate e gli attributi personalizzati non presenti quando l'applicazione è stata compilata.Ulteriori informazioni:Utilizzare la classe di entità con associazione tardiva nel codice

Utilizza lo strumento di generazione del codice (CrmSvcUtil) per creare classi di entità con associazione anticipata derivate dalla classe Entity che puoi utilizzare per accedere ai dati aziendali in Microsoft Dynamics 365. Tali classi includono una classe per ogni entità dell'installazione, incluse le entità personalizzate.Ulteriori informazioni:Utilizzare le classi di entità con associazione anticipata nel codice

La classe Entity contiene il nome logico di un'entità e una matrice del delle proprietà degli attributi delle entità. Ciò consente l'utilizzo di un'associazione tardiva in modo che sia possibile utilizzare i tipi come le entità personalizzate e gli attributi personalizzati non presenti quando l'applicazione è stata compilata.Ulteriori informazioni:Utilizzare la classe di entità con associazione tardiva nel codice

Dati di query in Dynamics 365: esistono tre modi per eseguire o recuperare i dati di query da Dynamics 365 utilizzando gli assembly SDK: FeatchXML, QueryExpression e .NET LINQ.Ulteriori informazioni:Recupera i dati con le query utilizzando gli assembly SDK

Sviluppo .NET: utilizzare gli assembly di strumenti XRM

Gli assembly di strumenti XRM utilizzano le API di assembly di Dynamics 365 SDK (servizio organizzazione e IDiscoveryService) per fornire un supporto di autenticazione semplice con meno righe di codice e tramite i cmdlet di Windows PowerShell. Tutte le chiamate di funzione in tali classi offrono sicurezza thread safety per le azioni eseguite in Dynamics 365 in un ambiente a thread multipli. Gli strumenti XRM forniscono un controllo accessi comune con logica di autenticazione integrata e la capacità di archiviare e riutilizzare in modo sicuro le informazioni di autenticazione per fornire un'esperienza di accesso unica e coerente a Dynamics 365 dalle applicazioni client di Windows.Ulteriori informazioni:Compilare applicazioni client di Windows tramite gli strumenti XRM

Gli assembly di strumento XRM sono disponibili come pacchetti NuGet. I pacchetti sono disponibili nel profilo crmsdk. Selezionare un pacchetto nell'elenco con nome "Xrm Tooling" per visualizzare la pagina dei dettagli del pacchetto. Gli assembly di strumento XRM sono inoltre disponibili nel pacchetto per il download di Dynamics 365 SDK. Scarica il pacchetto SDK di Microsoft Dynamics CRM.

Con il supporto stringa di connessione disponibile negli strumenti XRM e la deprecazione delle estensioni SDK per Dynamics 365, devi utilizzare gli assembly di strumenti XRM anziché la classe CrmConnection per connetterti a Dynamics 365.Ulteriori informazioni:Utilizzare le stringhe di connessione negli strumenti XRM per connettersi a Dynamics 365 e Esempio: avvio rapido semplificato di connessione con Microsoft Dynamics 365

Scegliere come connettersi a Dynamics 365

A seconda dello stile di sviluppo usato (.NET rispetto a non .NET), sceglierai come il codice autentica gli utenti in Dynamics 365. Nella tabella seguente ti vengono fornite brevi informazioni sul modello di autenticazione da considerare a seconda dello stile di sviluppo:

Stile di sviluppo	Descrizione
.NET: assembly Dynamics 365 SDK	Gli assembly Microsoft Dynamics 365 SDK utilizzano la tecnologia Windows Communication Foundation (WCF) per impostare un canale di comunicazione con i servizi Web Microsoft Dynamics 365. Microsoft Dynamics 365 SDK semplifica l'utilizzo della tecnologia di WCF e l'autenticazione basata sulle attestazioni fornendo le classi proxy helper che rendendo semplice sviluppare le applicazioni che si connettono a e si autenticano con i servizi Web Microsoft Dynamics 365. Ulteriori informazioni: Utilizzare il codice di esempio e dell'helper, Codice dell'helper: classe di ServerConnection
.NET: assembly di strumenti XRM	Utilizzare la stringa di connessione, la classe CrmServiceClient o i cmdlet PowerShell degli strumenti XRM per connettersi a Dynamics 365. Ulteriori informazioni: Utilizzare le stringhe di connessione negli strumenti XRM per connettersi a Dynamics 365, Usare i costruttori di CrmServiceClient per connettere a Dynamics 365, Utilizzare cmdlet PowerShell per gli strumenti XRM per connettersi a Dynamics 365
API Web di Dynamics 365	Per ulteriori informazioni, vedere Autenticazione a Microsoft Dynamics 365 con l'API Web

.NET: assembly Dynamics 365 SDK

Gli assembly Microsoft Dynamics 365 SDK utilizzano la tecnologia Windows Communication Foundation (WCF) per impostare un canale di comunicazione con i servizi Web Microsoft Dynamics 365. Microsoft Dynamics 365 SDK semplifica l'utilizzo della tecnologia di WCF e l'autenticazione basata sulle attestazioni fornendo le classi proxy helper che rendendo semplice sviluppare le applicazioni che si connettono a e si autenticano con i servizi Web Microsoft Dynamics 365.

Ulteriori informazioni: Utilizzare il codice di esempio e dell'helper, Codice dell'helper: classe di ServerConnection

.NET: assembly di strumenti XRM

Utilizzare la stringa di connessione, la classe CrmServiceClient o i cmdlet PowerShell degli strumenti XRM per connettersi a Dynamics 365.

Ulteriori informazioni: Utilizzare le stringhe di connessione negli strumenti XRM per connettersi a Dynamics 365, Usare i costruttori di CrmServiceClient per connettere a Dynamics 365, Utilizzare cmdlet PowerShell per gli strumenti XRM per connettersi a Dynamics 365

API Web di Dynamics 365

Per ulteriori informazioni, vedere Autenticazione a Microsoft Dynamics 365 con l'API Web

Per informazioni dettagliate sull'autenticazione degli utenti per connettersi a Dynamics 365, vedere Autenticare gli utenti in Microsoft Dynamics 365