Skip Navigation Links | |
Exit Print View | |
Oracle Java CAPS SWIFT Message Library User's Guide Java CAPS Documentation |
Overview of SWIFT Message Libraries
Installing the SWIFT Message Library
To Increase the Heap Size for GlassFish
To Increase the Heap Size for NetBeans
Using the SWIFT Message Library
Message Library and Collaboration Locations in NetBeans
SWIFT Message Library JAR Files
Message Format Validation Rules (MFVR)
In Collaboration Validation Methods
Calling the Validation Methods in your Collaboration
About the SWIFT MX Validation Sample
SWIFT Correlation Repository Sample
Linking the Domain Name and Direction to a Color
Using the SCR for Monitoring Flows
Using the Viewer for Monitoring Transactions
Using the Viewer to Repair Messages
BICDirService Method Operation
To Update BICPlusBAN Information
BICPlusIBAN Validation Method Definitions
Parse Debug Level Message Example
Using SWIFT FIN-Based Funds OTDs
SWIFT Message Library Funds Features
This section explains how to use specialized message validation features and Projects available with the SWIFT Message Library.
The SWIFT Message Library performs validation operations through Java-based Collaboration Definitions that are packaged with the library. These Collaboration Definitions have the following validation features:
Message Format Validation Rules (MFVRs): A set of functions that accurately tests the semantic validity of a given subset of the SWIFT messages.
Market Practice Rules (MPRs): A set of functions that accurately test the semantic and syntactical validity of a particular subset of the SWIFT messages called the 500 series.
BICDirService (Bank Identifier Code Directory Service) Lookup: A set of methods that provide search and validation functions for SWIFT's BIC codes and ISO currency and country codes. The information used for look ups and validation is provided by SWIFT.
BICPlusIBAN Validation: A set of methods that provide search and validation functions for SWIFT's BIC and IBAN codes. The SWIFT Message Library implements the suggested validation rules provided by SWIFT. For more information, see the BICPlusIBAN Directory Technical Specifications from SWIFT.
These validation features share the following use characteristics:
Each available method and function is fully incorporated into and used by the appropriate SWIFT message OTD.
You can modify the validation rules for your system if desired. Customize the Collaboration’s validation rules by checking the Collaboration out (from Version Control) and modifying the validation Collaboration code. The sample implementation and instructions are provided in the validation Collaboration as Java comments.
Validation methods and functions have no dependencies outside SWIFT data files and the individual OTD.
Installing the OTD library allows the Enterprise Service Bus and any Adapters you use with the library to provide full support for these features. The rest of this section provides a summary of how these features operate with the SWIFT Message Library.
In addition to components described under Basic Validation Features, the SWIFT Message Library also contains the following basic components:
SWIFT OTDs (2009 and 2010): OTDs in the SWIFT Message Library that represent standard SWIFT message types.
MT Funds OTDs: Specialized OTDs that allow you to automate the specialized funds operations. This category contains FIN-based OTDs.
Validation Collaboration Definitions: Components that define the validation logic and that are provided for specific SWIFT message types. See Validation Collaboration Definitions for details.
Sample Projects: Sample Projects are provided as examples of validation implementation. See SWIFT Projects for details.
The SWIFT Message Library provides three OTD API methods, validate(), validateMPR(), and validateMFVR(), that can be invoked by a Collaboration to validate SWIFT OTDs directly in the Collaboration (see In Collaboration Validation Methods). This is an alternative to using the Validation Collaboration Definitions.
Validation Collaboration Definitions are provided for many key SWIFT message types. These Collaboration Definitions, when combined with Enterprise Service Bus Services, become Java-based Collaborations that verify the syntax of the SWIFT messages.
Messages are verified by parsing the data into a structure that conforms to the SWIFT standard specifications. The validation functions use the Validation Collaborations to access specific data that is then verified according the algorithms of the Message Format Validation Rules (MFVR) specifications.
For lists of these Collaboration Definitions, see Message Validation Rules.
You can combine the library’s validation features in any way to meet your business requirements. The SWIFT Message Library packages a prebuilt implementation that takes SWIFT messages from a JMS Queue or Topic and validates them individually, then writes the results to a specified JMS Queue or Topic. One set contains valid messages, and the other contains the invalid ones, along with messages indicating the errors generated.
Each validation Collaboration Definition has only the applicable tests for a specific OTD or message type, but they all operate according to the same general format, as follows:
The Service first tests a message to make sure it is syntactically correct by parsing it into the OTD.
If the message fails, the message and its parser error are sent to an error Queue. If the message is valid, all applicable MFVR functions are applied to the message.
Any and all errors produced from these tests are accumulated, and the combined errors, as well as the message, are written to an error Queue for later processing. As long as no error is fatal, all applicable tests are applied.
Again any and all errors produced from these tests are accumulated, and the combined errors and message are written to the error Queue for later processing.
If no errors are found in a message, it is sent to a Queue for valid messages.
For an explanation of using these Collaboration Definitions and the validation Project examples, see SWIFT Projects.
The SWIFT Message Library provides a set of runtime methods that allow you to manipulate OTD data in a variety of ways. The following methods are the most frequently used with validation operations:
set(): Allows you to set data on a parent node using a byte array or a string as a parameter.
value(): Lets you get the string value of data in a node at any tree level.
getLastSuccessInfo(): Returns a string that represents information about the last node in the tree that was successfully parsed.
command(): Allows you to pass flags as parameters, which set levels that determine the quantity of debug information you receive (see Setting the Debug Level for details).
marshalToString() and unmarshalFromString(): Returns string data from or accepts string data to a desired node.
In addition, the library has methods that allow you to perform basic but necessary operations with the OTDs. See Table 11.
Table 11 Basic OTD Methods
|
To help in your use of the SWIFT Message Library and its features, the library includes a Javadoc. You can see this document for complete details on all of these methods. See Table 12 for more information on this document and how to use it.