Build a TM Form Version

   MaestroPreviously known as Transact Maestro.  |   Form Builder  |   21.11 This feature was updated in 21.11.

Maestro allows you to build a form as a TM Form Version ZIP file, which includes a FAR file and all related form's assets, so you can easily deploy it in a form space in Journey Manager. You develop and build the form in the same tool - the Maestro editor, which is handy and saves you time.

If the form containing multiple brands, you can build the form using one or many brands available to the form.

If you don't need to deploy a TM Form Version ZIP file right away, you can build and review it first, and import it into Manager later , when you need to. Usually, you import the TM Form Version ZIP file to Test and UAT environments, then you promote a form to a production environment by exporting and importing it using Manager's functionality.

To build the TM Form Version of a Maestro form:

  1. Open a form in the Maestro editor and select one of the following options from the Build dropdown menu:
  2. Maestro editor build functionality

  3. Click Build to build a TM Form Version. This doesn't download the TM Form Version or display the rendered form, which is useful when you are re-building and updating a TM Form Version that has already been imported into Journey Manager.
  4. Click Build and Download TM Form Version to build a TM Form Version and then immediately download the ZIP file needed to import the Form Version into Manager.
  5. Click Build and Render Form to build a TM Form Version and render the form in a new tab. You can download the TM Form Version later from the Management Dashboard. This option is handy when you need to view or test a rendered version of the form.
  6. Click Build with Options to apply the build and brand options before building the TM Form Version.
  7. Enter a new TM Form Version name in the TM Form Name field, in case you want to change it from the default name, which is the existing name of the form.

    Specify Build Options to build the form according to your requirements:

    If the form containing multiple brands, Maestro gives you additional options to choose which brand, or all of them, to use to generate a TM Form Version.

    Select the Build Specific Brands (no updates to the published form in JM. Built forms will be downloaded to the local file system) checkbox to see the the list of brands available to the form.

    Note

    You can't the Build Specific Brands (no updates to the published form in JM. Built forms will be downloaded to the local file system) checkbox if the form has only one brand.

    Specify Brands to build the form using specific brand or brands:

    Click Build to build the form. Check the build result and perform some actions as described below.

    • Click Render Form to render the form in a new tab. It's similar to the Preview Mode.
    • Click Download TM Form Version to download the ZIP file on your local PC.
    • Click Show Resource Summary to see resources associated with this form and included in this ZIP file.
    • Click Back to go to the previous screen.

Once a TM Form Version is built, you can download it at any time from the Maestro Management Dashboard using the Download JM Form Version option.

When building the TM Form Version, you may encounter some common errors, which you can resolve yourself.

Next, learn how to update TM Form Version.