Estensioni supportate per Microsoft Dynamics 365

  • Articolo

 

Data di pubblicazione: gennaio 2017

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

È possibile personalizzare Microsoft Dynamics 365 (online e locale) utilizzando gli strumenti disponibili nell'applicazione Web Microsoft Dynamics 365 o descritti in Microsoft Dynamics 365 SDK. Tali personalizzazioni sono supportate e possono essere aggiornate.

Le personalizzazioni effettuate utilizzando metodi diversi da quelli descritti in questo contesto non sono supportate e possono causare problemi durante gli aggiornamenti e gli upgrade a Microsoft Dynamics 365. Per ulteriori informazioni, vedere Personalizzazioni non supportate.

Gli argomenti trattati negli articoli tecnici pubblicati su MSDN nel Centro per sviluppatori Microsoft Dynamics CRM su MSDN sono supportati, ma potrebbero non essere aggiornati.

In questo argomento

Personalizzazioni mediante l'applicazione Web Microsoft Dynamics

Personalizzazioni utilizzando Microsoft Dynamics 365 SDK

Supporto per le versioni di .NET Framework

Personalizzazioni non supportate

Personalizzazioni mediante l'applicazione Web Microsoft Dynamics

In Microsoft Dynamics 365 sono disponibili vari strumenti che è possibile utilizzare per eseguire personalizzazioni. Le personalizzazioni effettuate tramite gli strumenti di Microsoft Dynamics 365 e l'applicazione Web sono totalmente supportate e aggiornabili.

I metodi di personalizzazione seguenti possono essere utilizzati per generare personalizzazioni totalmente supportate:

Nota

Totalmente supportato significa che il supporto per sviluppatori può fornire assistenza per le personalizzazioni e che il supporto dell'applicazione può aiutare i clienti che eseguono tali modifiche.

Per ulteriori informazioni sull'utilizzo degli strumenti di personalizzazione disponibili nell'applicazione Web, vedere Guida alla personalizzazione per Microsoft Dynamics CRM 2016 e Microsoft Dynamics CRM Online.

Personalizzazioni utilizzando Microsoft Dynamics 365 SDK

Microsoft Dynamics 365 SDK, gli articoli tecnici e il codice di esempio pubblicati sul Centro per sviluppatori di Microsoft Dynamics CRM e le informazioni pubblicate dal team di supporto per Microsoft Dynamics 365 sono incluse nell'area delle personalizzazioni tramite Microsoft Dynamics 365 SDK. Le azioni e i livelli specifici di supportabilità e di espandibilità sono descritti più avanti in questo argomento.

Microsoft Dynamics 365 SDK

L'utilizzo dei servizi Web è totalmente supportato. Questo include: DiscoveryService, OrganizationService, Organization Data Service, l'endpoint OData, l'endpoint moderno SOAP dell'app e DeploymentService. Microsoft si impegna a mantenere le API compatibili con le versioni precedenti tuttavia si riserva il diritto di modificare le API per offrire funzionalità aggiuntive. Anche gli attributi delle entità potrebbero cambiare nelle versioni future. Per ulteriori informazioni, vedere Estendere Microsoft Dynamics 365 nel server e Amministrare la distribuzione utilizzando il servizio Web di distribuzione.

JavaScript lato client

È possibile utilizzare JavaScript nel Microsoft Dynamics 365 (online e locale) in tre aree:

  • Gestori eventi di scripting dei moduli: è possibile configurare i gestori eventi dei moduli per chiamare le funzioni definite nelle risorse Web JavaScript.

  • Comandi della barra dei comandi (barra multifunzione): è possibile utilizzare gli elementi <JavaScriptFunction> (RibbonDiffXml) o <CustomRule> (RibbonDiffXml) per definire le azioni che chiamano le funzioni definite nelle risorse Web JavaScript.

  • Risorse Web e IFRAME: è possibile utilizzare le risorse Web JavaScript nelle risorse Web HTML. Gli IFRAME configurati per consentire lo scripting intersito o gli script nelle risorse Web HTML incluse in un modulo possono interagire con i metodi documentati Xrm.Page o Xrm.Utility del modulo tramite riferimento padre.

