How to run the example

This mx-mt translation will use the sample files to demonstrate the generation of SWIFT MT210 message output from a CBPR+ camt.057.001.06 XML message.

The cbprJnodesConfigIBM.tar.gz file is available either in IBM_financialpaymentsplus_vn.n.n.n.zip or in UIProjectImports directory.

Extract from cbprJnodesConfigIBM.tar.gz file.
  • jnodes0.jar
The following jars needs to be copied from <TX_install_dir>/jars:
  • jackson-core-n.n.n.jar
  • jackson-annotations-n.n.n.jar
  • jackson-databind-n.n.n.jar

Or visit https://repo1.maven.org/maven2/com/fasterxml/jackson/core/ for download.

For the non Docker environments,
  • Copy jars to <TX_install_dir>/extjar.

For TX V11.0.0 and up, native based Design Server installation,

Copy jars into the directory pointed to the config.yaml server.persisitence.files, by default, this is set to /opt/txlibs, then restart the running application ./ITX stop and then ./ITX start

For the Docker environments,
  • Docker cp jnodes0.jar tx-server:/opt/ibm/wsdtx/libs/.
  • Restart the design server, i.e., docker restart tx-server.

This example may generate stopTranslation.json log file to report the translation failure due to the pre-conversion checks:

NumberOfOccurrences <Ntfctn><Itm> should not be greater than 1.
Currency should not be any of these: {"XAU", "XAG", "XPD", "XPT"} for <Ntfctn><Itm><Amt><Ccy>
TotalNumberOfDigits <Ntry><Amt> less than or equal to 14.
  1. Import the cbpr_translation.zip project into the Design Server.
  2. Open the cbpr_translation project in Design Server and view the flow cbpr_camt057_mt210. It utilizes the following nodes:
    1. Map Nodes:
      • MX deenvelope

        Runs map cbpr2724_deenvelope which sets the flow variable mxMsgId to 'camt.057.001.06' based on the input. Also, distribute the input data into two: Application header and document.

      • set BAH

        Runs map cbpr2607_bah_camt057_set which set up the flow variables for the Application Header.

      • serialize data

        Runs map cbpr2606_camt057_serialize which set flow variable mxMsgId to '210' based on input and the flow variable stopTranslation if required.

      • set mt210

        Runs map cbpr2603_camt57_mt210_jexit, invokes JEXIT call to java class located in jnodes0.jar and returns with flow variables.

      • trx_log

        Runs map cbpr2501_mxmt_setvarlog, process the flow variables by extracting log as key.

      • build MT210

        Runs map cbpr2605_camt057_mt210 which builds the output MT210 message fields based on the values set in flow variables.

    2. Decision Nodes:
      • pre-conv chk

        This check the flow variable stopTranslation to decide if further translation is required.

    3. Log Nodes:
      • FAILURE

        It creates stopTranslation.json log file in case of failure during translation.

      • mt210

        Archive the mt210.out message generated from translation.

      • audit_log

        It creates the audit.log.json output file in case of success translation to MT210.

  3. In Design Server, create a package that contains the input files and one flow. The maps will automatically be included during deployment of the package onto the runtime server.