Caricamento di script
Per usare script client su un modulo, è necessario innanzitutto caricare lo script come risorsa Web script. Si possono usare le risorse Web script per mantenere le librerie di funzioni di script client scritte in JavaScript o in TypeScript, come pure usarle dall'interno di un modulo di app basata su modello o dalla definizione della barra dei comandi. Se si usa TypeScript, occorre estrarlo in JavaScript prima del caricamento come risorsa Web.
Per caricare una risorsa Web script, creare una nuova libreria di moduli dall'editor di moduli.
Verrà visualizzata la finestra popup Aggiungi libreria JavaScript. Selezionare + Nuova risorsa Web in alto a destra. Nel riquadro Nuova risorsa Web accertarsi di selezionare JavaScript (JS) come tipo.
Affinché i dati delle colonne della tabella siano disponibili per l'inclusione nella logica di uno script, accertarsi di aver configurato il modulo in modo che visualizzi la colonna. Tenere presente che se qualcuno in seguito rimuove la colonna dal modulo, lo script si interromperà perché la colonna a cui fa riferimento non è più disponibile. È possibile aggiungere la colonna come dipendenza per assicurarsi che i dati della colonna siano sempre disponibili per la logica dello script. L'immagine seguente mostra l'aggiunta della colonna Punteggio idea dalla tabella Idea come dipendenza.
Dipendenze delle risorse Web
Oltre alle dipendenze dei dati, è anche possibile configurare dipendenze su altre risorse Web. Questa dipendenza consente di risparmiare tempo e semplifica la logica di caricamento perché il modulo non dovrà caricare in modo esplicito più risorse Web dipendenti quando si registra uno script per un evento del modulo, un comando della barra multifunzione o regole di abilitazione della barra multifunzione. Con la configurazione delle dipendenze, è possibile registrare lo script principale e lasciare che la configurazione delle dipendenze carichi le altre risorse richieste dal codice.
È importante notare che le dipendenze delle risorse Web non forniscono alcun controllo sull'ordine in cui le risorse Web si caricano. Tutte le risorse Web si caricano in modo asincrono e in parallelo. Se si ha una risorsa Web JavaScript che dipende da un'altra risorsa Web JavaScript che si deve caricare e inizializzare prima di poter inizializzare la prima risorsa, sarà necessario gestire tale dipendenza in un altro modo.
Uso delle librerie di script client
Dopo aver configurato una risorsa Web script, è possibile associare librerie di script client a comandi della barra multifunzione e a eventi del modulo. Per associare uno script a un modulo, selezionare Librerie modulo nella barra degli strumenti e quindi Aggiungi libreria.
Dalla finestra di dialogo Aggiungi libreria è possibile associare una risorsa Web script caricata esistente o crearne una nuova.
L'associazione della libreria di script al modulo è richiesta una sola volta per script per ogni modulo, indipendentemente dal numero di gestori eventi registrati su quel modulo.
Se è necessario apportare delle modifiche perché si sta creando la logica di script client dopo il caricamento iniziale, occorre tornare alla risorsa Web script nella soluzione e caricare la nuova versione del file. Dopo il caricamento, è necessario pubblicare la risorsa Web script affinché l'app usi le modifiche più recenti.