Using webMethods Module for SWIFT SDK Services
What Is the SWIFT SDK?
The SWIFT Standards Developer Kit (SDK) is a library of tools that includes automated updates to XSDs and IS document types as new message standards are released annually. The library includes MT XML schema definitions (XSDs) and Java services for performing MT message conversion. The XSDs provide the ability to enforce MT standards by capitalizing on the benefits of XML, including defining and restricting the message elements, constraining field data values to SWIFT standards, and automatic validation of the message format and field data.
webMethods Module for SWIFT's integrated SDK tools provide several benefits including:
- The use of one technology for sending and receiving both MT and MX messages.
- XML integration between applications, while using the MT (FIN) format between partners.
- Fewer errors caused by incorrect FIN syntax.
- Automated annual updates to MT message standard changes.
About the webMethods Module for SWIFT SDK Features
webMethods Module for SWIFT integrates the SDK tools, enabling automated update of the XSDs and IS document types provided with webMethods Module for SWIFT as new message standards are released. In addition, webMethods Module for SWIFT capitalizes on XSD support by providing services to convert between flat file and XML format, including the flexibility to convert entire messages or just the block 4 portion of the message.
The following services convert between XML and flat file format and perform message validation:
Service | Description |
---|---|
wm.sdk.fin.converter:convertMTBlock4ToMTXML | Converts only block 4 of the MT flat file into XML format. |
wm.sdk.fin.converter:convertMTFlatFileToMTXML | Converts the entire MT flat file into XML format. |
wm.sdk.fin.converter:convertMTXMLblock4ToMTFlatFile | Converts only block 4 of the XML file into MT flat file format. |
wm.sdk.fin.converter:convertMTXMLToMTFlatFile | Converts the entire XML file into MT flat file format. |
wm.sdk.fin.validator:validateMTXML | Validates any MT XML message against the SWIFT SDK MT schema. |
To use these services, you must map them in Designer. For more information, see IBM webMethods Service Development Help. webMethods Module for SWIFT automatically performs file conversion based on the corresponding XSD or matching IS document type.
For information about these services, see WmFIN Package Services.
webMethods Module for SWIFT SDK Document Formats
About this task
As part of the SDK feature, webMethods Module for SWIFT provides pre-bundled SDK MT and MX XSDs for the creation of MT and MX IS document types. webMethods Module for SWIFT also provides services that automatically create the back-end IS document types and IS schemas from the MT and MX schemas.
The following IS and XSD documents are included as part of the SDK feature:
- IS document types—The creation services generate a separate IS document type for each message type, per SDK version (provided as part of the SWIFT FIN component). The conversion services use these document types when converting an XML message into flat file format.
-
MT and MX XSDs—The following XSDs are pre-bundled within webMethods Module for SWIFT:
- Block 4 XSDs—A separate XSD to define the business content (block 4) of a message for each message type, per SDK version. These are used when converting flat file messages into XML format.
-
File Definition XSDs —A separate XSD that defines the header and trailer elements common to all message types (Blocks 1, 2, 3, and 5). This is used to enforce the message standard format during conversion of the (entire) file. There is a separate XSD for each SDK version.
To install SDK document formats
To install the IS document types and IS schemas, complete the following steps:
Procedure
- Execute the wm.sdk.docgenerator:createMTISDocFromSchema service to create IS document types and IS schemas for MT FIN messages.
- Execute the wm.sdk.docgenerator:createMXISDocFromSchema service to create IS document types and IS schemas for MX FIN messages.
Results
The corresponding MT and MX IS document types and IS schemas are created in the wm.sdk.rec folder inside the WmFIN package.
webMethods Module for SWIFT SDK Folder Organization
The supporting SDK documents and services are organized using the following folder structure:
Folder | Description |
---|---|
wm.sdk.fin Folder | Contains all the Java services related to the SDK feature. |
wm.sdk.rec.mtxsd.Vyear Folder | Placeholder for the IS document types created from MT XSDs that correspond to the supported MT XML message version. |
wm.sdk.rec.mxxsd Folder | Placeholder for all the IS document types created from MX (ISO20022) XSDs that correspond to the supported MX XML message version. |
IBMwebMethods_directory\Integration Server\packages\WmFIN\pub\resources\ SDK_MT_XML_Schema_Library Folder | Contains the pre-bundled MT XSDs. |
IBMwebMethods_directory\Integration Server\packages\WmFIN\pub\resources\ SDK_MX_Schema_Library Folder | Contains the pre-bundled MX XSDs. |
For information about using webMethods Module for SWIFT SDK samples, see webMethods SWIFT Module Samples Guide.