Truleaf Fields runs in your web browser and needs an internet connection to load and save data. Out in the field, reception comes and goes. When it drops, the page you are on keeps what it loaded, and a new record waits on your device until you can save it.
When you lose the connection
At the top of the screen you see You're offline. Showing what was already loaded.
- The page you are on keeps showing what it loaded, as long as the tab stays open. The map shows Offline: cached imagery for the imagery it already has.
- A part of the page that hasn't loaded yet shows You're offline. This loads when you reconnect.
- Actions that need the server are marked Needs a connection, or tell you they need a connection when you try them.
- Opening another page, or reloading this one, needs a connection. Offline, your browser shows its own no-internet page, and what was on screen is gone. Stay on the page you are on until you are back online.
- An open form keeps what you typed. Nothing is sent until you are back online and save again.
When the connection comes back you see Back online. Pages then load the latest data.
Warning
Don't reload or close the tab while you are offline.
Keep a record while you are offline
When you add a new record, the treatment and observation forms save what you type on this device every few seconds, photos included.
- While you still have signal, open the observation or treatment form once, so it is ready on the device. A form you have never opened can't load offline.
- Fill in the record as usual, even without a connection.
- Select Save. Offline, you see You're offline. Your record is kept on this device; send it when you're back online. Nothing is sent yet.
- Back online, select Save again. The record is sent and the draft on the device is removed.
When you review a treatment offline you see Duplicate checks run after sending. Once the record arrives, we check whether the same treatment is already recorded.
The record sheet, which opens from Record, shows how many unfinished drafts this workspace has on this device. If the page reloads while a record form is open, the newest draft of that kind comes back once you are back online. It shows the time it was saved. Select Discard if you would rather start again.
All this applies to new records. Changes to a saved record are not kept on the device. Offline you see You're offline. Not saved; your changes are still here. Keep the form open and save when you are back online.
Not available yet
Sending saved drafts by themselves when the connection returns, and a list to reopen a particular draft, are not available yet. Keep the form open until you can save it.
Warning
A draft lives only in this browser on this device, and your other devices don't see it. Clearing the browser's data for the site deletes it. Signing out does not. On iPhone and iPad, the home-screen icon and Safari each keep their own drafts and their own sign-in.
If you see This draft couldn't be kept on this device. Copy what you typed before you leave. the device could not store the draft, for example because its storage is full. Copy what you typed somewhere safe before you leave the form.
Field outlines need a connection
Saving a new field or a changed outline needs a connection. Offline, Save outline in the outline editor stays pale and says it needs a connection. Keep the editor open and save once you are back online.
Not available yet
Drawing or editing a field outline offline and syncing it later is not available. An outline you are drawing or editing is not kept on this device, so it is lost if the page reloads or the tab closes.
Put Truleaf Fields on your home screen
You can open Truleaf Fields from an icon on your phone or tablet:
- iPhone or iPad (Safari): tap the share button, then Add to Home Screen.
- Android (Chrome): open the browser menu, then Add to Home screen or Install app.
Not available yet
There is no Truleaf Fields app to download from Google Play or the App Store. Add it to your home screen from the browser instead.
The icon opens the app full screen, in the last workspace you used. Otherwise it works like the browser. It needs a connection to open, to load data and to move between pages.
Not available yet
Opening the app without any connection, and maps saved for offline use, are not available yet.
When the app is read-only for a short while
During maintenance the app stays open and you see Truleaf Fields is read-only for a short while. You can view and export everything; changes are paused.
- You can open every page, read your data and download exports.
- Other changes are refused with
Read-only for a short while
- A new record you try to save stays as a draft on your device. Keep the form open and save it again when the banner is gone.
A workspace can also be read-only because its trial ended or a payment is overdue. That is a different case. See The free trial and Payment problems and read-only mode.
When a page doesn't load
- Something went wrong: select Try again. If it keeps happening, select Copy details and send the details to support.truleaf@truleaf.org.
- A new version of Truleaf Fields is available: usually we updated the app while you had it open. Select Reload. What you already saved is safe.
- This page needs a connection: you are offline and opened something this device hasn't loaded before, such as a form. It hasn't been opened on this device yet. Reload when you're back online; what you saved is safe. The Reload button shows once you are back online.
Data source not responding
: a service we rely on, such as file storage, is not answering. Try again in a few minutes.
On a slow connection, give a page time to finish loading. If you select Save again while a record is being sent, it is still sent only once.
Related pages
Still stuck?Email support.truleaf@truleaf.org