This article addresses the issue of the background save feature failing in Maestro forms when using the Form.backgroundSave() API. Customers may encounter the error message 'Possibly unhandled rejection: Save is disabled.' on certain pages. This article explains the root cause, provides reproduction steps, and offers resolution and a workaround.
Applicable To
Product: Temenos Journey Manager (JM) / Maestro
Module: Form background save functionality
Versions: All versions where background save is supported
Prerequisites
- Access to Maestro form design and rules configuration
- Browser developer tools (console) for debugging
- Ability to test and modify form page load rules
Use Case
The background save feature normally allows users to save progress automatically as they complete forms. However, on some forms, after moving to later pages, users may encounter the error:
- Possibly unhandled rejection: Save is disabled.
This indicates that saving has been disabled on specific pages, preventing the background save API from functioning.
Recreation Procedure
- Enable background save in a form and render it.
- Begin filling out the form.
- Proceed to later pages.
- Observe that the error appears, and the background save stops working.
- Open the browser console and inspect the error.
Expected Result: Background save continues to work across all pages.
Actual Result: Background save fails with the error message.
Resolution
This issue occurs because the property Form.disableSave is set to true on certain pages.
- Default Behavior: Form.disableSave = false (save allowed).
- Issue: When set to true, save is disabled, causing the error.
How to Check and Fix
Render the form and navigate to the page where the error occurs. In the browser console, check the value:
maestro.Form.disableSave
- If it returns false, save is allowed.
- If it returns true, save is disabled.
For testing, temporarily enable saving in the console:
maestro.Form.disableSave = false;
To implement a fix, add the following logic in the page’s load rule:
if (Form.disableSave) { Form.disableSave = false;}
Important Note
Before applying this change permanently, advise customers to carefully test their forms. In some cases, enabling saving on restricted pages may interfere with other business rules or features. Validation should be performed to ensure no unintended issues arise.
References / Additional Resources
Maestro API Reference – Form.backgroundSave()
Temenos Journey Manager Documentation