Configurar els controladors d'incidències dels formularis d'aplicacions basades en models

Nota

Vigent a partir del novembre de 2020:

  • S’ha canviat el nom del Common Data Service per Microsoft Dataverse. Més informació
  • S’han actualitzat alguns termes del Microsoft Dataverse. Per exemple, ara entitat s’anomena taula, i el camp ha passat a anomenar-se columna. Més informació

Aquest article s’actualitzarà pròximament per reflectir la terminologia més recent.

Els controladors d'incidències del formulari per a formularis del Power Apps es poden configurar per a les següents àrees d'un formulari:

Element Incidència Descripció
Formulari OnLoad Es produeix quan es carrega el formulari.
OnSave Es produeix quan les dades es desen.
Tabulació TabStateChange Es produeix quan la pestanya s'expandeix o es contrau.
Columnes OnChange Es produeix quan les dades de la columna canvien i el control perd enfocament.
IFRAME OnReadyStateComplete Es produeix quan es carrega el contingut d'un IFRAME.

Un controlador d'incidències consta d'una referència a un recurs web del JavaScript i una funció definida dins del recurs web que s'executarà quan es produeix la incidència. Cada formulari pot tenir configurats fins a 50 controladors d'incidències independents.

Important

Configurar un controlador d'incidències incorrectament pot ocasionar errors d'scripts que poden provocar que el formulari no es carregui o no funcioni correctament. Si no sou el desenvolupador de l'script, assegureu-vos que compreneu exactament quines opcions de configuració necessita l'script.

No configureu un controlador d'incidències d'scripts mitjançant una biblioteca que no prové d'un origen de confiança. Els scripts es poden utilitzar per realitzar qualsevol acció que podria realitzar un usuari, i un script escrit malament pot perjudicar considerablement el rendiment d'un formulari.

Després de configurar un controlador d'incidències, proveu-lo sempre per comprovar que funciona correctament.

Configurar un controlador d'incidències

El procediment següent descriu com configurar un controlador d'incidències per a un formulari. Utilitzeu passos semblants per configurar un controlador d'incidències per a una pestanya, una columna o un iFrame.

  1. Inicieu la sessió alPower Apps, obriu la taula que vulgueu i, a continuació, obriu el formulari al dissenyador de formularis on voleu configurar un controlador d'incidències.

  2. Segons l'estat de la biblioteca, trieu el següent:

    • Si la biblioteca que conté la funció que voleu definir com a controlador d'incidències ja està disponible, a la subfinestra de propietats dreta, a Formulari principal del compte, seleccioneu la pestanya Incidències i aneu al pas 3.
    • Si la biblioteca que conté la funció que voleu no està disponible, seleccioneu Biblioteques de formularis a la subfinestra de navegació esquerra i seleccioneu Afegeix una biblioteca:
      1. A la pàgina Afegeix una biblioteca del JavaScript, seleccioneu Nova. Afegir la incidència de formulari a la biblioteca.
      2. A la pestanya nova del navegador, completeu les propietats per crear el recurs web JScript i, a continuació, seleccioneu Desa i, a continuació, seleccioneu Publica. Més informació: Crear un recurs web de JavaScript
      3. Tanqueu la pestanya del navegador i torneu a la llista Afegeix una biblioteca del JavaScript.
      4. Seleccioneu el recurs web de JavaScript de la llista, seleccioneu Afegeix i, a continuació, seleccioneu la pestanya Incidències.

      Nota

      Pot ser que hàgiu de seleccionar Cancel·la i, a continuació, seleccionar Afegeix una biblioteca per actualitzar la llista.

  3. A la pestanya Incidències, seleccioneu Controlador d'incidències i empleneu la informació següent per configurar la incidència de formulari i, a continuació, seleccioneu Fet:

    • Tipus d'incidència:

      • En desar: quan es desa un registre després de canviar un camp de formulari.
      • En carregar: quan s'obre el formulari.
    • Biblioteca: el recurs web de JavaScript.

    • Funció: nom de la funció dins del recurs web de JavaScript que s'ha d'executar per a la incidència.

    • Habilitat per defecte, el controlador d'incidències està habilitat. Desactiveu la casella Habilitat si no voleu habilitar aquesta incidència.

    • Passa el context d'execució com a primer paràmetre: algunes funcions requereixen un context d'execució per passar-se a la funció. Seleccioneu Transfereix el context d'execució com el primer paràmetre si és necessari.

    • Llista de paràmetres separats per comes que es passarà a la funció: algunes funcions poden acceptar un conjunt de paràmetres per controlar el comportament d'una funció. Si són obligatoris, introduir-los a la Llista de paràmetres separats per comes que es transferiran a la funció.

    • Dependències de columnes de taula: per a les incidències En desar, seleccioneu les columnes on voleu que s'activi la incidència després de desar el registre.

      Configurar la incidència per al formulari.

  4. Deseu i publiqueu el formulari.

