Librerie JavaScript per Microsoft Dynamics 365

Articolo
03/04/2017

Data di pubblicazione: gennaio 2017

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

Le librerie diJavaScript sono in Risorse Web per script (JScript) che contiene le funzioni che è possibile utilizzare per:

Gestire eventi di modulo e di campo.
Eseguire azioni per i controlli configurati nella barra multifunzione.
Supportare altre funzioni.

Utilizzare librerie JScript

È possibile utilizzare librerie JavaScript analogamente a come vengono utilizzate le librerie di JavaScript in qualsiasi applicazione Web.

Associare funzioni con eventi di campo e modulo

È possibile associare un massimo di 50 risorse Web dello script in modo che vengano caricate con qualunque modulo dell'entità.

Dopo aver aggiunto una libreria al modulo, la stessa diviene disponibile per tutti gli eventi nel modulo. Per ogni evento, è possibile decidere quali funzionalità devono diventare gestori eventi. È possibile specificare fino a 50 funzioni come gestori eventi per ogni evento.

Associare funzioni in fase di esecuzione

Puoi aggiungere funzioni all'attributo OnChange, al modulo OnSave e agli eventi PreSearch del controllo di ricerca in fase di esecuzione utilizzando i metodi Xrm.Page.data.entity attribute.addOnChange, Xrm.Page.data.entity.addOnSave e addPreSearch del controllo di ricerca. Quando questi metodi vengono utilizzati, la funzione viene aggiunta nella parte inferiore della pipeline del gestore eventi e ricevono il contesto di esecuzione come primo parametro. È possibile utilizzare i corrispondenti metodi removeOnChange,removeOnSave e removePreSearch per rimuovere le funzionalità aggiunte con questa modalità.

Contesto di esecuzione

Ogni gestore eventi può essere configurato per accettare un oggetto di contesto di esecuzione come primo parametro. Il contesto di esecuzione include funzioni che è possibile chiamare per determinare:

Profondità: L'ordine relativo in cui il gestore viene eseguito.
Origine evento: Un riferimento all'oggetto che ha avviato l'evento.

Questa funzionalità è importante quando si crea una funzione in grado di rispondere a eventi da vari moduli o eventi di campo diversi.
Variabili condivise: Questo consente a una funzione di impostare una variabile come coppia chiave/valore a cui è possibile accedere da altri gestori eventi.

Ulteriori informazioni:Contesto di esecuzione (riferimento sul lato client)

Nella finestra di dialogo Proprietà gestore è possibile immettere un elenco di valori stringa delimitati da virgole che saranno passati alla funzione. Ciò può essere utile per consentire di modificare il comportamento di una funzione senza richiedere modifiche al codice.

Associare funzioni con i comandi della barra dei comandi (Barra multifunzione)

Ogni controllo nella barra dei comandi o barra multifunzione è associato con un <CommandUIDefinition> (RibbonDiffXml) contenente un elemento <Actions> (RibbonDiffXml) che contiene una o più azioni.<JavaScriptFunction> (RibbonDiffXml) è una delle azioni disponibili. L'elemento JavaScriptFunction richiede un riferimento a una libreria e una funzione nella libreria.

Sviluppare e testare gli script

È possibile modificare gli script tramite il modulo delle risorse Web o la scheda Eventi nella quale si configurano le librerie e i gestori eventi dei moduli.

In alternativa, è possibile utilizzare lo strumento di modifica degli script che si preferisce e caricare le modifiche in modo che aggiornino la risorsa Web script. È necessario pubblicare la risorsa Web dopo aver effettuato le modifiche.

Creare librerie di script

Quando si progettano funzioni che verranno utilizzate nelle librerie di JavaScript, le funzioni possono essere caricate in un modulo con altre librerie di JavaScript. Se un'altra libreria contiene una funzione con lo stesso nome di una funzione fornita dall'utente, la funzione caricata per ultima viene definita per la pagina. Per evitare che le proprie funzioni siano sovrascritte dalle funzioni in un'altra libreria, è necessario assicurarsi che le proprie funzioni abbiano nomi univoci.

È possibile utilizzare due strategie per assicurarsi che le proprie funzioni abbiano nomi univoci:

Prefisso univoco di funzione
Definire ognuna delle proprie funzioni utilizzando la sintassi standard con un nome coerente che include una convenzione di denominazione univoca, come illustrato nell'esempio seguente.
```
function MyUniqueName_performMyAction()
{
// Code to perform your action.
}
```
Nomi libreria Namespaced
Associare ognuna delle proprie funzioni a un oggetto di JavaScript per creare un tipo di spazio dei nomi da utilizzare quando si chiama le proprie funzioni, come illustrato nell'esempio seguente.
```
//If the MyUniqueName namespace object isn’t defined, create it.
if (typeof (MyUniqueName) == "undefined")
 { MyUniqueName = {}; }
  // Create Namespace container for functions in this library;
  MyUniqueName.MyFunctions = {
   performMyAction: function(){
   // Code to perform your action.
   //Call another function in your library
   this.anotherAction();
  },
  anotherAction: function(){
   // Code in another function
  }
};
```
Quindi quando si utilizza la funzione si può specificare il nome completo. Di seguito è riportato un esempio di quanto detto.
```
MyUniqueName.MyFunctions.performMyAction();
```
Se si effettua la chiamata una funzione in un'altra funzione è possibile utilizzare la parola chiave this come collegamento all'oggetto che contiene entrambe le funzioni. Tuttavia, se la funzione è utilizzata come gestore eventi, parola chiave this farà riferimento all'oggetto che si sta verificando nell'evento.

Script di debug

Ciascun browser dispone del proprio insieme di strumenti di sviluppo. Nelle istruzioni seguenti di descrive l'utilizzo di Internet Explorer.

Script di debug nei moduli Microsoft Dynamics 365

Premere F12 per aprire gli strumenti di sviluppo.
Nella scheda Script, a destra del pulsante Avvia debug, utilizzare l'elenco a discesa per individuare la libreria JavaScript.
Impostare un punto di interruzione facendo clic sul margine sinistro della funzione.
Fare clic su Avvia debug.
Se lo script si trova nell'evento Onload, è necessario selezionare la finestra di Microsoft Dynamics 365 e premere F5 per ricaricare la finestra.

Per ulteriori informazioni, vedere Debugging Script with Developer Tools (Eseguire il debug degli script con gli strumenti di sviluppo).

Vedere anche

Utilizzare JavaScript con Microsoft Dynamics 365
Personalizzare le applicazioni di Microsoft Dynamics 365
Estendere Microsoft Dynamics 365 nel client
Risorse Web per script (JScript)
Creare il codice per moduli di Microsoft Dynamics 365
Personalizzare moduli di entità
Definire le azioni della barra multifunzione
Esempio: importare file come risorse Web
Esempio: utilità risorsa Web

Microsoft Dynamics 365

Condividi tramite