Copyright © Cloud Software Group, Inc. All Rights Reserved

Parse SWIFT MX

The Parse SWIFT MX activity takes a SWIFT MX message string as input, validates it, and generates an XML message in TIBCO ActiveMatrix BusinessWorks. The output of this activity can be used by other activities.

Before configuring this activity, you must download required XSD files from the SWIFT website, and save them in the TIB_ADSWIFT_HOME\bin\xsd\year directory.

Configuration Tab

The following table lists the fields in the Configuration tab of the Parse SWIFT MX activity:

Table 25 Parse SWIFT MX - Configuration Tab 

Field	Description
Name	(Required) Specify the name of the activity in the process definition. The default value is Parse SWIFT MX.
Description	(Optional) Provide a short description for the activity. Click to add a description in the Description window.
SWIFT Specification	(Required) Click Browse resources to select a Load SWIFT MX Schema shared resource in the Select a Resource window.
Schema	(Required) Select one of the following schema types from the Schema list: • MX Schema • All Schema
Transport Schema	(Required) Click Select a file from the file system to select the transport schema that you want to parse. This field is displayed only when you select All Schema from the Schema list.
Element	(Required) Select one message element type from the Element list. This field is displayed only when you select All Schema from the Schema list. It provides a list of message element types after you select a transport schema in the Transport Schema field. The following items are available in the Element list after you select an InterAct type transport schema: • ExchangeRequest • ExchangeResponse • HandleRequest • HandleResponse Only the DataPDU item is available in the Element list after you select an SAA type transport schema.
AppHeader Schema	(Required) Click Select a file from the file system to select the AppHeader schema that you want to parse. This field is displayed only when you select All Schema from the Schema list.
MX Schema	(Required) Click Select a file from the file system to select the MX message type schema that you want to parse.

Basic Tab

The following table lists the fields in the Basic tab of the Parse SWIFT MX activity:

Table 26 Parse SWIFT MX - Basic Tab

Field	Description
Select All Validations	Select this check box to enable all the supported types of validation.
Validate Transport Schema	Select this check box to enable message transport validation in SWIFT messages against the SWIFT transport schema.
Validate AppHeader Schema	Select this check box to enable message header validation in SWIFT messages against the SWIFT AppHeader schema.
Validate MX Schema	Select this check box to enable syntax validation in SWIFT messages against the SWIFT MX schema.
Validate MX Rules	Select this check box to validate extended rules and business logic in SWIFT messages against the MX rules. When you select this box, the Validate MX Schema check box is selected automatically.
Validate BIC/BEI	Select this check box to validate SWIFT message BIC/BEI codes against a BIC/BEI directory. SWIFT BIC and BEI codes are entity identifiers that are displayed in various subfields of the text block. Validating them is expensive because data must be searched in a very large database which is time and memory consuming to be loaded. At initialization time, an FI . dat BIC directory is provided to be the validator, and then full BIC/BEI validation is performed against the provided directory. If no BIC directory is provided, the plug-in uses the default BIC file. Note: Use the latest BIC file provided by SWIFT for up-to-date BIC or BEI validation.
Validate IBAN/BBAN	Select this check box to enable IBAN/BBAN validation in SWIFT messages against an IBAN/BBAN directory. When you select this box, the Validate MX Schema and Validate MX Rules check boxes are selected automatically, and the BANK Directory and IBAN Plus field becomes available.
BANK Directory and IBAN Plus	Click Select a file from the file system to navigate to the location of the BANK directory and IBAN plus file. Select the file and click Open to load it. This field becomes available only when you select the Validate IBAN/BBAN check box.
BIC Code File (Fl.dat)	Click Select a file from the file system to navigate to the location of BIC or BICPlus file. Select the file and click Open to load it. Note: If you do not specify any file here, the default FI.dat file is used.
ISO3166 Country Code File (CT.dat)	Click Select a file from the file system to navigate to the location of the country code data file. Select the file and click Open to load it. Note: ISO3166 country codes are used if the file is specified here. Otherwise, an internal database of country codes is used.
ISO4217 Currency Code File (CU.dat)	Click Select a file from the file system to navigate to the location of the currency code data file. Select the file and click Open to load it. Note: ISO4217 currency codes are used if the file is specified here. Otherwise, an internal database of country codes is used.
Validation Filter File (Validation Filter.xml)	Click Select a file from the file system to navigate to the location of the ValidationFilter.xml file. Select the file and click Open to load it. See Using Validation Filters for more information.

Input Tab

The following table lists the input items in the Input tab of the Parse SWIFT MX activity:

Table 27 Parse SWIFT MX - Input Tab

Input Item	Data Type	Description
MXMessage	string	Specify an MX message in string format.

If an input item is of the Boolean type, you must set the value of the input item to true or false.

Output Tab

The following table lists the output items in the Output tab of the Parse SWIFT MX activity:

Table 28 Parse SWIFT MX - Output Tab

Output Item	Data Type	Description
SWIFTMessage	XML	Displays the XML representation of the output SWIFT MX message. The structure of the output SWIFT MX message is based on the value you select from the Element list in the Configuration tab.

Error Output Tab

The following table lists the exceptions in the Error Output tab of the Parse SWIFT MX activity:

Table 29 Parse SWIFT MX - Error Output Tab 

Exception	Description
ValidationException	An MX message in validation does not follow the selected SWIFT specification.
SwiftException	The activity cannot locate the metadata directory or fails to initialize the metadata.

Copyright © Cloud Software Group, Inc. All Rights Reserved