If you are using Maestro 17.10.x with a Journey Manager 5.x environment, and your form version number is longer than 10 digits (e.g. "1.0-develop"), you will get an error when you attempt to import the Manager 17.10.x form to the Manager 5.x environment. In this case, it is recommended that you shorten the default suffix when creating new form versions in Maestro 17.10.x.
Creating a new form version at these points may save you the hassle of fixing your form should something go wrong. For example, say you're adding a feature or changing the behavior of existing form items but while making these changes something goes wrong. Form versions allow you to easily return to a previous working version of the form.
Since v17.10, the Transact platform follows open source semantic versioning conventions. Following this convention, all new form version names are recommended to start at version 1.0-develop until they reach production. In versions of Maestro prior to v17.10, form versions are incremented by whole numbers (for example version 1, version 2, version 3, etc.).
When you create a new form, the initial form version will depend on the Default Initial Version applied from the Project Details page. The Default Initial Version will be set when a new project is created.
The Default Initial Version can be changed at any time by switching to the Project Details tab and changing its value. This will only impact new forms and assets within this project; version numbers of existing forms are unaffected.
Form versions are sorted and displayed based on major, minor and patch release numbers and are displayed in the Maestro interface in descending order.
Semantic versioning in Maestro provides the following benefits:
When working on any form, it is recommended that you do all your work on version 1.0-develop (the initial form version) until the form is ready for production. When a form is ready for production, it is recommended that you create a tagged version of the form.
Next, learn how Manager handles form versions.