Live-Aktualisierungen nutzen
Zweck und Einsatzbereich
Abschnitt betitelt „Zweck und Einsatzbereich“NeuraPort versucht nach einer erfolgreichen Anmeldung, ausgewählte Änderungen während der laufenden Sitzung automatisch sichtbar zu machen. Im geprüften Frontend betrifft dies Aktualisierungen der Listen für Sendungen und Benachrichtigungen, wenn NeuraPort ein entsprechendes Ereignis empfängt. Die Funktion hat keinen eigenen Menüpunkt, keinen Schalter und keine sichtbare Verbindungsanzeige für Live-Aktualisierungen.
Live-Aktualisierungen sind im Handbuchstand konfigurations- und deploymentabhängig. Fehlen die Voraussetzungen auf dem Server, soll die übrige Anwendung weiter nutzbar bleiben; Nutzer müssen Änderungen dann bei Bedarf manuell durch Aktualisieren der Ansicht oder der Seite prüfen. Es ist nicht belegt, dass jede Datenänderung in jedem Modul automatisch aktualisiert wird.
Voraussetzungen und Berechtigungen
Abschnitt betitelt „Voraussetzungen und Berechtigungen“- Sie benötigen eine aktive Anmeldung mit gültigem Zugriffstoken und einem Mandantenkontext.
- Ein erzwungener Passwortwechsel, eine ausstehende E-Mail-Verifizierung oder eine noch erforderliche MFA-Einrichtung verhindern die Nutzung der Live-Verbindung, bis der jeweilige Sicherheitsvorgang abgeschlossen ist.
- Browser und Netzwerk müssen eine sichere WebSocket-Verbindung zur laufenden NeuraPort-Umgebung zulassen.
- Die Serverumgebung benötigt die zugehörige Listener- und Datenbankkonfiguration. Ob diese in einer bestimmten Demo-, Test- oder Produktivumgebung aktiv ist, ist nicht aus der sichtbaren Oberfläche ableitbar.
- Für die Nutzung gibt es keine separate Rollenfreigabe. Die Verbindung wird dem angemeldeten Mandanten zugeordnet; sie ersetzt keine Rechteprüfung für Daten oder Aktionen.
Schritt-für-Schritt-Anleitung
Abschnitt betitelt „Schritt-für-Schritt-Anleitung“- Melden Sie sich regulär bei NeuraPort an und schließen Sie gegebenenfalls geforderte Sicherheits- oder Kontoaktionen ab.
- Arbeiten Sie in einer Sendungsübersicht oder mit Benachrichtigungen wie gewohnt weiter. Für Live-Aktualisierungen ist keine zusätzliche Einstellung erforderlich.
- Wenn ein Sendungsstatus oder eine neue Benachrichtigung durch eine andere Aktion im selben Mandanten geändert wird, prüfen Sie die entsprechende Liste. Bei verfügbarer Live-Verbindung kann NeuraPort deren Daten automatisch neu laden.
- Erscheint eine erwartete Änderung nicht, aktualisieren Sie zuerst die betroffene Ansicht oder laden Sie die Seite neu.
- Besteht die Abweichung fort, prüfen Sie zuerst, ob Sie den richtigen Mandanten und die passende Berechtigung verwenden. Melden Sie anschließend Zeitpunkt, betroffene Sendung oder Benachrichtigung und verwendete Umgebung an die Administration.
Die Anzeige Verbunden oder Offline in der Seitenleiste ist kein Nachweis für eine aktive Live-Aktualisierung: Sie bezieht sich auf den dort geprüften Backend-Status und zeigt keinen eigenen WebSocket-Status an.
Feldreferenz
Abschnitt betitelt „Feldreferenz“| Feld | Pflicht | Bedeutung | Validierung |
|---|---|---|---|
| Sendungsübersicht | Nein | Liste, die bei einem Ereignis zum Sendungsstatus neu abgefragt werden kann. | Eine sichtbare Aktualisierung setzt ein passendes Ereignis und eine verfügbare Live-Verbindung voraus. |
| Benachrichtigungen | Nein | Liste, die bei einem Ereignis zu neuen Benachrichtigungen neu abgefragt werden kann. | Eine sichtbare Aktualisierung setzt ein passendes Ereignis und eine verfügbare Live-Verbindung voraus. |
| Verbunden / Offline | Nein | Seitenleistenanzeige für den Backend-Status. | Sie ist keine Bestätigung oder Fehleranzeige der Live-Aktualisierung. |
| Browser aktualisieren | Nein | Manuelle Möglichkeit, Daten bei ausbleibender automatischer Aktualisierung erneut zu laden. | Lädt die Ansicht mit Ihrer weiterhin gültigen Sitzung neu. |
Status und mögliche Übergänge
Abschnitt betitelt „Status und mögliche Übergänge“| Ausgangsstatus | Auslöser | Folgestatus |
|---|---|---|
| Nicht angemeldet | Erfolgreiche Anmeldung mit Mandantenkontext | NeuraPort versucht im Hintergrund, die Live-Verbindung herzustellen. |
| Verbindung wird aufgebaut | Anmeldung und Sicherheitsprüfung sind gültig | Verbindung kann für den aktuellen Mandanten genutzt werden. |
| Verbindung nutzbar | Ereignis zu Sendungsstatus oder Benachrichtigung | Die zugehörige Liste kann automatisch neu geladen werden. |
| Verbindung nicht verfügbar oder unterbrochen | Netzwerk-, Server- oder Deploymentproblem | Die normale Arbeit bleibt grundsätzlich möglich; Aktualisierung erfolgt bei Bedarf manuell. |
| Verbindung unterbrochen | Wieder verfügbare Netzwerkverbindung | Die Anwendung versucht erneut zu verbinden; der genaue Erfolg ist in der Oberfläche nicht ausgewiesen. |
| Sitzung ungültig oder Sicherheitsvorgang erforderlich | Regelmäßige Prüfung der Sitzung | Die Live-Verbindung wird beendet, bis eine gültige Anmeldung wieder vorliegt. |
Was im Hintergrund passiert
Abschnitt betitelt „Was im Hintergrund passiert“Nach der Anmeldung öffnet die Anwendung eine Live-Verbindung und authentifiziert sie mit der aktuellen Sitzung. Sie versucht bei einem Verbindungsabbruch mit zunehmendem Abstand erneut zu verbinden. Bei einem eingehenden Ereignis lädt das Frontend im geprüften Stand die Daten für Sendungen oder Benachrichtigungen neu.
Der Server ordnet die Verbindung einem Mandanten zu und prüft die Sitzung regelmäßig erneut. Die Verteilung von Ereignissen zwischen Serverprozessen hängt von einem zusätzlichen Datenbank-Listener ab. Kann dieser Listener nicht starten, ist laut Implementierung nur die Live-Aktualisierung betroffen. Diese technische Absicherung erklärt jedoch nicht, ob sie in Ihrer Umgebung tatsächlich aktiviert und erreichbar ist.
Typische Fehler und Lösungen
Abschnitt betitelt „Typische Fehler und Lösungen“| Meldung oder Beobachtung | Ursache | Lösung |
|---|---|---|
| Eine Sendungs- oder Benachrichtigungsliste aktualisiert sich nicht automatisch | Die Live-Verbindung, das Ereignis oder die Serverkonfiguration ist nicht verfügbar; außerdem sind nicht für alle Datenarten automatische Aktualisierungen belegt. | Aktualisieren Sie die Ansicht oder laden Sie die Seite neu. Prüfen Sie Mandant und Berechtigung und melden Sie den Fall bei Bedarf an die Administration. |
| Nach Anmeldung erscheinen keine Live-Änderungen | Die Sitzung hat möglicherweise keinen zulässigen Mandantenkontext oder ein Sicherheitsvorgang ist noch offen. | Schließen Sie Passwortwechsel, E-Mail-Verifizierung oder MFA-Einrichtung ab und melden Sie sich bei Bedarf neu an. |
| Die Seitenleiste zeigt Verbunden, Änderungen kommen aber nicht automatisch | Die Seitenleistenanzeige prüft nicht den WebSocket-Status. | Behandeln Sie den Status nicht als Live-Nachweis. Aktualisieren Sie die betroffene Ansicht und lassen Sie die Live-Konfiguration prüfen. |
| Die Anwendung arbeitet weiter, aber neue Daten erscheinen erst nach Neuladen | Die optionale Live-Aktualisierung ist unterbrochen oder in dieser Umgebung nicht aktiv. | Arbeiten Sie weiter und laden Sie die betroffene Ansicht bei Bedarf neu. Für eine technische Prüfung dokumentieren Sie Zeitpunkt und betroffene Daten. |
| Die Sitzung wird beendet oder eine Aktion ist erst nach Kontoabschluss möglich | Die Live-Verbindung akzeptiert keine Sitzung, wenn ein erforderlicher Passwortwechsel, eine E-Mail-Verifizierung oder MFA-Einrichtung offen ist. | Schließen Sie den geforderten Sicherheitsvorgang ab und melden Sie sich erneut an. |