History and saved surveys
You never have to remember to save. Stopping a survey is the save — any walk that recorded a reading or a roam lands in the History tab automatically, newest first, ready to reopen, grade, or export.
How is History organised?
Section titled “How is History organised?”Once you have at least one site, History shows one section per site (most recently used first), then Unfiled for surveys not filed under a site. Without any sites it is one plain list. A search field filters by site, client, or survey name.
| Action | How |
|---|---|
| Open a survey | Tap the row. |
| File it under a site | Swipe the row right (Move) or long-press it and pick Move to site…. |
| Delete it | Swipe left, or long-press and pick Delete, then confirm. |
| Compare two surveys | A site’s ⋯ menu → Compare surveys…; the compare button on the Unfiled header; or Compare in the toolbar when you have no sites. See Before and after compare. |
| Rename or delete a site | The site’s ⋯ menu → Rename site… / Delete site…. Deleting a site keeps its surveys and moves them to Unfiled. |
The demo can’t be filed under a site.
What a History row shows
Section titled “What a History row shows”Each row is a summary, read from a lightweight index rather than the full survey document, so the list opens instantly however many surveys you have:
| Element | What it is |
|---|---|
| Thumbnail | A miniature top-down walk map, its dots coloured by signal band. |
| Title | Your custom name if you set one, otherwise the RUCKUS One venue name, otherwise Demo survey for the demo, Experience walk for a phone-measured survey, or Manual survey. |
| DEMO badge | An orange tag on a simulated demo walk, so it can’t pass for a real survey. |
| Subtitle | Date and time, point count, and roam count. |
| Grade badge | The letter grade, colour-coded, computed once when the survey was saved: the RF grade when the survey has one, otherwise the experience grade. |
Tap a row to open the same Results screen the survey ended on — the full document is decoded in the background, so a very long walk takes a moment.
How do I delete a survey?
Section titled “How do I delete a survey?”Swipe the row left (or long-press it and pick Delete). ARRF asks “Delete this survey?” first — “Its readings, floor plan and report are removed from this device. This can’t be undone.” — and only Delete removes the survey document from the device permanently.
Rename a survey
Section titled “Rename a survey”The title is edited on the Results screen, not in the list: open the survey and type over the name in the grade card header. Clearing it back to empty restores the default title (venue name, Demo survey, Experience walk, or Manual survey).
A report you opened without saving it (see below) has no title field — there is nothing on disk to rename.
Where surveys are stored
Section titled “Where surveys are stored”Saved surveys live inside ARRF’s own container on the iPhone: one JSON document per survey — byte-identical to the JSON export — plus a small index file that backs the list. They are never uploaded anywhere, and deleting the app deletes them.
When a survey can’t be saved
Section titled “When a survey can’t be saved”If writing the survey to storage fails — a full disk is the usual cause — ARRF does not discard the walk. A “Survey not saved” alert appears with the underlying reason and two choices:
- Retry — attempt the write again. The survey is still held in memory, so a retry after freeing space usually succeeds.
- Open anyway — skip saving and open the Results screen regardless, so you can still export the PDF, CSV, or JSON by hand before leaving the screen.
When a saved survey won’t open
Section titled “When a saved survey won’t open”Tapping a row whose file is missing or damaged raises a “Couldn’t open survey” alert rather than doing nothing:
| Message | Meaning |
|---|---|
| ”This survey’s file is missing from storage.” | The index still lists the survey but its document is gone. |
| ”This survey’s file is damaged and can’t be opened.” | The document is present but can’t be decoded. |
The row stays in the list — ARRF never deletes a document it failed to read, so a file recovered from a backup still opens. Delete the row yourself once you’re satisfied it’s unrecoverable.
Recovered surveys
Section titled “Recovered surveys”If the index file is lost or damaged, ARRF rebuilds it at launch by scanning the survey documents themselves, and re-grades each one it finds. The survey data — readings, roams, floor plan, grade, and the site it was filed under — is fully intact. The casualties are the RUCKUS One venue name and any custom name you typed, which live only in the index: a recovered survey shows its default title until you rename it.