Skip to main content

Version: 24.04

Application Package Quick Start

This guide is a quick walk-through of creating and deploying a new Journey Platform 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 transact-auth.properties 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 Journey Manager server.

Then, in the Journey 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.

info

In this example, you can replace each Ant task with the equivalent goal from the JM SDK Maven plugin.

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-23.4.0\examples\form-example-v1.0.zip src\forms\homeloan

    The Project window should now look like this:

Deploy your project to JM​

Here we run the app-deploy Ant target to deploy the Application Package to the configured JM 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 JM.

Verify the form in Journey Manager​

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

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

info

Even though the example form is available in Journey 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 JM 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.