Snapshots

This extension will extend Tabidoo's capabilities to create a snapshot of the application. Both definition data and user data.

Introduction

Snapshots are an easy way to backup and restore data in Tabidoo. Please read these instructions carefully before using them. You may lose data by restoring the wrong data. If there is any passage you do not understand, please feel free to contact us at support@tabidoo.cloud.

We strongly recommend that you try working with snapshots first on a test application before using it in a live environment.

First of all, you have to add the extension Snapshots into your application. You can achieve it in two ways:

Edit application and select the "Application extensions" section
Use a button Add a new table (left down corner) and afterwards select from all the options of App extensions the Snapshots.

A snapshot is a copy of application data. Backup.

You can back up definition data, user data, or both. We strongly recommend backing up both. Choosing other options is for experts and may cause non-standard application behavior.

Definition data - Application and table definitions. E.g. application name, names and type of items in the table. The definition data does not contain the data you enter into the table!

User data - Data that you enter into the table, including attachments. User data does not include application settings and table structure.

Create snapshot

You just add a row to the Snapshots table. The snapshot is created in the background after the row is saved. Wait until the status of the record changes to Done before working with the snapshot again.

If you are not exactly sure you understand the implications, do not manipulate the "Definition part" and "User data"

If you wish to automatically delete a snapshot after a certain date, use the "Delete after" item.

Create snapshot screen

The size of the data in the snapshot counts as any other data in the pricing plan.

Restore snapshot

The Restore snapshot option overwrites all application data with the data that was saved to the snapshot. The action runs in the background. Please wait for the Done status before working further with the system. In case of any problems, please contact us as soon as possible at support@tabidoo.cloud.

Automation

Snapshots is a table like any other. For example, if you wish to backup your application every night, you can create a Workflow that inserts a row into the snapshots table. Do not forget to delete old snapshots or set an automatic delete date.

Here is an example of how you can write a simple JavaScript in your workflow to create a snapshot which will be deleted after 14 days. Of course, if you want to keep the snapshots and decide on their deletion later, you can omit the deleteAfter property or leave it empty.

   let field = <IDooApiTableSnapshots>{
        label: 'Snapshot-' + new Date().toISOString(),
        definitionPart: true,
        userData: true,
        deleteAfter: doo.functions.date.addDays(new Date(), 14).toISOString().substring(0,10),
        state: 'New'
    };

    await doo.table.createRecord('snapshots', field);

The field label is required and determines the name of each snapshot. You can also set the date after which the particular snapshot will be deleted. The state of the created record has to be set to 'New'.