Esdeveniments en formularis i quadrícules en aplicacions basades en models

Els esdeveniments inicien tot el codi del client. A les aplicacions basades en models, associeu una funció específica en una biblioteca JavaScript (recurs web Script) que s'executarà quan es produeix un esdeveniment. Aquesta funció s'anomena controlador d'esdeveniments. Cada controlador d'esdeveniments especifica una sola funció dins d'una biblioteca JavaScript i qualsevol paràmetre que es pugui passar a la funció.

Podeu associar controladors d'incidències només a alguns esdeveniments mitjançant la interfície d'usuari. Per als esdeveniments que no estan disponibles per associar-los a través de la interfície d'usuari, l'API de client proporciona mètodes que es poden utilitzar per adjuntar controladors d'incidències a aquests esdeveniments.

Afegir o suprimir la funció del controlador d'incidències a l'esdeveniment mitjançant la interfície d'usuari

Llegat

Utilitzeu la secció Controladors d'incidències del quadre de diàleg Propietats del formulari per associar l'script amb un esdeveniment per a formularis i columnes.

Interfície unificada

Per afegir o suprimir funcions del controlador d'incidències als esdeveniments de la nova interfície unificada:

1. Ves a Power Apps.

2. A la subfinestra de navegació esquerra, seleccioneu Dades i, a continuació, seleccioneu Taules.

3. A la llista de taules, seleccioneu la taula on voleu afegir els controladors d'incidències.

4. Seleccioneu la pestanya Formularis a la barra d'ordres i, a continuació, seleccioneu el formulari on voleu afegir.

   

5. Seleccioneu la pestanya Esdeveniments . Observeu els controladors d'incidències On Save i On Load .

   

6. Si voleu afegir el controlador d'incidències per a l'esdeveniment en canviar, seleccioneu la columna i, a continuació, seleccioneu la pestanya Esdeveniment .

   

Formularis d'edició massiva

Per defecte, els gestors d'esdeveniments no es criden quan un formulari està en mode d'edició massiva.

Per habilitar un controlador d'esdeveniments en mode d'edició massiva, modifiqueu l'XML del formulari cercant l'element rellevant event i creant/establint l'atribut BehaviorInBulkEditForm a Enabled. Actualment, això només s'admet per a esdeveniments OnLoad.

Per obtenir més informació sobre la personalització XML del formulari, vegeu Quan s'ha d'editar el fitxer de personalització, Personalitzar els formularis i l'esquema XML del formulari.

Per determinar quan es crida un controlador d'incidències en un formulari en mode d'edició massiva, utilitzeu getFormType el mètode.

Afegir o suprimir la funció del controlador d'incidències a l'esdeveniment mitjançant el codi

Utilitzeu els mètodes següents per afegir i suprimir el controlador d'incidències per a esdeveniments que no es poden associar mitjançant la interfície d'usuari:

Esdeveniments	Controlador d'incidències
Atribut OnChange	Mètodes addOnChange i removeOnChange
Formulari OnLoad	formContext.ui addOnLoad i removeOnLoad mètodes
Formulari carregat	formContext.ui addLoaded i removeLoaded mètodes
Dades del formulari OnLoad	formContext.data addOnLoad i removeOnLoad mètodes
Formulari OnSave	Mètodes addOnSave i removeOnSave
Control de cerca Cerca prèvia	Mètodes addPreSearch i removePreSearch
control kbsearch OnResultOpened	Mètodes addOnResultOpened i removeOnResultOpened
control kbsearch OnSelection	Mètodes addOnSelection i removeOnSelection
control kbsearch PostSearch	Mètodes addOnPostSearch i removeOnPostSearch

Important

El context d'execució es passa automàticament com a primer paràmetre a les funcions que s'estableixen mitjançant el codi. Més informació: Context d'execució de l'API de client

Pipeline d'esdeveniments de formulari

Podeu definir fins a 50 controladors d'incidències per a cada esdeveniment. Cada controlador d'incidències s'executa en l'ordre en què es mostra a la secció Controladors d'incidències de la pestanya Esdeveniments del quadre de diàleg Propietats del formulari .

Utilitzeu els mètodes setSharedVariable i getSharedVariable per passar una variable comuna entre gestors d'incidències (funcions). Utilitzeu el mètode getDepth del context d'execució per conèixer la seqüència en què s'executa un controlador d'incidències en relació amb altres controladors d'esdeveniments.

Articles relacionats

Entendre el model d'objectes de l'API de client
Context d'execució de l'API del client
Esdeveniments (referència de l'API del client)