É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 :
É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 :
- Sous la section Bibliothèques de formulaires, ajoutez la bibliothèque de formulaires à partir de la ressource Web créée.
- 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.
- 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é).