Ogni interazione con le pagine dell'applicazione Microsoft Dynamics 365 deve essere eseguita solo tramite i metodi con gli spazi dei nomi Xrm.Page o Xrm.Utility documentati in Riferimento programmazione sul lato client L'accesso diretto al Document Object Model (DOM) di alcune pagine dell'applicazione di Microsoft Dynamics 365 non è supportato. L'utilizzo di jQuery negli script e nei comandi del modulo non è consigliato.Ulteriori informazioni:b7840a25-f25e-409b-8b6a-0ef04c7ed9c4#BKMK_UsingjQuery

È possibile aprire i moduli, le visualizzazioni, le interazioni e i report di Microsoft Dynamics 365 utilizzando i metodi documentati in Aprire moduli, visualizzazioni, interazioni e report con un URL.

Personalizzazione della barra multifunzione

L'utilizzo di RibbonDiffXml per aggiungere, rimuovere o nascondere elementi della barra multifunzione è supportato. Il riutilizzo dei comandi della barra multifunzione definiti da Microsoft Dynamics 365 è supportato; tuttavia, Microsoft si riserva il diritto di modificare o deprecare i comandi disponibili. Il riutilizzo delle funzioni JavaScript definite nei comandi della barra multifunzione non è supportato.

File della soluzione

La modifica di un file della soluzione non gestito è supportata come descritto in Microsoft Dynamics 365 SDK. Alcune attività di personalizzazione vengono effettuate con i passaggi seguenti:

  • Esportare un componente di soluzione come una soluzione non gestita.

  • Estrarre il contenuto del pacchetto della soluzione.

  • Modificare il file Customizations.xml.

  • Reinserire in un pacchetto il file della soluzione.

  • Importare la soluzione modificata.

Le modifiche apportate al file Customizations.xml devono essere conformi allo schema CustomizationsSolution.xsd. Per ulteriori informazioni, vedere Schemas used in Microsoft Dynamics 365.

Le attività supportate elencate di seguito richiedono la procedura seguente:

  • Personalizzazione della barra multifunzione.

  • Personalizzazione della navigazione dell'applicazione utilizzando SiteMap.

  • Personalizzazione del dashboard e del modulo mediante FormXml.

  • Personalizzazione delle query salvate.

Plug-in

La possibilità di creare regole business personalizzate utilizzando il meccanismo plug-in descritto in Microsoft Dynamics 365 SDK è totalmente supportata e le regole create sono aggiornabili. Questa funzionalità è disponibile per tutte le distribuzioni di Microsoft Dynamics 365, incluse le distribuzioni locali, IFD e online. Tuttavia, i plug-in possono essere esclusivamente registrati ed eseguiti nel sandbox (modalità di isolamento) di Microsoft Dynamics 365 (online).Ulteriori informazioni:Scrivere plug-in per estendere i processi aziendali

L'aggiunta di assembly di plug-in e di attività flusso di lavoro personalizzate nella cartella %installdir%\server\bin\ è supportata solo nelle installazioni server locali e IFD di Microsoft Dynamics 365.

Flusso di lavoro

La possibilità di creare attività flusso di lavoro (assembly) personalizzate da chiamare dalle regole del flusso di lavoro è totalmente supportata e le attività create sono aggiornabili. Questa funzionalità è disponibile per tutte le distribuzioni locali, IFD e online di Microsoft Dynamics 365. Tuttavia, i plug-in e le attività flusso di lavoro personalizzate possono essere registrati ed eseguiti solo nel sandbox (modalità di isolamento) di Microsoft Dynamics 365 (online).Ulteriori informazioni:Automatizzare i processi aziendali utilizzando il processo Dynamics 365

