Raster und Unterraster in modellgestützten Apps (Client-API-Referenz)

Raster zeigen Daten in einem tabellarischen Format in modellgesteuerten Apps. 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: Neben dem Anzeigen von Daten im Tabellenformat bietet es umfangreiche Inline-Bearbeitungsfunktionen auf Internet- und mobilen Client einschließlich der Möglichkeit, Daten innerhalb der gleichen Rasters zu gruppieren, zu sortieren und zu filtern, um nicht zwischen Datensätzen oder Ansichten zu wechseln. 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 eines Rasterkontexts, um Ihren JavaScript-Code auszuführen, finden Sie unter Client API-Rasterkontext

Ereignisse

Name	Beschreibung	Anwendbar für
Unterraster-OnLoad-Ereignis	Tritt auf, wenn das Unterraster aktualisiert wird. Dies gilt auch dann, wenn Benutzer Werte im Unterraster 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	Vor dem Versenden der aktualisierten Informationen zum Server tritt es auf und bei einer der folgenden Aktionen: Es gibt eine Änderung in der Datensatz-Auswahl, der Benutzer löst einen Speichervorgang explizit mithilfe der bearbeitbaren Speichern-Schaltfläche des Rasters aus, oder der Benutzer wendet eine Sortierung, einen Filters, eine Gruppe, eine Paginierung oder einen Navigationsvorgang auf das bearbeitbaren Raster an, wenn keine ausstehende Änderungen vorhanden ist.	Bearbeitbares Raster

Hinweis

Sie können sich für die OnChange, OnRecordSelect, und OnSave Ereignisse mit der Ereignis Registerkarte der modellgesteuerten Apps-Seite anmelden, auf der bearbeitbare Raster für eine Tabelle oder ein schreibgeschütztes Raster aktiviert werden.

Objekte

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

Name des Dataflows	Beschreibung des Dataflows	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
Modell-angetriebene Apps Entwickler-Übersicht

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).