Working Offline & Sync
DMap uses the same offline machinery as the Issue module — a local cache plus a send queue — so a DMap you took with you behaves the same way an issue does: you keep working, and the app catches up later.
Reading offline
The DMap list, the DMap itself, its pins and the linked issues are all cached on the device. The map image and any documents are pinned in the cache so routine clean-up cannot evict them.
How much you can read depends on the bundle you downloaded:
| Bundle | Offline you get |
|---|---|
| Create | The DMap, and the existing pins rendered on it |
| Review | Also the issue behind each pin — content, latest activity and documents |
See Offline Downloads.
Cache refreshes never overwrite a pin that has local unsynced changes, and a pin that has just synced will not flash back to a placeholder like #? while the data settles.
Capturing a defect offline
Tap, photograph, fill in the form — exactly as when you are online. What the app does behind the scenes:
- A draft pin lands on the DMap instantly, so the position is visible to you before anything has been sent.
- The issue and its pin are queued as a dependent pair, in one transaction. The pin waits for the issue to exist; neither can end up orphaned.
- Photos are stored locally and uploaded first when connectivity returns.
- Once the system assigns the issue its real number, it links the pin to the issue and the draft becomes a real pin.
- If you discard the draft, the draft pin disappears from the DMap with it.
Draft pin states
| State | Meaning |
|---|---|
| Pending | Queued, waiting its turn |
| Blocked | Waiting on its issue to be created first |
| Failed | The send failed — retry it |
| Conflict | The system state changed underneath it |
| Synced | Done; it is now a normal pin |
The DMap reloads itself once the queue drains, turning your temporary pins into real ones without you having to leave the screen and come back.
Where pins live
Coordinates are stored in the DMap's own page space and normalized to 0–1 for display, rotation-aware at all four angles. When you place a pin, the tapped point is converted back into DMap coordinates before being sent.
The device's GPS is never used.
Managing what is waiting
Everything queued from DMap sits in the same queue as the rest of the app, where it shows as Map Pin and Create Issue entries. You manage it in one place:
- Offline Mode — deliberately work offline even with a signal.
- Network & Sync — connection state, drafts, pending uploads, and Sync Now.
- Pending Uploads — per-item Retry and Cancel.
- Offline Storage — the space it all occupies, and how to reclaim it.
All of it is described in Offline Mode & Sync Management.
:::tip Before you head to site Download the DMaps you will need — from the list for Create mode if you are there to capture defects, from the DMap itself for Review mode if you are there to action them. Then it does not matter what the signal does. :::