Synchronisation

IQORA synchronisiert Stammdaten, Bestände, Aufträge und mobile Buchungen zwischen der lokalen Anwendung und den Cloud-Diensten von AK Software Solutions.

Voraussetzungen

Für die Synchronisation werden benötigt:

  • aktive Internetverbindung
  • gültige IQORA-Lizenz
  • in der Konfiguration gespeicherter Lizenzschlüssel
  • erreichbarer lokaler Datenbankpfad
  • laufende IQORA-Hintergrunddienste

Synchronisierte Daten

Daten Richtung Verwendung
Artikel lokal → Cloud Artikelauswahl in Scanner und Cloud
Lagerplätze lokal → Cloud Lagerplatzauswahl in mobilen Buchungen
Aufträge lokal → Cloud Auftragsauswahl für Material und Zeiten
Benutzer lokal → Cloud PIN-Anmeldung und Scannerberechtigungen
Bestände lokal → Cloud aktuelle Bestandsanzeige
Materialbuchungen Cloud → lokal mobile Zu- und Abgänge
Umbuchungen Cloud/Relay → lokal mobile Lagerplatzwechsel
Zeitbuchungen Cloud → lokal Übernahme mobiler Arbeitszeiten
Bestandsanfragen lokal ↔ Cloud aktueller Bestand eines Artikels

Regelmäßiger Cloud-Abgleich

Der Cloud-Synchronisationsdienst läuft im Hintergrund und wiederholt den Abgleich ungefähr alle 60 Sekunden.

Die Reihenfolge ist:

  1. Artikel übertragen
  2. Lagerplätze übertragen
  3. Aufträge übertragen
  4. Benutzer übertragen
  5. Cloud-Buchungen lokal übernehmen
  6. mobile Zeitbuchungen lokal übernehmen
  7. vollständigen aktuellen Bestand zurück an die Cloud senden

Diese Reihenfolge stellt sicher, dass benötigte Stammdaten vorhanden sind, bevor Bewegungen verarbeitet werden.

Relay-Verbindung

Der Relay-Client dient der zeitnahen Verarbeitung mobiler Aktionen. Er sendet regelmäßig ein Lebenszeichen und fragt ungefähr alle fünf Sekunden nach offenen Aufgaben.

Unterstützte Relay-Aufgaben:

  • Buchung ausführen
  • Umbuchung ausführen
  • Bestand eines Artikels abfragen

Nach erfolgreicher Verarbeitung bestätigt IQORA die Aufgabe beim Server. Erst dann gilt sie als erledigt.

Bei einer auftragsbezogenen Buchung sucht IQORA die lokale Auftrags-ID anhand der übertragenen Auftragsnummer.

Schutz vor doppelten Buchungen

Cloud-Bewegungen und Zeitbuchungen besitzen eindeutige IDs. IQORA speichert bereits importierte IDs lokal und überspringt Einträge, die schon verarbeitet wurden.

Relay-Aufgaben werden nach erfolgreicher Verarbeitung bestätigt. Offline-Buchungen der Scanner-PWA besitzen ebenfalls eindeutige Kennungen.

Dienste nicht gewaltsam mehrfach starten

IQORA verhindert normalerweise einen zweiten Relay-Thread. Starten Sie dennoch nicht mehrere unabhängige Programminstanzen mit derselben Datenbank, wenn dies betrieblich nicht vorgesehen ist.

Offline-Buchungen der Scanner-PWA

Ist das Mobilgerät offline, werden Materialbuchungen und Umbuchungen zunächst im Browser gespeichert. Die PWA versucht:

  • alle 30 Sekunden zu synchronisieren und
  • unmittelbar nach Wiederherstellung der Verbindung erneut zu übertragen.

Weitere Informationen finden Sie unter Scanner-Buchungen.

Zeitbuchungen

Mobile Zeitbuchungen werden aus der Cloud in die lokale Tabelle der Auftragszeiten übernommen. Eine eindeutige Cloud-ID verhindert den mehrfachen Import derselben Zeit.

Die importierten Zeiten können anschließend in einem Auftrag unter Lohn übernommen werden.

Synchronisationsstatus prüfen

In der Scanner-PWA zeigt die Statuszeile beispielsweise:

  • Verbunden
  • Offline-Modus
  • Wartet auf Sync
  • Relay

In der Desktop-Anwendung überwacht die Statusleiste zusätzlich die Erreichbarkeit des Scanner- beziehungsweise Serverdienstes.

Der lokale Dienst stellt außerdem einen Health-Endpunkt bereit. Eine erfolgreiche Antwort enthält den Status ok.

Änderungen erscheinen verzögert

Der vollständige Cloud-Abgleich läuft ungefähr einmal pro Minute. Warten Sie daher kurz und aktualisieren Sie anschließend die betroffene Ansicht.

Relay-Buchungen werden normalerweise schneller verarbeitet, da der Relay-Client etwa alle fünf Sekunden nach Aufgaben fragt.

Synchronisation funktioniert nicht

Prüfen Sie:

  1. Besteht eine Internetverbindung?
  2. Ist die IQORA-Lizenz gültig und der Lizenzschlüssel gespeichert?
  3. Läuft die Desktop-Anwendung beziehungsweise der lokale Hintergrunddienst?
  4. Ist die Cloud-API erreichbar?
  5. Verwendet die Scanner-PWA die richtige URL und Lizenz?
  6. Sind lokale Datenbank und Konfiguration erreichbar?
  7. Zeigen die Protokolldateien einen Netzwerk-, JSON- oder Datenbankfehler?

Typische Fehlerursachen

Problem Mögliche Ursache
Scanner zeigt alte Artikel Artikelabgleich noch nicht abgeschlossen
Lagerplatz fehlt mobil Lagerplatzabgleich fehlgeschlagen oder _SYSTEM_ wurde erwartet
Auftrag fehlt in der PWA Auftrag noch nicht synchronisiert
PIN funktioniert mobil nicht Benutzerabgleich ausstehend, Konto inaktiv oder Scannerzugriff fehlt
Buchung wartet auf Sync Gerät oder Server ist offline
Zeit erscheint nicht im Auftrag Cloud-Zeit noch nicht importiert oder noch nicht in Lohn übernommen
Bestand ist kurzfristig abweichend Bestands-Snapshot wurde noch nicht erneut übertragen

System-Lagerplatz

Der interne Lagerplatz _SYSTEM_ wird nicht als normal auswählbarer Lagerplatz an die Benutzeroberflächen übertragen.

Protokolldateien

Der Synchronisationsdienst protokolliert erfolgreiche Abläufe und Fehler, darunter:

  • Netzwerkfehler
  • abgelehnte Serverantworten
  • ungültige JSON-Antworten
  • fehlgeschlagene Relay-Aufgaben
  • bereits verarbeitete Cloud-Bewegungen
  • Anzahl synchronisierter Einträge

Weitere Informationen finden Sie unter Protokolldateien.

Siehe auch