View Designs

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

Journey Maestro allows you to view and manage designs and their versions from the Journey Maestro Management Dashboard.

Note

This UI is similar for all designs, such as forms, components, templates and receipt, so it's described using a form as an example.

To view the list of design 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.
    view the list of form versions in Maestro

    The forms are listed in ascending order by form versions. The list includes the following information:

    • Version: a version of a form
    • Tag: whether a form version is tagged or not.
    • Description: a meaningful description of a form version .
    • Modified by: a user name or email address of a user who modified a form version.
    • Last Modified: when a form version was modified.
    • Created By: a user name or email address of a user who created a form version.
    • Created At: a day 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 Maestro 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.
  7. Tip

    Use Shift or Ctrl to select multiple designs for bulk operations on actions, such as Delete, Export and Download.

  8. Click Export Versions to export the selected form versions.
  9. 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.
  10. 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.
  11. 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.

  12. 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.
  13. 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.
    Tip

    You can use the Compare Designs functionality to see differences without exporting form version as JSON.

  14. Select two design versions and click Compare Version to see the difference between them.  |  23.10 This feature was introduced in 23.10
  15. 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.
    Maestro editor view form version details
    Note

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

  16. 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.