Eventi nei moduli e nelle griglie nelle app basate su modello

Gli eventi avviano tutto il codice lato client. Nelle app basate su modello si associa una funzione specifica in una libreria JavaScript (risorsa Web Script) da eseguire quando si verifica un evento. Questa funzione è denominata gestore eventi. Ogni gestore eventi specifica una singola funzione all'interno di una libreria JavaScript e qualsiasi parametro che può essere passato alla funzione.

È possibile associare i gestori eventi solo ad alcuni eventi usando l'interfaccia utente. Per gli eventi che non sono disponibili per essere associati tramite l'interfaccia utente, l'API client fornisce metodi che possono essere usati per collegare gestori eventi a tali eventi.

Aggiungere o rimuovere la funzione del gestore eventi all'evento tramite l'interfaccia utente

eredità

Utilizzare la sezione Gestori eventi della finestra di dialogo Proprietà modulo per associare lo script a un evento per moduli e colonne.

Interfaccia unificata

Per aggiungere o rimuovere funzioni del gestore eventi agli eventi nella nuova interfaccia unificata:

1. Vai a Power Apps.

2. Nel riquadro di spostamento a sinistra selezionare Dati e quindi tabelle.

3. Nell'elenco delle tabelle selezionare la tabella in cui si desidera aggiungere i gestori eventi.

4. Selezionare la scheda Moduli dalla barra dei comandi e quindi selezionare il modulo da aggiungere.

   

5. Selezionare la scheda Eventi . Si notino sia i gestori eventi On Save che On Load .

   

6. Se si desidera aggiungere il gestore eventi per l'evento di modifica, selezionare la colonna e quindi selezionare scheda Evento .

   

Moduli di modifica in blocco

Per impostazione predefinita, i gestori eventi non vengono chiamati quando un modulo è in modalità di modifica bulk.

Per abilitare un gestore eventi in modalità di modifica bulk, modificare il codice XML del modulo individuando l'elemento pertinente event e creando/impostando l'attributo BehaviorInBulkEditForm su Enabled. Attualmente, questa opzione è supportata solo per gli eventi OnLoad.

Per altre informazioni sulla personalizzazione xml del modulo, vedere Quando modificare il file di personalizzazioni, Personalizzare moduli e XML Schema del modulo.

Per determinare quando viene chiamato un gestore eventi in una maschera in modalità di modifica bulk, utilizzare il getFormType metodo .

Aggiungere o rimuovere la funzione del gestore eventi all'evento usando il codice

Usando i metodi seguenti per aggiungere e rimuovere il gestore eventi per gli eventi che non possono essere associati tramite l'interfaccia utente:

Events	Gestore di eventi
Attributo OnChange	Metodi addOnChange e removeOnChange
OnLoad modulo	Metodi formContext.ui addOnLoad e removeOnLoad
Modulo caricato	metodi addLoaded e removeLoaded di formContext.ui
OnLoad dei dati del modulo	Metodi addOnLoad e removeOnLoad di formContext.data
Salva modulo	Metodi addOnSave e removeOnSave
Controllo di ricerca - Ricerca	Metodi addPreSearch e removePreSearch
Controllo kbsearch OnResultOpened	Metodi addOnResultOpened e removeOnResultOpened
Controllo kbsearch OnSelection	Metodi addOnSelection e removeOnSelection
Controllo kbsearch PostSearch	Metodi addOnPostSearch e removeOnPostSearch

Importante

Il contesto di esecuzione viene passato automaticamente come primo parametro alle funzioni impostate usando il codice. Altre informazioni: Contesto di esecuzione dell'API client

Pipeline di eventi del modulo

È possibile definire fino a 50 gestori eventi per ogni evento. Ogni gestore eventi viene eseguito nell'ordine in cui viene visualizzato nella sezione Gestori eventi della scheda Eventi della finestra di dialogo Proprietà modulo .

Usare i metodi setSharedVariable e getSharedVariable per passare una variabile comune tra gestori eventi (funzioni). Usare il metodo getDepth del contesto di esecuzione per conoscere la sequenza in cui viene eseguito un gestore eventi rispetto ad altri gestori eventi.

Articoli correlati

Comprendere il modello a oggetto dell'API client
Contesto di esecuzione dell'API client
Eventi (informazioni di riferimento sulle API client)