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. métodos removeOnLoad para gerenciar manipuladores de eventos para este evento.

Suporte ao manipulador de eventos OnLoad assíncrono

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

O formulário é carregado quando cada promessa retornada pelo manipulador de eventos é resolvida. Para qualquer promessa retornada, há um limite de 10 segundos para cada promessa. Depois disso, a plataforma considera que as promessas serão cronometrada. Esse tempo limite é aplicado por promessa. Por exemplo, se você tiver cinco promessas retornadas, o tempo total de espera será de 50 segundos. Suponha que a promessa seja rejeitada ou atingiu o tempo limite. 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 encapsular 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 encapsula todas as promessas necessárias. Isso é para minimizar os tempos de espera causados pelo tempo limite.

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

Para usar manipuladores assíncronos noLoad, 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 recursos com suporte para seu aplicativo. Para habilitar os manipuladores de eventos do Onload assíncrono para um aplicativo específico:

1. Ir para https://make.powerapps.com.

2. Selecione o ambiente correto.

3. Selecione Aplicativos no painel de navegação esquerdo.

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

5. Selecione Configurações na barra de comandos.

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

7. Ative o manipulador de carregamento assíncrono.

8. Clique em Salvar.

   

Tempos limite de OnLoad assíncrono

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

Artigos relacionados

Eventos (referência à API do cliente)
Eventos em formulários e grades em aplicativos baseados em modelos