Partager via

Événement OnLoad de formulaire

  • Article

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.

Note

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

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

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

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 attendra une promesse renvoyée par gestionnaire. OnLoad Si plusieurs promesses sont requises, il est recommandé de Inclure dans un wrapper toutes les promesses dans la méthode Promise.all() et de renvoyer la promesse unique 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éder à https://make.powerapps.com.

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

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

  4. Sélectionner l’application puis Sélectionner ... (ellipses). Cliquez sur Modifier.

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

  6. Lorsque la boîte de dialogue s’ouvre, Sélectionner Fonctionnalités.

  7. Activez le gestionnaire de chargement asynchrone.

  8. Sélectionnez Enregistrer.

    Paramètre d’application OnLoad asynchrone

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.

Événements (référence API client)
Événements dans les formulaires et les grilles dans les applications pilotées par modèle