Loading, connection, empty, and error states
Business App separates a request in progress, a list with no matching results, a failed request, and the realtime connection status. Use the visible state to decide whether to wait, refresh, change a filter, or ask for help.
Before you start
- Sign in to the intended project and business scope.
- Check the state on the same Orders or Messages view where you expected the information to appear.
- Keep the app open while a loading or connection state is changing.
States and actions
| Visible term or state | What it means | What to do |
|---|---|---|
| Placeholder rows | The current list request is still loading. The latest result is not established yet. | Wait for results or an error before acting on the list. |
| Sorry, no results found | The completed view has no matching items. Active filters or the selected queue can narrow the result. | Review the selected queue and filters. Clear filters or refresh when you expect an item. |
| An API error message | The request finished with an error returned to the list. | Read the message, confirm your scope and filters, then refresh once. Ask your administrator or support team for help if it continues. |
| Network Error | The view could not establish its current network result. | Restore the device connection, then select Refresh when it is available. Verify the list before continuing work. |
| Last Update | The Orders view is showing when its locally retained information was last updated while the device is offline. | Treat the list as potentially stale. Reconnect and verify the current order state before making a decision. |
An empty result is not the same as a network or API error. Changing filters can help only when the view completed without an error.
Connection status
On an Orders view, select Status to open Connection status. The dialog also shows Last update.
| Status | Interpretation | Recovery |
|---|---|---|
| Ok | The realtime connection is connected and the dialog records its latest connection time. This does not prove every list item is current. | Continue monitoring. Refresh the list if its contents appear stale. |
| Connecting | The realtime connection is attempting to reconnect. | Wait for Ok. Avoid relying on new realtime updates until the status changes. |
| Disconnected | The realtime connection is not connected. New realtime updates may not arrive. | Confirm the device network, then select Update to restart the app. Return to the same view and confirm Ok and the expected data. |
The realtime status and a list request report different boundaries. Ok does not replace the result of a manual refresh, and a successful list refresh does not guarantee that later realtime updates will arrive.
Offline limits
The current app does not provide a supported pending-action indicator or an offline replay procedure. Last Update describes locally retained list data; it does not confirm that an order action was stored or delivered.
After reconnecting, refresh the relevant queue and inspect every affected order. If the displayed state differs from the action you intended, stop further changes and ask your administrator or support team to reconcile it.
Troubleshooting
| What you observe | Interpretation | Next action |
|---|---|---|
| Loading does not finish | The view has not established a usable result. | Confirm the device connection. Reopen the view once; if it continues, record the visible state and ask for help. |
| No results appear after filtering | The filter can exclude all items. | Clear filters and confirm the queue. If the unfiltered view is also empty, verify the expected order in its source workspace. |
| Network Error remains after reconnecting | The current request is still unavailable. | Select Refresh once. If the same message returns, share the visible message and time with your administrator or support team. |
| Connecting does not become Ok | Realtime updates are not confirmed. | Confirm the network, select Update, and reopen Connection status. Escalate a persistent non-Ok state. |
| Ok appears but expected data is missing | Connection status alone does not prove list freshness or scope. | Refresh the list and confirm project, business, queue, and filters. |
| You expect an offline action or pending-action indicator | This version does not provide a supported indicator or replay procedure for offline order actions. | Reconnect, refresh the relevant queue, and verify the order. Ask your administrator or support team to reconcile any mismatch before repeating the action. |
Related articles
- Monitor current orders on a phone
- Interpret order groups and statuses
- Understand navigation and push boundaries
:::note Visual status Visual guidance is deferred pending an authorized synthetic capture program with exact loading, empty, error, offline, and realtime scenarios plus independent visual QA. :::