Condividi tramite


Procedure di personalizzazione supportate e non supportate

Gli sviluppatori che estendono Dynamics 365 Customer Engagement (on-premises) hanno la responsabilità di seguire le regole e le procedure consigliate documentate in SDK: Procedure ottimali per lo sviluppo con Dynamics 365 Customer Engagement (on-premises). SDK documenta le API disponibili per gli sviluppatori e offre indicazioni sul modo migliore di utilizzarle. Microsoft supporta solo le API e le procedure consigliate documentati nell'SDK. È possibile che in Internet trovi le indicazioni per la risoluzione di un problema, ma se non si utilizzano le API documentate nell'SDK, questa non è supportata da Microsoft. Prima che uno sviluppatore applichi una modifica è consigliabile verificare che utilizzi i metodi supportati.

Se gli sviluppatori utilizzano le API e le procedure consigliate descritte in SDK sicuramente le modifiche apportate a Customer Engagement verranno testate in modo da verificare se possono interrompere le personalizzazioni esistenti. Il nostro obiettivo è che le personalizzazioni del codice scritto utilizzando i metodi supportati continueranno a funzionare quando le nuove versioni o gli aggiornamenti delle app Customer Engagement verranno rilasciati. Si tratta di un vantaggio poiché è ora possibile passare alle nuove versioni con funzionalità migliorate senza che gli sviluppatori debbano modificare il codice ogni volta.

Se si rileva che una modifica in una nuova versione delle app Customer Engagement determinerà un'interruzione nella personalizzazione supportata, gli elementi interessati verranno documentati e verrà suggerito come modificare il codice per risolvere il problema.

Quali tipi di personalizzazione non sono supportati con Dynamics 365 Customer Engagement (on-premises)?

Solo perché alcune API e procedure di programmazione non sono supportate da Microsoft, ciò non significa che non funzionano. "Non supportato da Microsoft" significa esattamente quanto indicato: non è possibile ottenere supporto per queste API o procedure di programmazione da Microsoft. Non vengono eseguiti test su queste e quindi non sappiamo se le modifiche possono interromperle in qualche modo. Non siamo a conoscenza di ciò che può accadere se viene modificato il codice nell'applicazione.

Lo sviluppatore che utilizza le API e le procedure di programmazione non supportate si assume la responsabilità di supportarne il codice. Sarà necessario testare il codice per verificare che funzioni.

Se si sceglie di utilizzare le personalizzazioni non supportate nella distribuzione delle app Customer Engagement è necessario assicurarsi di documentare le operazioni eseguite e disporre di una strategia per rimuovere tali personalizzazioni prima di contattare il supporto tecnico delle app Dynamics 365 Customer Engagement (on-premises). Per ottenere assistenza con le personalizzazioni non supportate, contattare lo sviluppatore o l'organizzazione con ha preparato le personalizzazioni.

Procedure comuni di personalizzazione non supportate

Viene di seguito riportato un elenco delle procedure di personalizzazione comuni non supportate. Questo elenco non è completo. Altre informazioni: Estensioni supportate per Dynamics 365 Customer Engagement (on-premises): personalizzazioni non supportate.

Interazione con gli elementi di Document Object Model (DOM) dell'applicazione Web tramite JavaScript
Tutte le librerie di JavaScript utilizzate nell'applicazione devono interagire solo con le API documentate. Quando utilizzano le applicazioni, gli sviluppatori JavaScript accedono spesso agli elementi di DOM utilizzando nomi specifici. Poiché Dynamics 365 Customer Engagement (on-premises) è un'applicazione Web, tali tecniche funzionano, ma potrebbero interrompersi durante un aggiornamento perché i nomi degli elementi a cui fanno riferimento sono soggetti a modifiche in qualsiasi momento. Ci riserviamo il diritto di apportare tutte le modifiche necessarie nell'applicazione e ciò significa in genere modificare la modalità in cui la pagina è costruita. L'aggiunta di eventuali modifiche che dipendono dalla struttura della pagina corrente significa che dovrai investire nella verifica ed eventualmente nella modifica del codice personalizzato di questi script quando applichi un aggiornamento all'applicazione.

jQuery è una libreria molto comune usata dagli sviluppatori JavaScript. La maggior parte dei vantaggi di utilizzare jQuery è che semplifica la capacità di uno sviluppatore di accedere e di creare gli elementi DOM, questo è ciò che non supportiamo nelle pagine di applicazione delle app Customer Engagement. jQuery è consigliato quando gli sviluppatori stanno creando interfacce utente personalizzate con risorse Web HTML, ma nelle pagine di applicazione delle app Customer Engagement, le API supportate non richiedono l'utilizzo di jQuery.

Utilizzo di oggetti o metodi interni non documentati con JavaScript
Dynamics 365 Customer Engagement (on-premises) usa molti oggetti JavaScript nelle pagine. Uno sviluppatore JavaScript può individuare questi oggetti eseguendo il debug di una pagina e quindi accedendo e riutilizzando questi oggetti. Ci riserviamo il diritto di apportare tutte le modifiche necessarie per questi oggetti, inclusa la loro eliminazione o la modifica dei nomi dei metodi. Se un script fa riferimento a questi oggetti, questo si interromperà se non vengono trovati.

Vedi anche

Panoramica sulla creazione e personalizzazione di app per Dynamics 365 for Customer Engagement, versione 9 (locale)