In this section: |
This topic provides step-by-step instructions for configuring a basic outbound message flow for the iWay Integration Solution for SWIFT. The message flow represents the movement and tasks in the conversion of a message from XML to SWIFT.
If you plan to modify the message flow presented here and would like more information on the supported iWay business components that you can use in channel construction, see the iWay Service Manager User's Guide.
For instructions, see Accessing the iWay Service Manager Administration Console.
Note: Before configuring your XML to SWIFT channel, it is recommended that you first test and configure your SWIFT to XML channel.
The iWay e-Business Information Exchange (Ebix) framework supplies several Ebix files for the iWay Integration Solution for SWIFT.
An Ebix file for SWIFT is named SWIFT_ccyy.ebx, where ccyy is the release year. For example, an Ebix file for the 2009 SWIFT FIN message is named SWIFT_2009.ebx.
For details on the supported SWIFT FIN messages, see Ebix-Supported Transaction Sets.
This topic describes how to add an Ebix to the Registry on Windows and UNIX.
Note: Ebix archives are not packaged with the iWay Service Manager installation. You can download all Ebix archives from the following Web site, which is hosted and maintained by iWay Software.
http://techsupport.informationbuilders.com
Tip: If you already added an Ebix to the Registry as described in Adding an Ebix to the Registry, you do not need to add it again for outbound processing. You can go directly to Defining an Inlet.
The Ebix pane opens, as shown in the following image.
You are prompted for the name of the Ebix and an optional description.
Note: This step must be repeated for each SWIFT document that is added to the Registry.
On the Ebix pane, you will see that the Ebix was successfully added. Later you will associate it with the channel for inbound processing.
Depending on your system configuration, there are two methods that you can use to add an Ebix to the Registry on UNIX and z/OS.
You will add a listener to the Registry, then associate that listener with a new inlet.
Select File from the Type drop-down list and click Next.
The configuration parameters pane opens.
Parameter |
Value |
---|---|
Input Path * |
C:\XML_in This value is the directory in which input messages are received. Make sure that you have created this directory; otherwise, errors will occur during deployment. |
Destination * |
C:\XML_out This value is the directory in which output files are stored after transformation. Make sure that you have created this directory; otherwise, errors will occur during deployment. |
Removal Destination |
C:\XML_removal This value is the directory to which input messages are moved if they fail during transformation. Make sure that you have created this directory; otherwise, errors will occur during deployment. It is recommended to configure a removal destination when you are constructing a basic channel. |
Suffix In |
xml Input files with the extension .xml are allowed. |
Suffix Out |
swift In this example, the extension for output files is .swift. |
Parameter |
Value |
---|---|
Name * |
XMLtoSWIFT_Listener |
Description |
File listener for XML input. |
Parameter |
Value |
---|---|
Name * |
XMLtoSWIFT_Inlet |
Description |
Inlet for XML to SWIFT. |
The next pane prompts you to select a listener.
The listener is added to the inlet.
A route defines the path a message takes through a channel.
The route for the channel for outbound processing consists of a process. A process is a stateless, lightweight, short-lived microflow executed by iWay Service Manager on a message as it passes through the system. A service is an executed procedure that handles the business logic of a message.
This section describes how to create a process flow with iWay Designer and bind it to a sample channel as a route.
For details on the full features of iWay Designer, and additional information on using its capabilities, see the iWay Designer User's Guide.
You will complete the following high-level steps to define the route.
Note: A Validation Report is used to determine if your SWIFT message is compliant with SWIFT-defined standards. SWIFT tagging validation and network validation will be performed.
The Designer Project Information dialog box opens, prompting you for a project name and optional description.
In the Description field, type Defining a route for SWIFT outbound processing using iWay Designer to describe the project.
The Designer Project Bindings dialog box opens.
The iWay Process Configuration dialog box opens.
In the Description field, type Process flow for SWIFT Route outbound channel processing.
The new XML_SWIFT_Validation_process node appears under the Processes folder, and the workspace displays a Start object.
You are ready to build the XML_SWIFT_Validation_process by adding objects to it and specifying their relationships.
The SWIFT XML Transform service object transforms SWIFT XML to SWIFT messages.
The Service Name and Description dialog box opens.
The Service Type dialog box opens.
The Define Service dialog box opens.
Do not select the check box, since you do not want to use this service in other process flows.
The Properties dialog box opens.
XMLtoMT%.xch
The new SWIFTXML_Transform object appears in the workspace.
Now you need to connect the Start object to the SWIFTXML_Transform object.
The Line Configuration dialog box opens.
This option indicates that there are no conditions that affect the path, and that the path between the two objects will always be followed.
A line appears between the objects to indicate that a relationship has been established.
The following procedure describes how to add a Set object, which is used to indicate the completion of the SWIFT to XML transformation process.
The Set Name and Description dialog box opens.
The Define Events dialog box opens.
The Set object is added to the workspace area, as shown in the following image.
The Line Configuration dialog box opens.
This option indicates that there are no conditions that affect the path, and that the path between the two objects will always be followed.
A line appears between the objects to indicate that a relationship has been established.
The following procedure describes how to add a Synch object, which is used to indicate the start of the outbound validation report process. The Synch object waits until the Set Object returns the AllDone status.
The Synch Name and Description dialog box opens.
The Expression Builder dialog box opens.
The Timeout dialog box opens.
The Synch object is added to the workspace area.
The Synch object dialog box opens.
The Line Configuration dialog box opens.
This option indicates that there are no conditions that affect the path, and that the path between the two objects will always be followed.
A line appears between the objects to indicate that a relationship has been established.
You will add a Validation Report service to execute a SWIFT validation report.
The Service Name and Description dialog box opens.
The Service Type dialog box opens.
The Define Service dialog box opens.
Do not select the check box, since you do not want to use this service in other process flows.
The Properties dialog box opens.
The new SWIFT_Outbound_Validation_Report object appears in the workspace.
The Line Configuration dialog box opens.
A line appears between the objects to indicate that a relationship has been established. The process flow will look similar to the following.
All processing paths must terminate with an End object.
The End Name and Description dialog box opens.
The End Name Schema dialog box opens.
The Properties dialog box opens.
The new End object appears in the workspace.
The Line Configuration dialog box opens.
This option indicates that there are no conditions that affect the path and that the path between the two objects will always be followed.
You can reposition the objects as desired.
The Line Configuration dialog box opens.
This option indicates that there are no conditions that affect the path and that the path between the two objects will always be followed. This relationship will redirect the output document to its destination.
A line appears between the objects to indicate that a relationship has been established.
Validating a process flow ensures that its structure is correct. Publishing a process flow makes it available in the Registry for use in channel configuration.
For instructions on validating and publishing the process flow, see the iWay Designer User’s Guide.
Parameter |
Value |
---|---|
Name * |
XMLtoSWIFT_Route_PFlow |
Description |
Route for SWIFT XML to SWIFT using process flow. |
You are prompted for the type of component to associate with the route.
The route, with its associated process flow, has been successfully defined.
An outlet defines how a message leaves a channel. An emitter is a transport protocol that sends a document to its recipient. In the sample configuration, we will use a File emitter. For details on supported protocols, see the iWay Service Manager Protocol Guide.
For the channel in this example, you will add two emitters to the Registry. Then you will define two outlets, associating one emitter with each outlet.
When you associate the outlets with the channel in later steps, you will apply a condition to each one to dynamically direct the flow of the output document based on its content.
In the example, you will add:
The configuration parameters pane opens.
Parameter |
Value |
---|---|
Destination * |
C:\File_out\SWIFT\_SREG(basename)_*.swift This value is the directory to which the SWIFT output goes. Make sure that you have created this directory; otherwise, errors will occur during deployment. SREG(basename) is a special register reserved by iWay Service Manager, which uses a file name without an extension. For more information on how to configure a special register (SREG), see the iWay Service Manager User's Guide. On output, an asterisk (*) in the destination file name is replaced by a date and time stamp. |
Create Directory |
false |
Parameter |
Value |
---|---|
Name * |
SWIFT_Out_Emitter |
Description |
Emitter for SWIFT output. |
The configuration parameters pane opens.
Parameter |
Value |
---|---|
Destination * |
C:\File_out\Report\_SREG(basename)_*.xml This value is the directory to which the report validation output goes. You can use an extension other than .xml, for example, .SWIFT or .data. Make sure that you have created this directory; otherwise, errors will occur during deployment. On output, an asterisk (*) in the destination file name is replaced by a date and time stamp. For details on the special register (SREG) used in the preceding file name, see the iWay Service Manager User's Guide. |
Create Directory |
false |
Parameter |
Value |
---|---|
Name * |
Validation_Report_Emitter_Outbound |
Description |
Emitter for Validation Report output for SWIFT. |
Now that you have added a SWIFT and Validation Report emitter to the Registry, you are ready to add and define the outlets. You will associate the previously created emitters with the outlets (one emitter for each outlet).
Parameter |
Value |
---|---|
Name * |
SWIFT_Outlet |
Description |
Outlet containing SWIFT data. |
The next pane prompts you for the component type.
The next pane prompts you to select an emitter.
The SWIFT emitter is associated with the outlet. Now you need to define the second outlet for the validation report output.
Parameter |
Value |
---|---|
Name * |
Validation_Report_Outlet_Outbound |
Description |
Validation report Outlet for SWIFT outbound |
The next pane prompts you for the component type.
The next pane prompts you to select an emitter.
Now you have defined the two outlets.
Now that you have defined the inlet and outlet for the outbound channel, you are ready to add the channel to the Registry and associate the conduits with it. At this time you will also add the route to the channel.
Parameter |
Value |
---|---|
Name * |
XMLtoSWIFT_Channel |
Description |
Channel for XML to SWIFT outbound processing. |
You are prompted to associate components with the channel.
The inlet is associated with the channel. Now you need to associate a predefined route with the channel and set it to the default.
The next pane prompts you for the component type.
On the next pane, you are prompted to select a route.
The Construct Channel pane reopens.
A list of available outlets is displayed, as shown in the following image.
The Set Condition pane opens.
This condition tests the format of the data. Only flat formatted data will be written to this outlet.
The Set Condition pane opens.
This condition tests the output data for XML format.
The Channel Definitions pane opens.
Note: Before you build your channel, verify that your Ebix and preemitter are configured to use the same SWIFT version.
The results of the build are displayed on the right pane.
If an error or errors are displayed in the Message column, take the appropriate action as instructed.
Deployment is the mechanism by which a channel moves from being stored in the Registry to becoming active in iWay Service Manager. For more information on deployment, see the iWay Service Manager User's Guide.
The Channel Management pane reopens.
The red X under Status changes to a green check mark to indicate that the channel has been started. If an error or errors are displayed, take the appropriate action as instructed.
To make sure that the channel is working as expected, perform the following steps:
The following table contains links to sample XML input files that are attached to this PDF and can be used for testing purposes.
SWIFT MT950 2009 |
SWIFT MT535 2009 |
SWIFT MT541 2009 |
---|---|---|
. MT950.xml |
. MT535.xml |
. MT541.xml |
The following table contains links to the SWIFT output files that are attached to this PDF and can be used to verify your output.
SWIFT MT950 (Statement of Cash) |
SWIFT MT535 (Statement of Holding) |
SWIFT MT541 (Receive Against Payment) |
---|---|---|
. MT950.txt |
. MT535.txt |
. MT541.txt |
Note: For file association compatibility only, each SWIFT output file that is attached to this PDF has been renamed to include a .txt extension. However, please note that the actual SWIFT output file that is placed in the C:\XML_out directory will not carry a .txt extension.
Using the Archive Manager feature of iWay Service Manager, you can archive your channel configuration with its associated components and import them into another Registry. They will then be available from that Registry for modification or reuse.
For details on this feature, see the iWay Service Manager User's Guide.
iWay Software |