Schreiben von Skripts für Unterraster

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Sie können Ereignishandler festlegen, um Skripts auszuführen, wenn Daten in Unterrastern geladen werden. Dadurch werden Methoden zur Verfügung gestellt, die ausgewählte Ansicht zu ändern und Verweise auf Daten zu bekommen, die im Raster angezeigt werden.

Wichtig

Diese Funktion wurde mit CRM Online 2015 Update 1 und CRM 2016 (lokal) eingeführt.

In diesem Thema

Unterraster-OnLoad-Ereignis

Unterrasterobjektmodell

Unterraster-OnLoad-Ereignis

Unterraster laden asynchron im Formular, sodass Sie nicht zuverlässig Zugriff auf die Daten im Unterraster im OnLoad-Formularereignis haben. Sie können jedoch einen Ereignishandler für das OnLoad-Ereignis des Unterrasters festlegen. Dieses Ereignis tritt immer auf, wenn die Daten im Raster aktualisiert werden, u. a. wenn Benutzer Spalten des Rasters sortieren.

Es gibt keine Benutzeroberfläche, um neue Ereignishandler für dieses Ereignis hinzufügen, sodass Sie, wenn Sie dies vorhaben, Code in einem anderen Ereignis verwenden müssen, normalerweise das OnLoad-Formularereignis, um die GridControl.addOnLoad-Methode zu verwenden. Um Ereignishandler für dieses Ereignis zu entfernen, verwenden Sie die GridControlremoveOnLoad-Methode.

Unterrasterobjektmodell

Das folgende Diagramm zeigt die Objekte an, auf die Sie aus einem Unterraster in einem Formular zugreifen können.

Das Unterrastersteuerelement wird in diesem Kontext als GridControl bezeichnet. Als Xrm.Page.ui-Steuerelement verfügt das Unterraster über alle Methoden für alle Steuerelemente, zusätzlich zur refresh-Methode.

GridControl ist das gleiche Objekt, das der Befehlsleiste oder Menübandaktionen oder Regeln mit <CrmParameter> (RibbonDiffXml) übergeben werden (falls verfügbar), wenn der SelectedControl-Parameter ausgewählt ist.

Ändern der Ansichten mit dem ViewSelector

Wenn ein Unterraster so konfiguriert ist, dass eine Ansichtsauswahl angezeigt wird, können Sie die aktuelle Ansicht abrufen oder festlegen. Verwenden Sie die GridControl.getViewSelector-Methode, um auf die Ansichtsauswahl zuzugreifen, und anschließend die ViewSelector.getCurrentViewgetCurrentView- und ViewSelector.setCurrentView-Methoden, um die aktuelle Ansicht mit einem Suchobjekt abzurufen oder festzulegen.

Abrufen von Daten vom Raster

Verwenden Sie die Methode GridControl.getGrid für den Zugriff auf das Raster. Verwenden Sie die Grid.getRows-Methode oder Grid.getSelectedRows-Methode, um eine Sammlung von GridRow-Objekten abzurufen. Sie können dann auf einen Verweis zu jedem Datensatz in der Zeile zugreifen, indem Sie die GridRow.getData, GridRowData.getEntity- und GridEntity.getEntityReference-Methoden verketten.

Siehe auch

Rasterobjekte (schreibgeschützt)und -Methoden (clientseitige Referenz)
Sammlungen (clíentseitige Referenz)
Schreiben von Code für Microsoft Dynamics 365-Formulare
Erweitern von Microsoft Dynamics 365 auf dem Client

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright