Écriture de scripts pour les sous-grilles

 

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Avec Mise à jour 1 de Microsoft Dynamics CRM Online 2015, vous pouvez effectuer plus d'actions avec les contrôles de sous-grille dans les formulaires à l'aide de nouveaux événements et objets.

Important

Pour les organisations Microsoft Dynamics CRM Online, cette fonctionnalité n'est disponible que si votre organisation a effectué la mise à jour vers la mise à jour 1 de Dynamics CRM Online 2015. Cette fonctionnalité n'est pas disponible pour Dynamics CRM (local).

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 (référence côté client)
Collections (référence côté client)
Écrire du code pour les formulaires Microsoft Dynamics CRM 2015
Écrire des extensions d’application cliente

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