Build a TM Form Version

   MaestroThe UI design product.  |   Form Builder  |   22.10This feature was updated in 22.10.

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. 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.
3. 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.
4. 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.
5. Click Build with Options to apply the build and brand options before building the TM Form Version.

   

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:

• Select the Use server side Transact Functions (requires TM 17.10 +) checkbox to use Transact functions to call services in Manager.  |  17.10 This feature was introduced in 17.10.

  It's important to notice that enabling Transact functions causes the following:

  1. It limits the number of available services you can configure for your form version, as shown below:

     

  2. It removes a number of SystemProfile properties, such as <TestMode>false</TestMode>, from the form and from the submission XML data.

  However, enabling Transact functions allows you to configure Transact functions, which were not available before that.

  Note

  You can see whether the Transact function are available in a form when you configure a form version in Manager.

  Note

  Transact functions require Journey Manager 17.10 and higher.

• Select the Minify Code checkbox to reduce the size of the form and related JavaScriptJavascript (JS) is a scripting languages, primarily used on the Web. It is used to enhance HTML pages and is commonly found embedded in HTML code. JavaScript is an interpreted language. Thus, it doesn't need to be compiled. resources without changing its functionality so they can be sent out to a client browser more efficiently.
  Note

  Code minificationMinification is the process of removing all unnecessary characters from the source code of interpreted programming languages or markup languages without changing its functionality. functionality has been enhanced in the following Maestro versions:

  • Prior to 18.05 - JavaScript resources are concatenated into the app.js and then minified, but not transpiledTtranspiler is a source-to-source translator, source-to-source compiler, transcompiler, which is a type of translator that takes the source code of a program written in a programming language as its input and produces an equivalent source code in the same or a different programming language..
  • In 18.05 - JavaScript resources are concatenated into the app.js, then minified and transpiled. The transpiling support to the rules, the runtime framework and any widget scripts so that users could use ES6ECMAScript (ES6) is a general-purpose programming language, standardized by Ecma International according to the document ECMA-262. It is a JavaScript standard meant to ensure the interoperability of Web pages across different Web browsers. constructs in their rules while maintaining IE 11 support as it is still a supported browser. External JavaScript files are the responsibility of the form developer to maintain for minification and IE 11 compatibility.
  • Since 19.05 - JavaScript resources are added as they are as separate resources and provided to the form as-is. External JavaScript files that are loaded with just a URL are not processes at all other than to add the script tag that adds them to the form.
  • Since 22.10 - a reference to Internet Explorer 11 was removed from this option.
  Note

  JavaScript resources are the object dropped on to a form and a user has selected a JavaScript resource that is in the form or other available library. External JavaScript files are added through the JavaScript object and setting the URL property.

  Note

  Reducing the code makes it difficult to read it, so you have to consider deselecting the Minify Code checkbox when debugging the form.

• Select the Use Separate Receipt Design checkbox to use a separate receipt, if a receipt design is available in the form, so all built receipt assets are pulled into the FAR file. This FAR is different as it effectively has two complete Maestro designs - a form and a receipt. There is an XML file in the FAR that tells Manager that the form uses a specific HTML file for the interactive form and a different HTML for the receipt.
  Note

  When Maestro builds the form, it doesn't rebuild the receipt form. It simply takes the latest version of the receipt that has been built and checks whether the last update time on the receipt is after the last built time on the receipt or not. If the receipt has been changed since its last built, Maestro shows a warning that the receipt needs to be republished.

• Select the Remove Automation Framework checkbox to remove the MAF code, which reduces the download size of the form and prevent misuse of the API in production forms. The Maestro Automation Framework (MAF) provides an API which can be used by other tools to automate and investigate the state of a Maestro form. Once a form is ready for production, MAF is not required.

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 select 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:

• Select one or many brands from the available list of brands defined in your template. The Default brand is always available.
• Select Generate ZIP Files to bundle the form and all relevant resources in a ZIP file, which you can deploy in various Manager environments.
• Select Generate FAR files to bundle the form and all relevant resources in a FARFAR is a Form Archive that contains a form and all related resources that can be deployed as a package in various Journey Manager environments. file, which you can deploy in various Manager environments.

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.