InnerWeb
Zum Inhalt springen

Bewährte Praktiken für Offline-Warteschlangen in Feld-Apps

Ein Prüfer auf dem Rundgang verliert den Empfang im Keller, auf dem Dach und in einer Halle mit Stahlkonstruktion, und die Einträge aus dem Formular dürfen nicht verloren gehen. Im Folgenden Praktiken für den Entwurf einer Offline-Warteschlange, mit der der Server keine Duplikate bekommt und der Benutzer sieht, was bereits angekommen ist und was noch wartet.

13 Tage
Standardbereinigung der Idempotenz-Datensätze
Quelle: Produktdatenblatt
4
Speicherstatus, sichtbar für den Benutzer
Quelle: Produktdatenblatt

Was die Offline-Warteschlange in einer Web-App leistet

Die Web-App speichert fehlgeschlagene Anfragen, die Daten ändern (POST, PUT, PATCH), ohne Netz in der IndexedDB-Warteschlange des Browsers und spielt sie nach der Rückkehr des Netzes wieder ab. Der Benutzer füllt das Formular aus, drückt Speichern und kann weiterarbeiten, während die App die Daten später zustellt.

Das ist eine Lösung für Aufgaben, die nicht auf den Empfang warten können: Rundgang, Kontrolle, Meldung, Foto eines Mangels. Die Warteschlange unterstützt auch Dateien und Formulare, nicht nur einfache Textdaten.

Sieben Entwurfspraktiken

Die Praktiken in der Reihenfolge, in der ein Team meist Entscheidungen trifft.

1. Jede Anfrage mit einem Idempotenz-Schlüssel versehen

Jede Anfrage, die Daten ändert, erhält einen Idempotenz-Schlüssel im Header. Ein erneutes Senden nach einem teilweisen Netzausfall erzeugt kein Duplikat auf dem Server, weil der Server den Schlüssel erkennt.

2. Der Server merkt sich nur den Erfolg

Der Server speichert Ergebnisse mit Erfolg 2xx. Nach einem Fehler 4xx oder 5xx wird der Schlüssel freigegeben, sodass die korrigierte Anfrage erneut gesendet werden kann. Die Datensätze der Idempotenz werden standardmäßig nach 13 Tagen bereinigt.

3. Den Stand der Warteschlange dem Benutzer zeigen

Der Speicherstatus ist sichtbar: wartet, synchronisiert, Fehler, Anmeldung erforderlich. Ein Prüfer, der „wartet“ sieht, wiederholt die Kontrolle nicht, und wer „Anmeldung erforderlich“ sieht, weiß, was nach der Rückkehr ins Büro zu tun ist.

4. Mit wachsender Verzögerung wiederholen

Die Verzögerungen der Wiederholungen wachsen nach der Fibonacci-Folge: 1, 2, 3, 5, 8, 13 s und weiter. Die Folge steigert die Pausen sanfter als Verdoppeln, daher findet das Gerät nach der Rückkehr des Empfangs schnell zur Synchronisation zurück, belastet aber bei langem Ausfall das Netz nicht.

5. Fehlendes Netz von einem Logikfehler unterscheiden

Fehlendes Netz ist ein Grund zur Wiederholung. Eine Antwort 4xx verlangt die Aufmerksamkeit des Benutzers, denn eine Wiederholung derselben Anfrage ergibt denselben Fehler. Die Warteschlange zeigt sie als Fehler und nicht als dauerndes Warten.

6. Den Inhalt der Warteschlange begrenzen

Dateien und Fotos belegen Speicher im Browser. Legen Sie eine Grenze für Größe und Auflösung der Fotos in der Feld-App fest, bevor der erste Prüfer die Warteschlange auf dem Rundgang füllt.

7. Mit abgeschaltetem Netz und unterbrochener Verbindung testen

Testszenarien: Flugmodus während des Speicherns, Abbruch der Verbindung mitten im Versand, Sitzung abgelaufen während der Offline-Arbeit. Prüfen Sie, ob nach der Rückkehr des Netzes genau ein Datensatz auf dem Server liegt, nicht null und nicht zwei.

Verzögerung der Wiederholungen der Warteschlange nach Fibonacci-Folge

Verzögerung der Wiederholungen der Warteschlange nach Fibonacci-FolgeBalkendiagramm: Verzögerungen der aufeinanderfolgenden Wiederholungen 1, 2, 3, 5, 8 und 13 Sekunden051015s1. Versuch: 1 s1 s1. Versuch2. Versuch: 2 s2 s2. Versuch3. Versuch: 3 s3 s3. Versuch4. Versuch: 5 s5 s4. Versuch5. Versuch: 8 s8 s5. Versuch6. Versuch: 13 s13 s6. Versuch
Quelle: Fibonacci-Folge laut Funktionsdokumentation der Offline-Warteschlange

Beispielhafte Zahlen für die Planung

Beispielrechnung: Ein Prüfer führt einen Rundgang mit 40 Punkten durch und speichert bei jedem ein Formular und ein Foto. Liegen 8 dieser Punkte außerhalb des Empfangs, warten 8 Formulare und 8 Fotos in der Warteschlange, die nach der Rückkehr des Netzes gesendet werden. Mit Idempotenz-Schlüsseln erhöht eine Wiederholung des Versands die Zahl der Datensätze nicht über 40.

Ohne Idempotenz-Schlüssel könnte dieselbe Situation bei einem abgebrochenen Versand für einige Punkte zwei Datensätze ergeben. Das ist ein ausreichender Grund, den Schlüssel als Standard und nicht als Zugabe zu behandeln.

Was die Offline-Warteschlange nicht leistet

Die Warteschlange ersetzt keine geschäftliche Entscheidung darüber, was verbindlich ist. Ein offline gespeicherter Eintrag trägt die Gerätezeit, daher sollte man bei wichtigen Ereignissen (Freigabe, Übernahme der Arbeit) dem Benutzer zeigen, dass der Eintrag noch nicht vom Server bestätigt ist. Für Alarme bei Lebensgefahr ist ein Gerät mit eigener Verbindung besser, etwa eine LoRa-Uhr mit Gateway.

Checkliste

Videomaterial

Häufig gestellte Fragen

Unterstützt die Offline-Warteschlange Fotos und Dateien?

Ja. Die Warteschlange unterstützt auch Dateien und Formulare, aber die Größe muss begrenzt werden, weil der Speicher des Browsers endlich ist.

Was ist, wenn der Server einen Fehler 4xx zurückgibt?

Der Schlüssel wird freigegeben, und die Anfrage geht in den Fehlerzustand. Der Benutzer korrigiert die Daten und sendet erneut, ohne Gefahr eines Duplikats.

Wie lange merkt sich der Server die Idempotenz-Schlüssel?

Standardmäßig 13 Tage, danach werden die Datensätze bereinigt. Eine Anfrage, die nach längerer Zeit wiederholt wird, gilt als neu.

Quellen

Testen wir die Offline-Arbeit auf Ihrem Rundgang

Wir zeigen die Offline-Warteschlange in der App und entwerfen mit Ihnen gemeinsam Testszenarien für Rundgänge an Orten ohne Empfang. Wir laden Sie zu einem Gespräch ein.

Sprechen wir