La possibilità di modificare i flussi di lavoro XAML è totalmente supportata e i flussi modificati sono aggiornabili. Tuttavia, questa funzionalità è disponibile solo per le distribuzioni locali e IFD di Microsoft Dynamics 365.Ulteriori informazioni:Automatizzare i processi aziendali utilizzando il processo Dynamics 365

Supporto per le versioni di .NET Framework

Di seguito sono riportate le considerazioni di supporto per il codice personalizzato scritto con Microsoft .NET Framework 4.5.2.

Qualsiasi client del servizio Web creato utilizzando Microsoft .NET Framework 4.5.2 che chiama i servizi Web di Microsoft Dynamics 365 è totalmente supportato in Microsoft Dynamics 365.

Eventuali assembly .NET creati con Microsoft .NET Framework 4.5.2 per l'utilizzo in Microsoft Dynamics 365 sotto forma di assembly di plug-in di Microsoft Dynamics 365 o come attività flusso di lavoro personalizzata del Microsoft Dynamics 365 sono supportati.

Qualsiasi visualizzazione (grafico) creata con .NET Framework 4.5.2.

Personalizzazioni non supportate

Le modifiche a Microsoft Dynamics 365 che vengono apportate senza utilizzare gli strumenti di Microsoft Dynamics 365 o di Microsoft Dynamics 365 SDK non sono supportate e non vengono mantenute durante gli aggiornamenti o gli upgrade di Microsoft Dynamics 365. Tutto ciò che non è documentato in Microsoft Dynamics 365 SDK e nei documenti di supporto non è supportato. Inoltre, le modifiche non supportate potrebbero causare problemi durante l'aggiornamento tramite l'aggiunta aggiornamenti rapidi o service pack o l'upgrade di Microsoft Dynamics 365. Per ridurre al minimo i problemi di aggiornamento e di upgrade, non modificare alcun file di Microsoft Dynamics 365 che non sia stato creato personalmente.

