Écriture de scripts pour les sous-grilles

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Vous pouvez définir des gestionnaires d'événements pour exécuter des scripts lorsque les données sont chargées dans des sous-grilles. Cela fournit des méthodes pour modifier la vue sélectionnée et pour obtenir des références aux données affichées dans la grille.

Contenu de la rubrique

Événement OnLoad de sous-grille

Modèle d'objet Sous-grille

Événement OnLoad de sous-grille

Les sous-grilles sont chargées de manière asynchrone à partir du formulaire. Vous ne pouvez donc pas obtenir de manière fiable l'accès aux données de la sous-grille dans l'événement OnLoad du formulaire. Mais vous pouvez définir un gestionnaire d'événements pour l'événement OnLoad de la sous-grille. Cet événement se produit à chaque actualisation des données de la grille, y compris lorsque les utilisateurs trient les colonnes de la grille.

Il n'existe aucune interface utilisateur pour ajouter un nouveau gestionnaire d'événements pour cet événement. Si vous souhaitez le faire, vous devez donc utiliser le code d'un autre événement, généralement l'événement OnLoad du formulaire pour utiliser la méthode GridControl.addOnLoad. Pour supprimer les gestionnaires d'événements pour cet événement, utilisez la méthode GridControl.removeOnLoad.

Modèle d'objet Sous-grille

La figure ci-dessous montre les objets auxquels vous pouvez accéder à partir d'une sous-grille d'un formulaire.

Le contrôle de sous-grille est considéré comme un GridControl dans ce contexte. En tant que contrôle Xrm.Page.ui, la sous-grille contient toutes les méthodes disponibles pour tous les contrôles, ainsi que la méthode refresh.

Le GridControl est le même objet transmis à une barre de commandes, à des actions du ruban ou à des règles à l'aide de <CrmParameter> (RibbonDiffXml) si disponible lorsque le paramètre SelectedControl est sélectionné.

Modifier les vues avec le sélecteur de vue

Lorsqu'une sous-grille est configurée pour afficher un sélecteur de vue, vous pouvez obtenir ou définir la vue active. Utilisez la méthode GridControl.getViewSelector pour accéder au sélecteur de vue, puis les méthodes ViewSelector.getCurrentViewgetCurrentView et ViewSelector.setCurrentView pour obtenir ou définir la vue active avec un objet de recherche.

Obtenir des données de la grille

Utilisez la méthode GridControl.getGrid pour accéder à la grille. Utilisez la méthode Grid.getRows ou la méthode Grid.getSelectedRows pour obtenir une collection d'objets GridRow. Vous pouvez ensuite accéder à une référence à chaque enregistrement dans la ligne en chaînant ensemble les méthodes GridRow.getData, GridRowData.getEntity et GridEntity.getEntityReference.

Voir aussi

Méthodes et objets de grille (lecture seule) (référence côté client)
Collections (référence côté client)
Écrire du code pour les formulaires Microsoft Dynamics 365
Étendre Microsoft Dynamics 365 sur le client

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright