Événement OnRecordSelect de grille (référence de l’API client)

L’événement OnRecordSelect se produit lorsqu’une seule ligne (enregistrement) est sélectionnée dans une grille modifiable. Cet événement ne se produit pas si un utilisateur sélectionne différentes cellules dans la même ligne, ou sélectionne plusieurs lignes.

Exemple : Remplacer le comportement d’ouverture par défaut dans les grilles basées sur un modèle

Lorsque vous souhaitez personnaliser la façon dont un enregistrement de table s’ouvre à partir du Contrôle de grille Power Apps, vous pouvez contrôler son ouverture avec une fonction JavaScript associée à l’événement OnRecordSelect de la grille.

L’exemple suivant garantit que l’enregistrement s’ouvre en utilisant le formulaire spécifié par la valeur pageInput formId à l’aide de la méthode Xrm.Navigation.navigateTo. Dans cet exemple, le formulaire et la grille doivent appartenir à la même entité.

Étape : Créer une ressource Web

Créez, enregistrez et publiez une ressource Web JavaScript (JS) contenant le code suivant :

var Example = window.Example || {};
(function () {
this.OnSelect = function (executionContext) {
   var pageInput = {
      pageType: "entityrecord",
      entityName: executionContext.getEventSource().getEntityName(),
      entityId: executionContext.getEventSource().getId(),
      formId: "420786E3-D342-4A9A-914B-AA331FF2D25E"    
   };
   Xrm.Navigation.navigateTo(pageInput);
}
}).call(Example);

Pour plus d’informations : Créer ou modifier les ressources Web d’une application pilotée par modèle

Étape 2 : Activer le contrôle de grille Power Apps

Suivez ces étapes pour activer le Contrôle de grille Power Apps en tant que grille principale (vue de table) ou dans une sous-grille de formulaire basée sur un modèle :

• Utiliser comme grille principale
• Utiliser comme sous-grille

Étape 3 : Enregistrer le comportement personnalisé sur l’événement OnRecordSelect

Lorsque vous activez le Contrôle de grille Power Apps, un onglet Événements apparaît. Sélectionnez l’onglet Événements :

1. Sous la section Bibliothèques de formulaires, ajoutez la bibliothèque de formulaires à partir de la ressource Web créée.
2. Sous la section Gestionnaires d’événements, sélectionnez l’événement OnRecordSelect et sélectionnez Ajouter pour faire apparaître une fenêtre contextuelle.
3. Dans la fenêtre contextuelle, sélectionnez la bibliothèque de formulaires que vous venez d’ajouter et le nom de la fonction Example.OnSelect. Il s’agit du nom de la fonction JavaScript créée dans la ressource Web. Assurez-vous de cocher l’option Transmettre le contexte d’exécution comme premier paramètre.

Plus d’informations : Contrôle de grille Power Apps

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é).