Schreiben von Skripts für Unterraster

 

Veröffentlicht: November 2016

Gilt für: Dynamics CRM 2015

Bei Microsoft Dynamics CRM Online 2015-Update 1 können Sie mit Unterrastersteuerelementen in Formularen durch die Verwendung von neuen Ereignissen und Objekten mehr Aktionen ausführen.

Wichtig

Für Microsoft Dynamics CRM Online-Organisationen steht diese Funktion nur zur Verfügung, wenn die Organisation auf Dynamics CRM Online 2015 Update 1 aktualisiert hat. Diese Funktion ist nicht für Dynamics CRM (lokal) verfügbar.

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 und Methoden (clientseitige Referenz)
Sammlungen (clíentseitige Referenz)
Schreiben von Code für Microsoft Dynamics CRM 2015-Formulare
Schreiben von Client-Anwendungserweiterungen

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright