Raster und Unterraster in modellgesteuerten Apps (Client-API-Referenz)

Raster und Untergitter stellen Daten in einem tabellarischen Format in modellgesteuerten Apps dar. Verwenden Sie die Client-API-Ereignisse und -Objekte in diesem Artikel, um mit schreibgeschützten und bearbeitbaren Rastern zu arbeiten. Raster können das gesamte Formular einschließen oder eines der Elemente in einem Formular sein; die letzteren werden als Unterraster bezeichnet.

Rastertypen

Es gibt zwei Typen von Rastern in modellgesteuerten Apps:

• Schreibgeschützte Raster: Daten anzeigen in einen tabellarischen Format. Um die in einem schreibgeschützten Raster angezeigten Daten zu bearbeiten, müssen Sie den Datensatz im Raster auswählen, um das Formular zu öffnen, die Daten zu bearbeiten und dann zu speichern.
• Bearbeitbare Raster: Zusätzlich zum Anzeigen von Daten in einem tabellarischen Format bietet es umfangreiche Inlinebearbeitungsfunktionen auf Web- und mobilen Clients, einschließlich der Möglichkeit zum Gruppieren, Sortieren und Filtern von Daten innerhalb desselben Rasters, sodass Sie keine Datensätze oder Ansichten wechseln müssen. Das bearbeitbare Raster ist ein benutzerdefiniertes Steuerelement und wird im Hauptraster, in den Formularrastern und im Unterraster im Webclient und in Dashboards und im Formularraster auf dem mobilen Clients unterstützt. Obwohl das bearbeitbare Unterrastersteuerelement Bearbeitungsfunktion enthält, sind die schreibgeschützten Rastermetadaten und die Sicherheitsebenen-Einstellungen zentral.

Abrufen des Rasterkontexts

Rasterkontext ist die Raster- oder Unterrasterinstanz in einem Formular, mit dem Sie Ihren Code ausführen. Weitere Informationen zum Abrufen des Rasterkontexts zum Ausführen ihres JavaScript-Codes finden Sie im Client-API-Rasterkontext.

Grid-Ereignisse

Name	Beschreibung	Anwendbar für
Unterraster-OnLoad-Ereignis	Tritt auf, wenn das Unterraster aktualisiert wird. Dieses Ereignis schließt ein, wenn Benutzer Werte im Untergrid sortieren, indem Sie auf die Spaltenüberschriften klicken.	Schreibgeschütztes Raster
Raster OnChange	Tritt auf, wenn ein Wert an einem Computerarbeitsplatz im bearbeitbaren Raster geändert wurde und die Zelle den Fokus verliert.	Bearbeitbares Raster
Raster OnRecordSelect	Tritt auf, wenn eine einzelne Zeile (Datensatz) im bearbeitbaren Raster ausgewählt ist.	Bearbeitbares Raster
Raster OnSave	Tritt auf, bevor die aktualisierten Informationen an den Server gesendet werden, und wenn eine der folgenden Aktionen auftritt: Es gibt eine Änderung in der Datensatzauswahl, der Benutzer löst einen Speichervorgang explizit mithilfe der Schaltfläche zum Speichern des bearbeitbaren Rasters aus, oder der Benutzer wendet einen Sortier-, Filter-, Gruppen-, Paginierungs- oder Navigationsvorgang aus dem bearbeitbaren Raster an, während ausstehende Änderungen vorhanden sind.	Bearbeitbares Raster

Anmerkung

Sie können sich für die OnChange-, OnRecordSelect- und OnSave-Ereignisse registrieren, indem Sie die Registerkarte "Ereignisse " der Modellgesteuerten App-Seite verwenden, die Sie verwenden, um bearbeitbare Raster für eine Tabelle oder ein schreibgeschütztes Raster zu aktivieren.

Rasterobjekte

Verwenden Sie die folgenden Objekte, um mit Rastern zu interagieren. Diese Objekte bilden eine Hierarchie, wie im folgenden Diagramm dargestellt:

Name	Beschreibung	Verfügbar für
GridControl	Stellt Methoden zur Arbeit mit dem Raster oder dem Unterrastersteuerelement bereit.	Bearbeitbare und schreibgeschützte Raster
Grid	Stellt Methoden bereit, um auf Informationen über Daten im Raster zuzugreifen.	Bearbeitbare und schreibgeschützte Raster
GridRow	Stellt Methoden bereit, um mit Zeilen oder ausgewählten Zeilen im Raster zu arbeiten.	Bearbeitbare und schreibgeschützte Raster
GridRowData	Stellt Methoden bereit, um mit Zeilen oder ausgewählten Zeilen im Raster zu arbeiten.	Bearbeitbare und schreibgeschützte Raster
GridEntity	Stellt Methoden für den Zugriff auf Daten zu den spezifischen Datensätzen in den Zeilen bereit.	Bearbeitbare und schreibgeschützte Raster
GridAttribute	Stellt Methoden bereit, um auf die Daten in der Zelle eines bearbeitbaren Rasters zuzugreifen.	Bearbeitbares Raster
GridCell	Bietet Methoden für den Zugriff auf die Daten zur Steuerung in einem Formular, das an eine Spalte in einem bearbeitbaren Raster gebunden ist.	Bearbeitbares Raster
ViewSelector	Stellt Methoden bereit, um Informationen zur Ansichtsauswahl des Unterrastersteuerelements abzurufen oder festzulegen.	Schreibgeschütztes Raster

Ähnliche Artikel

Rasterkontext der Client-API
Bearbeitbare Raster verwenden
Client-API-Referenz für modellgesteuerte Apps
Entwicklerhandbuch für modellgesteuerte Apps