Configurar controladores de eventos para un formulario
Este tema aplícase a Dynamics 365 Customer Engagement (on-premises). Para a versión de Power Apps deste tema, consulte: Configura controladores de eventos de formularios de aplicacións baseados en modelos
Os controladores de eventos para formularios de Dynamics 365 Customer Engagement (on-premises) poden configurarse para as seguintes áreas nun formulario:
| Elemento | Evento | Descrición |
|---|---|---|
| Formulario | OnLoad |
Prodúcese cando se carga o formulario. |
OnSave |
Prodúcese cando se gardan os datos. | |
| Separador | TabStateChange |
Prodúcese cando se expande ou cando se contrae o separador. |
| Campo | OnChange |
Prodúcese cando os datos no campo modifícanse e o control perde enfoque. |
| IFRAME | OnReadyStateComplete |
Prodúcese cando se carga o contido dun IFRAME. |
Un controlador de eventos consiste nunha referencia a un recurso web de JavaScript e nunha función definida nese recurso web que se executará cando se produza o evento. Cada elemento poden ter até 50 controladores de eventos independentes configurados.
Importante
Configurar un controlador de eventos incorrectamente poden provocar erros de script que poden causar que o formulario non cargue ou non funcione correctamente. Se non é o programador do script, asegúrese de comprender exactamente que opcións de configuración require o script.
Non configure un controlador de eventos de script mediante unha biblioteca que non provén dunha orixe na que confía. Os scripts poden usarse para realizar calquera acción que pode realizar un usuario e un script pobre pode danar significativamente o desempeño dun formulario.
Despois de configurar un controlador de eventos próbeo sempre para comprobar que funciona correctamente.
Para configurar un controlador de eventos
No editor de formularios, seleccione o elemento co evento para o que quere configurar o controlador.
Na pestana Inicio, no grupo Editar , seleccione Cambiar propiedades ou simplemente prema dúas veces no elemento.
No diálogo de propiedades do elemento, seleccione a pestana Eventos .
Amplíe a área Bibliotecas de formularios . Se a biblioteca que contén a función que quere definir como o controlador de eventos aínda non aparece, engada a biblioteca.
Para engadir unha biblioteca de formularios a un controlador de eventos:
Na sección Bibliotecas de formularios da Lista de eventos, seleccione Engadir.
Localice o recurso web de JavaScript na lista de recursos web dispoñibles. Selecciónao e despois selecciona Engadir.
Se o recurso web JavaScript que precisa non existe, seleccione Novo para abrir un novo formulario de recurso web e crear un.
Para crear un recurso web de JavaScript:
No formulario do recurso web configure as propiedades seguintes:
Propiedade Valor Nome Necesario. Escriba o nome do recurso web. Nome para mostrar Necesario. Escriba o nome que se mostrará na lista de recursos web. Descrición Opcional. Escriba unha descrición do recurso web. Tipo Necesario. Seleccione Script (JScript). Idioma Opcional. Escolla un dos idiomas dispoñibles para a súa organización. Se se che proporcionou un script, recomendámosche que utilices o botón Examinar para localizar o ficheiro e cargalo.
Alternativamente, pode seleccionar o botón Editor de texto e pegar ou escribir o contido do script no Editar contido diálogo.
Nota
Debido a que este editor de texto non fornece ningunha funcionalidade para comprobar a corrección do script, deberá tentar usar sempre unha aplicación independente como Visual Studio para editar scripts e, a seguir, cargalos.
Seleccione Gardar e pecha o diálogo de recursos web.
O recurso web que creaches agora está seleccionado no diálogo Buscar rexistro . Seleccione Engadir para pechar o diálogo.
Na sección Xestores de eventos , seleccione o evento para o que quere configurar un controlador de eventos.
Seleccione Engadir para abrir o diálogo Propiedades do controlador .
Na pestana Detalles escolla a biblioteca adecuada e escriba o nome da función que se debe executar para o evento.
Por defecto, o controlador de eventos está activado. Desmarque a caixa de verificación Activado se non quere activar este evento.
Algunhas funcións requiren un contexto de execución para que se transmita á función. Seleccione Pasar contexto de execución como primeiro parámetro se é necesario.
Algunhas funcións poden aceptar un conxunto de parámetros para controlar o comportamento dunha función. Se son necesarios, introdúceos na lista de parámetros separados por comas que se pasarán á función.
Na pestana Dependencias , engade todos os campos dos que dependa o script na área Campos dependentes .
Seleccione Aceptar para pechar o diálogo Propiedades do controlador .
Cando se introduza o controlador de eventos, é posible que teña que axustar a orde na que se executará a función en relación a calquera outra función mediante as frechas verdes para movela cara abaixo ou cara arriba.
Seleccione Aceptar para pechar o diálogo de propiedades do elemento.
Seleccione Gardar para gardar as modificacións. Seleccione Publicar para publicar o formulario.
Nota
Aínda que a interface de usuario (IU) lle permite axustar a orde en que as secuencias de comandos se cargan mediante as frechas verdes cara arriba e cara abaixo, as secuencias de comandos en realidade non se cargan en orde.