Événement OnLoad de formulaire

Cet événement se produit lorsque le formulaire est chargé, notamment :

• Au chargement de la page initiale
• Après la sauvegarde (création) d’un nouvel enregistrement

Utilisez les méthodes formContext.ui.addOnLoad et formContext.ui.removeOnLoad pour gérer les gestionnaires d’événements pour cet événement.

Notes

Les contrôles d’un formulaire risquent de ne pas être prêts lorsqu’un événement OnLoad de formulaire se produit. Utilisez l’événement OnLoad du contrôle pour attendre qu’il soit prêt. En savoir plus : Ajouter ou supprimer la fonction de gestionnaire d′événements d′un événement à l′aide de l′interface utilisateur

Prise en charge du gestionnaire d’événements OnLoad asynchrones

Le gestionnaire d’événements OnLoad a la capacité d’attendre que les promesses renvoyées par les gestionnaires d’événements soient résolues avant de charger un formulaire qui permet à un événement OnLoad d’être asynchrone (« async »). L’événement OnLoad devient asynchrone lorsque le gestionnaire d’événements renvoie une promesse.

Le formulaire se charge lorsque chaque promesse renvoyée par le gestionnaire d’événements est résolue. Pour les promesses renvoyées, il y a une limite de 10 secondes pour chaque promesse. Passé ce délai, la plateforme considère que les promesses ont expiré. Ce délai d’attente est appliqué par promesse. Par exemple, si cinq promesses sont renvoyées, le temps d’attente total est de 50 secondes. Supposons que la promesse soit rejetée ou arrive à expiration. Dans ce cas, l’opération de chargement de formulaires se comporte de la même manière par rapport aux erreurs de script en cours.

L’événement OnLoad n’attendra qu’une seule promesse renvoyée par gestionnaire. Si plusieurs promesses sont requises, il est recommandé d’envelopper toutes les promesses dans la méthode Promise.all() et de renvoyer la seule promesse résultante. Pour plusieurs gestionnaires qui renvoient une promesse, nous vous recommandons de créer un gestionnaire qui appelle tous les événements et renvoie une seule promesse qui encapsule toutes les promesses requises. Cela permet de minimiser les délais causés par le temps d’attente.

Activer le gestionnaire OnLoad asynchrone à l’aide du paramètre d’application

Pour utiliser les gestionnaires onLoad asynchrones, vous devez les activer via le paramètre d’application. Un paramètre d’application est un composant de plateforme qui vous permet d’activer ou de désactiver les fonctionnalités prises en charge pour votre application. Pour activer les gestionnaires d’événements Onload asynchrones pour une application spécifique :

1. Accédez à https://make.powerapps.com.

2. Veillez à sélectionner l’environnement correct.

3. Cliquez sur Applications dans le volet de navigation de gauche.

4. Sélectionnez l’application, puis les points de suspension .... Cliquez sur Modifier.

5. Sélectionnez Paramètres dans la barre de commandes.

6. Quand la boîte de dialogue s’ouvre, sélectionnez Fonctionnalités.

7. Activez le Gestionnaire onload asynchrone.

8. Cliquez sur Enregistrer.

   

Délais d’attente OnLoad asynchrones

Lors de l’utilisation d’un gestionnaire asynchrone, un chargement de formulaire attend que la promesse soit exécutée, mais uniquement jusqu’à 10 secondes. Cette limite garantit que le formulaire se charge dans un délai raisonnable.

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).