Evento OnLoad de formulario

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.data.removeOnLoad para administrar los controladores de eventos para este evento.

Nota

Los controles en un formulario pueden no estar listos cuando ocurre un evento OnLoad de formulario. Utilizar el evento OnLoad del control para esperar a que esté listo. Más información: Agregar o quitar funciones de controlador de eventos a eventos mediante la interfaz de usuario

Compatibilidad con el controlador de eventos OnLoad asincrónicos

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

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 OnLoad solo esperará a que se devuelva una promesa por controlador. Si se requieren varias promesas, se recomienda encapsular todas las promesas en el método Promise.all() y devolver la única promesa resultante. 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. Seleccione la aplicación y, a continuación, seleccione ... (puntos suspensivos). Seleccione Editar.

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

6. Cuando se abra el cuadro de diálogo, seleccione Características.

7. Active Controlador onload asincrónico.

8. Seleccione Guardar.

   

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.

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).