Compartir vía

Evento OnLoad de formulario

  • Artículo

Este evento se produce cada vez que se carga el formulario, específicamente:

  • Durante la carga de páginas de inicio
  • Después de que se guarde (cree) un nuevo registro por primera vez

Utilice los métodos formContext.ui.addOnLoad y formContext.ui.removeOnLoad para administrar los controladores de eventos para este evento.

Nota

Es posible que los controles de un formulario no estén listos cuando se produce el evento OnLoad de un formulario. Utilice el evento OnLoad del control para esperar a que esté listo. Más información: Agregar o eliminar la función del controlador de eventos al evento mediante la interfaz de usuario

Compatibilidad con el controlador de eventos OnLoad asincrónicos

El controlador de eventos tiene la capacidad de esperar a que se cumplan las promesas devueltas por los controladores de eventos antes de cargar un formulario que permite que un evento sea asincrónico ("async"). OnLoad OnLoad El evento se vuelve asíncrono cuando el controlador de eventos devuelve una promesa. OnLoad

El formulario se carga cuando se resuelve cada promesa devuelta por el controlador de eventos. Para las promesas que se devuelven, hay un límite de 10 segundos para cada promesa. Después de eso, la plataforma considera que las promesas están agotadas. Este tiempo de espera se aplica según la promesa. Por ejemplo, si le devuelven cinco promesas, el tiempo total de espera es de 50 segundos. Suponga que la promesa se rechaza o se agota el tiempo. En ese caso, la operación de carga del formulario se comporta de manera similar a los errores de secuencia de comandos actuales.

El evento esperará a que se devuelva una promesa por controlador. OnLoad Si se requieren múltiples promesas, se recomienda Encapsular todas las promesas en el método y devolver la única promesa resultante. Promise.all() Para varios controladores que devuelven una promesa, le recomendamos que cree un controlador que llame a todos los eventos y devuelva una única promesa que encapsule todas las promesas necesarias. Esto es para minimizar los tiempos de espera causados por el tiempo de espera.

Habilitar Async OnLoad usando la configuración de la aplicación

Para usar controladores onLoad asíncronos, deberá habilitarlos a través de la configuración de la aplicación. La configuración de una aplicación es un componente de la plataforma que le permite activar o desactivar las funciones admitidas para su aplicación. Para habilitar los controladores del evento asincrónico Onload para una aplicación específica:

  1. Vaya a https://make.powerapps.com.

  2. Asegúrese de seleccionar el entorno correcto.

  3. Seleccione Aplicaciones en el panel de navegación izquierdo.

  4. Seleccionar la aplicación y luego Seleccionar ... (puntos suspensivos). Seleccione Editar.

  5. Seleccionar Configuración en la barra de comandos.

  6. Cuando se abra el cuadro de diálogo, aparecerán las siguientes opciones: Seleccionar Características.

  7. Activar el controlador de carga asíncrona.

  8. Seleccione Guardar.

    Configuración de la aplicación Async OnLoad

Tiempo de espera de Async OnLoad

Cuando se usa un controlador asíncrono, la carga de un formulario espera a que se cumpla la promesa, pero solo hasta 10 segundos. Este límite garantiza que el formulario se cargue en un período de tiempo razonable.

Eventos (referencia de API de cliente)
Eventos en formularios y cuadrículas en aplicaciones basadas en modelos