Working offline

Working offline lets you keep using parts of Teralo in the mobile app when you have no signal. Teralo saves each change on your device and sends it when the connection returns.

• The mobile app: pinned documents, inspections in progress, observations raised from an inspection, Passive Fire installations, and markups.
• The desktop app: pinned documents, to read.
• A browser: nothing. Teralo in a browser shows You're offline when the connection drops, and saves nothing for later.

Offline, Teralo can show only what is already on your device. While you still have a connection:

1. Pin each document you will need.
2. Start each inspection you will fill in.
3. Open each inspection, document and register you will need.

Teralo keeps a copy of each page you open with a connection. Offline, a page you have opened shows Offline copy and when it was saved. A page you have not opened shows Not available offline.

1. In Documents, open the row menu on the document.
2. Select Available offline.

To pin several, select their rows, then select Make Available Offline. A pinned document shows an icon in its Document Number column. To unpin one, select Remove from offline in its row menu.

Pinning needs a connection. Pins belong to the device, so a document pinned on your phone isn't pinned on your tablet. Pinning is separate from Teralo Drive's way of keeping a file on a computer.

You can pin PDFs (.pdf), Excel workbooks (.xlsx) and images (.jpg, .jpeg, .png, .gif and .webp). Teralo refuses any other file type with a message, including Word, PowerPoint and IFC files.

A file over 100 MB asks you to confirm in Download A Large File?. Select Download to pin it. A file over 1 GB can't be pinned. When you pin several at once, Teralo pins large files without asking and skips any over 1 GB, and its message counts the files it skipped.

A pin keeps the document, not one revision of it. When someone uploads a newer revision, the document's icon turns red and a Sync button appears above the register, with a count of the documents to update.

1. Select Sync.
2. In Update offline copies?, select Update.

Teralo replaces each superseded copy with the latest revision. The dialog shows how much it will download, when that is known. To update one document, select Update offline copy in its row menu.

Teralo checks for newer revisions only while the register is open and you have a connection.

If a document is deleted, or you lose access to it, Teralo removes its copy from your device the next time you open the register with a connection. A message tells you which document it removed.

In the mobile app, selecting a pinned document in the register opens it to read, without its markups. To see markups and draw new ones offline, select Properties in the document's row menu. This opens the document's own page, which works offline only if you opened it while you had a connection.

In the desktop app, pinned documents are for reading. Markups drawn offline in the desktop app are not saved.

In the mobile app, in an inspection that is already in progress, you can:

• answer items, and clear an answer;
• add notes to an item;
• take photos against an item, and remove them;
• select Raise Observation on an item to raise an observation, with photos. It has a temporary number until it syncs.

Starting, submitting, completing, closing, reopening and deleting an inspection all need a connection. So do inspection plans, attachments that are not photos, and the activity feed. Selecting one of those offline shows a message saying it needs a connection.

In the mobile app, on an installation or a drawing, you can mark a planned installation as installed, and add or delete photos you took offline. Teralo confirms each with Saved offline. Any other change shows a message asking you to reconnect.

In every other tool, a page you opened with a connection shows its offline copy to read. Creating or changing anything there needs a connection.

While you are offline, a You're offline strip at the top of the screen counts the changes waiting. When the connection returns, a banner at the bottom shows Teralo syncing them. Select the strip or a banner to open the Sync queue.

The queue groups the waiting changes by tool. Each shows what it is, when you made it, and its status:

• Queued: waiting to send.
• Syncing: sending now.
• Waiting: held until an earlier change lands. A photo waits for the observation it belongs to.
• Retrying: an attempt failed, and Teralo will try again, up to 8 attempts.

Teralo syncs when the connection returns, when you go back to the app, and every minute while it is open. To sync straight away, select Sync now.

A change fails when its last attempt fails, or straight away when Teralo refuses it, for example because you no longer have permission. A failed change moves to Failed in the queue, with the reason, and a banner counts the failed changes.

1. Open the sync queue.
2. On the failed change, select Retry to send it again, or Discard to throw it away.
3. If you selected Discard, confirm in Discard this change?.

Discarding a change also discards the changes that depend on it, such as the photos of a discarded observation. Retrying a change retries them with it.

The last change to reach Teralo wins. If you change an item note offline and someone else changes the same note while you are away, the record keeps whichever change arrives last. Teralo does not warn either of you.

Logging out on another device, or changing your password, also signs the mobile app out, and can delete its waiting changes.

Teralo encrypts its offline database on your phone, and the photos waiting to upload.