View Form Versions

   MaestroThe UI design product.  |    Form BuilderPlatform Developer  |   21.05 This feature was updated in 21.05.

Journey Maestro allows you to view and manage form versions.

To view the list of form versions:

1. Open your project in the Navigator pane and click Forms to view the list of forms created in your project.
2. Select a form in the Forms folder to view available versions of this form.

   

   The forms are listed in ascending order by form versions. The list includes the following information, which helps you use forms correctly:

   • Version - a form version
   • Tag - whether a form version is tagged or not
   • Description a form version description
   • Modified by - who modified a form version
   • Last Modified - when a form version was modified
   • Created By - who created a form version
   • Created At - when a form version was created
   • Built - this flag is set when there is a corresponding built form where the form developer has edited a form version and clicked Build in the editor and there is a Manager Form Version. In this case, if you use the Delete JM Form Versions functionality, described below, it will delete the built form and deleting the form design version will also delete the built version as well. If the Built checkbox is selected, the Download JM Form Version button is available, so you can use it. Otherwise, you need to open the form version in Maestro and build the TM Form Version of the form.
3. Click Edit Version to open a selected form version in the Maestro editor for editing.
4. Click New Version to create a new version of a selected form.
5. Click New Tag to tag a selected form version.
6. Click Delete Version to delete the selected form version.
   Note

   Use Shift or Ctrl key to select multiple form versions.  |  21.05 This feature was introduced in 21.05.

7. Click Export Versions to export the selected form versions.
   Note

   Use Shift or Ctrl key to select multiple form versions.  |  21.05 This feature was introduced in 21.05.

8. Click Download JM Form Version to download a form version deployed in Manager. This button is only available for selection once the form version has been built at least once.  |  21.05 This feature was introduced in 21.05.
9. Click Delete JM Form Versions to delete a built form version from a Manager instance where it is deployed but leave the form design in Maestro.
   Note

   Use Shift or Ctrl key to select multiple form versions.  |  21.05 This feature was introduced in 21.05.

You can use this functionality to solve the following project issue. Each form you build needs an organization wide unique name in Manager. Now, if you want to use the same form name in a new project, you must delete the previously published forms that use that name, for example, My Application Form, and start using the other form to publish to the same name. If you delete a project, form design or form design version, it will also delete the published form, otherwise the published form is "orphaned". If you have access to the Manager dashboard, you can do it manually from there. However, this features allows you to do it straight from the Maestro dashboard.

10. Click Render JM Form Version to open a form version, that has previously been built and deployed in the host Manager, in a new tab of your browser.  |  21.05 This feature was introduced in 21.05.
11. Click Download JSON to download JSON files of the selected form versions. If you have multiple versions of a form, you can download a JSONJSON (JavaScript Object Notation) is an open standard file format and data interchange format that uses human-readable text to store and transmit data objects consisting of attribute–value pairs and arrays. file of each version and use an external tool to compare them to see the differences between the versions.
    Note

    Use Shift or Ctrl key to select multiple form versions.  |  21.05 This feature was introduced in 21.05.

12. Double-click a selected form version to view the form version's details where you can update the Description field. Click Save to update the changes.

    

    Note

    You can't update the name and version number of the form.

13. Select the Details tab to see the form details where you can change the form's name and description in the corresponding Name and Description fields.

    

    Click Save to persist the changes after you are done.

Next, learn how to export form versions.