Import Forms

   Journey Manager (JM) Previously known as Transact Manager (TM). |   Platform Developer |   v19.11 This feature was updated in v19.11.

Manager allows you to export and import a current form version or all versions of a selected form. This process is commonly used to migrate forms from one environment to another. You can use this functionality to:

  • Rollback one or several forms.
  • Re-create one or several forms in another Manager.
  • Promote one or several forms to other environments.

In Manager prior to version 17.10, Import Form was named Import Form Version.

Manager also allows you to import a form as an application. The main difference between these imports is an archive file format that contains application XML configuration for applications or form XML configuration for forms.

To import one or several forms:

  1. Select Forms > Forms, and then click Import Form.
  2. Click Choose File and choose a form archive ZIP file.
  3. Click Upload.
  4. Select an organization to add the form to.
  5. Select Update an Existing Form if the form is already in Manager, so it will be updated with the new version.
  6. Select Create a Form if the form is not in Manager. Type a form code in the text field as shown below.
  7. Click Proceed To import.
  8. Review the Import Options.
  9. Select the appropriate Form – Import Options, which are associated with all versions of the form. They are all selected by default.
  10. Select the appropriate Form Version – Import Options, which are applied to a selected version of the form, normally the current version.
  11. Select the Form Functions checkbox to import form functions used by the form version. The existing form functions on the target server will be updated with that of from the imported archive. The form functions are referenced by the name and version, so they must exist on the target server prior to the import, otherwise they can't be imported.  |  v19.11 This feature was introduced in v19.11.
  12. Click Import to complete the process.
  13. Check the import status and message in the Import Action tab.
  14. Select the Detailed Messages to see whether there were any errors or warnings during the import.
  15. If errors are sever, you may want to update Manager configuration to fix the error and import the form again.

  16. Click Close and check the list of forms to verify the imported forms have been added.

You can also import and export Maestro forms using the Maestro dashboard.

When importing a form that has come from a more recent version of Manager, you may get an IllegalArgumentException error. To resolve this error:

  1. Log onto Manager you have imported the form into.
  2. Select Forms > Forms and locate the form.
  3. Click the Current Version of the form and change the Form Type to Composer Smart Form . This allow you to render this form correctly now.

Next, learn about how to export forms.