The following conditions must be met for autosave to happen:
- The user must be logged in.
- The user must have update permissions (if permissions are enabled for the form).
- The form mode must be
- The persistence layer must support autosave and have the
oxf.fr.persistence.$name.autosaveproperty set to
trueby default for the built-in relational databases).
- The autosave delay (set with
oxf.fr.detail.autosave-delay) must be greater than
0(which is the case by default).
NOTE: Form Builder doesn't yet support autosave as of Orbeon Forms 2019.1.
If the following conditions above are met, autosave will be enabled. In this case, if you wish to disable autosave, you can set the
You can as usual disable it for specific forms only, for example:
When autosave is enabled and you are an authenticated user, form data is automatically saved as drafts in the background as you enter and modify form data. This reduces the chance that you will lose data if something goes wrong and you haven't explicitly saved the data.
The summary page shows the drafts, on separate lines and clearly marked as such. From the summary page, users can click on a draft to open it, or select it to then delete it, assuming they have the permission to do so.
If users edit a form for which there is a draft, they will be asked whether they want to open the saved data, or start from the autosaved draft.
If users started filling out a new form, but didn't save the data, if starting to fill out a new form later, they will be asked whether they wish to start from scratch, or from one of the drafts saved earlier. In this case, the prompt will be different whether there is just one draft for new data, or multiple drafts available, as in the latter case, users will need to select which draft they want to use.
New page, single draft
New page, single draft
When multiple drafts are available, choosing the "View autosaved drafts" button takes you to the form's Summary page in a special mode where only the relevant drafts are visible:
Summary page with drafts only
You don't need to do anything special to use this feature.
The value of
oxf.fr.detail.autosave-delaysets the maximum time, in milliseconds, after which a change done by the user will be autosaved. If 0 or negative, autosaving is disabled. Out of the box, this property is set to
5000, that is 5 seconds. If your server experiences a lot of load, you might want to make that value higher to reduce the number of requests made by Orbeon Forms to your database.
With Orbeon Forms 4.3 specifically, you need to:
<property as="xs:boolean" name="oxf.fr.support-owner-group" value="true"/>
<property as="xs:boolean" name="oxf.fr.support-autosave" value="true"/>