Automatic sync
Changes saved without a signal wait in a queue and are sent automatically when the phone gets a network. We explain what this covers, when sending starts, what happens on an error and how to check that everything got through.
What the queue covers
The queue covers changes to measurement items — adding an item, correcting a dimension, removing one. This applies both to field mode on the phone and to the item list on the measurement record. When there is no network, the save is put aside for later instead of reporting an error.
When sending starts
The queue starts on its own at two moments:
- When the connection returns — the browser signals that there is a network, and sending starts without you clicking anything.
- When the app is opened — if the phone got a signal while the app was closed.
The order is preserved
Saves go one after another, in the same order in which they were made. The next one starts only when the previous one has finished.
This is not a technical detail. If a surveyor first added an item and then corrected its dimension, both changes have to arrive in that order — otherwise the correction would go to an item that does not exist yet.
What happens on an error
Every sending attempt ends in one of three ways:
- Server accepted the save
- The change disappears from the queue. The counter goes down by one.
- No connection or the server had an outage
- The change goes back to the queue and waits for the next opportunity. The counter does not go down.
- Server rejected the save
- For example when the measurement was deleted in the office in the meantime. Retrying will not help here, so the change is removed from the queue so that it does not block the rest. When the creation of an item is rejected, its later corrections are dropped along with it — they would have nothing to apply to.
What the bar at the bottom of the screen says
- Offline mode
- The phone has no connection. Saves are put aside for later.
- Syncing… (3)
- There is a network, and three more changes are waiting in the queue. The number refreshes every few seconds.
- No bar
- Everything got through. This is the simplest check.
Where unsent changes wait
In the browser's storage on that particular phone. This has three consequences worth knowing about:
- Closing the app or switching off the phone does not delete the queue.
- The queue is not visible from another device — until it is sent, the office does not have these changes.
- Clearing the site data in the browser deletes the queue along with its contents. Do not do this while the bar shows pending changes.
How to check that everything got through
- Check the barIt should disappear. As long as the counter is visible, something is still waiting.
- Open the measurement on another deviceOn a computer in the office. If all the items are visible — the sync has finished.
- Check the photos separatelyPhotos do not go through the queue, so a missing photo does not mean something is still being sent — it has to be uploaded again.
Every save leaves a trace in the event log — Audit log.