Il seguente è un elenco di tipi di operazioni non supportati sui quali vengono frequentemente chieste informazioni:

  • Modifiche apportate a qualsiasi file ASPX, CSS, HTM, JS, XML, JPG o .GIF o aggiunta di file nelle directory wwwroot dell'applicazione Microsoft Dynamics 365, degli strumenti di Microsoft Dynamics 365 o dei file di Microsoft Dynamics 365 disponibili in Programmi\Microsoft Dynamics 365. Tuttavia, se si sono apportate modifiche a questi file, i file vengono verificati per rilevare la presenza di modifiche e non vengono sovrascritti.

  • Modifiche al sito Web di Microsoft Dynamics 365 (impostazioni dei file e del sito Web). Le soluzioni personalizzate devono essere installate in un sito Web diverso. Questo comprende le modifiche apportate agli elenchi di controllo di accesso (ACL) del file system di tutti i file presenti nel server Microsoft Dynamics 365.

  • L'utilizzo dei certificati client non è supportato da Microsoft Dynamics 365 SDK. Se si configura il sito Web Microsoft Dynamics 365 per richiedere i certificati client IIS, verranno restituiti errori di autenticazione per tutte le applicazioni che sono state sviluppate utilizzando SDK.

  • Modifiche allo schema fisico del database diverse dall'aggiunta o dall'aggiornamento degli indici. Sono incluse tutte le azioni eseguite sul database senza utilizzare le funzionalità di personalizzazione del sistema nell'applicazione Web o le API di metadati descritti nella presente documentazione su SDK. La modifica di tabelle, stored procedure o visualizzazioni nel database non è supportata. Anche l'aggiunta di tabelle, stored procedure o visualizzazioni al database non è supportata a causa dei problemi di integrità referenziale o di aggiornamento. Per le distribuzioni locali di Microsoft Dynamics 365, l'aggiunta degli indici è supportata se viene effettuata in base alle indicazioni fornite nella documentazione Distribuzione e gestione di Microsoft Dynamics CRM. Verrà applicata a tutti i database Microsoft Dynamics 365 e del database locale di Microsoft Dynamics 365 per Outlook.

    Quando si modifica il database senza utilizzare i metodi di supporto per la personalizzazione del sistema, esiste il rischio di problemi che potrebbero verificarsi durante gli aggiornamenti e gli upgrade.

  • Le modifiche dei record () nel database di Microsoft Dynamics 365 utilizzando i comandi SQL o qualsiasi altra tecnologia diversa da quelle descritte in Microsoft Dynamics 365 SDK.

  • I riferimenti alle raccolte di collegamenti dinamici (DLL) di Microsoft Dynamics 365 diversi dai seguenti:

    • Microsoft.Xrm.Sdk.dll

    • Microsoft.Crm.Sdk.Proxy.dll

    • Microsoft.Xrm.Sdk.Workflow.dll

    • Microsoft.Xrm.Sdk.Deployment.dll

    • Microsoft.Crm.Outlook.Sdk.dll

    • Microsoft.Crm.Tools.EmailProviders.dll

  • L'utilizzo di API (Application Programming Interface) diverse da quelle documentate nei servizi Web DeploymentService, nel Servizio dati organizzazione di DiscoveryService, nell'endpoint SOAP per le risorse Web e in OrganizationService.

    Per ottenere l'aspetto e il comportamento di Microsoft Dynamics 365, è possibile riutilizzare i controlli dell'interfaccia utente di Microsoft Dynamics 365, inclusi i controlli griglia. Questi controlli potrebbero essere modificati o sovrascritti durante un aggiornamento. Non è consigliabile utilizzare o modificare il file Default.css nella cartella di installazione principale di Microsoft Dynamics 365.

  • Il riutilizzo di eventuale codice JavaScript di Microsoft Dynamics 365, inclusi i comandi della barra multifunzione. Questo codice potrebbe essere modificato o sovrascritto durante un aggiornamento.

  • Le modifiche a uno dei moduli di Microsoft Office Outlook o l'aggiunta di nuovi moduli, come pagine ASPX personalizzate, direttamente a Microsoft Dynamics 365 oppure l'esecuzione di modifiche ai file PST. Queste modifiche non verranno aggiornate.

  • Le personalizzazioni tranne quando si utilizza la modalità offline disponibile per gli strumenti supportati Microsoft Dynamics 365 in Dynamics 365 per Outlook.

  • L'utilizzo di HttpModules personalizzati per inserire codice HTML/DHTML nei moduli Microsoft Dynamics 365.

  • La creazione di un assembly di plug-in per un assembly standard di Microsoft Dynamics 365 (Microsoft.Crm.*.dll) o di un aggiornamento o di un'eliminazione di una piattaforma pluginassembly creata non è supportata.

  • I plug-in e le attività flusso di lavoro personalizzate di Microsoft Dynamics CRM 4.0 non sono supportati.

  • L'endpoint del servizio Microsoft Dynamics CRM 4.0 (endpoint 2007) non è supportato.

  • La creazione di una domanda di un'applicazione Internet Information Services (IIS) all'interno del sito Web Microsoft Dynamics 365 per ogni VDir e in particolare nella cartella ISV non è supportata. La cartella <crmwebroot>\ISV non è più supportata.

  • La modifica di un file della soluzione per modificare alcuni componenti di una soluzione diversi dalle barre multifunzione, dai moduli e da SiteMap o dalle query salvate non è supportata. Per ulteriori informazioni, vedere Quando modificare il file di personalizzazione. La definizione di nuovi componenti della soluzione mediante la modifica del file della soluzione non è supportata. La modifica dei file delle risorse Web esportati con una soluzione non è supportata. Ad eccezione dei passaggi documentati in Gestire soluzioni gestite, la modifica del contenuto di una soluzione gestita non è supportata.

  • Silverlight Application Library Caching non è supportata.

  • La visualizzazione di un modulo dell'entità in un IFrame incorporato in un altro modulo dell'entità non è supportata.

Vedere anche

Scegliere il proprio stile di sviluppo per Dynamics 365
Estendere Microsoft Dynamics 365 nel server
Creare il codice per moduli di Microsoft Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright