Transact Functions Overview

   Journey Manager (JM) Previously known as Transact Manager (TM).  |    Form Builder Platform Developer |  17.10 This feature was introduced in 17.10.

Journey Manager allows developers to create services as Transact functions, which can be called from Maestro forms.

Consider calling Transact functions from a Maestro form to:

  • Use the rich Transact Fluent API, as opposed to Java script calls
  • Implement complex business logic that requires extensive coding, so Maestro forms can only use simple JavaScripts
  • Make code more secure because it resides on the server side, not on the client side, which is a Maestro form
  • Provide better integration with back end, such as database, because it resides on the server side

Manager defines the following Transact functions:

  • Fluent Function (aka Form Function)
  • Delivery Function

Both Fluent and Delivery Transact functions are Fluent Functions as they implement com.avoka.fc.core.service.fluent.FluentFunctionService Fluent Service, see Transact Fluent API reference.

Fluent Functions

Fluent Functions, also known as Form Functions, provide an improved programming model for client applications to call server-side business functions. Form Functions are designed for applications to make call to other system for doing remote data look-up or executing some secure business logic on the server. They provide the replacement for Form Dynamic Data Services with an improved programming and security model. Fluent Functions provide server-side function event handlers for a variety of Form event triggers. The Fluent Function programming interface is the same across a variety of function triggers enabling you to re-uses function code in a variety of contexts. For example, you could a single function for doing both data pre-fill when a form is first opened and when a saved form is resumed.

Delivery Functions

Delivery Functions are used to deliver user entered form data when a transaction is submitted. This form data includes the submitted form XML, the PDF receipt document and many also include user uploaded file attachments.

How It Works

Transact functions are configured in Manager and they can be used from Maestro forms.

To update a Transact function:

  1. Select Forms > Forms and search for a form.
  2. Click the Functions link to configure a Transact function.
  3. If the form does not have a function associated to it, you need to re-build it in Journey Maestro with the Use Transact Functions option.
  4. Refresh your form view in Manager. You should see the Functions link available now.
  5. Click the link to continue the configuration. You will be presented with the Form Versions tab from where you can configure the Transact function.
  6. Complete the Transact function configuration.

As Transact functions may be complex in their implementations, it can be difficult and time consuming for you to troubleshoot any errors associated with forms that use these Transact functions. Manager provides you with a quick way to access service logging information, using Groovy Service Log, where you can find some key Transact function stats generated during its execution.

Next, learn how to view Transact functions.