Didn't find what you were looking for?

    Extend your Search in Community


    We're always happy to help with questions you might have. Contact Us


Exchange Package Installation

   Exchange This topic is related to the Avoka Exchange.  |   Platform Developer |  v5.0 & Higher   This feature is related to v5.0 and higher.

There are two ways to install Exchange packages into your Journey Manager environment to use in your Maestro applications. The installation method to use depends on your Journey Manager version. They are:

  • Via the Avoka Exchange
  • Via a ZIP archive file

Installation via The Avoka Exchange (v18.05 and later)

 |  v18.05 This feature was introduced in v18.05.

The Avoka Exchange catalog has been integrated into Journey Manager from v18.05 to allow you to easily download Exchange packages directly into your Journey Manager environment. You will need the Exchange permissions to be able to do this.

  1. Select Avoka Exchange from the Journey Manager Modules menu.
  2. Or login to the Avoka Exchange from: https://<transactmanager.environment.com>/exchange/secure/web/exchange-browser
  3. Locate the required Exchange package. Filter by Category and Region to confirm the package is supported in your region.
  4. Make sure you have selected the correct organization. The package will be installed into the Organization you selected and will only be available for use in forms within that Organization.
  5. Click
  6. The Exchange package will be downloaded and installed into your Journey Manager environment.
  7. Then click on the Download Maestro library link to add the Maestro component of the package into the Maestro Palette.
  8. The Exchange package services and Maestro assets are installed and ready for use.
  9. Click on the View documentation link to understand what configuration is required to use the package.

Installation via a ZIP archive file (TPac) (v5.0 - v17.11)

 |  v5.0 & Higher   This feature is related to v5.0 and higher.

To install an Exchange package follow the steps below:

  1. Unzip the package to a directory on your computer.
  2. Import each zip archive found in the Services folder to Journey Manager under the Services >> All Services menu item.
  3. Review the Help Doc tab for each of the imported services and make any required adjustments to service parameters.
  4. In the Service Definition tab of each service, check the Organization name to make sure it reflects the correct organization.
  5. Configure any required Journey Manager Service Connections. Make sure they point to the package name and add your package credentials also. These requirements can be found in the Help Doc for each of the imported services.
  6. Note

    Service Connections can be configured in Journey Manager under the Services >> Service Connections menu item.

  7. Test all package services are actively running in Journey Manager by clicking on the green arrows and make sure they display a green success message.
  8. Import each archive found in the Libraries folder to Maestro.
  9. Note

    Importing these into the Organization level libraries folder is recommended as this will make the components available to all projects, however they can be imported at the Project level if required.

  10. Review the package readme file to understand what configuration is required to use the package.

What is a Transact Distribution Package (TPac)

Transact Distribution Packages (TPacs) are the currency of the Avoka Exchange and contain all assets required to install and configure these extension modules. Typically these assets include:

  • Package Documentation: HTML based read-me documentation detailing installation and usage instructions, compatibility notes, licensing requirements and detailed documentation for each asset in the package.
  • Fluent Groovy Services: One or more Groovy services built using the Transact Fluent SDK to provide the API based integration to 3rd parties and supporting functions.
  • Maestro Library: A library of design assets to support drag and drop usage in the Maestro designer.

A TPac is a simple archive file based on the ZIP format.