Skip to main content

Version: 18.05 (EOL)

Application Package Quick Start

This guide is a quick walk-through of creating and deploying a new Transact Application using the Ant tasks supplied with the SDK. Prior to undertaking this exercise, you need to have installed the SDK prerequisites and the SDK itself, as described in SDK/IDE Setup. You should also have scaffolded a new Home Loan project as part of the setup instructions, and edited the file with your credentials.

Learning outcomes from this exercise

Upon completion of these step-by-step instructions, you will have completed the following tasks.

  • Scaffold a new Application Package into the Home Loan project.
  • Copy an example form from the SDK to the Application Package.
  • Deploy the Application Package to your Transact Manager server.

Then, in the Transact Manager Console, you will verify the result.

  • Search for your new form.
  • Render your new example form.

Finally, we show how you can work with your own Maestro form instead of using the example form included with the SDK.

Exercise Steps

We'll be running the Ant targets in this exercise from IntelliJ on Windows. The SDK has been unzipped in the folder C:\Development\SDK\Intellij.

Scaffold a new Application Package into the project

In the Ant Build panel:

  1. Select the app-scaffold target and click the Run icon. Alternatively, you can double-click the app-scaffold target to run it.

  2. Check the result in the Messages window. You can display the Messages window with the Alt+0 (zero) keyboard shortcut.

Copy the example form from the SDK

To make this exercise quicker to perform, we've included a pre-built Maestro form in the SDK. You need to copy the example form from the SDK into the correct place in the Application Package to remind you of the need for this step when you eventually create your own forms.

  1. Expand the src folder in the Project pane, then expand the forms.homeloan folder.

  2. Select View > Tool Windows > Terminal to open the Terminal window. Alternatively, you can press Alt+F12.

  3. Enter the appropriate command for your operating system.

    copy ..\transact-sdk-18.5.0\examples\ src\forms\homeloan

    The Project window should now look like this:

Deploy your project to TM

Here we run the app-deploy Ant target to deploy the Application Package to the configured TM server.

In the Ant Build pane:

  1. Select the app-deploy target and click the Run icon. Alternatively, you can double-click the app-deploy target.

  2. Check the result in the Messages window. You can display the Messages window with the Alt+0 (zero) keyboard shortcut.

Your Application Package, including the example form, will now be deployed to TM.

Verify the form in Transact Manager

Here we locate the new form in TM and render it.

  1. Login to TM.
  2. Select Forms > Forms from the menu.
  3. Enter loan in the search field.
  4. Click Search.
  5. Click the Form Test Render icon.


Even though the example form is available in Transact Manager, it will not be available to you in Maestro because it has credentials from a development server. It is only provided as a convenience for the sake of this quick start exercise.

Creating your own Maestro form

Now that you have deployed the supplied example form to your TM server, you might want to create your own form so you can work with it in Maestro.

Follow these steps to create and download your own Maestro form version archive file.

Build a Maestro form

Here we build a Maestro form that has been designed and is ready to build.

  1. In the Maestro designer, click the dropdown beside the Build button, and select Build with Options.

    The Build Options dialog is displayed.

  2. Select the Build Option Use Transact Functions (requires TM 17.10 +), and click Build.

    The Actions dialog is displayed.

  3. Click Download TM Form Version.

    The form version archive file is downloaded in a format suitable for including as a form in an Application Package.