Snapshot Report Attachments
When you create a Snapshot of a survey mark, you can attach jurisdiction-specific reports to it. These reports — PDF sketch plans, TIFF images, and other documents — are fetched from the jurisdiction's data source and stored alongside the Snapshot data.
Available report types by jurisdiction
Each jurisdiction provides different report types. Not all report formats are available everywhere, and some jurisdictions provide reports through external web portals rather than downloadable files.
| Jurisdiction | Report types | Format | Attachable |
|---|---|---|---|
| NSW | Sketch plans, survey information | Yes | |
| VIC | Mark sketches, survey information | TIFF, PDF | Yes |
| QLD | Survey plans, mark details | Yes | |
| SA | SAILIS mark information | HTML portal | View only (external link) |
| TAS | Survey mark reports (SurCom) | HTML portal | View only (external link) |
| NT | Locality sketches, survey plans | JPEG, PDF | Yes |
| ACT | Survey mark details | Yes |
SA and TAS provide survey mark information through external government web portals (SAILIS and SurCom respectively). These are view-only links — the reports can't be downloaded and attached to snapshots because no raw PDF endpoint exists.
Fetching and attaching reports
Reports are attached during the snapshot creation process, not as a separate step.
During snapshot creation
- Open the point details panel for a mark.
- Click Capture to open the snapshot form.
- The form shows available reports with checkboxes:
- Benchmrk Report (PDF) — A formatted PDF with the mark's full details and location map. Enabled by default.
- Government reports — Jurisdiction-specific reports (sketch plans, diagrams). Only attachable reports are shown with checkboxes; external portal links are shown as view-only.
- Select which reports to attach.
- Click Save Snapshot.
What happens during save
The snapshot is saved in two steps:
- Step 1 — Create snapshot — The mark data, title, description, and tags are saved as JSON to the backend.
- Step 2 — Upload documents — Selected reports are fetched from their sources and uploaded as file attachments to the snapshot.
The server fetches reports from jurisdiction data sources:
- Downloadable reports (NSW, VIC, QLD, ACT, NT) — Reports are fetched from the jurisdiction's API and streamed to the browser, avoiding CORS issues.
- External portals (SA, TAS) — These are HTML web portals with no raw file endpoint. They appear as view-only links in the reports dropdown but cannot be attached to snapshots.
Viewing attached reports
Once a report is attached to a Snapshot:
- PDF reports can be viewed in the browser or downloaded.
- TIFF images can be downloaded for viewing in an image viewer or GIS application.
Reports are accessible from the Snapshot's detail view in the Ledger panel.
Reports and Snapshot history
Reports are tied to specific Snapshots, not to the mark itself. This means:
- Each Snapshot can have its own set of attached reports.
- If you create a new Snapshot later, you'll need to fetch reports again for that Snapshot.
- Older Snapshots retain their attached reports even if the jurisdiction updates the report content.
Attach reports when you create a Snapshot to preserve a complete record. The report content may change if the jurisdiction updates their data, so having it attached to a Snapshot ensures you have the version that was current at the time.
Troubleshooting report fetches
| Problem | Likely cause | Resolution |
|---|---|---|
| Report not available | Jurisdiction doesn't publish downloadable reports for this mark type | SA and TAS provide view-only portal links — reports can't be attached |
| Fetch timeout | Jurisdiction's report service is slow or unavailable | Try again later |
| Empty or corrupted report | Upstream data issue | Re-fetch the report; if the problem persists, the source data may be incomplete |
| "Documents upload failed" | File too large for upload or network interruption | The snapshot is saved without attachments — try creating a new snapshot |
| Report checkbox greyed out | External government portal (no raw file endpoint) | Use the view-only link to open the report in a new tab instead |