BLE Scan Data
Receive a shared form from a nearby device over Bluetooth when there is no network.
BLE Scan Data is the receiving side of an offline share. After you scan another device's QR code, this screen shows you who and what you are about to receive, then connects over Bluetooth and pulls the form across. It exists for the field, where you and a colleague are standing next to each other and neither of you has a usable connection.

Overview
The screen confirms the incoming share, then manages the transfer.
| Part | What it does |
|---|---|
| Name | The name carried in the scanned code, identifying the sender or the form. |
| Agency name | The agency the shared form comes from. |
| Navigation title | The title of the screen being shared, so you know which form is coming. |
| Progress ring | Appears once data starts arriving and fills as the transfer runs. |
| Connect | Checks Bluetooth, then starts the connection and the transfer. |
| Cancel | Disconnects and closes the screen. |
All three pieces of text come from the QR code you scanned, not from the network, which is what lets you confirm the handoff with no coverage at all. The card resizes for your device, taking about half the screen width on a tablet or in landscape.
Getting Here
- On the sending device, open the share screen and choose Offline to display a QR code. See Share Options.
- On your device, scan that QR code with the matching scanner. See Bluetooth Scan.
- This screen opens, showing the name, agency name, and navigation title read from the scanned code.
- Confirm those details look right before you connect.
Check the agency name and the sender's name before tapping Connect. Once the transfer completes, the form is saved onto your device, so this is the point at which you decide whether you want it.
Receiving a Form
- Read the name, agency name, and navigation title to confirm you are receiving the right form from the right person.
- Tap Connect. The app checks Bluetooth first, then shows "Connecting..." while it establishes the link.
- Once connected, the sending device starts pushing the form. The progress ring appears, sized to the amount the sender announced, and fills as each chunk arrives.
- When the last chunk lands, the pieces are reassembled, the form is saved to your device, and a "Data Received" message confirms it. The screen closes and hands the form over.
| Stage | What you see |
|---|---|
| Waiting | The sender's name, agency, and screen title, with Connect available |
| Connecting | "Connecting..." |
| Transferring | The progress ring filling |
| Finished | "Data Received", then the screen closes |
| Dropped | "Device disconnected" and the ring disappears |
Tapping Connect again while already connected does nothing. If the transfer has stopped, use Cancel to disconnect and start again from the QR scan.
If Bluetooth Is Off
- If Bluetooth is disabled, tapping Connect brings up a Bluetooth Off alert reading "Please turn on Bluetooth to use this feature."
- Tap Open Settings to jump to your device's settings and turn Bluetooth on, or Cancel to stay where you are.
- Return to the app and tap Connect again.
- Keep both devices close together throughout the transfer.
Cancelling or Losing the Connection
| What happened | What the app does | What to do |
|---|---|---|
| You tap Cancel | Disconnects and closes the screen | Rescan the QR code if you still want the form. |
| The devices move apart | Shows "Device disconnected" and hides the ring | Move closer and start again from the QR scan. |
| The sender closes their share screen | The link drops the same way | Have them reopen Offline and rescan. |
| The transfer stops part way | Nothing partial is kept | Repeat the whole handoff; a half-received form is not saved. |
Offline transfer is ideal when you are out of coverage. Once the form is received it is stored on your device, so you can keep working with it straight away and let it reconcile with your agency's records when you are next in signal.
How This Connects
- Where the data comes from. The device beside you, over a direct Bluetooth link. The QR code you scanned is what tells your device which sender to connect to; no server is involved at any point.
- Where it goes when received. Into your device's store of offline shares, together with the sender's name, their agency, and the form's title, and then into the form itself so you can open and work with it. See Data and Sync.
- Which other parts of the app are involved. The sending half is Share Options, the online equivalent is Share a Form, the scanner and pairing live under Bluetooth Scan, and a received form opens as an ordinary Server UI screen or Form Popup. Shares are listed with your other shared items; see Share Data.
- Offline and reconnect. This whole screen is built for no coverage: confirming, connecting, transferring, and saving all happen device to device. When you are back in signal, the received form behaves like any other, and saving it sends your work to your agency's records. See Offline Mode.
Troubleshooting
| If this happens | What to do |
|---|---|
| The Bluetooth Off alert appears | Tap Open Settings, turn Bluetooth on, return to the app, and tap Connect again. |
| Nothing happens when you tap Connect | You may already be connected. Watch for the progress ring; if nothing moves, tap Cancel and rescan. |
| It sits on "Connecting..." | The sender's share screen must be open on Offline. Have them reopen it, keep the devices close, and rescan. |
| The Bluetooth transfer stalls | Hold both devices still and close together with their screens on. If it stops, wait for "Device disconnected", then repeat from the QR scan. |
| "Device disconnected" appears | The link dropped and nothing partial was kept. Start the handoff again. |
| The name or agency looks wrong | Do not connect. Tap Cancel and check you scanned the right device's code. |
| "Data Received" appeared but you cannot find the form | Look under your shared items and in the module the form belongs to. See Share Data. |
| The QR code will not scan | Ask the sender to brighten their screen and hold it steady, filling your frame. |
Related Pages
⬅️ Previous: Time Picker | Next: Server UI Overview ➡️