aplonREPORTER User Manual
SWIFT MT MESSAGE REPORTER
** aplonREPORTER 16.0**
Paymentcomponents Ltd 288 Bishopsgate, EC2M 4QP London, UK
Use aplonREPORTER to automatically generate a PDF report directly from an existing SWIFT MT message. With support for all SWIFT MT Categories from 1 to 9 it offers the ideal way for a bank to provide its customers with an attractive, easily readable, version of any SWIFT MT message.
aplonREPORTER has been developed in Java to provide the best cross-platform flexibility within the banks environment.
In addition to the stand-alone functionality, aplonREPORTER can also be integrated with existing bank applications to generate PDF reports on-the-fly.
- Cross platform
- It can be used as a stand-alone application or deployed on a server depending upon the level of license purchased.
- Available for all SWIFT MT message categories from 1 to 9
aplonREPORTER parses the information from a message and outputs the following user-friendly report:
aplonREPORTER contains mapping definitions for each tag and message type to enable a user-friendly description of a field to be displayed on the report.
The aplonREPORTER DEMO provides an easy way to input the text of an existing SWIFT MT message and generate a PDF report.
In order to run GUI, first set the properties in gui.properties file.
In aplonReporter-x.x folder, run the command:
java -cp lib/\*:aplonReporter-x.x.jar gr.datamation.swift.SwiftMessageParser
The SWIFT message text window can be populated either by pasting the message text or loading from a file.
The PDF can then be generated by the click of a button. The Output window displays a log of activity.
The aplonREPORTER command line provides an easy way to pass the text of existing SWIFT MT messages and generate PDF reports.
The API can be called directly using the following combination of parameters.
Single message – report generation
Input and Output filename
In aplonReporter-x.x folder, run the command:
java -cp lib/*:aplonReporter-x.x.jar gr.datamation.swift.CommandLineMessageParser c:\aplonREPORTER\msgs\103.txt c:\aplonREPORTER\pdfs\103_report.pdf ``` #### Multi message (RJE) – report generation Input filename of RJE file true and target directory for output files The `true` parameter indicates to aplonREPORTER that the input file is an RJE format file containing multiple messages. The SWIFT message reference is used as the file name for each of the reports generated. In aplonReporter-x.x folder, run the command: ```bash java -cp lib/*:aplonReporter-2.0.jar gr.datamation.swift.CommandLineMessageParser c:\aplonREPORTER\msgs\msgs.rje true c:\aplonREPORTER\pdfs\
When added to a Java project, the aplonREPORTER developer library provides an easy way to add the generation of PDF SWIFT MT message reports to existing projects.
The following examples demonstrate how easily you can access the power of aplonREPORTER from within your own projects.
The 'templates' folder should be placed in the same directory with the 'test' package.
Create PDF directly to the file system
Create PDF as a Byte Stream
The file path, for example
should be added in the program arguments.
Customizing the PDF
Customize Message Title
If you want to have another description, than the default for a field or for a message title, then you have to create your own property file. The custom property file must be named **custom\_messages.properties** and must be placed in the **templates** folder**.**The property file must be in a **key=value **format. In the following sample, we override the MT 103 title and the description of the 13C tag in MT 103.
Add sender and receiver descriptions
If you want to add descriptions for the sender or the receiver, then you have to add a new property file in the **templates** folder. Name it **bic\_directory.properties** **custom\_messages.properties**
Add custom fields.
If you want to send some custom fields to the PDF, then you have to add them to the end of the MT message. You can add up to 99 custom parameters, as follows
MT103 with custom parameters
and add the custom parameters to the jrxml file.
The SDK is packaged within a JAR file, that can be added as a dependency to any JVM project within the IDE. During the deployment, make sure that the JAR file is included in the runtime classpath. The JASPER file should be also placed within the scope of the classpath.
Requires at least JDK 1.6.x
commons-beanutils-1.8.0 commons-collections-3.1 commons-digester-2.1 commons-logging-1.1.1 groovy-1.8.1 hamcrest-core-1.3 iText-2.1.7 jasperreports-4.7.1 jdom2-2.0.6 jdom-1.1.3 smv-16.0.0 junit-4.11
Modifying the report layout
The templates folder contains a sample bank logo image file that should be replaced with the required image. The SWIFT_REPORT.jasper file can be copied and customized using the Jasper iReport tool. iReport can be downloaded from the following link.
To use the customized report with aplonREPORTER just edit the gui.properties file to reflect the new report name.
Contact and Support
The support team is available to answer questions on using the component, code assistance, error determination, ideas, examples etc.
Forward your questions to: firstname.lastname@example.org
Visit www.paymentcomponents.com for other components and services by PaymentComponents.