Caching und persistierte Zustände im Monitor

Diese Seite beschreibt, welche Monitor-Einstellungen als Ausgangswerte dienen und durch persistierte Zustände überlagert werden können. Sie erläutert außerdem, wie sich lokaler Browser-State, gespeicherte Ansichten und mehrere Grids auf das sichtbare Verhalten eines Monitors auswirken.

Der Monitor arbeitet mit mehreren Persistenz-Ebenen. Aus der Monitor-Konfiguration werden Ausgangswerte für das Verhalten des Monitors geladen. Zusätzlich speichert der Monitor Zustände lokal im Browser. Außerdem können gespeicherte Ansichten serverseitig einen vollständigen Monitor-Zustand enthalten, der später wieder angewendet werden kann.

Welche Zustände lokal erhalten bleiben

Der Monitor speichert Grid-bezogene Zustände lokal im Browser. Bei mehreren Grids gilt das getrennt pro Grid.

Lokal erhalten bleiben insbesondere:

Sortierung eines Grids
Filter eines Grids
Fixierung der aktuell angezeigten oder ausgewählten Datensätze, siehe Datensätze fixieren
Gruppierung eines Grids
Spaltenzustand eines Grids
Sichtbarkeit, Reihenfolge und Breite von Spalten
die globale Suche des Monitors (über alle Grids)
das aktive Grid in einem Multi-Grid-Monitor

Änderungen, die ein Benutzer an diesen Eigenschaften vornimmt, werden im lokalen Speicher des Browsers abgelegt.

Diese lokal gespeicherten Zustände werden beim erneuten Laden des Monitors wieder angewendet.

Einstellungen, die vom lokalen Zustand überschrieben werden können

Einige der Monitor-Einstellungen liefern beim Aufbau des Monitors zunächst nur einen Ausgangswert. Sobald für den Monitor bereits ein lokaler Zustand vorhanden ist, kann dieser die konfigurierten Werte überlagern.

Das betrifft insbesondere:

grid_mainSortColumn
grid_mainSortDirection
column_config
sort_multi
sort_multiColumnCount
sort_multiReversedOrder
function_gridMultipleViews
function_gridMultipleViewsConfig

Änderungen an diesen Einstellungen sind deshalb nach einem Browser-Refresh meist nicht sichtbar. Ein bereits gespeicherter lokaler Zustand beziehungsweise eine angewandte Monitoransicht hat weiterhin Vorrang.

Beispiel: `grid_mainSortColumn`

Die Einstellung grid_mainSortColumn definiert, nach welcher Spalte der Monitor initial sortiert wird.

Wenn ein Anwender später im Monitor eine andere Sortierung verwendet, wird dieser Zustand lokal gespeichert. Nach einem Browser-Refresh bleibt diese Benutzersortierung erhalten. Auch eine spätere Änderung von grid_mainSortColumn in der Konfiguration ist dann nicht sichtbar.

Die geänderte Konfiguration wird erst wieder sichtbar, wenn mindestens einer der folgenden Fälle eintritt:

der Monitor-Zustand wird zurückgesetzt
der lokale Browser-State wird gelöscht
eine gespeicherte Ansicht mit passender Sortierung wird angewendet
der Monitor mit einem explizit übergebenen State geöffnet wird

Zusammenspiel von Konfiguration, lokalem Zustand und gespeicherter Ansicht

Für die sichtbare Darstellung eines Monitors ist nicht nur die aktuelle Konfiguration relevant. Zusätzlich wirken lokale Zustände und gegebenenfalls gespeicherte Ansichten auf den Monitor ein.

Für die Praxis ist folgende Priorität (von höchster nach niedrigster) wichtig:

Ein übergebener Monitor-State über URL-Parameter, siehe Monitor Deeplink
Eine explizit geladene Ansicht
Ein bereits vorhandener lokaler Zustand des Monitors oder des Grids
Die Monitor-Konfiguration

Das bedeutet für Administratoren:

Änderungen an Sortierung, Filtern oder Spalten in der Konfiguration werden nicht automatisch beim nächsten Reload sichtbar.

Anwender können weiterhin einen älteren lokalen Zustand sehen.

Gecachte Daten verwerfen

Wenn gecachte Monitor-Daten verworfen werden sollen, kann die aktuelle Ansicht zurückgesetzt werden, siehe, Ansicht zurücksetzen.

Alternativ kann der lokale Speicher des Browsers gelöscht beziehungsweise zurückgesetzt werden, siehe, Zurücksetzen des Local Storages.

Dadurch werden lokal gespeicherte Monitor-Zustände entfernt, sodass die Monitor-Konfiguration verwendet wird.