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

Els esdeveniments en formularis i graelles inicien tot el codi del costat client en aplicacions basades en models. S'associa una funció específica en una biblioteca JavaScript (recurs web Script) per executar-la 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ó.

Pots associar gestors d'esdeveniments només a alguns esdeveniments utilitzant la interfície d'usuari. Per als esdeveniments que no pots associar a través de la interfície, l'API del client proporciona mètodes que pots utilitzar per adjuntar gestors d'esdeveniments.

Afegir o eliminar funcions gestores d'esdeveniments en formularis utilitzant la interfície d'usuari

Per afegir o eliminar funcions del gestor d'esdeveniments per a esdeveniments a 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. Selecciona la pestanya Forms des de la barra de comandes i després selecciona el formulari on vols afegir el gestor d'esdeveniments.

    Captura de pantalla de la pestanya Forms que mostra la llista de formularis per a una taula a Power Apps.

  5. Selecciona la pestanya Esdeveniments . Veus tant els gestors d'esdeveniments On Save com On Load .

    Captura de pantalla de la pestanya d'Esdeveniments que mostra els gestors d'esdeveniments dels formularis On Save i On Load.

  6. Per afegir un gestor d'esdeveniments per a l'esdeveniment de canvi, selecciona la columna i després selecciona la pestanya Esdeveniment .

    Captura de pantalla de la pestanya d'Esdeveniments de la columna que mostra la configuració del gestor d'esdeveniments On Change.

Formularis d'edició massiva

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

Per habilitar un gestor d'esdeveniments en mode d'edició massiva, modifica l'XML del formulari trobant l'element rellevant event i creant o configurant l'atribut BehaviorInBulkEditForm a Enabled. Actualment, aquest comportament només es suporta per a esdeveniments OnLoad.

Per a més informació sobre la personalització del Formulari XML, vegeu Quan editar el fitxer de personalitzacions, Personalitzar formularis i l'esquema del Formulari XML.

Per determinar quan un gestor d'esdeveniments s'executa en un formulari en mode d'edició massiva, utilitzeu el getFormType mètode.

Afegir o eliminar funcions del gestor d'esdeveniments utilitzant codi API del client

Utilitza els següents mètodes per afegir i eliminar gestors d'esdeveniments per a esdeveniments que no puguis associar a través de 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 configures utilitzant el codi. Per a més informació, vegeu Context d'execució de l'API del client.

Pipeline d'esdeveniments de formulari

Podeu definir fins a 50 controladors d'incidències per a cada esdeveniment. La secció de Gestors d'Esdeveniments a la pestanya Esdeveniments del quadre de diàleg Propietats del Formulari mostra l'ordre dels gestors d'esdeveniments, i cada gestor d'esdeveniments s'executa en aquest ordre.

Utilitzeu els mètodes setSharedVariable i getSharedVariable per passar una variable comuna entre gestors d'incidències (funcions). Utilitza el mètode getDepth del context d'execució per entendre la seqüència d'execució dels gestors d'esdeveniments en relació amb altres gestors d'esdeveniments.

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)

  • Darrera actualització el