Eventi nei moduli e nelle griglie nelle app basate su modello

Gli eventi nei moduli e nelle griglie avviano tutto il codice lato client nelle app basate su modello. Associare 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 è possibile associare tramite l'interfaccia utente, l'API client fornisce metodi che è possibile usare per collegare gestori eventi.

Aggiungere o rimuovere funzioni del gestore eventi nei moduli usando l'interfaccia utente

Per aggiungere o rimuovere funzioni del gestore eventi per gli 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 in cui si vuole aggiungere il gestore eventi.

    Screenshot della scheda Moduli che mostra l'elenco dei moduli per una tabella in Power Apps.

  5. Selezionare la scheda Eventi . Vengono visualizzati sia i gestori eventi On Save che On Load .

    Screenshot della scheda Eventi che mostra i gestori eventi del modulo On Save and On Load.

  6. Per aggiungere un gestore eventi per l'evento di modifica, selezionare la colonna e quindi selezionare la scheda Evento .

    Screenshot della scheda Eventi della colonna che mostra le impostazioni del gestore eventi On Change.

Moduli di modifica in blocco

Per impostazione predefinita, i gestori eventi non vengono eseguiti 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 o impostando l'attributo BehaviorInBulkEditForm su Enabled. Attualmente, questo comportamento è supportato 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 un gestore eventi viene eseguito in una maschera in modalità di modifica bulk, utilizzare il getFormType metodo .

Aggiungere o rimuovere funzioni del gestore eventi usando il codice DELL'API client

Usare i metodi seguenti per aggiungere e rimuovere gestori eventi per gli eventi che non è possibile associare 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 . Per altre informazioni, vedere Contesto di esecuzione dell'API client.

Pipeline di eventi del modulo

È possibile definire fino a 50 gestori eventi per ogni evento. La sezione Gestori eventi nella scheda Eventi della finestra di dialogo Proprietà modulo mostra l'ordine dei gestori eventi e ogni gestore eventi viene eseguito in tale ordine.

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

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