InnerWeb
Zum Inhalt springen

Checkliste für den Offline-Betrieb einer Feld-App

Die Projektleitung muss keinen Code lesen, um zu prüfen, ob eine Feld-App ohne Netz funktioniert. Es genügen einige Versuche auf dem Gerät in der Halle: Netz abschalten, Daten erfassen, Netz wieder einschalten und die Datensätze zählen. Diese Liste führt durch die Versuche und nennt das erwartete Ergebnis.

13 Tage
Standardaufbewahrung der Datensätze zur Idempotenz
Quelle: karta
4 Zustände
der Warteschlange für die Nutzer sichtbar
Quelle: karta

Funktionsprinzip, das Sie prüfen

Die Web-App speichert fehlgeschlagene Anfragen, die Daten verändern, also POST, PUT und PATCH, bei fehlendem Netz in der IndexedDB-Warteschlange des Browsers und sendet sie nach der Rückkehr des Netzes erneut. Jede Anfrage erhält einen Idempotenzschlüssel im Header, sodass ein erneutes Senden auf dem Server kein Duplikat erzeugt.

Die Warteschlange verarbeitet auch Dateien und Formulare, und ihr Status ist für die Nutzer sichtbar: wartet, synchronisiert, Fehler oder Anmeldung erforderlich. Die Abnahme besteht darin, jedes dieser Verhalten auf einem realen Gerät an einem realen Arbeitsplatz zu prüfen.

Vorbereitung der Versuche

Verwenden Sie ein Testkonto, nicht das Konto eines Mitarbeiters, und das Gerät, auf dem die App später benutzt wird. Bereiten Sie drei einfache Erfassungen vor: ein Formular ohne Anhang, ein Formular mit Foto und eine Erfassung, die mit einem Validierungsfehler endet. Notieren Sie vor dem Versuch die Anzahl der Datensätze im System, denn sie ist der Ausgangswert.

Planen Sie einen Ort ohne jeden Empfang, etwa eine Halle oder einen Keller, und in der Nähe einen Ort mit Netz, damit Sie während des Versuchs zwischen beiden wechseln können.

Beispielversuch: Datensätze im System vor und nach der Rückkehr des Netzes

Beispielversuch: Datensätze im System vor und nach der Rückkehr des NetzesVorher-nachher-Diagramm: Drei Erfassungen warten in der Warteschlange, nach der Rückkehr des Netzes sind alle drei im System und die Warteschlange ist leer0123DatensätzeVor der Rückkehr des Netzes (In der Warteschlange): 3 Datensätze3Nach der Rückkehr des Netzes (In der Warteschlange): 0 Datensätze0In der WarteschlangeVor der Rückkehr des Netzes (Im System): 0 Datensätze0Nach der Rückkehr des Netzes (Im System): 3 Datensätze3Im System
  • Vor der Rückkehr des Netzes
  • Nach der Rückkehr des Netzes
Quelle: Beispiel eines Versuchs mit drei Erfassungen, wie auf dieser Seite beschrieben

Versuche und Kriterien für das Ergebnis

Jeder Punkt der Liste hat ein erwartetes Ergebnis. Eine Abweichung halten Sie als Mangel bei der Abnahme fest und geben ihn an den Lieferanten weiter. Beachten Sie: Nach einem Fehler 4xx oder 5xx wird der Idempotenzschlüssel freigegeben, und der Server merkt sich nur Ergebnisse mit Erfolg 2xx. Eine korrigierte Erfassung kann daher erneut gesendet werden.

Die Wartezeiten zwischen den Wiederholungen wachsen nach der Fibonacci-Folge. Nach einem längeren Ausfall erfolgt die Synchronisation deshalb nicht sofort nach der Rückkehr des Netzes. Geben Sie der App Zeit und beobachten Sie den Status der Warteschlange, statt erneut zu klicken.

Zwei Fehler, die man bewusst auslösen sollte

Der erste ist eine Erfassung mit Validierungsfehler: Die Warteschlange muss den Fehlerzustand anzeigen und ihn nicht verbergen. Der zweite ist eine abgelaufene Sitzung: Die Anfrage muss in den Zustand Anmeldung erforderlich wechseln und nach der Anmeldung ohne Datenverlust gesendet werden.

Was im Abnahmeprotokoll festzuhalten ist

Das Abnahmeprotokoll ist ein kurzes Dokument mit Datum, Gerät, Ort des Versuchs, Liste der Schritte, Anzahl der Datensätze vor und nach dem Versuch und Screenshots der Zustände der Warteschlange. Es dient als Nachweis gegenüber einem Audit, dass die App Daten bei Netzverlust erhält.

Halten Sie auch die Grenzen fest: Ohne Netz lädt der Browser keine neuen Daten vom Server, und die Datensätze zur Idempotenz werden standardmäßig nach 13 Tagen bereinigt. Erfassungen, die länger in der Warteschlange liegen, brauchen daher ein eigenes Verfahren.

Checkliste

Videomaterial

Häufig gestellte Fragen

Wie viele Versuche reichen für die Abnahme?

Drei Arten von Erfassungen (einfach, mit Foto, mit Fehler) und ein Versuch mit abgelaufener Sitzung. Führen Sie jeden auf dem Zielgerät an einem Ort ohne Empfang durch.

Was bedeutet ein korrektes Ergebnis?

Genau ein Datensatz pro Erfassung nach der Rückkehr des Netzes, ohne Duplikate, mit sichtbarem Status der Warteschlange in jeder Phase.

Wer sollte die Versuche durchführen?

Die Projektleitung gemeinsam mit einer Nutzerin oder einem Nutzer aus der Halle, auf einem Testkonto, damit keine falschen Erfassungen auf dem Konto eines Mitarbeiters entstehen.

Abnahme des Offline-Betriebs auf Ihrem Gelände

Wir führen die Versuche mit Ihrer Projektleitung an einem Ort ohne Empfang durch und erstellen das Abnahmeprotokoll. Vereinbaren Sie ein Gespräch.

Sprechen wir