Changes to Autosave Protocol
Unearth has an autosave feature that works in the background to save data while you work. To ensure users are properly notified when any data fails to autosave due to a network interruption or other error, we are implementing a change to the autosave feature of our asset forms. Data will now complete the save process while you are still in the asset form, and if there’s any save fails you will see an error and an opportunity to manually retry the save. This is to make sure that if there is a failure for any reason, the user is given proper information so they can see what went wrong and correct it.
In this article, you will learn about how these changes will affect the basic form save flow, as well as where you can expect to see small changes in the process.
New save process:
When you create, edit, or batch edit an asset’s data, the form will not be able to be closed until the autosave completes. If the autosave fails, an error will occur and an option to manually “Save Changes” will appear in the place of the “Done” button. If you try to leave the asset with unsaved changes, you will be prompted to return and save your unsaved changes.
Here’s how that will look in various situations:
When creating a new asset:
-
When you create a new asset from the “+” menu, the form will immediately go into “Saving” mode while the asset’s geometry is saved. Then you can proceed to editing the form.
-
-
If any autosave error occurs while creating the asset, an error message will appear and the button will change to “Save Changes.” Clicking “Save Changes” will manually save the data and close the form. If you try to click away from the form, you will be reminded through the pop-up to make sure the new asset has been saved.
-
When editing an existing form:
-
When you edit an existing asset created on the map, the “Done” button will change to “Saving” while the form autosaves.
-
-
If any autosave error occurs while editing the asset, an error message will appear and the button will change to “Save Changes.” Clicking “Save Changes” will manually save the data and close the form. If you try to click away from the form, you will be reminded through the pop-up to make sure the edits have been saved.
-
When editing asset data in the Table View:
-
When editing an asset in the Table View, you will see the same process - first “Saving” will appear to indicate the data is being autosaved, then “Done” will indicate the save has completed
-
If the autosave fails, you will see an error message and the option to manually “Save Changes.” If you try to click away from this field, you will be reminded through the pop-up to make sure the edits have been saved.
-
When you try to leave the form with unsaved data:
-
If an autosave error occurs while data is being edited, either in the form or in the table, there are a few ways a user might leave the asset. To prevent a user from leaving a form with unsaved data, we have enabled a popup window to warn the user that their form has not finished saving, prompting them to return to the form and manually save.
-
If they would like to discard the unsaved change, the user does have the option to “Leave Anyway” which will result in that data not saving. They can then reattempt the change if desired.
-
If you run into any issues or have any questions, please reach out to us at unearthsupport@procore.com
Revised April 2025