Événements dans les formulaires et les grilles des applications basées sur un modèle

Les événements dans les formulaires et les grilles lancent tout le code côté client dans les applications basées sur des modèles. Vous associez une fonction spécifique dans une bibliothèque JavaScript (ressource web de script) à exécuter lorsqu’un événement se produit. Cette fonction est appelée gestionnaire d′événements. Chaque gestionnaire d′événements spécifie une fonction unique au sein d′une bibliothèque JavaScript et tous les paramètres qui peuvent être transmis à la fonction.

Vous pouvez associer des gestionnaires d’événements à certains événements uniquement à l’aide de l’interface utilisateur. Pour les événements que vous ne pouvez pas associer via l’interface utilisateur, l’API cliente fournit des méthodes que vous pouvez utiliser pour attacher des gestionnaires d’événements.

Ajouter ou supprimer des fonctions de gestionnaire d’événements dans des formulaires à l’aide de l’interface utilisateur

Pour ajouter ou supprimer des fonctions de gestionnaire d’événements pour les événements dans la nouvelle interface unifiée :

  1. Accéder à Power Apps.

  2. Dans le volet de navigation de gauche, sélectionnez Données, puis sélectionnez Tables.

  3. Dans la liste des tables, sélectionnez la table dans laquelle vous souhaitez ajouter les gestionnaires d′événements.

  4. Sélectionnez l’onglet Formulaires dans la barre de commandes, puis sélectionnez le formulaire dans lequel vous souhaitez ajouter le gestionnaire d’événements.

    Capture d’écran de l’onglet Formulaires montrant la liste des formulaires d’un tableau dans Power Apps.

  5. Sélectionnez l’onglet Événements . Vous voyez à la fois les gestionnaires d’événements On Save et On Load .

    Capture d’écran de l’onglet Événements montrant les gestionnaires d’événements sur l’enregistrement et le chargement.

  6. Pour ajouter un gestionnaire d’événements pour l’événement de modification, sélectionnez la colonne, puis sélectionnez l’onglet Événement .

    Capture d’écran de l’onglet Événements de colonne montrant les paramètres du gestionnaire d’événements On Change.

Formulaires de modification en bloc

Par défaut, les gestionnaires d’événements ne s’exécutent pas lorsqu’un formulaire est en mode d’édition en bloc.

Pour activer un gestionnaire d’événements en mode édition en bloc, modifiez le code XML de formulaire en recherchant l’élément approprié event et en créant ou en définissant l’attribut BehaviorInBulkEditForm sur Enabled. Actuellement, ce comportement est pris en charge uniquement pour les événements OnLoad.

Pour plus d’informations sur la personnalisation XML de formulaire, consultez Quand modifier le fichier de personnalisations, personnaliser les formulaires et le schéma XML de formulaire.

Pour déterminer quand un gestionnaire d’événements s’exécute sur un formulaire en mode édition en bloc, utilisez la getFormType méthode.

Ajouter ou supprimer des fonctions de gestionnaire d’événements à l’aide du code d’API client

Utilisez les méthodes suivantes pour ajouter et supprimer des gestionnaires d’événements pour les événements que vous ne pouvez pas associer via l’interface utilisateur :

Événements  Gestionnaire d’événements
Événement OnChange d′un attribut Méthodes addOnChange et removeOnChange
Événement OnLoad d′un formulaire Méthodes formContext.ui addOnLoad et removeOnLoad
Événement Loaded d′un formulaire Méthodes formContext.ui addLoaded et removeLoaded
Événement OnLoad des données de formulaire Méthodes addOnLoad et removeOnLoad de formContext.data
Événement OnSave d′un formulaire Méthodes addOnSave et removeOnSave
Événement PreSearch du contrôle de recherche Méthodes addPreSearch et removePreSearch
Événement OnResultOpened du contrôle de recherche dans la base de connaissances Méthodes addOnResultOpened et removeOnResultOpened
Événement OnSelection du contrôle de recherche dans la base de connaissances Méthodes addOnSelection et removeOnSelection
Événement PostSearch du contrôle de recherche dans la base de connaissances Méthodes addOnPostSearch et removeOnPostSearch

Important

Le contexte d’exécution est automatiquement passé en tant que premier paramètre aux fonctions que vous définissez à l’aide du code. Pour plus d’informations, consultez le contexte d’exécution de l’API cliente.

Pipeline d’événements de formulaire

Vous pouvez définir jusqu’à 50 gestionnaires d′événements pour chaque événement. La section Gestionnaires d’événements de l’onglet Événements de la boîte de dialogue Propriétés du formulaire affiche l’ordre des gestionnaires d’événements et chaque gestionnaire d’événements s’exécute dans cet ordre.

Utilisez les méthodes setSharedVariable et getSharedVariable pour transmettre une variable commune entre les gestionnaires d′événements (fonctions). Utilisez la méthode getDepth du contexte d’exécution pour comprendre la séquence d’exécution du gestionnaire d’événements par rapport à d’autres gestionnaires d’événements.

Comprendre le modèle objet de l’API client
Contexte d’exécution de l’API client
Événements (référence de l'API client)

  • Dernière mise à jour :