Partager via

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

  • Article

L’événement se produit lorsqu’une seule ligne (enregistrement) est sélectionnée dans un fichier grille modifiable. OnRecordSelect 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 manière dont un enregistrement de table s’ouvre à partir de Power Apps contrôle de grille, vous pouvez contrôler la manière dont il s’ouvre avec une fonction JavaScript associée à l’événement grille OnRecordSelect .

L’exemple suivant garantit que l’enregistrement s’ouvre à l’aide du formulaire spécifié par la valeur à l’aide de la méthode Xrm.Navigation.navigateTo. pageInputformId ... 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);

Plus d’informations : Créer ou modifier des ressources Web d’applications pilotées par modèle

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

Suivre ces étapes pour activer le Power Apps contrôle de grille comme grille principal (vue de table) ou dans une sous-grille de formulaire pilotée par modèle :

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

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

  1. Dans la section Bibliothèques de formulaires , ajoutez la bibliothèque de formulaires à partir de la ressource Web créée.
  2. Dans la section Gestionnaires d’événements , Sélectionner l’événement OnRecordSelect et Sélectionner Ajouter et une fenêtre contextuelle apparaît.
  3. Dans la fenêtre contextuelle, Sélectionner la bibliothèque de formulaires qui vient d’être ajoutée 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 : Power Apps contrôle de grille

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