Evento Form OnLoad

Esse evento ocorre sempre que o formulário é carregado, especificamente:

• No carregamento inicial da página
• Depois que um novo registro é salvo pela primeira vez (criado)

Use o formContext.ui. addOnLoad e formContext.ui. removeOnLoad métodos para gerenciar manipuladores de eventos para este evento.

Suporte assíncrono ao manipulador de eventos OnLoad

O OnLoad manipulador de eventos tem a capacidade de aguardar que as promessas retornadas pelos manipuladores de eventos sejam liquidadas antes de carregar um formulário que permite que um OnLoad evento seja assíncrono ("assíncrono"). O OnLoad evento torna-se assíncrono quando o manipulador de eventos retorna uma promessa.

O formulário é carregado quando cada promessa retornada pelo manipulador de eventos é resolvida. Para todas as promessas devolvidas, há um limite de 10 segundos para cada promessa. Depois disso, a plataforma considera que as promessas serão esgotadas. Este tempo limite é aplicado por promessa. Por exemplo, se você tiver cinco promessas retornadas, o tempo total de espera é de 50 segundos. Suponha que a promessa seja rejeitada ou esgotada. Nesse caso, a operação de carregamento de formulário se comporta de forma semelhante aos erros de script atuais.

O OnLoad evento aguardará uma promessa retornada por manipulador. Se várias promessas forem necessárias, é recomendável envolver todas as promessas no Promise.all() método e retornar a única promessa resultante. Para vários manipuladores que retornam uma promessa, recomendamos que você crie um manipulador que chame todos os eventos e retorne uma única promessa que envolva todas as promessas necessárias. Isso é para minimizar os tempos de espera causados pelo tempo limite.

Ativar o Async OnLoad usando a configuração do aplicativo

Para usar manipuladores onLoad assíncronos, você precisará habilitá-lo por meio da configuração do aplicativo. Uma configuração de aplicativo é um componente de plataforma que permite ativar ou desativar os recursos suportados para seu aplicativo. Para habilitar os manipuladores de eventos Onload assíncronos para um aplicativo específico:

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

2. Certifique-se de selecionar o ambiente correto.

3. Selecione Aplicações no painel de navegação esquerdo.

4. Selecione o aplicativo e, em seguida, selecione ... (reticências). Selecione Editar.

5. Selecione Definições na barra de comando.

6. Quando a caixa de diálogo abrir, selecione Recursos.

7. Ative o manipulador de carga assíncrona.

8. Selecione Guardar.

   

Tempos limite do Async OnLoad

Ao usar um manipulador assíncrono, uma carga de formulário aguarda o cumprimento da promessa, mas apenas até 10 segundos. Esse limite garante que o formulário seja carregado dentro de um período de tempo razoável.

Artigos relacionados

Eventos (referência da API do cliente)
Eventos em formulários e grelhas em aplicações condicionadas por modelo