Skip to main content

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.

BLE scan data

Overview​

The screen confirms the incoming share, then manages the transfer.

PartWhat it does
NameThe name carried in the scanned code, identifying the sender or the form.
Agency nameThe agency the shared form comes from.
Navigation titleThe title of the screen being shared, so you know which form is coming.
Progress ringAppears once data starts arriving and fills as the transfer runs.
ConnectChecks Bluetooth, then starts the connection and the transfer.
CancelDisconnects 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​

  1. On the sending device, open the share screen and choose Offline to display a QR code. See Share Options.
  2. On your device, scan that QR code with the matching scanner. See Bluetooth Scan.
  3. This screen opens, showing the name, agency name, and navigation title read from the scanned code.
  4. Confirm those details look right before you connect.
caution

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​

  1. Read the name, agency name, and navigation title to confirm you are receiving the right form from the right person.
  2. Tap Connect. The app checks Bluetooth first, then shows "Connecting..." while it establishes the link.
  3. 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.
  4. 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.
StageWhat you see
WaitingThe sender's name, agency, and screen title, with Connect available
Connecting"Connecting..."
TransferringThe progress ring filling
Finished"Data Received", then the screen closes
Dropped"Device disconnected" and the ring disappears
note

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​

  1. If Bluetooth is disabled, tapping Connect brings up a Bluetooth Off alert reading "Please turn on Bluetooth to use this feature."
  2. Tap Open Settings to jump to your device's settings and turn Bluetooth on, or Cancel to stay where you are.
  3. Return to the app and tap Connect again.
  4. Keep both devices close together throughout the transfer.

Cancelling or Losing the Connection​

What happenedWhat the app doesWhat to do
You tap CancelDisconnects and closes the screenRescan the QR code if you still want the form.
The devices move apartShows "Device disconnected" and hides the ringMove closer and start again from the QR scan.
The sender closes their share screenThe link drops the same wayHave them reopen Offline and rescan.
The transfer stops part wayNothing partial is keptRepeat the whole handoff; a half-received form is not saved.
tip

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 happensWhat to do
The Bluetooth Off alert appearsTap Open Settings, turn Bluetooth on, return to the app, and tap Connect again.
Nothing happens when you tap ConnectYou 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 stallsHold 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" appearsThe link dropped and nothing partial was kept. Start the handoff again.
The name or agency looks wrongDo not connect. Tap Cancel and check you scanned the right device's code.
"Data Received" appeared but you cannot find the formLook under your shared items and in the module the form belongs to. See Share Data.
The QR code will not scanAsk the sender to brighten their screen and hold it steady, filling your frame.

⬅️ Previous: Time Picker | Next: Server UI Overview ➡️