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).