Configurar un controlador d'incidències mitjançant l'experiència clàssica

  1. A l'editor de formularis clàssic, seleccioneu l'element amb la incidència per a la qual voleu configurar un controlador.

  2. A la pestanya Inici, al grup Edita, seleccioneu Canvia les propietats o simplement feu doble clic a l'element.

  3. Al diàleg de propietats d'element, seleccioneu la pestanya Incidències.

  4. Expandiu l'àrea Biblioteques de formularis. Si la biblioteca que conté la funció que voleu definir com el controlador d'incidències no està preparada, afegiu la biblioteca.

  5. Afegir una biblioteca formularis a un controlador d'incidències:

    1. A la secció Biblioteques de formularis de la Llista d'incidències, trieu Afegeix.

    2. Localitzeu el recurs web del JavaScript a la llista de recursos web disponibles. Seleccioneu-los i després trieu Afegeix.

      Si el recurs web del JavaScript que necessiteu no existeix, seleccioneu Nou per obrir un nou formulari de recurs web i crear-ne un.

    3. Per crear un recurs web de JavaScript, vegeu Crear un recurs web de JavaScript.

    4. El recurs web que heu creat ara està seleccionat al diàleg Cerca una fila. Trieu Afegeix per tancar el quadre de diàleg.

  6. A la secció Controladors d'incidències, seleccioneu la incidència per a la qual voleu definir un controlador d'incidències.

  7. Trieu Afegeix per obrir el quadre de diàleg Propietats del gestor.

  8. A la pestanya Detalls, trieu la biblioteca adequada i escriviu el nom de la funció que s'ha d'executar per a la incidència.

  9. Per defecte, el controlador d'incidències està habilitat. Desactiveu la casella Habilitat si no voleu habilitat aquesta incidència.

    Algunes funcions requereixen la transferència d'un context d'execució a la funció. Seleccioneu Transfereix el context d'execució com el primer paràmetre si és necessari.

    Algunes funcions poden acceptar un conjunt de paràmetres per controlar el comportament d'una funció. Si són obligatoris, introduir-los a la Llista de paràmetres separats per comes que es transferiran a la funció.

  10. A la pestanya Dependències, afegiu les columnes de les quals depèn l'script a l'àrea Columnes dependents.

  11. Trieu D'acord per tancar el quadre de diàleg Propietats del gestor.

  12. Quan s'introdueix el controlador d'incidències, podeu ajustar l'ordre en el qual la funció s'executarà en relació amb qualsevol altra funció utilitzant les fletxes verdes per desplaçar-lo amunt o avall.

  13. Trieu D'acord per tancar el quadre de diàleg de propietats dels elements.

  14. Seleccioneu Desa per desar els canvis. Trieu Publica per publicar el formulari.

Nota

Tot i que la interfície d'usuari (UI) permet ajustar l'ordre en què els scripts es carreguen utilitzant les fletxer verdes cap amunt i cap avall, en realitat els scripts no es carreguen seqüencialment.

Crear un recurs web del JavaScript

  1. Al formulari de recurs web, definiu les propietats següents:

    Propietat Valor
    Nom Obligatori. Escriu el nom del recurs web.
    Nom de visualització Obligatori. Escriviu el nom que es mostrarà a la llista de recursos web.
    Descripció Opcional. Escriviu una descripció del recurs web.
    Tipus Obligatori. Seleccioneu Script (JScript).
    Llengua Opcional. Trieu una de les llengües disponibles per a la vostra organització.
  2. Si se us ha proporcionat un script, es recomana encaridament que premeu el botó Explora per localitzar el fitxer i carregar-lo.

De manera alternativa, podeu triar el botó Editor de text i enganxeu o escriviu el contingut de l'script al diàleg Edita el contingut.

Nota

Atès que aquest editor de text senzill no proporciona característiques per comprovar l'exactitud de l'script, normalment, heu de provar a utilitzar sempre una aplicació independent com ara el Visual Studio per editar scripts i, a continuació, carregar-los.

  1. Trieu Desa i tanqueu la pàgina del recurs web.

Passos següents

Tutorial: Escriure la primera seqüència d'ordres de client
Ús del formulari principal i els seus components