Home

Sun SeeBeyond eWay(TM) Adapter for SWIFT Alliance Gateway

1. 6 The Copy r n new Date ExchangeRequest r n SAGOutboundeWay_1 Primitives SnlPrimitives SwInt_ExchangeRequest to FileClient_1 Text rule gets the Primitive value File Response from the SAG server and includes the time stamp Create the Copy r n new Date ExchangeRequest r n SAGOutboundeWay_1 Primitives SnlPrimitives SwInt_ExchangeRequest to FileClient_1 Text rule SWIFTAIliance Gateway eWay User s Guide 75 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing a Project Using Java Collaboration Definitions JCD The prjSaglA Sample Project From the Business Rules toolbar click the rule icon to add a new rule From the Business Rules Designer toolbar click the Class Browser icon The Class Browser dialog box appears From the Class Browser select Date as the class java util as the package and Date as the constructor Click Select The Date constructor box is added to the Business Rules Designer mapping canvas From the Business Rules Designer s Math menu select Add The Add box appears From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter r n as the Literal value Map the r n output node of the String Literal box to the Valuel input node of the Add box Map the result Date output node of the Date constructor box to the value2 input node of the Add box From the Business Rules Designer s String men
2. This chapter provides a brief overview of SWIFTAlliance Gateway and the SWIFTAlliance Gateway eWay Adapter as well as an introduction to this document What s in This Chapter About SWIFTAlliance Gateway on page 6 About the SWIFT Alliance Gateway eWay on page 8 What s New in This Release on page 9 About This Document on page 10 Sun Microsystems Inc Web Site on page 11 11 About SWIFTAlliance Gateway SWIFTAlliance Gateway is a modular software package that is installed on top of the SWIFTNet Link SNL software and is designed to enable application to application communication Using the SWIFTNet interactive services InterAct and FileAct messages and files are typically exchanged between a customer application client and a central application server over the Secure IP Network SIPN SWIFTAlliance Gateway can handle large volumes of information and is therefore suitable for use with both client and server applications 111 Introduction to SWIFTNet SWIFTNet is a global business messaging network for secure connectivity between institutions that participate in the financial services industry As such SWIFTNet is designed to satisfy institutional community requirements for inter operability of mission critical financial software solutions SWIFTNet provides an assurance of infrastructure reliability availability access control correspondent and message authentication message integrity and confidentiality to business
3. SAGOutboundeWay 1 getConfiguration getFileActClient getPutFile setSw PhysicalName C temp SAG Cert W testFile2ToSnF txt SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw LogicalName testFile2ToSnF SAGOutboundeWay_1 getServices getFileActClient put track OK msg r n r n transactionSeq Scenario 5 3 SAG Cert FA Delivery Signed 3rd file 57 track msg SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw_TransferDescription msg SAGOutboundeWay_1 getConfiguration getFileActClient setSwInt_RequestCrypto SAGOutboundeWay_1 getConstants getSw_Boolean getTRUE SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw_PhysicalName C temp SAG_Cert testFile3ToSnF txt SAGOutboundelWay_1 getConfiguration getFileActClient getPutFile setSw_ LogicalName testFile3ToSnF SAGOutboundeWay_1 getServices getFileActClient put SAGOutboundeWay_1 getConfiguration getFileActClient setSwInt_RequestCrypto SAGOutboundeWay_1 getConstants getSw_Boolean getFALSE track OK msg r n r n transactionSeg Scenario 5 4 SAG Cert FA Delivery NonRepudiation 4th file track msg SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw_TransferDescription msg SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw_P
4. SWIFTAlliance Gateway eWay User s Guide 35 Sun Microsystems Inc Chapter 3 Configuring the eWay 338 FileAct Client gt Get File This section maps to the parameter Sw GetFileRequest of the Primitive Sw ExchangeFileRequest For parameters SwXXX under this section refer to the SNL Specification for more detailed descriptions The FileAct Client gt Get File section of the SWIFT AG eWay Connectivity Map properties contains the top level parameters displayed in Table 10 Section 3 3 SWIFT AG eWay Connectivity Map Properties Table 10 Connectivity Map FileAct Client gt Get File Name Description Required Value Transfer Specifies the Sw_TransferDescription The transfer description Description user information about the file transfer Free text Size is limited to 256 bytes Transfer Info Specifies the Sw_TransferInfo user information about the file transfer Structured data that can be analyzed by the server Size is limited to 256 bytes The transfer information Logical File Specifies the Sw_LogicalName the The logical file name Name logical name of the file to get This name is communicated to the server application By default this name is the physical name without path Size is limited to 254 bytes Physical File Specifies the Sw_PhysicalName the The physical file name Name full physical name where the file to get must be stored If the file already exists it is overwritten Size is
5. 3 If you have already created a domain select your domain in the Domain Manager and click the Start an Existing Domain button Once your domain is started a green check mark indicates that the domain is running 4 If there are no existing domains a dialog box indicates that you can create a domain now Click Yes The Create Domain dialog box appears SWIFTAlliance Gateway eWay User s Guide 70 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing a Project Using Java Collaboration Definitions JCD Creating the prjSagFA Project 5 Make any necessary changes to the Create Domain dialog box and click Create The new domain is added to the Domain Manager Select the domain and click the Start an Existing Domain button Once your domain is started a green check mark indicates that the domain is running 6 For more information about creating and managing domains see the Sun SeeBeyond eGate Integrator System Administration Guide 5 5 13 Building and Deploying the Project The Build process compiles and validates the Project s Java files and creates the Project EAR file Build the Project 1 From the Deployment Editor toolbar click the Build icon 2 If there are any validation errors a Validation Errors pane will appear at the bottom of the Deployment Editor and displays information regarding the errors Make any necessary corrections and click Build again 3 After the Build has succeeded you are ready to deploy your Project Depl
6. 37 Transfer Info 36 37 User DN 29 32 User Reference 29 32 properties editor 22 Queue Name To Acquire 31 35 Sun Microsystems Inc Index R Read Blocking Timeout 28 Read From RA CFG File 40 Recovery Mode 31 35 Remote API initializing 18 installing 18 overview 7 Remote File Handler TransferEP 34 RemoteApi Base settings 28 properties 28 Request Type 29 32 Requestor DN 29 32 Responder DN 29 32 running a project 71 83 S SAGOutboundeWay OTD Configuration node 44 Constants node 45 overview 44 Primitives node 46 Remote APIs node 48 Service node 48 sample project importing 52 Java Collaboration 51 properties 66 79 scope of guide 11 Sender 26 Sender Auth 26 Server DN 41 Service Name 29 32 Session Mode 31 35 Signed 29 32 SSL Mode 41 Steady Pool Size 42 store and forward 8 supported operating systems 13 SWIFT AG eWay OTD overview 44 SWIFT overview 6 SWIFT Remote File Handler 53 SWIFTAlliance Gateway component package installation 16 17 overview 6 SWIFTNet overview 6 SWIFTAlliance Gateway eWay User s Guide 95 T text conventions 11 Transfer Description 36 37 Transfer Info 36 37 Transport properties 40 U User DN 29 32 User Reference 29 32 W working files extracting 53 SeeBeyond Proprietary and Confidential
7. Appendix A Section A 1 Sample prjSAGCert Project Overview The prjSAGCert Sample Project Collaboration Scenario 9 3 Pull messages from Oueue 3rd file Scenario 10 Show more usages of other API Primitive The Java Collaboration Editor The Enterprise Designer s Collaboration Editor Java allows you to create Business Rules using the Business Rules Designer a graphical interface used to graphically add methods and map data paths This creates the Java code that drives the Collaboration s business logic You can see this Java code from the Collaboration Editor s Java Source Editor see Figure 35 Figure 35 Java Collaboration Editor I gt Sg xFow M 1 Business Rules pP bados9 C263 50 a 108 G Collaboration 4 Business Rules p Displays the Business lt gt Copy FileClient 1 to file VAR Copy 0 to variable transactionSeq Rules tree GRE Copy nRemote test from input Socket InetAddress HostName at time new Date Jin to variable msg lt gt Copy msg to FileClient 1 Text i lt gt FileClient_1avrite Business Rules Designer Business Rules Designer Graphically creates 8D 89 X pociean comparisons Elmah object A String ilAray 86 Operator Business Rules input receiveString 9 1 Collaboration_1 x Collaboration 1 138 ME FileClient 1 O aleter EO Java Source Editor Q m input TCPIPEXTServerApplication i R DedicatedSessionMode Displ
8. Manually 64 Binding the eWay Components 64 Using the Connectivity Map Generator 65 Creating an Environment 66 Configuring the eWays 66 Configuring the File eWay Properties 67 Configuring the SWIFT AG eWay Properties 68 Configuring the Integration Server 69 Creating the Deployment Profile 69 Initializing your Remote API 70 Creating and Starting the Domain 70 Building and Deploying the Project 71 Running the Project 71 The prjSaglA Sample Project 72 Creating the prjSaglA Project 72 Creating the Collaboration Definition 72 Using the Collaboration Editor Java 72 Creating the jcdSAGIA Business Rules 73 Creating the Connectivity Map 78 Generate the Connectivity Map Using the Connectivity Map Generator 78 Creating an Environment 78 Configuring the eWays 79 Configuring the File eWay Properties 79 Modify the File eWay Environment Explorer Properties 79 Configuring the SWIFT AG eWay Properties 80 Configuring the Integration Server 81 Creating the Deployment Profile 81 Initializing your Remote API 82 Creating and Starting the Domain 82 Building and Deploying the Project 83 Running the Project 83 Appendix A Sample prjSAGCert Project Overview 84 jcdSAGCert Collaboration Definition Scenarios 84 The Java Collaboration Editor 86 jcdSAGCert Collaboration Java Code 86 SWIFTAlliance Gateway eWay User s Guide 5 Sun Microsystems Inc Chapter 1 Introduction This guide explains how to install configure and use the SWIFTAlliance Gateway eWay
9. Strict SNL Format Additional Processing Available WebSphere MO Host Adapter Remote API Host Adapter For more information on configuring SWIFTAlliance Gateway see the SWIFTAlliance Gateway Operations Guide SWIFTAlliance Gateway eWay User s Guide 20 Sun Microsystems Inc Chapter 3 Configuring the eWay This chapter describes how to create and configure the SWIFTAlliance Gateway eWay What s in This Chapter Configuring the SWIFTAlliance Gateway eWay on page 21 SWIFT AG eWay Connectivity Map Properties on page 25 SWIFT AG eWay Environment Properties on page 40 31 Configuring the SWIFTAlliance Gateway eWay All eWays contain a set of properties that are unique to that eWay type After the eWays are created and a SWIFTAlliance Gateway External System is added to the Project s Environment the eWay parameters can be modified for your specific system The SWIFTAlliance Gateway eWay properties are modified from two locations From the Connectivity Map These properties most commonly apply to a specific eWay and may vary from other eWays of the same type in the Project From the Environment Explorer tree These properties are commonly global and apply to all eWays of the same type in the Project The saved properties are shared by all eWays in the SWIFTAlliance Gateway External System window 311 Selecting SWIFTAlliance Gateway as the External Application To create an SWIFTAlliance Gateway eWay
10. automatic mode Advanced indicates advanced mode Relaxed SNL Protocol does not support manual cryptographic mode SWIFTAlliance Gateway eWay User s Guide 25 Sun Microsystems Inc Chapter 3 Configuring the eWay Section 3 3 SWIFT AG eWay Connectivity Map Properties Table 3 Connectivity Map Envelope Continued Name Description Required Value Msg Format Specifies the format of the The default value is Sag RelaxedSNL current message Each of the names of the required values Note This property is grayed out to denotes a SWIFTAlliance indicate that the property is not Gateway message format configurable Sender Specifies the name of the The name of the sender SWIFTAlliance Gateway Sender This is an SAG operator Sender Auth Specifies the password of the The SAG operator password SAG operator SWIFTAlliance Gateway eWay User s Guide 26 Sun Microsystems Inc Chapter 3 Configuring the eWay Section 3 3 SWIFT AG eWay Connectivity Map Properties 332 Primitive Control The Primitive Control section of the SWIFT AG eWay Connectivity Map properties contains the top level parameters displayed in Table 5 Table 4 Connectivity Map Primitive Control Name Description Required Value Include XML Specifies the construction marshalling of SNL Select True or False True Attributes in primitives indicates that the eWay SNL Primitive includes the XML
11. snfFetch track OK msg r n r n transactionSeg Scenario 6 2 SAG Cert FetchFile 2nd file track msg SAGOutboundeWay_1 getServices getFileActClient snfPull SAGOutboundeWay 1 getConfiguration getFileActClient getSnFFetchFile setSw PhysicalName C temp SAG Cert fetch2FromSnF txt SAGOutboundeWay_1 getServices getFileActClient snfFetch SAGOutboundeWay 1 getServices getFileActClient snfAck SAGOutboundeWay_1 getServices getFileActClient snfRelease track OK msg r n r n transactionSeg Scenario 6 3 SAG Cert FetchFile 3rd file track msg SAGOutboundeWay 1 getServices getFileActClient snfAcauire SAGOutboundeWay 1 getServices getFileActClient snfPull SAGOutboundeWay 1 getConfiguration getFileActClient getSnFFetchFile setSw PhysicalName C temp SAG_Cert fetch3FromSnF txt SAGOutboundeWay 1 getServices getFileActClient snfFetch SAGOutboundeWay 1 getServices getFileActClient snfAck SAGOutboundeWay 1 getServices getFileActClient snfRelease track OK msg r n r n transactionSeg Scenario 6 4 SAG Cert FetchFile NonRepudiation 4th file track msg SAGOutboundeWay 1 getServices getFileActClient snfAcauire SWIFTAlliance Gateway eWay User s Guide 90 Sun Microsystems Inc Appendix A Sample prjSAGCert Project Overview SAGOutboundeWay_ SAGOutbo
12. user documentation provided by SWIFT SWIFTAlliance Gateway eWay User s Guide 24 Sun Microsystems Inc Chapter 3 Section 3 3 Configuring the eWay SWIFT AG eWay Connectivity Map Properties 33 SWIFT AG eWay Connectivity Map Properties The SWIFTAlliance Gateway eWay Connectivity Map Properties include the following parameter sections Envelope on page 25 Primitive Control on page 27 RemoteApi Base settings on page 28 InterAct Client on page 29 InterAct Client gt Store and Forward on page 31 FileAct Client on page 32 FileAct Client gt Store and Forward on page 35 FileAct Client gt Get File on page 36 FileAct Client gt Put File on page 37 FileAct Client gt SnF Fetch File on page 38 Connection Establishment on page 39 331 Envelope The Envelope section of the SWIFT AG eWay Connectivity Map properties contains the top level parameters displayed in Table 3 Table 3 Connectivity Map Envelope Name Description Required Value Application Specifies the name of the The name of the Application Interface ID Application Interface Message Message Partner Partner The Message Partner basically identifies an application that sends and receives messages on behalf of This property is mandatory a user Context ID Specifies the cryptographic mode Advanced or blank indicating the selected for Relaxed SNL Protocol Context ID Empty blank indicates The configured default is Advanced
13. you must first create an SAG SWIFTAlliance Gateway External Application in your Connectivity Map SWIFTAlliance Gateway eWays are located between the SAG External Application and a Service Services are containers for Collaborations Business Processes eTL processes and so forth Creating the SAG External Application 1 From the Connectivity Map toolbar click the External Applications icon 2 Select the SAG External Application from the menu see Figure 3 on page 22 The selected SAG External Application icon appears on the Connectivity Map toolbar SWIFTAlliance Gateway eWay User s Guide 21 Sun Microsystems Inc Chapter 3 Section 3 1 Configuring the eWay Configuring the SWIFTAlliance Gateway eWay Figure 3 External Applications Selection Menu M amp FE 8 File External Application Scheduler 3 Drag the new SAG External Application from the toolbar onto the Connectivity Map canvas This represents an external SWIFTAlliance Gateway system From the Connectivity Map you can associate bind the External Application with the Service to establish an eWay see Figure 4 Figure 4 eWay Location SWIFT ha gt Service SWIFT AG eWay esSAG When SAG is selected as the External Application it automatically applies the default SWIFTAlliance Gateway eWay properties provided by the OTD to the eWay that connects it to the Service You can then modify these properties for your specific sys
14. Date Starting collab of SAG_IA r n to FileClient_1 Text rule creates a Starting collab of SAG_IA comment and includes the starting time stamp Create the Copy r n new Date Starting collab of SAG_IA r n to FileClient_1 Text rule A From the Business Rules toolbar click the rule icon to add a new rule under receive on the Business Rules tree From the Business Rules Designer toolbar click the Class Browser icon The Class Browser dialog box appears From the Class Browser select Date as the class java util as the package and Date as the constructor Click Select The Date constructor box is added to the Business Rules Designer mapping canvas From the Business Rules Designer s Math menu select Add The Add box appears From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter r n as the Literal value Map the r n output node of the String Literal box to the Valuel input node of the Add box Map the result Date output node of the Date constructor box to the value2 input node of the Add box To do this click on the result Date output node of the Date constructor box and drag your cursor to the input node of the Add box A link now connects the two nodes SWIFTAlliance Gateway eWay User s Guide 73 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing a Project Using Java Collaboration Definitions JCD The prjSaglA Sample Project
15. File Handler TransferEP If you are using the Remote File Handler you must specify your transfer EndPoint name See Remote File Handler TransferEP on page 34 FileAct Client gt Get File Set as directed otherwise use the default settings Transfer Description Get a file Transfer info operation get Logical File Name selftest Physical File Name Sw_PhysicalName Size limit 254 bytes For example c work SAG_FA getFromCTE txt Modify the SWIFT AG eWay Environment Explorer Properties 1 From the Environment Explorer tree right click the SWIFT AG eWay External System esSunJavaSys in this sample and select Properties from the shortcut menu The Properties Editor appears SWIFTAlliance Gateway eWay User s Guide 68 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing a Project Using Java Collaboration Definitions JCD Creating the prjSagFA Project 2 Modify the SWIFT AG eWay Environment properties for your system including the settings in Table 20 and click OK Table 20 SWIFT AG eWay Environment Properties SWIFT AG eWay Environment Properties Transport Set as directed otherwise use the default settings Read From RA CFG File sagta_ra cfg Host Name The Host Name Port Number The Port Number 5 59 Configuring the Integration Server You must set your Sun SeeBeyond Integration Server Password property before deploying your Project 1 From the Environment
16. H From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter Starting collab of SAG_TA r n as the value Map the Starting collab of SAG_IA r n output node of the second String Literal box to the Value3 input node of the Add box J Map the result output node of the Add box to Text under FileClient_1 in the right pane of the Business Rules Designer see Figure 30 Figure 30 jcdSAGIA Collaboration Business Rules Create Variable Business Rules Designer 80 8 28X pooean Comparison Math Sa0bjectr AStringy ilArray 8 Operators Assignment lt Copy n new Date Starting collab of SAG_IA in to FileClient_1 T ext Ge jedSAGIA jedSAGIA 158 i i Li IS FileClient 1 a MS input ByteArray 5 Encoding om ByteArray o Encoding input ME G L Text SAGOutboundeWay_1 S SAGOutboundeWay_1 ier Configuration ier Constants Starting collab of SAG_IA r n a Primitives result a RemoteApis Services S R FileActClient E InterActClient jeasacia 3 The FileClient_1 write rule used throughout this Collaboration writes the processed data to the file Create the FileClient 1 write rule A From the Business Rules toolbar click the rule icon to add a new rule B Right click FileClient 1 in the left pane of the Business Rules Designer and click Select method to call from the
17. Microsystems Inc Chapter 5 Section 5 2 Implementing a Project Using Java Collaboration Definitions JCD The SWIFT AG eWay Sample Projects 52 The SWIFT AG eWay Sample Projects The SWIFT AG eWay includes three sample Projects that use Java Collaboration Definitions for their Business prjSagFA demonstrates support for the SWIFT FileAct service prjSagIA demonstrates support for the SWIFT InterAct service prjSAGCert provided as an example of a SWIFT AG eWay Project which demonstrates several important scenarios The prjSagFA and prjSagIA sample Projects can be imported in a near complete state and can be run with minimal configuration The sample Projects are designed to run using a single Remote API instance connecting with SWIFTAlliance Gateway see Figure 12 Figure 12 Running the Sample Projects JavaCAPS IS Host RA Instance1 JavaCAPS Integration Server SWIFT AG eWay Working Files SWIFTAlliance Gateway RA Transport S amp S Config File Remote API ov se Transport os A SSL SWIFTNet Link prjSagFA Sample Overview The prjSagFA Project demonstrates the following The inbound File eWay subscribes to an external input directory When a target message is present the File eWay picks up the message and triggers the jedSagFA Java Collaboration The jcdSagFA Collaboration connects to the SWIFT AG server through the SWIFT AG eWay The Collaboration uses the FileAct service to get a file then writes several
18. Profile Auto Map Environment envSAGA G CI Map Variables Gf Build M Deploy A Automap b G IntegrationSvr1 CMap1_Collaboration_11 fe eaFileln gt CMap1_Collaboration_11 CMap1_Collaboration_11 gt eaSAG 8 CMap1 Collaboration 11 gt eaFileOut 4 The Project s components are automatically mapped to their system windows as seen in Figure 34 Figure 34 Deployment Profile M pe he Be IntegrationSvrt L eh CMap1 Collaboration 11 P E eaFileln gt CMap1 Collaboration 11 E CMap1 Collaboration 11 gt eaFileOut Ed CMapt Collaboration 11 gt eaSAG 5 Click Activate When activation succeeds save the changes to the Repository 5 6 10 Initializing your Remote API Initialize start the Remote API instance on your JavaCAPS Integration Server IS host prior to starting the JavaCAPS Integration Server and deploying your Project Running the JavaCAPS IS on top of the RA fulfills the required environment variables For directions see Installing and Initializing the SWIFT AG Remote APIs on page 18 5 6 11 Creating and Starting the Domain To deploy your Project you must first create a domain A domain is an instance of a Logical Host Create and Start the Domain 1 Navigate to your lt JavaCAPS51 gt logicalhost directory where lt JavaCAPS51 gt is the location of your Sun Java Composite Application Platform Suite installation 2 Double click the domainmgr bat
19. Project Using Java Collaboration Definitions JCD Creating the prjSagFA Project Configuring the SWIFT AG eWay Properties The SWIFT AG eWay properties are set in both the Connectivity Map and the Environment Explorer For more information on the SWIFT AG eWay properties and the Properties Editor see Configuring the eWay on page 21 Modify the SWIFT AG eWay Connectivity Map Properties 1 From the Connectivity Map double click the SWIFT AG eWay The Properties Editor opens to the SWIFT AG eWay properties 2 Modify the SWIFT AG eWay Connectivity Map properties for your system including the settings in Table 19 and click OK Table 19 SWIFT AG eWay Connectivity Map Properties SWIFT AG eWay Connectivity Map Properties Envelope Settings Set as directed otherwise use the default settings Application Id My_Al Sender SAG Operator name Sender Auth The password for the SAG Operator FileAct Client Set as directed otherwise use the default settings User DN SwSec_UserDN Size limit 100 bytes For example cn John o ptsauszz o swift Requestor DN Swint_Requestor Size limit 100 bytes For example o ptsauszz o swift Responder DN Swint_Responder Size limit 100 bytes For example cn management o swift o swift Service Name Swint_Service Size limit 30 bytes For example swift cte swift generic fa x swift generic fast x etc User Reference Swint_RequestRef Size limit 30 bytes Remote
20. User s Guide 72 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing a Project Using Java Collaboration Definitions JCD The prjSaglA Sample Project Creating the jcdSAGIA Business Rules The jedSAGIA Collaboration contains the Business Rules displayed in Figure 29 GP jedSAGIA oO receive E logger T alerter F collabContext E typeConverter Figure 29 jcdSAGIA Collaboration Business Rules lt gt Copy Win new Date Starting collab of SAG_IA rin to FileClient 1 Text lt gt FileClient_1 write lt gt Copy input Text to SAGOutboundeWay_1 Serices InterActClient RequestP ayload SAGOutboundeWay_1 Serices InterActClientsendAndReceive lt gt Copy Win new Date ExchangeRequest n SAGOutboundeWay 1 Primitives SnIPrimitives Swlnt ExchangeReguest to FileClient 1 Text lt gt FileClient 1 write lt gt Copy Win new Date ExchangeResponsetin SAGOutboundeWay_1 Primitives SnlPrimitives Swint_ExchangeResponse to FileClient_1 Text lt gt FileClient_1 write Copy Win new Date Ending collab of SAG_lA An nnirinirin to FileClient 1 Text L lt gt FileClient_4 write To create the jedSAGIA Collaboration Business Rules using the Java Collaboration Editor s Business Rules Designer do the following 1 To open Collaboration Editor to the Sun jedSAGIA Collaboration double click jedSAGIA in the Project Explorer tree 2 The Copy r n new
21. When the SWIFT AG eWay constructs marshals the attributes in the SNL primitives this flag indicates whether the eWay primitives includes the XML attributes in the primitives For example The configured default is FALSE For element Swint Requestor including XML attributes may be as follows lt SwInt Reguestor type Sw Gbl DN version 4 0 0 gt o swift o swift lt Swint Requestor gt If you do not include XML attributes it may be as follows lt Swint Requestor gt o swift o swift lt Swint Requestor gt if not include XML attributes Note that all XML attributes in SNL Primitives are defined in SNL Specification SWIFTAlliance Gateway eWay User s Guide 27 Sun Microsystems Inc Chapter 3 Configuring the eWay 333 RemoteApi Base settings Section 3 3 SWIFT AG eWay Connectivity Map Properties The RemoteApi Base settings section of the SWIFT AG eWay Connectivity Map properties contains the top level parameters displayed in Table 5 Table 5 Connectivity Map RemoteApi Base settings Name Description Required Value Client Handle Specifies the maximum time in An integer indicating the maximum time Timeout milliseconds allowed between a allowed between a request message and its request message and its corresponding response message in corresponding response milliseconds for example 300000 equals 5 message minutes The configured default is 300000 Read Specifies the maximum time in An integer indicating t
22. a Deployment Profile see Creating the Deployment Profile on page 69 Initialize your Remote API see Initializing your Remote API on page 70 Create and start a domain see Creating and Starting the Domain on page 70 Build and deploy the Project see Building and Deploying the Project on page 71 s4 Extracting the Working Files The SWIFT AG eWay Sample Project package includes a ZIP file SAG_Cert zip that contains working files for the sample Projects These files are extracted to the SWIFTAlliance Gateway server host prior to running the sample Project You can run the Project with the Working files loaded on the Remote API host but this requires that you also run the SWIFT Remote File Handler Extracting the files to the SWIFT AG Server Copy the working files to the SWIFT AG server To do this extract the files to the SAG server host in the following location temp SAG_Cert folder Extracting the files to the Remote API computer If you choose to run the sample Projects with the working files located on the SWIFT Remote API computer where your Logical Host is located do the following 1 Extract the working files to the following location temp SAG_Cert folder 2 Start the SWIFT Remote File Handler If you are running the Logical Host on the SWIFT Remote API computer configure the sample Projects to use the Remote File Handler specify the Transfer Endpoint and start swfa_handler exe before r
23. connection is not available the caller must wait this long before another RA connection is created A value of 0 indicates that an exception is thrown if there is no RA connection available If the pool is completely utilized and the timer expires an exception will be delivered to the application Note This element is deprecated for the bean pool container for Sun Java System Application Server Pool Idle Specifies the pool idle timeout in seconds An integer indicating Timeout In the pool idle timeout in Seconds This property is mapped to the parameter pool idle seconds A value of 0 timeout in seconds in sun ra xml which is specific to the Sun Java System Application Server or Sun SeeBeyond Integration Server see the corresponding documentations for more information This serves as a hint to the server A timer thread periodically removes unused RA connections This parameter defines the interval at which this thread runs This thread removes unused RA connection that have an expired timeout This allows you to specify the amount of time that an RA connection instance can be idle in the pool When pool idle timeout in seconds is set to greater than 0 the container removes or destroys any RA connection instance that is idle for this specified duration It is the maximum time that a component can remain idle in the pool After this amount of time the pool can remove this bean A value of 0 specifies that i
24. file The Domain Manager appears 3 If you have already created a domain select your domain in the Domain Manager and click the Start an Existing Domain button Once your domain is started a green check mark indicates that the domain is running SWIFTAlliance Gateway eWay User s Guide 82 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing a Project Using Java Collaboration Definitions JCD The prjSaglA Sample Project 4 If there are no existing domains a dialog box indicates that you can create a domain now Click Yes The Create Domain dialog box appears 5 Make any necessary changes to the Create Domain dialog box and click Create The new domain is added to the Domain Manager Select the domain and click the Start an Existing Domain button Once your domain is started a green check mark indicates that the domain is running 6 For more information about creating and managing domains see the Sun SeeBeyond eGate Integrator System Administration Guide 56 12 Building and Deploying the Project The Build process compiles and validates the Project s Java files and creates the Project EAR file Build the Project 1 From the Deployment Editor toolbar click the Build icon 2 If there are any validation errors a Validation Errors pane will appear at the bottom of the Deployment Editor and displays information regarding the errors Make any necessary corrections and click Build again 3 After the Build has succeeded you are re
25. how these components are created and implemented in an eGate Project It is assumed that the reader understands the basics of to create a Project using the Enterprise Designer For more information on creating an eGate Project see the Sun SeeBeyond eGate Tutorial and the Sun SeeBeyond eGate Integrator User s Guide What s in This Chapter The SWIFT AG eWay Sample Projects on page 51 Importing a Sample Project on page 52 Creating the prjSagFA Project on page 54 Creating an Environment on page 66 Creating the Deployment Profile on page 69 SWIFT AG eWay Components This chapter presents a sample SWIFTAlliance Gateway eWay Project created using the same procedures as the sample end to end Project provided in the eGate Integrator Tutorial The components of the SWIFT AG eWay include the following SAGOutboundeWay OTD The SAGOutboundeWay OTD is a natural point of connection between the eWay and SWIFTNet Within a Java Collaboration Definition this OTD defines the methods to connect and utilize the SWIFTAlliance Gateway see OTD Overview on page 44 SWIFT AG eWay Properties File The properties configuration file for the SWIFT AG eWay directly corresponds to the properties of the SAGOutboundeWay OTD The Properties Editor allows you to preset the parameters for your system to connect and communicate with SWIFTAlliance Gateway see Configuring the eWay on page 21 SWIFTAlliance Gateway eWay User s Guide 50 Sun
26. last Crypto block is analyzed operations to be performed Swint_RequestCrypto digital signature The configured default is FALSE Priority Specifies the Swint_ Priority The priority Normal or Urgent of delivery In the future SWIFTNet may implement this priority through schemes such as top queuing dedicated server processes network transport priority In the current implementation differentiation on priority may be used for store and forward delivery The configured default is Normal SWIFTAlliance Gateway eWay User s Guide 32 Sun Microsystems Inc Chapter 3 Configuring the eWay Section 3 3 SWIFT AG eWay Connectivity Map Properties Table 8 Connectivity Map FileAct Client Continued Name Description Required Value Non Repudiation Specifies whether Swint_NRindicator non repudiation support is being requested Select True or False True indicates that non repudiation is requested The configured default is FALSE Delivery Notification Queue Name Specifies the SwInt NotifOueue store and forward delivery mode When a value is present it indicates SnF delivery mode and the gueue where SnF delivery notifications are received In the case of non delivery Rejected or Failed message an SnF failed notification is always generated in this notification gueue In the case of delivery Accepted or Duplicated message an SnF delivery notification is optionally generate
27. limited to 254 bytes Maximum File Size Specifies the Sw_MaxSize the maximum accepted file size When a value is present the maximum size is a field that is communicated from the client application to the server application This property is optional Size range is 0 to 250 Megabytes The maximum file size SWIFTAlliance Gateway eWay User s Guide 36 Sun Microsystems Inc Chapter 3 Configuring the eWay 339 FileAct Client gt Put File This section maps to parameter Sw PutFileRequest of the Primitive Sw ExchangeFileRequest For parameters SwXXX under this section refer to the SNL Specification for more detailed descriptions The FileAct Client gt Put File section of the SWIFT AG eWay Connectivity Map properties contains the top level parameters displayed in Table 10 Section 3 3 SWIFT AG eWay Connectivity Map Properties Table 11 Connectivity Map FileAct Client gt Put File Name Description Required Value Transfer Specifies the Sw_TransferDescription The transfer description Description This is information about the file transfer Free text Size is limited to 256 bytes Transfer Info Specifies the Sw_TransferInfo information about the file transfer This is structured data that can be analysed by the server Size is limited to 256 bytes The transfer information Logical File Specifies the Sw_LogicalName the The logical file name Name logical name of the file
28. relevant Primitives to an output file The outbound File eWay publishes the new message to an output directory prjSaglA Sample Overview The prjSagIA Project demonstrates the following The inbound File eWay subscribes to an external input directory When a target message is present the File eWay picks up the message and triggers the jedSAGIA Java Collaboration SWIFTAlliance Gateway eWay User s Guide 51 Sun Microsystems Inc Chapter 5 Section 5 3 Implementing a Project Using Java Collaboration Definitions JCD Importing a Sample Project The jedSAGIA Collaboration connects to the SWIFT AG server through the SWIFT AG eWay The Collaboration uses the InterAct service to exchange a message then writes several relevant Primitives to an output file The outbound File eWay publishes the new message to an output directory prjSAGCert Project The prjSAGCert Project is presented as an example of a SWIFT AG eWay Project that demonstrates several important scenarios with one Collaboration An outline of these scenarios is available at jcdSAGCert Collaboration Definition Scenarios on page 84 as well as the Collaboration s Java code 53 Importing a Sample Project To import a sample Project to the Enterprise Designer do the following 1 The sample files are uploaded with the eWay s documentation SAR file and downloaded from the Sun Java Composite Application Platform Suite Installer s Documentation tab Save and extract t
29. swift cte track msg SAGOutboundeWay 1 getConfiguration getFileActClient getGetFile setSw TransferDescription msg SAGOutboundeWay 1 getServices getFileActClient get track OK msg r n r n transactionSeg Scenario 2 2 to be continued on 2 6 SAG Cert RT FA Get generic fa x Non Blocking ASync 1MB file track msg SAGOutboundeWay_1 getConfiguration getFileActClient setBlockFileTransfer SAGOutboundeWay_1 getConstants getSw_Boolean getFALSE SAGOutboundeWay_1 getConfiguration getFileActClient setSwInt_Service swift generic fa x SAGOutboundeWay_1 getConfiguration getFileActClient setSwInt_Responder o ptsauszz o swift SAGOutboundeWay_1 getConfiguration getFileActClient getGetFile setSw_TransferDescription msg SAGOutboundeWay_1 getConfiguration getFileActClient getGetFile setSw_PhysicalName c temp SAG_Cert getDownload2FromFTA_1MB txt SAGOutboundeWay_1 getConfiguration getFileActClient getGetFile setSw_LogicalName downloadFile2_1MB txt String getTransferRef22 SAGOutboundeWay_1 getServices getFileActClient get SAGOutboundeWay_1 getConfiguration getFileActClient setBlockFileTransfer SAGOutboundeWay_1 getConstants getSw_Boolean getTRUE SWIFTAlliance Gateway eWay User s Guide 87 Sun Microsystems Inc Appendix A Section A 1 Sample prjSAGCert Project Overview The prjSAGCe
30. the InterAct and FileAct client implementations to support Real Time and Store and Forward messaging In addition to the OTD the SWIFT AG eWay provides Connectivity Map and External System configuration for design time configuration 13 What s New in This Release The Sun SeeBeyond eWay Adapter for SWIFTAlliance Gateway includes the following new features New Features for Version 5 1 2 Version Control An enhanced version control system allows you to effectively manage changes to the eWay components SWIFTAlliance Gateway eWay User s Guide 9 Sun Microsystems Inc Chapter 1 Section 1 4 Introduction About This Document Manual Connection Management Establishing a connection can now be performed automatically configured as a property or manually using OTD methods from the Java Collaboration Multiple Drag and Drop Component Mapping from the Deployment Editor The Deployment Editor now allows you to select multiple components from theEditor s component pane and drop them into your Environment component Support for Runtime LDAP Configuration eWay configuration properties now support LDAP key values Connectivity Map Generator Generates and links your Project s Connectivity Map components using a Collaboration or Business Process Many of these features are documented further in the Sun SeeBeyond eGate Integrator User s Guide or the Sun SeeBeyond eGate Integrator System Administrator Guide 14 About Thi
31. this priority through schemes such as top queuing dedicated server processes network transport priority In the current implementation differentiation on priority may be used for store and forward delivery Normal or Urgent The configured default is Normal Non Repudiation Specifies whether Swint_NRindicator non repudiation support is being requested Select True or False True indicates that non repudiation is requested The configured default is FALSE Delivery Notification Queue Name Specifies the Swint_NotifQueue store and forward delivery mode When a value is present it indicates SnF delivery mode and the queue where SnF delivery notifications are received In the case of non delivery Rejected or Failed message an SnF failed notification is always generated in this notification queue In the case of delivery Accepted or Duplicated message an SnF delivery notification is optionally generated in this queue For store and forward delivery mode enter the name of the delivery notification queue Size is limited to 30 bytes For example ptsauszz_generic x see Sw DeliveryNotif Ask Positive Delivery Notification Specifies Sw_DeliveryNotif delivery notification This is for store and forward delivery mode only Indicates whether a delivery notification is required in case of successful delivery Accepted or Duplicated Select True or False True indicates that a d
32. to put This name is communicated to the server application By default this name is the physical name without path Size is limited to 254 bytes Physical File Specifies the Sw_PhysicalName the The physical file name Name full physical name of the file to put Size is limited to 254 bytes File Specifies the Sw_FileDescription This is The file description Description user information about the file Free text Size is limited to 256 bytes File Info Specifies the Sw_FileInfo user The file information information about the file This is structured data that can be analysed by the server Size is limited to 256 bytes SWIFTAlliance Gateway eWay User s Guide 37 Sun Microsystems Inc Chapter 3 Section 3 3 Configuring the eWay SWIFT AG eWay Connectivity Map Properties 33 10 FileAct Client gt SnF Fetch File This section maps to Primitive Sw FetchFileRequest For parameters SwXXX under this section refer to the SNL Specification for more detailed descriptions The FileAct Client gt SnF Fetch File section of the SWIFT AG eWay Connectivity Map properties contains the top level parameters displayed in Table 10 Table 12 Connectivity Map FileAct Client gt SnF Fetch File Name Description Required Value Physical File Specifies the Sw_PhysicalName the full The physical file name Name physical name where the file is stored locally Size is limited to 254 bytes SWIFTAlliance Gateway eWay U
33. transactionSeq Scenario 4 SAG_Cert SnF Queue Non RecoveryMode track msg SAGOutboundeWay_1 getServices getFileActClient snfAcquire SAGOutboundeWay_1 getServices getFileActClient snfRelease track OK msg r n r n transactionSeg Scenario 5 SAG Cert FileAct NotifQueue Delivery track msg msg r n r n transactionSeg Scenario 5 1 SAG Cert FA Delivery 1st file track msg SAGOutboundeWay_1 getConfiguration getFileActClient setSwInt_Service swift generic fast x SAGOutboundeWay_1 getConfiguration getFileActClient setSwInt_NotifQueue ptsauszz_generic x SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw_TransferDescription msg SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw_PhysicalName C temp SAG_Cert testFilelToSnF txt SWIFTAlliance Gateway eWay User s Guide 89 Sun Microsystems Inc Appendix A Section A 1 Sample prjSAGCert Project Overview The prjSAGCert Sample Project Collaboration SAGOutboundeWay 1 getConfiguration getFileActClient getPutFile setSw LogicalName testFilelToSnF SAGOutboundeWay_1 getServices getFileActClient put track OK msg r n r n transactionSeq Scenario 5 2 SAG Cert FA Delivery 2nd file track msg SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw_TransferDescription msg
34. 38 platforms requirements 13 supported 13 Pool Idle Timeout In Seconds 43 Port Number 41 Primitive Control properties 27 Priority 30 32 prjSAGCert Java code 86 overview Java code 86 sample overview 51 scenarios 86 prjsagFA creating the sample 54 sample overview 51 prjSaglA creating the sample 72 sample overview 51 Projects creating 54 importing 51 52 sample overview 51 properties SWIFTAlliance Gateway eWay User s Guide Always Create New Connection 39 Application ID 25 Ask Positive Delivery Notification 30 33 Auto Disconnect Connection 39 Block File Transfer 34 CA Certificate 41 Client Handle Timeout 28 Context ID 25 Delivery Notification Oueue Name 30 33 File Description 37 File Info 37 Force Acguire 31 35 Ftla Port Number 41 Host Name 40 Include XML Attributes in SNL Primitive 27 Logical File Name 36 37 Max Pool Size 42 Max Wait Time in Millis 43 Maximum File Size 36 modifying 22 Msg Format 26 Non Repudiation 30 33 Order By 31 35 Physical File Name 36 37 38 Pool Idle Timeout In Seconds 43 Port Number 41 Priority 30 32 Queue Name To Acquire 31 35 Read Blocking Timeout 28 Read From RA CFG File 40 Recovery Mode 31 35 Remote File Handler TransferEP 34 Request Type 29 32 Requestor DN 29 32 Responder DN 29 32 Sender 26 Sender Auth 26 Server DN 41 Service Name 29 32 Session Mode 31 35 Signed 29 32 SSL Mode 41 Steady Pool Size 42 Transfer Description 36
35. Client_1 T ext lt gt FileClient_1 write Copy n new Date Last ResponseMessage rin SAGOutboundeWay_1 Services FileActClient Response to FileClient_1 Text lt gt FileClient_1 write lt gt Copy n new Date Ending collab of SAG FAi nim ni n to FileClient_4 T ext FileClient_1 write E logger E alerter Figure 15 jcdSagFA Collaboration Business Rules E collabContext E typeConverter The Java Collaboration Editor features a graphical interface the Business Rules Designer that allows you to select menu options and use drag and drop to graphically create your Business Rules You can also create your Business Rules using the editors Java Source Editor which allows you to simply enter you Business Rules in Java To create the jedSagFA Collaboration Business Rules using the Java Collaboration Editor s Business Rules Designer do the following 1 To open Collaboration Editor to the Sun jedSagFA Collaboration double click jedSagFA in the Project Explorer tree If you choose to create comments for the Business Rules click the comment icon on the Business Rules toolbar The Enter a Comment dialog box appears Enter the comment and click OK The comment is placed on the Business Rules tree under the last selected item You can move drag the new comment up or down the Business Rules tree The Copy r n new Date Starting collab of SAG_FA r n to FileClient 1 Text rule cre
36. Environment Explorer right click IntegrationSvr1 under your Logical Host and select Properties from the shortcut menu The Integration Server Properties Editor appears 2 Click the Password property field under Sun SeeBeyond Integration Server Configuration An ellipsis appears in the property field 3 Click the ellipsis The Password Settings dialog box appears Enter STC as the Specific Value and as the Confirm Password and click OK 4 Click OK to accept the new property and close the Properties Editor For more information on deploying a Project see the Sun SeeBeyond Java Composite Application Platform Suite Deployment Guide 569 Creating the Deployment Profile Deployment Profiles are specific instances of a Project in a particular Environment A Deployment Profile is created using the Enterprise Designer s Deployment Editor To create a Deployment Profile do the following 1 From the Enterprise Explorer s Project Explorer right click the Project and select New gt Deployment Profile 2 From the Create Deployment Profile dialog box enter a name for the Deployment Profile for this example dpSAGIA Select the appropriate Environment envSAGIA and click OK 3 Click the Auto Map icon as displayed in Figure 33 SWIFTAlliance Gateway eWay User s Guide 81 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing a Project Using Java Collaboration Definitions JCD The prjSaglA Sample Project Figure 33 Deployment
37. Explorer right click IntegrationSvr1 under your Logical Host and select Properties from the shortcut menu The Integration Server Properties Editor appears 2 Click the Password property field under Sun SeeBeyond Integration Server Configuration An ellipsis appears in the property field 3 Click the ellipsis The Password Settings dialog box appears Enter STC as the Specific Value and as the Confirm Password and click OK 4 Click OK to accept the new property and close the Properties Editor For more information on deploying a Project see the Sun SeeBeyond Java Composite Application Platform Suite Deployment Guide 55 10 Creating the Deployment Profile Deployment Profiles are specific instances of a Project in a particular Environment A Deployment Profile is created using the Enterprise Designer s Deployment Editor To create a Deployment Profile do the following 1 From the Enterprise Explorer s Project Explorer right click the Project and select New gt Deployment Profile 2 From the Create Deployment Profile dialog box enter a name for the Deployment Profile for this example dpSAGFA Select the appropriate Environment envSAGFA and click OK 3 Click the Automap icon as displayed in Figure 27 on page 70 SWIFTAlliance Gateway eWay User s Guide 69 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing a Project Using Java Collaboration Definitions JCD Creating the prjSagFA Project Figure 27 Deployme
38. FA Collaboration Definition The jcdSagFA Collaboration defines transactions from the inbound File eWay to the SWIFT AG eWay and the outbound File eWay 1 From the Project Explorer right click your new Project and select New gt Collaboration Editor Java from the shortcut menu The Collaboration Definition Wizard Java appears 2 Enter a Collaboration Definition name for this sample jcdSagFA and click Next SWIFTAlliance Gateway eWay User s Guide 54 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing a Project Using Java Collaboration Definitions JCD Creating the prjSagFA Project 3 For Step 2 of the wizard from the Web Services Interfaces selection window double click Sun SeeBeyond gt eWays gt File gt FileClient gt receive The File Name field now displays receive Click Next 4 For Step 3 of the wizard from the Select OTDs selection window double click Sun SeeBeyond gt eWays gt File gt FileClient The FileClient_1 OTD is added to the Selected OTDs field 5 Click Up One Level to return to the Repository From the Select OTDs selection window double click Sun SeeBeyond gt eWays gt SAG gt SAGOutboundeWay The SAGOutboundeWay_1 OTD is added to the Selected OTDs field see Figure 14 Figure 14 Collaboration Definition Wizard Java Select Web Service Steps Select OTDs to be used in this Collaboration 1 Enter Name and Type 2 Select Web Service Lookin Ga SAG 4 Ss BE Operatio
39. FileClient 1 I SAGOutboundeli ay 1 a Configuration c Constants Primitives A a SnlPrimitives E FileActClient gt E InterActClient jedSAGFA AD G FileClient 1 MS ByteArray Gi Encoding mTot A N String Date result Date an add valuei A value2 Last ResponseMessage t n _ value 3 CURE valued Response value ai Envelope Letter input US SAGOutboundelay_1 ME String result jedSAGFA 11 The FileClient 1 write rule writes the data to the message Create the FileClient 1 write rule A 12 Follow the directions provided in step 4 of this section to create another FileClient 1 write rule The Copy r n new Date Ending collab of SAG_FA r n r n r n r n to FileClient 1 Text rule creates the Ending collab ofSAG FA comment and includes the starting time and date Create the Copy r n new Date Ending collab of SAG FA r n r n r n r n to FileClient 1 Text rule A From the Business Rules toolbar click the rule icon to add a new rule B From the Business Rules Designer toolbar click the Class Browser icon The Class Browser dialog box appears C From the Class Browser select Date as the class java util as the package and Date as the constructor Click Select The Date constructor box is added to the Business Rules Designer mapping canvas D From the Business Rule
40. SUN SEEBEYOND eWAY ADAPTER FOR SWIFTALLIANCE GATEWAY USERS GUIDE Release 5 1 2 S Re SUN microsystems Copyright 2006 Sun Microsystems Inc 4150 Network Circle Santa Clara California 95054 U S A All rights reserved Sun Microsystems Inc has intellectual property rights relating to technology embodied in the product that is described in this document In particular and without limitation these intellectual property rights may include one or more of the U S patents listed at http www sun com patents and one or more additional patents or pending patent applications in the U S and in other countries U S Government Rights Commercial software Government users are subject to the Sun Microsystems Inc standard license agreement and applicable provisions of the FAR and its supplements Use is subject to license terms This distribution may include materials developed by third parties Sun Sun Microsystems the Sun logo Java Sun Java Composite Application Platform Suite SeeBeyond eGate elnsight eVision eTL eXchange eView elndex eBAM eWay and JMS are trademarks or registered trademarks of Sun Microsystems Inc in the U S and other countries All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International Inc in the U S and other countries Products bearing SPARC trademarks are based upon architecture developed by Sun Microsystems Inc UNIX is a registered trademark
41. _1 getConstants getSw_Boolean getFALSE track OK msg r n r n transactionSeq Scenario 3 5 continued on 3 1 SAG_Cert RT FA Put Non Blocking ASync 1MB file CheckTransferStatus on putTransferRef31 track msg for int i 0 i lt 100 i String status SAGOutboundeWay_1 getServices getFileActClient checkFileStatus putTransferRef31 msg r n r n status SAGOutboundeWay 1 getPrimitives getSnlPrimitives getSw GetFileStatusResponse getSw FileStatu s getSw CurrentSize getX PCDATA of SAGOutboundeWay 1 getPrimitives getSnlPrimitives getSw GetFileStatusResponse getSw FileStatu s getSw Size getX PCDATA bytes track msg if SAGOutboundeWay 1 getConstants getSw TransferStatus getCompleted equalsIgnoreCase status SAGOutboundeWay 1 getConstants getSw TransferStatus getDuplicated equalsIgnoreCase status SAGOutboundeWay 1 getConstants getSw TransferStatus getUnknown egualsIgnoreCase status SAGOutboundeWay_1 getConstants getSw_TransferStatus getFailed egualsIgnoreCase status SAGOutboundeWay_1 getConstants getSw_TransferStatus getRejected equalsIgnoreCase status SAGOutboundeWay 1 getConstants getSw TransferStatus getAborted egualsIgnoreCase status tr ck 2 4 ha break Thread sleep 20000 track OK msg r n r n
42. aCAPS Integration Server 25 Configuring the Application ID For the sample Projects the application interface message partner name is my AI To configure this message partner for SWIFTAlliance Gateway do the following 1 From the SAG Admin Interface click Application Interface The Application Interface module appears 2 From the Application Interface module toolbar click Add a new Message Partner the Message Partner Detail dialog box appears 3 From the Message Partner Detail dialog box see Figure 2 on page 20 enter the following values Name my_AI Type ClientServer Unit None Supported Message Formats Selected Basic InterAct Format Sag Primitive Format Relaxed SNLFormat Strict SNLFormat Additional Processing Selected Remote API Host Adapter 4 Save your changes and close the Message Partner Detail dialog box From the Application Interface Module Message Partners tab right click the my AI message partner and select Enable from the shortcut menu SWIFTAlliance Gateway eWay User s Guide 19 Sun Microsystems Inc Chapter 2 Section 2 5 Installing the eWay Configuring the Application ID Figure 2 SWIFTAlliance Gateway Application Interface Module p a Status Unit HostAdapter Remote API HostAdapter W Default Message Format for Emission from Message Partner Relaxed SNL Format Supported Message Formats Available Selected Basic InterAct Format SAG Primitive Format Relaxed SNL Format
43. ady to deploy your Project Deploy the Project 1 From the Deployment Editor toolbar click the Deploy icon Click Yes when the Deploy prompt appears 2 A message appears when the project is successfully deployed 5 6 13 Running the Project To run your deployed sample Project do the following 1 From your configured input directory paste or rename the sample input file to trigger the eWay The trigger input file input_SAG_IA txt is picked up by the file eWay 2 The processed output file is published to your output directory Verify the output data A sample output data file outputSAGIA1 dat is included in the sample package download for comparison SWIFTAlliance Gateway eWay User s Guide 83 Sun Microsystems Inc Appendix A Sample prjSAGCert Project Overview This appendix provides the Java code that is represented by the Business Rules of the SWIFT AG eWay sample Project s jcdSAGCert Collaboration What s in this Appendix The prjSAGCert Sample Project Collaboration on page 84 A1 The prjSAGCert Sample Project Collaboration The prjsAGCert Sample Project demonstrates several different scenarios and therefore provides a good example of how the logic for these scenarios to create jcdSAGCert Collaboration Definition Scenarios The jcdSAGCert Java Collaboration Definition performs the following scenarios Scenario 1 InterAct Real Time swift cte Scenario 1 1 InterAct Real Time synchronous cte Got InterAct ResponsePay
44. applications that are interconnected among a community of institutions Optionally SWIFTNet also provides non repudiation support message validation store and forward and role based access control SWIFTAlliance Gateway eWay User s Guide 6 Sun Microsystems Inc Chapter 1 Section 1 1 Introduction About SWIFTAlliance Gateway 112 SWIFTAlliance Gateway SWIFTAlliance Gateway is an interface product for SWIFTNet It incorporates all the functionality of the SWIFTNet Link Additionally it provides several different connectivity and usability features for SWIFTNet users providing solutions to a variety of system integration problems SWIFTAlliance Gateway is designed to concentrate traffic from multiple SWIFTAlliance WebStations It provides a graphical user interface for the administration of the SWIFTAlliance Gateway and related SWIFTNet security administration functions SWIFTAlliance Gateway can serve as a message concentrator receiving messages from various other applications for passage through SWIFTNet It can receive these messages through host adapters including a WebSphere MO host adapter for interfacing with business applications running on a variety of different types of computing platforms 113 SWIFTAlliance Gateway Remote API SWIFTAlliance Gateway Remote API RA is a software package that establishes a communication link with the RA Host Adapter component of SWIFTAlliance Gateway either from a SWIFTNet application existi
45. ario 8 1 SAG Cert IA Delivery 1st getConfiguration getInterActClient setSwInt_Service getConfiguration getInterActClient setSwInt_Requestor ou management o ptsauszz o swift SAGOutboundeWay_ getConfiguration getInterActClient setSwInt_Responder ou management o ptsauszz o swift SAGOutboundeWay_ ptsauszz_generic x SAGOutboundeWay_ SAGOutboundeWay_ track OK msg r n r n track msg SAGOutboundeWay_ SAGOutboundeWay_ track OK msg r n r n track msg SAGOutboundeWay_ getConfiguration getInterActClient setSwInt_NotifQueue getServices getInterActClient setRequestPayload msg getServices getInterActClient sendAndReceive transactionSeg Scenario 8 2 SAG Cert IA Delivery 2nd getServices getInterActClient setRequestPayload msg getServices getInterActClient sendAndReceive transactionSeq Scenario 8 3 SAG_Cert IA Delivery Signed 3rd getConfiguration getInterActClient setSwInt_RequestCrypto SAGOutboundeWay_1 getConstants getSw_Boolean getTRUE SAGOutboundeWay_ SAGOutboundeWay_ SAGOutboundeWay_ getServices getInterActClient setRequestPayload msg getServices getInterActClient sendAndReceive getConfiguration getInterActClient setSwInt ReguestCrypto SAGOutboundeWay_1 getConstants getSw_Boolean getFALSE SAGOutboundeW
46. as 2 From the Connectivity Map Editor toolbar click the Connectivity Map Generator The Generator populates the Connectivity Map with the necessary components and binds the components according to your Collaboration Definition 3 Save your changes to the Repository 5 6 6 Creating an Environment Environments include the external systems Logical Hosts integration servers and message servers used by a Project and contain the configuration information for these components Environments are created using the Environment Editor 1 From the Enterprise Explorer click the Environment Explorer tab 2 Right click the Repository and select New Environment A new Environment is added to the Environment Explorer tree 3 Rename the new Environment to envSAGIA SWIFTAlliance Gateway eWay User s Guide 78 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing a Project Using Java Collaboration Definitions JCD The prjSaglA Sample Project 4 Right click envSAGIA and select New gt SAG External System Name the External System esSAG Click OK esSAG is added to the Environment Editor 5 Right click envSAGIA and select New gt File External System Name the External System esFile Click OK esFile is added to the Environment Editor 6 Right click envSAGIA and select New gt Logical Host LogicalHost1 is added to the Environment Editor 7 From the Environment Explorer tree right click LogicalHost1 and select New gt Sun SeeBeyond Int
47. ates a Starting collab of SAG FA comment and includes the starting time stamp Create the Copy r n new Date Starting collab of SAG_FA r n to FileClient 1 Text rule A From the Business Rules toolbar click the rule icon to add a new rule under receive on the Business Rules tree B From the Business Rules Designer toolbar click the Class Browser icon The Class Browser dialog box appears SWIFTAlliance Gateway eWay User s Guide 56 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing a Project Using Java Collaboration Definitions JCD Creating the prjSagFA Project C From the Class Browser select Date as the class java util as the package and Date as the constructor see Figure 16 Click Select The Date constructor box is added to the Business Rules Designer mapping canvas Figure 16 jcdSagFA Collaboration Business Rules Class Browser dP D3 seach SSS E DataTruncation 2 Date String s DateFormat DateF ormat Field vmbols Date int year int month int date in Date iong date java sal D o s a amate rinimi Date int year int month int date amp java util Date Date public Date result java util Date Select Cancel D From the Business Rules Designer s Math menu select Add The Add box appears E From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter r n as th
48. ault settings User DN SwSec_UserDN Size limit 100 bytes For example cn John o ptsauszz o swift Requestor DN Swint_Requestor Size limit 100 bytes For example o ptsauszz o swift Responder DN Swint_Responder Size limit 100 bytes For example cn management o swift o swift Service Name Swint_Service Size limit 30 bytes For example swift cte swift generic fa x swift generic fast x etc User Reference Swint_RequestRef Size limit 30 bytes Modify the SWIFT AG eWay Environment Explorer Properties 1 From the Environment Explorer tree right click the SWIFT AG eWay External System esSAG in this sample and select Properties from the shortcut menu The Properties Editor appears 2 Modify the SWIFT AG eWay Environment properties for your system including the settings in Table 25 and click OK SWIFTAlliance Gateway eWay User s Guide 80 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing a Project Using Java Collaboration Definitions JCD The prjSaglA Sample Project Table 25 SWIFT AG eWay Environment Properties SWIFT AG eWay Environment Properties Transport Set as directed otherwise use the default settings Read From RA CFG File sagta_ra cfg Host Name The Host Name Port Number The Port Number 568 Configuring the Integration Server You must set your Sun SeeBeyond Integration Server Password property before deploying your Project 1 From the
49. ava Collaboration Definition To populate the cmSAGFA Connectivity Map using the Connectivity Map Generator do the following 1 Create the cmSAGFA Connectivity Map as described in Creating a Connectivity Map on page 63 Steps 1 and 2 2 From the Project Explorer tree drag and drop the jcdSagFA Collaboration onto the cmSAGFA Connectivity Map Editor canvas 3 From the Connectivity Map Editor toolbar click the Connectivity Map Generator The Generator populates the Connectivity Map with the necessary components and binds the components according to your Collaboration Definition SWIFTAlliance Gateway eWay User s Guide 65 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing a Project Using Java Collaboration Definitions JCD Creating the prjSagFA Project 557 Creating an Environment Environments include the external systems Logical Hosts integration servers and message servers used by a Project and contain the configuration information for these components Environments are created using the Environment Editor 1 From the Enterprise Explorer click the Environment Explorer tab 2 Right click the Repository and select New Environment A new Environment is added to the Environment Explorer tree Rename the new Environment to envSAGFA 4 Right click envSAGFA and select New gt SAG External System Name the External System esSAG Click OK esSAG is added to the Environment Editor 5 Right click envSAGFA and select New
50. ay_1 getPrimitives getSnlPrimitives getSwlnt_ExchangeRequest getSwInt_Request removeSwSec Crypto track OK msg r n r n transactionSeg Scenario 9 SAG Cert PullQueue track msg msg r n r n Wait a while for SwiftNet SnF Queue access track msg Thread sleep 10000 track OK msg r n r n transactionSeg Scenario 9 1 SAG Cert PullQueue ist track msg SAGOutboundeWay_1 getServices getInterActClient snfAcquire SAGOutboundeWay_1 getServices getInterActClient snfPull track OK msg r n r n transactionSeg Scenario 9 2 SAG Cert PullQueue 2nd track msg SAGOutboundeWay_1 getServices getInterActClient snfPull SAGOutboundeWay_1 getServices getInterActClient snfAck SAGOutboundeWay_1 getServices getInterActClient snfRelease track OK msg r n r n transactionSeq Scenario 9 3 SAG Cert PullQueue 3rd track msg SAGOutboundeWay_1 getServices getInterActClient snfAcquire SAGOutboundeWay_1 getServices getInterActClient snfPull SAGOutboundeWay 1 getServices getInterActClient snfAck SAGOutboundeWay 1 getServices getInterActClient snfRelease track OK String to Ti msg r n r n transactionSeg Scenario 10 SAG Cert Show more usages of other API Primitive example Process Sag Primitive ReadEventLog s
51. ays and edits i meee Rita eater Java code Gi Messagelnto top 54 n ee this 9 F ate c m i TCPIPInboundConfiginto type dpi 4 D 513 SAGOutboundeti ay 1 piacenti l input ME Java Source Editor B x PAB r AAlRules O Curent Rule T T 22 input receiveString 23 tcpip input 24 file FileClient l 25 int transactionSeg 0 Collaboration_1 jcdSAGCert Collaboration Java Code The jedSA GCert sample Project s jedSA GCert Collaboration contains the following Java code package prjSAGCert public class jcdSAGCert public com stc codegen logger Logger logger public com stc codegen alerter Alerter alerter public com stc codegen util CollaborationContext collabContext public com stc codegen util TypeConverter typeConverter private com stc connector appconn file FileApplication file public void receive com stc connector appconn file FileTextMessage input com stc connector sagadapter sagapi SAGOutbound SAGOutboundeWay_1 com stc connector appconn file FileApplication FileClient_1 throws Throwable SWIFTAlliance Gateway eWay User s Guide 86 Sun Microsystems Inc Appendix A Section A 1 Sample prjSAGCert Project Overview The prjSAGCert Sample Project Collaboration file FileClient_1 int transactionSeg 0 String msg input getText msg input getText FileClient 1 setText msg FileClient 1 write track Xrin k k k kiikikkikkkkikkkkkkkkkkkkkkkkkkikkkkm trac
52. ctClient setRequestPayload msg long t2 SAGOutboundeWay_1 getServices getInterActClient sendRequest track t2 token OK msg r n r n transactionSeq Scenario 1 2 3 SAG_Cert RT IA cte ASync receive 1st resp track msg SAGOutboundeWay_1 getServices getInterActClient receiveResponse t1 track tl OK msg r n r n transactionSeg Scenario 1 2 4 SAG_Cert RT IA cte ASync recv 2nd resp track msg SAGOutboundeWay_1 getServices getInterActClient receiveResponse t2 track t2 OK msg r n r n transactionSeq Scenario 1 3 SAG Cert RT IA cte Signed track msg SAGOutboundeWay_1 getServices getInterActClient setRequestPayload msg SAGOutboundeWay 1 getConfiguration getInterActClient setSwInt_RequestCrypto SAGOutboundeWay 1 getConstants getSw Boolean getTRUE SAGOutboundeWay 1 getServices getInterActClient sendAndReceive SAGOutboundeWay_1 getConfiguration getInterActClient setSwInt_RequestCrypto SAGOutboundeWay_1 getConstants getSw Boolean getFALSE SAGOutboundeWay_1 getPrimitives getSnlPrimitives getSwInt_ExchangeRequest getSwInt_Request removeSwSec Crypto track OK msg r n r n transactionSeg Scenario 2 SAG Cert RealTime FileAct Get track msg msg r n r n transactionSeg Scenario 2 1 SAG Cert RT FA Get
53. cular eWay accessed from the Connectivity Map and those that are common to all eWays of this type accessed from the Environment Explorer tree 2 From the upper left pane of the Properties Editor select a properties directory from the Configuration tree The parameters contained in that directory are now displayed in the right pane of the Properties Editor For example from the outbound eWay Connectivity Map Properties click on Transport to display this section s editable parameters in the right pane as shown in Figure 5 Figure 5 Properties Editor SWIFT AG eWay Environment Properties D Ey Outbound Environment Configuration EA ae ransport gt Connection Pool Settings Read From RA CFG File sagta_racty Host Name Port Number 48002 Fila Port Number 48003 Server DN CA Certificate SSL Mode Description Read From RA CFG File We can get RA transport information in two ways 1 Read all of them from an existing RA configuration file for your SAG RA environment Comments Read From RA CFG File Properties Cancel 3 Click on any property field to make it editable For example click on the Read From RA CFG File parameter to edit the Read From RA CFG File value If a parameter s value is true false or multiple choice the field when selected reveals a submenu of property options If a parameter requires that you type ina value such as a name or password t
54. d in this gueue For store and forward delivery mode enter the name of the delivery notification gueue Size is limited to 30 bytes For example ptsauszz_generic x see Sw DeliveryNotif Ask Positive Delivery Notification Specifies Sw DeliveryNotif delivery notification This is for store and forward delivery mode only Indicates whether a delivery notification is reguired in case of successful delivery Accepted or Duplicated Select True or False True indicates that a delivery notification is reguired The configured default is FALSE SWIFTAlliance Gateway eWay User s Guide 33 Sun Microsystems Inc Chapter 3 Configuring the eWay Section 3 3 SWIFT AG eWay Connectivity Map Properties Table 8 Connectivity Map FileAct Client Continued Name Description Required Value Remote File Handler TransferEP Specifies the Sw_TransferEP the Transfer EndPoint name used for the remote file handler Value options Blank value indicates that the file transfer does not use the remote file handler Transfer EndPoint name When this value is present the file transfer uses the remote file handler Before the file transfer starts you need to start the remote file handler process with the specified Transfer EndPoint name on your system The command to start the remote file handler swfa_handler requires the command line arguments swfa_handler lt HostName gt lt PortNumbe
55. dd box appears From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter r n as the Literal value Map the r n output node of the String Literal box to the Valuel input node of the Add box Map the result Date output node of the Date constructor box to the value2 input node of the Add box From the Business Rules Designer s String menu select Literal String The String box appears Enter Last ResponseMessage r n as the Literal value Map the Last ResponseMessage r n output node of the String Literal box to the Value3 input node of the Add box Map Response under Services gt FileActClient in the left pane of the Business Rules Designer to the value4 input node of the Add box SWIFTAlliance Gateway eWay User s Guide 61 Sun Microsystems Inc Chapter 5 Implementing a Project Using Java Collaboration Definitions JCD K Section 5 5 Creating the prjSagFA Project Map the result output node of the Add box to Text under FileClient_1 in the right pane of the Business Rules Designer see Figure 21 Figure 21 Java Collaboration Editor jcdSagFA Business Rules Business Rules Designer AD 0 2 x pociean Comparisons Elmath Object A String Hilaray fOperators Assignment Copy n new Date Last ResponseMessage in SAGOutboundeWay_1 Semices FileActClient Response to FileClient 1 Text gt input Gab jedSAGFA D IS
56. dle RA connections can remain in the pool indefinitely indicates that an idle RA connection may remain in the pool indefinitely When the value is greater than 0 the container removes or destroys any RA connection instance that is idle for this specified duration The configured default is 300 SWIFTAlliance Gateway eWay User s Guide 43 Sun Microsystems Inc Chapter 4 OTD Overview This chapter provides an overview of the SWIFT AG eWay OTD What s in This Chapter Introduction to SWIFT AG eWay OTD on page 44 41 Introduction to SWIFT AG eWay OTD The SWIFT AG eWay includes the SAGOutboundeWay Object Type Definition The SAGOutboundeWay OTD structure is organized into five sections Configuration Constants Primitives RemoteApis Remote APIs and Services see Figure 6 Figure 6 SAGOutboundeWay OTD SAGOutboundeWay G ai Configuration ai Constants G ai Primitives EF RemoteApis 2 a Services Figure 6 shows the SAGOutboundeWay OTD as displayed in the Collaboration Editor Configuration Node The Configuration node directly corresponds to the eWay Connectivity Map and Environment Configuration properties The OTD Configuration node offers dynamic configuration configuration on the fly Dynamic configuration allows you to edit the configuration based on your Collaboration s Business Rule logic from the Java Collaboration Editor dynamically changing a parameter without shutting d
57. e ies Swint_SendRequest a Swlnt SendResponse GE swint_waitRequest a Swlnt WaitResponse i SwSec_CreateContextRequest ies SwSec_CreateContextResponse ies SwSec_DestroyContextRequest a SwSec_DestroyContextResponse a SwSec_SignEncryptRequest ies SwSec_SignEncryptResponse E SwSec_VerifyDecryptRequest ies SwSec_VerifyDecryptResponse SWIFTAlliance Gateway eWay User s Guide 47 Section 4 1 Introduction to SWIFT AG eWay OTD Figure 9 SAGOutboundeWay OTD Primitives Node Sun Microsystems Inc Chapter 4 Section 4 1 OTD Overview Introduction to SWIFT AG eWay OTD Remote APIs Node The SAGOutboundeWay OTD s RemoteApis node exposes the SWIFT Remote API s client APIs Just as the Primitives section provide a message structure the RemoteApis section provides a communication function structure The Remote APIs allow you to perform special lower level communication functions Figure 10 SAGOutboundeWay OTD Remote APIs Node ie RemoteApis E Client m Request ai Envelope Applicationld ApplicationStatus Contextid MsgFormat MsgRef E NameditemList Receiver Sender Letter oE Response Envelope Applicationld ApplicationStatus Contextid MsgFormat MsgRef i NameditemList Receiver Sender Letter Token Service Node The Service section of the OTD allows you to perform hi
58. e Gateway eWay The Javadoc is uploaded with the eWay s SWIFTAlliance Gateway eWay User s Guide 10 Sun Microsystems Inc Chapter 1 Section 1 5 Introduction Sun Microsystems Inc Web Site documentation file SwiftAGeWayDocs sar and downloaded from the Documentation tab of the Sun Java Composite Application Platform Suite Installer To access the full Javadoc extract the Javadoc to an easily accessible folder and double click the index html file 142 Scope This guide describes how to install and use the SWIFT AG eWay within the Sun Java Composite Application Platform Suite Sample Projects are documented to demonstrate how Collaborations and Projects are created and implemented in a typical environment 143 Intended Audience This guide is intended for experienced computer users who have the responsibility of helping to set up and maintain a fully functioning Java Composite Application Platform Suite system This person must also understand any operating systems on which the Java Composite Application Platform Suite will be installed Windows and UNIX and must be thoroughly familiar with Windows style GUI operations 144 Text Conventions The following conventions are observed throughout this document Table 1 Text Conventions Text Convention Used For Examples Bold Names of buttons files icons Click OK parameters variables methods On the File menu click Exit menus and objects Select the eGate sa
59. e Literal value F Map the r n output node of the String Literal box to the Value1 input node of the Add box G Map the result Date output node of the Date constructor box to the value2 input node of the Add box To do this click on the result Date output node of the Date constructor box and drag your cursor to the input node of the Add box A link now connects the two nodes H From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter Starting collab of SAG_FA r n as the Literal value Map the Starting collab of SAG_FA r n output node of the second String Literal box to the Value3 input node of the Add box J Map the result output node of the Add box to Text under FileClient_1 in the right pane of the Business Rules Designer see Figure 17 on page 58 SWIFTAlliance Gateway eWay User s Guide 57 Sun Microsystems Inc Chapter 5 Implementing a Project Using Java Collaboration Definitions JCD Section 5 5 Creating the prjSagFA Project Figure 17 jcdSagFA Collaboration Business Rules Create Variable Business Rules Designer 4599 jedSAGFA T alerter ET collabContext L I logger ET super O ET this EI typeConverter IS FileClient 1 I input MI SAGOutboundeWay_1 jedSAGFA Copy n new Date Starting collab of SAG FAiMn to FileClient 1 Text D fae result Date jo value2 value3 va
60. e the response SWIFTAlliance Gateway eWay User s Guide 46 Sun Microsystems Inc Chapter 4 OTD Overview ies Primitives SnlPrimitives Sw AbortFileReguest pad Sw AbortReason bad Sw Transferkey a Sw TransferRef Type Version X_PCDATA_ Type Version ei Sw AbortFileResponse a Sw ExchangeFileReguest i Sw ExchangeFileResponse a Sw_ExchangeSnF Request ies Sw_ExchangeSnF Response E Sw_FetchFileRequest ies Sw_FetchFileResponse a Sw_GetDate TimeRequest a Sw GetDateTimeResponse ies Sw GetFileDigestReguest ies Sw GetFileDigestResponse i Sw GetFileStatusReguest a Sw_GetFileStatusResponse ies Sw GetSnFStatusReguest i Sw GetSnFStatusRespons i Sw HandleFileEventReguest E Sw HandleFileEventResponse ies Sw HandleFileReguest i Sw HandleFileResponse ies Sw HandlelnitReguest a Sw HandlelnitResponse a Sw HandleSnFReguest a Sw_HandleSnF Response ies Sw HandleTermReguest a Sw_HandleTermResponse am Sw InitReguest i Sw InitResponse E Sw KMACertifyReguest i Sw KMACertifyResponse E Sw KMACertListReguest E Sw KMACertListResponse a Sw_KMAChangePasawordRe quest a Sw KM ChangeP asawordResponse G Sw ListFileStatusReguest i Sw ListFileStatusResponse a Sw_PullSnF Request a Sw_PullSnF Response ies Sw_SubscribeFileEventRequest ies Sw SubsoribeFileEventResponse i Sw TermReguest E Sw_TermResponse ies Swint_ExchangeRequest E Swint_ExchangeResponse ies Swint_HandleRequest a Swint_HandleRespons
61. eFileResponse r n as the Literal value Map the ExchangeFileResponse r n output node of the second String Literal box to the Value3 input node of the Add box Map Sw_ExchangeFileResponse under Primitives gt SnlPrimitives in the left pane of the Business Rules Designer to the value4 input node of the Add box Map the result output node of the Add box to Text under FileClient_1 in the right pane of the Business Rules Designer 9 The FileClient_1 write rule writes the data to the message Create the FileClient_1 write rule A Follow the directions provided in step 4 of this section to create another FileClient_1 write rule 10 The Copy r n new Date Last ResponseMessage r n SAGOutboundeWay_1 Services FileActClient Response to FileClient_1 Text rule creates the Response Message and includes the starting time and date Create the Copy r n new Date Last ResponseMessage r n SAGOutboundeWay_1 Services FileActClient Response to FileClient_1 Text rule A B From the Business Rules toolbar click the rule icon to add a new rule From the Business Rules Designer toolbar click the Class Browser icon The Class Browser dialog box appears From the Class Browser select Date as the class java util as the package and Date as the constructor Click Select The Date constructor box is added to the Business Rules Designer mapping canvas From the Business Rules Designer s Math menu select Add The A
62. eStatus getTransferRef22 msg r n r n status SAGOutboundeWay 1 getPrimitives getSnlPrimitives getSw GetFileStatusResponse getSw FileStatu s getSw CurrentSize getX PCDATA of SAGOutboundeWay 1 getPrimitives getSnlPrimitives getSw GetFileStatusResponse getSw FileStatu s getSw Size getX PCDATA bytes track msg if SAGOutboundeWay 1 getConstants getSw TransferStatus getCompleted equalsIgnoreCase status SAGOutboundeWay 1 getConstants getSw TransferStatus getDuplicated equalsIgnoreCase status SAGOutboundeWay 1 getConstants getSw TransferStatus getUnknown egualsIgnoreCase status SAGOutboundeway 1 getConstants getSw TransferStatus getFailed equalsIgnoreCase status VII SAGOutboundeWay 1 getConstants getSw TransferStatus getRejected egualsIgnoreCase status SAGOutboundeWay_1 getConstants getSw_TransferStatus getAborted equalsIgnoreCase status track break Thread sleep 20000 track OK msg r n r n transactionSeq Scenario 3 SAG Cert RealTime FileAct Put swift generic fa x track msg msg r n r n transactionSeq Scenario 3 1 to be continued on 3 5 SAG Cert RT FA Put Non Blocking ASync 1MB file track msg SAGOutboundeWay 1 getConfiguration getFileActClient setBlockFileTransfer SAGOutboundeWay_1 getConstants getSw_Boolea
63. eWay sont des marques de fabrique ou des marques d pos es de Sun Microsystems Inc aux Etats Unis et dans d autres pays Toutes les marques SPARC sont utilis es sous licence et sont des marques de fabrique ou des marques d pos es de SPARC International Inc aux Etats Unis et dans d autres pays Les produits portant les marques SPARC sont bas s sur une architecture d velopp e par Sun Microsystems Inc UNIX est une marque d pos e aux Etats Unis et dans d autres pays et licenci e exclusivement par X Open Company Ltd Ce produit est couvert la l gislation am ricaine en mati re de contr le des exportations et peut tre soumis la r glementation en vigueur dans d autres pays dans le domaine des exportations et importations Les utilisations ou utilisateurs finaux pour des armes nucl aires des missiles des armes biologiques et chimiques ou du nucl aire maritime directement ou indirectement sont strictement interdites Les exportations ou r exportations vers les pays sous embargo am ricain ou vers des entit s figurant sur les listes d exclusion d exportation am ricaines y compris mais de mani re non exhaustive la liste de personnes qui font objet d un ordre de ne pas participer d une facon directe ou indirecte aux exportations des produits ou des services qui sont r gis par la l gislation am ricaine en mati re de contr le des exportations et la liste de ressortissants sp cifiquement d sign s sont rigoureusement interdit
64. egration Server A new Integration Server IntegrationSvr1 is added to the Environment Explorer tree under LogicalHost1 567 Configuring the eWays The prjSaglA Project uses three eWays each represented in the Connectivity Map as a node between an External Application and a Service Configuring the File eWay Properties eWay properties are set in both the Connectivity Map and the Environment Explorer Modify the File eWay Connectivity Map Properties 1 Double click the inbound FileIn eWay The Properties Editor opens to the inbound File eWay properties Modify the Inbound File eWay properties for your system including the settings in Table 21 and click OK Table 21 Inbound File eWay Settings Inbound eWay Connectivity Map Properties Input file name input_SAG_IA txt 2 Inthe same way open and modify the outbound File eWay properties for your system including the settings in Table 22 and click OK Table 22 Outbound File eWay Settings Outbound eWay Connectivity Map Properties Output file name outputSAGIA d dat Modify the File eWay Environment Explorer Properties 1 From the Environment Explorer tree right click the File eWay External System esFile in this sample and select Properties from the shortcut menu The Properties Editor appears 2 Modify the File eWay Environment properties for your system including the settings in Table 23 on page 80 and click OK SWIFTAlliance Gateway eWay U
65. elivery notification is required The configured default is FALSE SWIFTAlliance Gateway eWay User s Guide 30 Sun Microsystems Inc Chapter 3 Configuring the eWay 335 InterAct Client gt Store and Forward Section 3 3 SWIFT AG eWay Connectivity Map Properties This section maps to the parameter Sw AcquireSnFRequest of the Primitive Sw ExchangeSnFRequest For parameters SwXXX under this section refer to the SNL specification for more detailed descriptions The InterAct Client gt Store and Forward section of the SWIFT AG eWay Connectivity Map properties contains the top level parameters displayed in Table 7 Note For more information on SWIFTAlliance Gateway configration properties in the context of SWIFTAlliance Gateway refer to the SWIFTAlliance Gateway and SNL user documentation provided by SWIFT Table 7 Connectivity Map InterAct Client gt Store and Forward Name Description Required Value Queue Name Specifies the name of the queue The User Swint_Queue To Acquire Swint_Queue For example ptsauszz_generic x Size is limited to 30 bytes Force Specifies the Sw_ForceAcquire Indicates Select TRUE or FALSE True indicates Acquire whether an acquisition request must be Indicates that an acquisition request accepted in case the queue is already acquired must be accepted The configured default is TRUE Session Mode Specifies the usage mode of the queue This property is
66. es Part Number 819 7327 10 Version 20061004095454 SWIFTAlliance Gateway eWay User s Guide 2 Sun Microsystems Inc Contents Contents Chapter 1 Introduction About SWIFTAlliance Gateway Introduction to SWIFTNet SWIFTAlliance Gateway SWIFTAlliance Gateway Remote API SWIFTNet Messaging Services SWIFTNet InterAct SWIFTNet FileAct About the SWIFT Alliance Gateway eWay SWIFT AG eWay Features SAGOutboundeWay Object Type Definition What s New in This Release About This Document What s in This Document SWIFTAlliance Gateway eWay Javadoc Scope Intended Audience Text Conventions Sun Microsystems Inc Web Site Documentation Feedback Chapter 2 Installing the eWay SWIFT AG eWay System Requirements Installing the SWIFT AG eWay Installing the eWay on a JavaCAPS Supported System Adding the eWay to an Existing Suite Installation Installing eWay Enterprise Manager plug ins SWIFT AG eWay Alert Codes After Installation Adding the SWIFTAlliance Gateway Component Package Installing and Initializing the SWIFT AG Remote APIs Install the Remote API SWIFTAlliance Gateway eWay User s Guide 3 COM ANNNNDAD G EN a i aun aot e D N 13 13 13 14 14 15 15 16 16 18 18 Sun Microsystems Inc Contents Configuring the Application ID Chapter 3 Configuring the eWay Configuring the SWIFTAlliance Gateway eWay Selecting SWIFTAlliance Gateway as the External Application Modifying t
67. es institution BIC 8 gt o swift For example cn management o swift o swift Service Name Request Type Specifies the Swint_Service the Service Name containing the SWIFTNet service used The size is limited to 30 bytes Specifies the Swint_RequestType used to identify the message type of the XML message using the standard message code The size is limited to 30 bytes The Service Name For example swift cte swift generic ia x swift generic iast x and so forth The Request Type For example camt 005 001 02 GetTransaction User Reference Specifies the Swint_RequestRef This is used to associate a request message with subsequent response or error messages The size is limited to 30 bytes A user reference of 30 bytes or less Signed Specifies whether the request contains Crypto operations to be performed Only the last Crypto block is analyzed Swint_RequestCrypto digital signature Select True or False True indicates that the request contains Crypto operations to be performed The configured default is FALSE SWIFTAlliance Gateway eWay User s Guide 29 Sun Microsystems Inc Chapter 3 Configuring the eWay Section 3 3 SWIFT AG eWay Connectivity Map Properties Table 6 Connectivity Map InterAct Client Continued Name Description Required Value Priority Specifies the Swint_Priority The priority of delivery In the future SWIFTNet may implement
68. ession container has a fully populated pool with a steady pool size of 10 If 20 concurrent requests arrive for the RA connection component the container creates 10 additional instances to satisfy the burst of requests The advantage of this is that it prevents the container from blocking any of the incoming requests However if the activity dies down to 10 or fewer concurrent requests the additional 10 instances are discarded The configured default is 1 Max Pool Size Specifies the maximum pool size This number represents the maximum number of RA connections in the pool A value of 0 indicates that the pool is unbounded An integer indicating the maximum pool size A value of 0 indicates that the pool is unbounded The configured default is 32 SWIFTAlliance Gateway eWay User s Guide 42 Sun Microsystems Inc Chapter 3 Configuring the eWay Section 3 4 SWIFT AG eWay Environment Properties Table 15 Environment Connection Pool Settings Continued Name Description Required Value Max Wait Time Specifies the maximum wait time in milliseconds An integer indicating in Millis the maximum wait time This property maps to parameter max wait time in in milliseconds millis in sun ra xml which is specific for the Sun Java System Application Server or Sun SeeBeyond The configured default Integration Server see the corresponding is 60000 documentations for more information If an RA
69. gher level message and communication functions Right click the FileActClient or InterActClient node in the Collaboration to view the available methods to perform your business functions exchange message get file put file gueue access and so forth SWIFTAlliance Gateway eWay User s Guide 48 Sun Microsystems Inc Chapter 4 OTD Overview Figure 11 SAGOutboundeWay OTD Services Node si Services E FileActClient Q ai Response a Envelope Applicationld ApplicationStatus Contextid MsgFormat MsgRef E NameditemList Receiver Sender L Letter E interActClient ReguestPayload ai Response a Envelope Applicationld ApplicationStatus Contextid MsgFormat MsgRef si NameditemList Receiver Sender L Letter ResponsePayload Section 4 1 Introduction to SWIFT AG eWay OTD See the sample Projects for an example of how this OTD is used to create your business logic The prjSAGCert Project demonstrates several business functions with one Collaboration For directions on importing the prjSAGCert sample Project see Importing a Sample Project on page 52 SWIFTAlliance Gateway eWay User s Guide 49 Sun Microsystems Inc Chapter 5 Implementing a Project Using Java Collaboration Definitions JCD 5 1 This chapter provides an introduction to the SWIFTAlliance Gateway eWay s components and demonstrates on
70. gt File External System Name the External System esFile Click OK esFile is added to the Environment Editor 6 Right click envSAGFA and select New gt Logical Host LogicalHost1 is added to the Environment Editor 7 From the Environment Explorer tree right click LogicalHost1 and select New gt Sun SeeBeyond Integration Server A new Integration Server IntegrationSvr1 is added to the Environment Explorer tree under LogicalHost1 seeFigure 25 Figure 25 Environment Editor Repository HEAD kh F IntegrationSvrt E z esFile E LogicalHosti LS g IntegrationSvrt B i B esSAG 5 58 Configuring the eWays The prjSagFA Project uses three eWays each represented in the Connectivity Map as a node between an External Application and a Service see Figure 26 on page 67 eWays facilitate communication and movement of data between the external applications and the eGate system SWIFTAlliance Gateway eWay User s Guide 66 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing a Project Using Java Collaboration Definitions JCD Creating the prjSagFA Project Figure 26 eWay Properties Connectivity Map Outbound SWIFT AG eWay Inbound File eWay fe eaFileln jedSAGFA1 O Outbound File p eaFileOut Configuring the File eWay Properties eWay properties are set in both the Connectivity Map and the Environment Explorer Modify the File eWay Connectivity Map Properties 1 Double click t
71. he SWIFT AG eWay sample Project package SWIFT AG Sample zip to a local directory The SWIFT AG Sample zip file contains the following files Sample Projects prjSagFA zip prjSaglA zip prjSAGCert zip Sample input and output files input_SAG_PA_ txt in input_SAG_JA_ txt in outputSagFA1 dat outputSAGIA1 dat Working and primitive files for the sample Projects SAG Cert zip These files must be extracted to the Swift Remote API machine or the SWIFT AG server see Extracting the Working Files on page 53 Save and extract the SWIFT AG Sample zip to a local directory 2 Save any unsaved work before importing a Project 3 From the Enterprise Designer s Project Explorer pane right click the Repository and select Import from the shortcut menu The Import Manager appears SWIFTAlliance Gateway eWay User s Guide 52 Sun Microsystems Inc Chapter 5 Section 5 4 Implementing a Project Using Java Collaboration Definitions JCD Extracting the Working Files 4 Browse to the directory that contains the sample Project zip file Select the sample file for this sample SWIFT_AG_Sample_JCD zip and click Import After the sample Project is successfully imported click Close 5 Before an imported sample Project can be run you must do the following Create an Environment see Creating an Environment on page 66 Configure the eWays for your specific system see Configuring the eWays on page 66 Create
72. he SWIFTAlliance Gateway eWay Properties Using the Properties Editor SWIFTAlliance Gateway eWay Properties SWIFT AG eWay Connectivity Map Properties Envelope Primitive Control RemoteApi Base settings InterAct Client InterAct Client gt Store and Forward FileAct Client FileAct Client gt Store and Forward FileAct Client gt Get File FileAct Client gt Put File FileAct Client gt SnF Fetch File Connection Establishment SWIFT AG eWay Environment Properties Transport Connection Pool Settings Chapter 4 OTD Overview Introduction to SWIFT AG eWay OTD Configuration Node Constants Node Primitives Node Remote APIs Node Service Node Chapter 5 19 21 21 21 22 24 25 25 27 28 29 31 32 35 36 37 38 39 40 40 42 44 44 44 45 46 48 48 Implementing a Project Using Java Collaboration Definitions JCD SWIFT AG eWay Components The SWIFT AG eWay Sample Projects prjSagFA Sample Overview prjSaglA Sample Overview prjSAGCert Project SWIFTAlliance Gateway eWay User s Guide 50 50 51 51 51 52 Sun Microsystems Inc Contents Importing a Sample Project 52 Extracting the Working Files 53 Creating the prjSagFA Project 54 Creating a Project 54 Creating the Collaboration Definition 54 Using the Collaboration Editor Java 56 Creating the jcdSagFA Business Rules 56 Creating a Connectivity Map 63 Selecting the External Applications 63 Populating the Connectivity Map
73. he inbound FileIn eWay The Properties Editor opens to the inbound File eWay properties Modify the Inbound File eWay properties for your system including the settings in Table 17 and click OK Table 16 Inbound File eWay Settings Inbound eWay Connectivity Map Properties Input file name input_SAG_FA_ txt 2 In the same way open and modify the outbound File eWay properties for your system including the settings in Table 17 and click OK Table 17 Outbound File eWay Settings Outbound eWay Connectivity Map Properties Output file name outputSagFA d dat Modify the File eWay Environment Explorer Properties 1 From the Environment Explorer tree right click the File eWay External System esFile in this sample and select Properties from the shortcut menu The Properties Editor appears 2 Modify the File eWay Environment properties for your system including the settings in Table 18 and click OK Table 18 File eWay Environment Settings File eWay Environment Properties Inbound File eWay gt Parameter Settings Set as directed otherwise use the default settings Directory An input directory for example C temp Outbound File eWay gt Parameter Settings Set as directed otherwise use the default settings Directory An output directory for example C temp SWIFTAlliance Gateway eWay User s Guide 67 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing a
74. he maximum time in Blocking milliseconds to block a read milliseconds to block a read operation for Timeout operation example 60000 equals 1 minute The configured default is 60000 SWIFTAIliance Gateway eWay User s Guide 28 Sun Microsystems Inc Chapter 3 Configuring the eWay 334 InterAct Client This section maps to Primitive SwInt ExchangeRequest For parameters SwXXX under this section refer to the SNL specification for more detailed descriptions The InterAct Client section of the SWIFT AG eWay Connectivity Map properties contains the top level parameters displayed in Table 5 Section 3 3 SWIFT AG eWay Connectivity Map Properties Table 6 Connectivity Map InterAct Client Name Description Required Value User DN Specifies the SwSec_UserDN full The User DN distinguished name distinguished name used to identify and ending with o lt BIC8 gt o swift authenticate the principal Size is limited For example to 100 bytes cn dandrews o bankn14b o swift Requestor DN Specifies the Swint_Requestor used to The Requestor DN distinguished identify the Application entity name Size name ending with o lt SWIFTNet is limited to 100 bytes institution BIC 8 gt o swift For example ou management o bankn14b o swift Responder Specifies the Swint_Responder used to The Responder DN distingusihed DN identify the intended responder Size is name ending with o lt SWIFTNet limited to 100 byt
75. he property field provides space to type in the value and an ellipsis button Click on the ellipsis in the properties field to open a separate configuration dialog box This is helpful for entering large values that cannot be fully displayed in the parameter s property field Enter the property value in the dialog box and click OK The value is now displayed in the property field SWIFTAlliance Gateway eWay User s Guide 2 Sun Microsystems Inc Chapter 3 Section 3 2 Configuring the eWay SWIFTAlliance Gateway eWay Properties 4 A description of each parameter is displayed in the Description pane when that parameter is selected providing an explanation of any required settings or options 5 The Comments pane provides an area for recording notes and information regarding the currently selected parameter This is saved for future reference 6 After modifying the configuration properties click OK to close the Properties Editor and save the changes 32 SWIFTAlliance Gateway eWay Properties The SWIFT AG eWay s Properties are organized as follows SWIFT AG eWay Connectivity Map Properties on page 25 SWIFT AG eWay Environment Properties on page 40 Important Modifying individual OTD configuration settings can override the default eWay OTD configuration settings Note For more information on SWIFTAlliance Gateway configration properties in the context of SWIFTAlliance Gateway refer to the SWIFTAlliance Gateway and SNL
76. he top level parameters displayed in Table 7 Table 9 Connectivity Map FileAct Client gt Store and Forward Name Description Required Value Queue Name Specifies the SwInt_Queue For example The User Swint_Queue To Acquire ptsauszz_generic x Size is limited to 30 For example ptsauszz_generic x bytes Force Specifies the Sw_ForceAcquire Indicates Select TRUE or FALSE True indicates Acquire whether an acquisition request must be Indicates if an acquisition request must accepted if a queue is already acquired be accepted The configured default is TRUE Session Mode Specifies the usage mode of the queue This property is purposely disabled The default setting is Pull Pull is the correct setting for client mode Note This property is purposely disabled Order By Specifies the Sw_OrderBy Indicates the Select InterAct blank FileAct or order priority in which the messages are Urgent retrieved on the queue The options are The configured default is FileAct InterAct Blank indicates FIFO first in first out FileAct Urgent Recovery Specifies the Sw_RecoveryMode Select TRUE or FALSE True indicates Mode Indicates whether the session must be that the session must be opened in opened in recovery mode Messages that recovery mode already have an output sequence number are sent first before considering The configured default is FALSE the selected order
77. heck the Collaboration for errors 15 Save your current changes to the repository For more information on how to create Business Rules using the Collaboration Editor see the Sun SeeBeyond eGate Integrator User s Guide 554 Creating a Connectivity Map The Connectivity Map provides a canvas for assembling and configuring a Project s components 1 From the Project Explorer tree right click the new prjSagFA Project and select New gt Connectivity Map from the shortcut menu 2 The New Connectivity Map appears and a node for the Connectivity Map is added under the Project on the Project Explorer tree labeled CMap1 Rename the Connectivity Map to cmSAGFA Selecting the External Applications In the Connectivity Map eWays are associated with External Applications For example to establish a connection to an external SWIFTAlliance Gateway application you must first select SAG External Application as an External Application to use in your Connectivity Map see Figure 22 Figure 22 Connectivity Map External Applications GO amp E 0e E File External Application Scheduler 1 Click the External Application icon on the Connectivity Map toolbar SWIFTAlliance Gateway eWay User s Guide 63 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing a Project Using Java Collaboration Definitions JCD Creating the prjSagFA Project 2 Select the External Applications that are necessary to c
78. his Release SWIFT AG Object Type Definition exposes SWIFTNet methods and attributes for use within a Java Collaboration to perform connectivity and business logic In addition to the OTD the SWIFT AG eWay provides Connectivity Map and External System configuration for design time configuration SWIFT AG eWay Features The 5 1 2 SWIFT AG eWay includes the following features Supports InterAct and FileAct Services in client mode with both Real Time and Store and Forward messaging Supports both synchronous and asynchronous operation modes Provides support for all the SWIFTNet Link SNL Primitives Supports dynamic configuration of InterAct and FileAct primitive attributes from the Java Collaboration Editor Supports dynamic configuration of SWIFT AG Remote API transport properties SAGOutboundeWay Object Type Definition The eWay provides a SWIFTAlliance Gateway specific OTD Object Type Definition which exposes methods attributes and configuration properties When it is incorporated in a Java Collaboration the SAGOutboundeWay OTD allows you to build powerful business logic into your Projects The SAGOutboundeWay OTD is comprised of the following nodes Configuration enables dynamic configuration of the eWay at runtime Constants provides various SNL constants Primitives provides all of the SNL Primitives for advanced users RemoteApis provides user access to the Remote API s client APIs Services provide
79. hysicalName C temp SAG_Cert testFile4ToSnF txt SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw_LogicalName testFile4ToSnF SAGOutboundeWay_1 getConfiguration getFileActClient setSwInt_NRIndicator SAGOutboundeWay 1 getConstants getSw Boolean getTRUE SAGOutboundeWay 1 getConfiguration getFileActClient setSwInt ReguestCrypto SAGOutboundeWay_1 getConstants getSw Boolean getTRUE SAGOutboundeWay 1 getServices getFileActClient put SAGOutboundeWay 1 getConfiguration getFileActClient setSwInt ReguestCrypto SAGOutboundeWay 1 getConstants getSw Boolean getFALSE SAGOutboundeWay 1 getConfiguration getFileActClient setSwInt NRIndicator SAGOutboundeWay_1 getConstants getSw_Boolean getFALSE track OK msg r n r n transactionSeg Scenario 6 SAG Cert FetchFile track msg msg r n r n Wait a while for SwiftNet SnF Queue access track msg Thread sleep 10000 track OK msg r n r n transactionSeq Scenario 6 1 SAG_Cert FetchFile 1st file track msg SAGOutboundeWay_1 getServices getFileActClient snfAcquire SAGOutboundeWay_1 getServices getFileActClient snfPull SAGOutboundeWay_1 getConfiguration getFileActClient getSnFFetchFile setSw_PhysicalName C temp SAG_Cert fetchlFromSnF txt SAGOutboundeWay_1 getServices getFileActClient
80. imitives SnlPrimitives Sw_ExchangeFileRequest to FileClient_1 Text rule A SWIFTAlliance Gateway eWay User s Guide From the Business Rules toolbar click the rule icon to add a new rule under receive on the Business Rules tree From the Business Rules Designer toolbar click the Class Browser icon The Class Browser dialog box appears From the Class Browser select Date as the class java util as the package and Date as the constructor Click Select The Date constructor box is added to the Business Rules Designer mapping canvas From the Business Rules Designer s Math menu select Add The Add box appears From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter r n as the Literal value Map the r n output node of the String Literal box to the Valuel input node of the Add box Map the result Date output node of the Date constructor box to the value2 input node of the Add box From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter ExchangeFileRequest r n as the Literal value Map the ExchangeFileRequest r n output node of the second String Literal box to the Value3 input node of the Add box 59 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing a Project Using Java Collaboration Definitions JCD Creating the prjSagFA Project J Map Sw_ExchangeFileRequest under Primitives gt SnlPrimitive
81. in the U S and other countries exclusively licensed through X Open Company Ltd This product is covered and controlled by U S Export Control laws and may be subject to the export or import laws in other countries Nuclear missile chemical biological weapons or nuclear maritime end uses or end users whether direct or indirect are strictly prohibited Export or reexport to countries subject to U S embargo or to entities identified on U S export exclusion lists including but not limited to the denied persons and specially designated nationals lists is strictly prohibited Copyright 2006 Sun Microsystems Inc 4150 Network Circle Santa Clara California 95054 Etats Unis Tous droits r serv s Sun Microsystems Inc d tient les droits de propri t intellectuels relatifs a la technologie incorpor e dans le produit qui est d crit dans ce document En particulier et ce sans limitation ces droits de propri t intellectuels peuvent inclure un ou plus des brevets am ricains list s a l adresse http www sun com patents et un ou les brevets suppl mentaires ou les applications de brevet en attente aux Etats Unis et dans les autres pays L utilisation est soumise aux termes de la Licence Cette distribution peut comprendre des composants d velopp s par des tierces parties Sun Sun Microsystems le logo Sun Java Sun Java Composite Application Platform Suite Sun SeeBeyond eGate elnsight eVision eTL eXchange eView elndex eBAM et
82. inding dialog box appears using the jcdSagFA Rule 2 From the cmSagFA_jcdSagFA binding dialog box drag FileClient Input under Implemented Services to the output node of the eaFileIn File External SWIFTAlliance Gateway eWay User s Guide 64 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing a Project Using Java Collaboration Definitions JCD Creating the prjSagFA Project Application A link now appears between the jcdSAGCert binding dialog box and the eaFileIn eWay 3 From the cmSagFA_jcdSagFA binding dialog box drag FileClient_1 under Invoked Services to the input node of the FileOut External Application 4 From the cmSagFA_jcdSagFA dialog box drag SAGOutboundeWay_1 under Invoked Services to the input node of the eaSAG External Application see Figure 24 Figure 24 Connectivity Map Binding the Projects Components fe eaFileln eaFilelnjeaFileln_craSagF A_icdSagF A Le cmSagFA jcdSagFA Rule licdSagFA Implemented Services Invoked Services FileClient input lu SAGOut SAGOut FileClient FileClie cmSagFA_jcdSagFA cmSagFA_jcdSagFA_eaFileOut P a 5 Save your current changes to the Repository 556 Using the Connectivity Map Generator The Connectivity Map Generator provides an alternative to manually populating and Binding the Connectivity Map components The Connectivity Map Generator populates the Connectivity Map and binds the components using the information provided by your J
83. ine at the time of transmission Messages are delivered when the recipient is ready to receive it Store and Forward is an ideal way to send individual instructions confirmations and reports to large numbers of correspondents some of which may be in different time zones Real time File Transfers Real time messaging provides a lower cost alternative to store and forward for files that are destined for correspondents that are online at the time of transmission This makes it ideal for sending files to a few large correspondents or market infrastructures Note For more information regarding SWIFTNet SWIFTAlliance Gateway and InterAct and FileAct services see the SWIFTNet Service Design Guide and SWIFTAlliance Gateway Operations Guide 12 About the SWIFT Alliance Gateway eWay The Sun SeeBeyond eWay Adapter for SWIFTAlliance Gateway referred to as the SWIFT AG eWay throughout this guide enables the Sun Java Composite Application Platform Suite to communication with SWIFTAlliance Gateway 5 0 The SWIFT AG eWay is comprised of the following components Connector module a JCA 1 5 Resource Adapter allows you to exchange messages or files across SWIFTNet SWIFT s secure IP network NetBeans module incorporates the eWay into Java CAPS and provides necessary design time and runtime functionality within the Suite SWIFTAlliance Gateway eWay User s Guide 8 Sun Microsystems Inc Chapter 1 Section 1 3 Introduction What s New in T
84. k r n Start of remote test for SAG Certification AN Ver track 00820 10 AE HA RH HER HEAR HER HER HE HAE HAE HEAR AM track r n r nStart of collaboration from SAG Cert java util Date startTime new java util Date java text SimpleDateFormat format new java text SimpleDateFormat dd MM yyyy HH mm ss SSS String from format format startTime msg r n r n transactionSeg Scenario 1 SAG Cert RealTime InterAct swift cte track msg msg r n r n transactionSeg Scenario 1 1 SAG Cert RT IA cte Sync track msg SAGOutboundeWay 1 getServices getInterActClient setRequestPayload msg SAGOutboundeWay_1 getServices getInterActClient sendAndReceive track OK msg r n r n Got InterAct ResponsePayload SAGOutboundeWay_1 getServices getInterActClient getResponsePayload track msg msg r n r n transactionSeq Scenario 1 2 SAG Cert RT IA swift cte ASync track msg msg r n r n transactionSeg Scenario 1 2 1 SAG Cert RT IA cte ASync send ist req track msg SAGOutboundeWay 1 getServices getInterActClient setRequestPayload msg long t1 SAGOutboundeWay_1 getServices getInterActClient sendRequest track t1 token OK msg r n r n transactionSeg Scenario 1 2 2 SAG Cert RT IA cte ASync send 2nd req track msg SAGOutboundeWay_1 getServices getInterA
85. lick Next 4 For Step 2 of the wizard click the Add All button to move all installable files to the Include in Install field then click Next 5 For Step 3 of the wizard wait for the modules to download then click Next 6 The wizard s Step 4 window displays the installed modules Review the installed modules and click Finish 7 When prompted restart the IDE Integrated Development Environment to complete the installation SWIFTAlliance Gateway eWay User s Guide 14 Sun Microsystems Inc Chapter 2 Section 2 2 Installing the eWay Installing the SWIFT AG eWay 222 Installing eWay Enterprise Manager plug ins The Sun SeeBeyond Enterprise Manager is a Web based interface that allows you to monitor and manage your Suite applications The Enterprise Manager requires an eWay specific plug in for each of your installed eWays These plug ins enable the Enterprise Manager to target specific alert codes for each eWay type as well as to start and stop the inbound eWays The Sun Java Composite Application Platform Suite Installation Guide describes how to install the Sun SeeBeyond Enterprise Manager The Sun SeeBeyond eGate Integrator System Administration Guide describes how to monitor servers Services logs and alerts using the Sun SeeBeyond Enterprise Manager and the command line client The eWay Enterprise Manager plug ins are available from the List of Components to Download under the Installer s DOWNLOADS tab There a
86. load lt Response gt lt ComRes gt lt Result gt lt Result gt lt OutXmitTime gt lt OutXmitTime gt lt OutInt gt 0 lt OutInt gt lt ComRes gt lt Response gt Scenario 1 2 InterAct Real Time asynchronous swift cte Scenario 1 2 1 InterAct Real Time asynchronous cte send 1st request 3 token Scenario 1 2 2 InterAct Real Time asynchronous cte send 2nd request 4 token Scenario 1 2 3 InterAct Real Time asynchronous cte receive 1st response 3 Scenario 1 2 4 InterAct Real Time asynchronous cte receive 2nd response 4 Scenario 1 3 InterAct Real Time cte signed request Scenario 2 FileAct Real Time get file Scenario 2 1 FileAct RealTime get file swift cte Scenario 2 2 to be continued on 2 6 FileAct RealTime get 1 MB file non blocking asynchronous SWIFTAlliance Gateway eWay User s Guide 84 Sun Microsystems Inc Appendix A Section A 1 Sample prjSAGCert Project Overview The prjSAGCert Sample Project Collaboration Scenario 2 3 File Act RealTime synchronous get file Scenario 2 4 File Act RealTime get file signed request and flagged urgent Scenario 2 5 File Act RealTime get file with Non Repudiation Scenario 2 6 continued on 2 2 FileAct RealTime get of 1 MB file non blocking asynchronous and check transfer status Scenario 3 FileAct RealTime put file Scenario 3 1 to be continued on 3 5 FileAct RealTime put 1 MB file non blocking asynchronous Scenario 3 2 FileAct RealTime put file blocking synchronous Sce
87. lue4 Starting collab of SAG FAi n s result 80 8479 SX Beooleany Comparisons Elmath object A String lilAray 8 Operators Assignment lt jedSAGFA Gap O FileClient_1 3 ByteArray Gi Encoding Text input WE SAGOutbounde ay_1 LE 4 The FileClient_1 write rule writes data value to the file Create the FileClient_1 write rule A From the Business Rules toolbar click the rule icon to add a new rule B Right click FileClient_1 in the left pane of the Business Rules Designer and click Select method to call from the shortcut menu C Select write from the method selection window The write method box appears see Figure 18 Figure 18 Java Collaboration Editor jcdSagFA Business Rules Business Rules Designer 8D SX Beooleany Comparisons Elmath Objecte AStringy Hilaray fOperators Assignment FileClient_1 write o DateTime D jodSAGFA IS FileClient 1 om ByteArray Encoding L Text Z input Z SAGOutboundewWay_1 jedSAGFA jedSAGFA Gye FileClient_1 5 input WE SAGOutboundewWay_1 S O O O O 5 The SAGOutboundeWay_1 Services FileActClient get rule connects to the FileAct Client service Create the SAGOutboundeWay_1 Services FileActClient get rule A From the Business Rules toolbar click the rule icon to add a new rule B Right click FileActClient under SAGOu
88. n getFALSE SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw_TransferDescription msg SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw_PhysicalName C temp SAG_Cert testFilelToFTA_1MB txt SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw_LogicalName testFilelToFTA 1MB String putTransferRef31 SAGOutboundeWay 1 getServices getFileActClient put SWIFTAlliance Gateway eWay User s Guide 88 Sun Microsystems Inc Appendix A Section A 1 Sample prjSAGCert Project Overview The prjSAGCert Sample Project Collaboration SAGOutboundeWay 1 getConfiguration getFileActClient setBlockFileTransfer SAGOutboundeWay_1 getConstants getSw Boolean getTRUE track putTransferRef31 OK msg r n r n transactionSeg Scenario 3 2 SAG Cert RT FA Put Blocking Sync track msg SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw TransferDescription msg SAGOutboundelay_1 getConfiguration getFileActClient getPutFile setSw_PhysicalName C temp SAG_Cert testFile2ToFTA txt SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw_LogicalName testFile2ToFTA SAGOutboundeWay 1 getServices getFileActClient put track OK msg r n r n transactionSeg Scenario 3 3 SAG Cert RT FA Put Signed track msg SAGOutboundeWay 1 getC
89. n to implement Select OTDs Name 5AGOutboundeWay Type Object Type Definition Add Selected OTDs OTD Instance Name SeeBeyond eWays File FileClient FileClient_1 SeeBeyond evVays SAG SAGOutboundevWay SAGOutboundevVay_1 Remove lt Back Next gt LEinish_ Cancel Help 6 Click Finish The Collaboration Editor Java appears in the right pane of the Enterprise Designer with the new jedSagFA Collaboration SWIFTAlliance Gateway eWay User s Guide 55 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing a Project Using Java Collaboration Definitions JCD Creating the prjSagFA Project 553 Using the Collaboration Editor Java The next step in the sample is to create the Business Rules of the jcdSagFA Java Collaboration using the Collaboration Editor Creating the jcdSagFA Business Rules The jedSagFA Collaboration contains the Business Rules displayed in Figure 15 GA icdSAGFA CAR receive Copy n new Date Starting collab of SAG FAMn to FileClient_1 Text lt gt FileClient_1 write lt gt SAGOutboundeWay_1 Semices FileActClient get Copy Win new Date ExchangeFileRequest n SAGOutboundeWay_1 Primitives SnlPrimitives Sw_ExchangeFileRequest to FileClient_1 T ext lt gt FileClient_1 write Copy n new Date ExchangeFileResponsel n SAGOutboundeWay_1 Primitives SnlPrimitives Sw_ExchangeFileResponse to File
90. nario 3 3 FileAct RealTime put file signed request Scenario 3 4 File Act RealTime put file Non Repudiation Scenario 3 5 continued on 3 1 FileAct RealTime put 1 MB file non blocking asynchronous and check transfer status Scenario 4 Store amp Forward Queue Non Recovery mode Scenario 5 FileAct Delivery Notification Queue Scenario 5 1 File Act given Delivery Notification Queue 1st file Scenario 5 2 File Act given Delivery Notification Queue 2nd file Scenario 5 3 File Act given Delivery Notification Queue signed request 3rd file Scenario 5 4 File Act given Delivery Notification Queue with Non Repudiation 4th file Scenario 6 Fetch file Wait a while for SwiftNet Store amp Forward Queue access Scenario 6 1 Fetch file 1st file Scenario 6 2 Fetch file 2nd file Scenario 6 3 Fetch file 3rd file Scenario 6 4 Fetch file Non Repudiation 4th file Scenario 7 Store amp Forward messages from Queue in Recovery Mode Scenario 8 InterAct given Delivery Notification Queue Scenario 8 1 InterAct given Delivery Notification Queue 1st file Scenario 8 2 InterAct given Delivery Notification Queue 2nd file Scenario 8 3 InterAct given Delivery Notification Queue signed request 3rd file Scenario 9 Pull messages from Queue Wait a while for SwiftNet Store amp Forward Queue access Scenario 9 1 Pull messages from Queue 1st file Scenario 9 2 Pull messages from Queue 2nd file SWIFTAlliance Gateway eWay User s Guide 85 Sun Microsystems Inc
91. ndeWay 1 getRemoteApis getClient call track OK String log SAGOutboundeWay 1 getRemoteApis getClient getResponse getLetter int idx log length gt 8192 log length 8192 0 msg r n r n Got Event Log for this set of tests r n log substring idx track msg msg r n r n r n Total number of request response test interactions transactionSeq track msg track r n r n r nEnd of collaboration from SAG_Cert r n r n r n r n track 00820 10 ICICI ICICI HAE IOI CCI IOI IOC IOI IM track r n End of remote test for SAG Certification FE F track WA DALE RRR RRR RRR RRR ER ERE RE RE RE RE RE REREREREREREKEREKEREE I Nn r n r n r n private void track String msg throws Exception logger info msg msg msg at time new java util Date file setText msg file write SWIFTAlliance Gateway eWay User s Guide 92 Sun Microsystems Inc Index Index A Always Create New Connection 39 Application ID 25 configuring 19 Message Partner 19 Ask Positive Delivery Notification 30 33 Auto Disconnect Connection 39 B binding eWay components 64 Block File Transfer 34 Business Rules comments creating 56 creating 56 73 C CA Certificate 41 Client Handle Timeout 28 Collaboration Definitions creating 54 72 Java 54 72 Collaboration Editor Java 56 72 configuring the eWay properties 21 configuring the JNI por
92. ndeWay_1 getConfiguration getFileActClient setSwInt ReguestCrypto SAGOutboundeWay_1 getConstants getSw_Boolean getFALSE SAGOutboundeWay_1 getConfiguration getFileActClient setSwInt_Priority SAGOutboundeWay_1 getConstants getSwInt_Priority getNormal track OK msg r n r n transactionSeq Scenario 2 5 SAG Cert RT FA Get generic fa x Non Rep track msg SAGOutboundeWay_1 getConfiguration getFileActClient getGetFile setSw_TransferDescription msg SAGOutboundeWay_1 getConfiguration getFileActClient setSwInt_NRIndicator SAGOutboundeWay_1 getConstants getSw_Boolean getTRUE SAGOutboundeWay_1 getConfiguration getFileActClient getGetFile setSw_PhysicalName c temp SAG_Cert getDownload5FromFTA txt SAGOutboundeWay_1 getConfiguration getFileActClient getGetFile setSw_LogicalName downloadFile5 txt SAGOutboundeWay_1 getServices getFileActClient get SAGOutboundeWay_1 getConfiguration getFileActClient setSwInt_NRIndicator SAGOutboundeWay_1 getConstants getSw_Boolean getFALSE track OK msg r n r n transactionSeg Scenario 2 6 continued on 2 2 SAG_Cert RT FA Get generic fa x Non Blocking ASync 1MB file CheckTransferStatus on getTransferRef22 track msg for int i 0 i lt 100 i String status SAGOutboundeWay_1 getServices getFileActClient checkFil
93. ness Rules can be written using the Collaboration Editor Java Creating the jcdSaglA Collaboration Definition The jedSAGIA Collaboration defines transactions from the inbound File eWay to the SWIFT AG eWay and the outbound File eWay 1 From the Project Explorer right click your new Project and select New gt Collaboration Editor Java from the shortcut menu The Collaboration Definition Wizard Java appears 2 Enter a Collaboration Definition name for this sample jedSAGIA and click Next 3 For Step 2 of the wizard from the Web Services Interfaces selection window double click Sun SeeBeyond gt eWays gt File gt FileClient gt receive The File Name field now displays receive Click Next 4 For Step 3 of the wizard from the Select OTDs selection window double click Sun SeeBeyond gt eWays gt File gt FileClient The FileClient_1 OTD is added to the Selected OTDs field 5 Click Up One Level to return to the Repository From the Select OTDs selection window double click Sun SeeBeyond gt eWays gt SAG gt SAGOutboundeWay The SAGOutboundeWay_1 OTD is added to the Selected OTDs field 6 Click Finish The Collaboration Editor Java appears in the right pane of the Enterprise Designer with the new jcdSagIA Collaboration 563 Using the Collaboration Editor Java The next step in the sample is to create the Business Rules of the jedSAGIA Java Collaboration using the Collaboration Editor SWIFTAlliance Gateway eWay
94. ng on a remote computer or from a SWIFTNet application existing on the computer where SWIFTAlliance Gateway is installed Using Remote API applications developed to run directly on top of SNL software can use SWIFTAlliance Gateway transparently as a concentrator for their SWIFTNet traffic thereby implementing the single window concept RA offers two sets of APIs SWIFTNet Link specific and SWIFTAlliance Gateway specific Message flow from an RA instance to SWIFTAlliance Gateway is managed by the Remote API Host Adapter RAHA a sub component of SWIFTAlliance Gateway s Application Interface AI For more information on configuration scenarios see the SWIFTAlliance Gateway Remote API Operations Guide 114 SWIFTNet Messaging Services SWIFTNet offers four messaging services SWIFTNet InterAct FileAct Browse and FIN Of these four the SWIFTAlliance Gateway specifically addresses FileAct and InterAct in client mode with both Real Time and Store and Forward transfers SWIFT Net InterAct SWIFTNet InterAct provides secure and reliable exchange of individual structured financial messages SWIFT customers messaging requirements vary from customer to customer but also from message to message SWIFTNet InterAct offers you a broad range of telecommunication modes Store and Forward Messaging SWIFTNet InterAct s store and forward capability is designed for messages that are destined for a large number of correspondents many of whom may
95. nlPrimitives Sw ExchangeFileResponse to FileClient 1 Text rule gets the Primitive value File Response from the SAG server and includes the time stamp Create the Copy r n new Date ExchangeFileResponse r n SAGOutboundeWay_1 Primitives SnlPrimitives Sw_ExchangeFileResponse to FileClient 1 Text rule A From the Business Rules toolbar click the rule icon to add a new rule B From the Business Rules Designer toolbar click the Class Browser icon The Class Browser dialog box appears C From the Class Browser select Date as the class java util as the package and Date as the constructor Click Select The Date constructor box is added to the Business Rules Designer mapping canvas D From the Business Rules Designer s Math menu select Add The Add box appears E From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter r n as the Literal value F Map the r n output node of the String Literal box to the Valuel input node of the Add box SWIFTAlliance Gateway eWay User s Guide 60 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing a Project Using Java Collaboration Definitions JCD Creating the prjSagFA Project G H Map the result Date output node of the Date constructor box to the value2 input node of the Add box From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter Exchang
96. not be online at the time of transmission It removes the uncertainty and inconvenience of worrying about SWIFTAlliance Gateway eWay User s Guide 7 Sun Microsystems Inc Chapter 1 Section 1 2 Introduction About the SWIFT Alliance Gateway eWay whether or not your correspondents are on line at the time you send the message The message is delivered as soon as the recipient is ready to receive it As a result it provides an ideal way to send individual instructions confirmations and reports to large numbers of correspondents some of whom may be in different time zones Real Time Messaging Real time messaging offers a low cost alternative to store and forward for messages which are destined for correspondents that are online at the time of transmission As a result it is ideal for sending individual instructions confirmations and reports to a few large correspondents or for messages to market infrastructures SWIFTNet FileAct SWIFTNet FileAct provides secure and reliable transfer of files such as batches of structured financial messages or large reports Typical applications include repetitive credit transfers such as pension or salary payments securities value added information and reporting and regulatory reporting SWIFTNet FileAct offers a variety of messaging modes Store and Forward File Transfers SWIFTNet FileAct s store and forward capability ensures that your correspondents receive your message whether or they are onl
97. nsport information Host Name Specifies the name or IP address of the The host name or IP address host to which you are connecting SWIFTAlliance Gateway eWay User s Guide 40 Sun Microsystems Inc Chapter 3 Configuring the eWay Section 3 4 SWIFT AG eWay Environment Properties Table 14 Environment Transport Continued Name Description Required Value Port Number Specifies the port number of the SAG host to which the RA connects The port number of the SAG host to which the RA connects The configured default is 48002 Ftla Port Specifies the Ftla port number the The Ftla port number Number number of the port on the SAG host through which File Transfers will take The configured default is 48003 place Server DN Specifies the Server DN Distinguished The Server DN Name used for SWIFTAlliance Gateway authentication CA Certificate Specifies the file that contains the The CA Certificate Certification Authority CA certificate SSL Mode Specifies whether the current True or False depending upon whether connection is using data encryption SSL data encryption is used True indicates that encryption is used The configured default is True SWIFTAlliance Gateway eWay User s Guide 41 Sun Microsystems Inc Chapter 3 Configuring the eWay Section 3 4 SWIFT AG eWay Environment Properties 342 Connection Pool Settings The Connection Pool Setting
98. nt Profile Auto Map Environment envSAGFA B MapYVariables f Build M Deploy Jeb cmSagFA_jcdSagFA gt 1 eaFileln gt cmSagF jedSagF cmSagF jedSagF gt eaFileOut EJ emSagFA jedSagFA gt eaSAG 4 The Project s components are automatically mapped to their system windows as seen in Figure 28 Figure 28 Deployment Profile B eaFileln gt cmSagFA_jcdSagFA B emSagFA jedSagFA gt eaFileOut r n Ed emSagFA jedSagFA gt eaSAG She e IntegrationSvrt L feb cmSagFA jedSagFA 5 Click Activate When activation succeeds save the changes to the Repository 55 11 Initializing your Remote API Initialize start the Remote API instance on your JavaCAPS Integration Server IS host prior to starting the JavaCAPS Integration Server and deploying your Project Running the JavaCAPS IS on top of the RA fulfills the required environment variables For directions see Installing and Initializing the SWIFT AG Remote APIs on page 18 55 12 Creating and Starting the Domain To deploy your Project you must first create a domain A domain is an instance of a Logical Host Create and Start the Domain 1 Navigate to your lt JavaCAPS51 gt logicalhost directory where lt JavaCAPS51 gt is the location of your Sun Java Composite Application Platform Suite installation 2 Double click the domainmgr bat file The Domain Manager appears
99. ntains the latest information on Supported Operating Systems System Reguirements External System Requirements The SWIFT AG eWay Readme is uploaded with the eWay s documentation file SwiftAGeWayDocs sar and can be accessed from the Documentation tab of the Sun Java Composite Application Platform Suite Installer Refer to the SWIFT AG eWay Readme for the latest requirements before installing the SWIFT AG eWay 22 Installing the SWIFT AG eWay The Sun Java Composite Application Platform Suite Installer a web based application is used to select and upload eWays and add on files during the installation process The following section describes how to install the components required for this eWay SWIFTAlliance Gateway eWay User s Guide 13 Sun Microsystems Inc Chapter 2 Section 2 2 Installing the eWay Installing the SWIFT AG eWay 221 Installing the eWay on a JavaCAPS Supported System Follow the directions for installing the Sun Java Composite Application Platform Suite in the Sun Java Composite Application Platform Suite Installation Guide After you have installed eGate do the following 1 From the Installer s Select Sun Java Composite Application Platform Suite Products to Install table Administration tab expand the eWay option 2 Select the products for your Suite and include the following FileeWay the File eWay is used by most sample Projects SwiftAGeWay To upload the SWIFT AG eWay User s G
100. o a Business Rule avoiding possible case or spelling errors SWIFTAlliance Gateway eWay User s Guide 45 Sun Microsystems Inc Chapter 4 Section 4 1 OTD Overview Introduction to SWIFT AG eWay OTD Figure 8 SAGOutboundeWay OTD Constants Node ai Constants rt EnvelopeApplicationStatus aa EnvelopehsgF ormat SagBasicinterAct SagDefault SagPrimitive SagRelaxedSNL SagSNL o m Sw_AcceptStatus om Sw AcguiredStatus i Sw Boolean om Sw DeliveryStatus GH Sw DigestAlgorithm om Sw_OrderBy om Sw Sessionttode om Sw_SessionStatus i Sw_SnFRetType om Sw_TransferAnawer om Sw TransferDirection i Sw TransferSide Ed Sw TransterStatus om Sw TransferType B Sw6bl Severity i Swlnt Deliveryhtode E Swlnt NRType E Swlnt Priority EF Swlnt ValResult Primitives Node The Primitives node provides the full set of SNL Primitives as defined by the SNL specification For information regarding any of the SNL Primitives refer to the SWIFTAlliance Gateway Documentation The SNL Primitives node and sub nodes are displayed in Figure 9 on page 47 Advanced users can construct their own Primitives and send the Primitive using the SWIFT AG eWay API directly communicating with SWIFTNet Once they get a response to their reguest they can parse the response based on their Primitives The parser is provide in the OTDs Primitives section The response can be dragged to the appropriate node to pars
101. onfiguration getFileActClient setSwInt ReguestCrypto SAGOutboundeWay_1 getConstants getSw Boolean getTRUE SAGOutboundeWay 1 getConfiguration getFileActClient getPutFile setSw TransferDescription msg SAGOutboundeWay 1 getConfiguration getFileActClient getPutFile setSw PhysicalName C temp SAG_Cert testFile3ToFTA txt SAGOutboundeWay 1 getConfiguration getFileActClient getPutFile setSw LogicalName testFile3ToFTA String transferRef31 SAGOutboundeWay 1 getServices getFileActClient put SAGOutboundeWay_1 getConfiguration getFileActClient setSwInt_RequestCrypto SAGOutboundeWay_1 getConstants getSw_Boolean getFALSE track OK msg r n r n transactionSeq Scenario 3 4 SAG Cert RT FA Put Non Rep track msg SAGOutboundeWay_1 getConfiguration getFileActClient setSwInt_NRIndicator SAGOutboundeWay_1 getConstants getSw_Boolean getTRUE SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw_TransferDescription msg SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw_PhysicalName C temp SAG_Cert testFile4ToFTA txt SAGOutboundeWay_1 getConfiguration getFileActClient getPutFile setSw_LogicalName testFile4ToFTA SAGOutboundeWay_1 getServices getFileActClient put SAGOutboundeWay_1 getConfiguration getFileActClient setSwInt_NRIndicator SAGOutboundeWay
102. oundeWay_1 2 Configuration irs Constants E Primitives ag RemoteApis lng Services E FileActClient E InterActClient er Response a gt ResponsePayload 5 The SAGOutboundeWay 1 Services InterActClient sendAndReceive rule uses the sendAndReceive method to send the payload Create the SAGOutboundeWay 1 Services InterActClient sendAndReceive rule A From the Business Rules toolbar click the rule icon to add a new rule to the Business Rules tree B From the left pane of the Business Rules Designer right click InterActClient and click Select method to call from the shortcut menu C From the method selection box double click sendAndReceive The sendAndReceive method box appears see Figure 32 Figure 32 Java Collaboration Editor jcdSAGIA Business Rules Business Rules Designer 80 82 X Beooleany Comparson Math gt oObjectr AStringy Hilaray Operators Assignment GB jedSAGIA IS FileClient 1 9 M input SAGOutboundeWay_1 a Configuration 9 E Constants a Primitives o Gi RemoteApis O Gi Services ta FileActClient Ge InterActclient RequestPayload om Response ResponsePayload jedsacia SAGOutboundelay_1 Services InterActClient sendAndReceive jedSAGIA Gah O FileClient_1 IZ input SAGOutboundeWay_1 g Configuration a Constants a 9 Primitives a RemoteApis ier Services E
103. own your Project As displayed in Figure 7 the Configuration section of the OTD is a Java representation of the SWIFT AG eWay Configuration file For more information regarding any of these configuration parameters refer to the corresponding property in Properties Chapter Configuring the eWay on page 21 displays The Configuration section with the expanded FileActClient node and sub nodes is displayed in Figure 7 on page 45 SWIFTAlliance Gateway eWay User s Guide M Sun Microsystems Inc Chapter 4 OTD Overview Section 4 1 Introduction to SWIFT AG eWay OTD Figure 7 SAGOutboundeWay OTD Configuration Node m Configuration o ai ConnectionEstablish Bd FileActClient HOW Constants Node Om BlockFileTransfer E GetFile Ei PutFile ReceivehlodeConfig E SnFFetchFile a SnF ToAcquire 9000990000000 Sw DeliveryNotif Sw TransferEP Swint_DeliversyMode Swint_NotifQueue Swilnt_NRindicator Swulnt_Priority Swint_RequestC rypto Swlnt Reguestor Swlnt ReguestRef Swlnt ReguestType Swlnt Responder Swlnt Service SwSec_UserDN E InterActClient GS PrimitiveControl ai RemoteApiBase ai SagEnvelope a SagTransport The Constants node provides a convenient way to select SNL related constants Constants are literal values that have a name see Figure 8 on page 46 OTD Constants are presented in the Collaboration Editor so that you can simply drag and drop the Constant t
104. oy the Project 1 From the Deployment Editor toolbar click the Deploy icon Click Yes when the Deploy prompt appears 2 A message appears when the project is successfully deployed 5 5 14 Running the Project To run your deployed sample Project do the following 1 From your configured input directory paste or rename the sample input file to trigger the eWay The trigger input file input_SAG_FA txt is picked up by the file eWay 2 The processed output file is published to your output directory Verify the output data A sample output data file outputSAGFA1 dat is included in the sample package download for comparison SWIFTAlliance Gateway eWay User s Guide 71 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing a Project Using Java Collaboration Definitions JCD The prjSaglA Sample Project s6 The prjSaglA Sample Project The prjSaglA Sample Project is similar to the prjSagFA Project but uses the InterAct service portion of the OTD 5 61 Creating the prjSaglA Project The first step is to create your Project 1 From the Enterprise Designer s Project Explorer tree right click the Repository and select New Project 2 From the Project Explorer tree rename the new Project to prjSagIA 562 Creating the Collaboration Definition The next step in the sample is to create the jedSAGIA Java Collaboration using the Collaboration Definition Wizard Java Once the Collaboration has been created the Collaboration s Busi
105. pal ending with o lt BIC8 gt o swift Size is limited to 100 bytes For example cn dandrews o bankn14b o swift Requestor DN Specifies the Swint_Requestor the The Requestor DN distinguished Application entity name Size is limited name ending with o lt SWIFTNet to 100 bytes institution BIC 8 gt o swift For example ou management o bankn14b o swift Responder Specifies the Swint_Responder the name The Responder DN distingusihed DN of the intended responder Size is name ending with o lt SWIFTNet limited to 100 bytes institution BIC 8 gt o swift For example cn management o swift o swift Service Name Specifies the Swint_Service the Service Name containing the SWIFTNet service used The size is limited to 30 bytes The Service Name For example swift cte swift generic fa x swift generic fast x and so forth Request Type Specifies the SwInt ReguestType used The Request Type For example to identify the message type of the XML camt 005 001 02 GetTransaction message using the standard message code The size is limited to 30 bytes User Specifies the Swint_RequestRef This is A user reference of 30 bytes or less Reference used to associate a request message with subsequent response or error messages The size is limited to 30 bytes Signed Specifies whether the request contains Select True or False True indicates that Crypto operations to be performed Only the request contains Crypto the
106. purposely disabled The default setting is Pull Pull is the correct setting for client mode Note This property is purposely disabled Order By Specifies the Sw_OrderBy Indicates the Select InterAct blank FileAct or order priority in which the messages are Urgent retrieved on the queue The options are The configured default is InterAct InterAct Blank indicates FIFO first in first out FileAct Urgent Recovery Specifies the Sw_RecoveryMode Select TRUE or FALSE True indicates Mode Indicates whether the session must be that the session must be opened in opened in recovery mode Messages that recovery mode already have an output sequence number are sent first before considering The configured default is FALSE the selected order SWIFTAlliance Gateway eWay User s Guide 31 Sun Microsystems Inc Chapter 3 Configuring the eWay 336 FileAct Client This section maps to the Primitive Sw ExchangeFileRequest For parameters SwXXX under this section refer to the SNL specification for more detailed descriptions The FileAct Client section of the SWIFT AG eWay Connectivity Map properties contains the top level parameters displayed in Table 8 Section 3 3 SWIFT AG eWay Connectivity Map Properties Table 8 Connectivity Map FileAct Client Name Description Required Value User DN Specifies the SwSec_UserDN Used to The User DN distinguished name identify and authenticate the princi
107. r file Monospaced Command line arguments code java jar filename jar samples variables are shown in bold italic Blue bold Hypertext links within See Text Conventions on page 11 document Blue underlined Hypertext links for Web http www sun com addresses URLs or email addresses 15 Sun Microsystems Inc Web Site The Sun Microsystems web site is your best source for up to the minute product news and technical support information The site s URL is http www sun com SWIFTAlliance Gateway eWay User s Guide 11 Sun Microsystems Inc Chapter 1 Section 1 6 Introduction Documentation Feedback 16 Documentation Feedback We appreciate your feedback Please send any comments or suggestions regarding this document to CAPS docsfeedback sun com SWIFTAlliance Gateway eWay User s Guide 12 Sun Microsystems Inc Chapter 2 Installing the eWay This chapter explains how to install the SWIFT AG eWay as well as supported operating systems and system requirements The chapter also includes necessary post installation procedures What s in This Chapter SWIFT AG eWay System Reguirements on page 13 Installing the SWIFT AG eWay on page 13 Installing eWay Enterprise Manager plug ins on page 15 Adding the SWIFTAlliance Gateway Component Package on page 16 Installing and Initializing the SWIFT AG Remote APIs on page 18 21 SWIFT AG eWay System Requirements The SWIFT AG eWay Readme co
108. r gt ssl lt TransferEndpoint gt lt Process ID gt Here are some examples swfa_handler snlhost 48003 ssl MyUniqueEndpoint 23450 swfa_handler snlhost 48003 MyUniqueEndpoint 23450 swfa_handler snlhost 48003 MyUniqueEndpoint As for the syntax details and operational guidelines of remote file handler refer to the SWIFTNet Service Design Guide or consult your system person The Transfer EndPoint name used for the remote file handler Size is limited to 30 bytes Block File Transfer Specifies BlockFileTransfer This indicates whether the function call will finish when a final file status is returned This may be useful for the large file transfers The final status values for file transfer are Completed Duplicated Aborted Failed Rejected and Unknown Select True or False True indicates that the function call will finish when a final file status is returned The configured default is True SWIFTAlliance Gateway eWay User s Guide 34 Sun Microsystems Inc Chapter 3 Configuring the eWay 337 FileAct Client gt Store and Forward Section 3 3 SWIFT AG eWay Connectivity Map Properties This section maps to parameter Sw AcquireSnFRequest of Primitive Sw ExchangeSnFRequest For parameters SwXXX under this section refer to the SNL specification for more detailed descriptions The InterAct Client gt Store and Forward section of the SWIFT AG eWay Connectivity Map properties contains t
109. re two ways to add the eWay Enterprise Manager plug ins 1 From the Enterprise Manager A From the Enterprise Manager s Explorer toolbar click the Configuration icon B Click the Web Applications Manager tab go to the Auto Install from Repository tab and connect to your Repository C Select the application plug ins you reguire and click Install The application plug ins are installed and deployed 2 From the Sun Java Composite Application Platform Suite Installer A From the Installer s Download tab select the Plug Ins you require and save them to a temporary directory B Log onto the Enterprise Manager From the Enterprise Manager s Explorer toolbar click the Configuration icon C Click the Web Applications Manager tab and the Manage Applications tab D Browse for and select the WAR file for the application plug in that you downloaded and click Deploy The plug in is installed and deployed SWIFT AG eWay Alert Codes You can view and delete alerts using the Enterprise Manager An alert is triggered when a specified condition occurs in a Project component The purpose of the alert is to warn the administrator or user that a condition has occurred To View the eWay Alert Codes 1 Add the eWay Enterprise Manager plug in for this eWay 2 From the Enterprise Manager s Explorer toolbar click the Configuration icon 3 Click the Web Applications Manager tab and go to the Manage Alert Codes tab Your installed alert codes are di
110. reate your Project for this sample SAG External Application and File Icons representing the selected External Applications are added to the Connectivity Map toolbar Populating the Connectivity Map Manually Add the Project components to the Connectivity Map by dragging the icons from the toolbar to the canvas Note You can also Populate and Bind the Connectivity Map components using the Connectivity Map Generator See Using the Connectivity Map Generator on page 65 for more information To populate your Connectivity Map do the following 1 From the Project Explorer tree drag and drop your jcdSagFA Collaboration onto the Connectivity Map Editor canvas 2 From the Connectivity Map Editor toolbar drag the following components to the Connectivity Map canvas as displayed in Figure 23 File External Application 2 for this sample SWIFTAlliance Gateway External Application 1 for this sample Figure 23 Connectivity Map with Components oP Peep SAG cmSagFA_jicdSagF A 3 Rename the components on the Connectivity Map as follows File1 External Application to eaFileIn File2 External Application to eaFileOut SAG1 External Application to eaSAG 4 Save your current changes to the Repository 55 5 Binding the eWay Components Next the components are associated and Bindings are created in the Connectivity Map 1 From the Connectivity Map Editor double click the cmSagFA_jcdSagFA service The cmSagFA_jcdSagFA b
111. rt Sample Project Collaboration track getTransferRef22 OK msg r n r n transactionSeq Scenario 2 3 SAG_Cert RT FA Get generic fa x Syne track msg SAGOutboundeWay_1 getConfiguration getFileActClient getGetFile setSw_TransferDescription msg SAGOutboundeWay_1 getConfiguration getFileActClient getGetFile setSw_PhysicalName c temp SAG_Cert getDownload3FromFTA txt SAGOutboundeWay 1 getConfiguration getFileActClient getGetFile setSw_LogicalName downloadFile3 txt SAGOutboundeWay_1 getServices getFileActClient get track OK msg r n r n transactionSeq Scenario 2 4 SAG_Cert RT FA Get generic fa x Signed Urgent track msg SAGOutboundeWay 1 getConfiguration getFileActClient getGetFile setSw TransferDescription msg SAGOutboundeWay 1 getConfiguration getFileActClient setSwInt ReguestCrypto SAGOutboundeWay_1 getConstants getSw Boolean getTRUE SAGOutboundeWay 1 getConfiguration getFileActClient setSwInt Priority SAGOutboundeWay_1 getConstants getSwInt_Priority getUrgent SAGOutboundeWay 1 getConfiguration getFileActClient getGetFile setSw PhysicalName c temp SAG_Cert getDownload4FromFTA txt SAGOutboundeWay_1 getConfiguration getFileActClient getGetFile setSw_LogicalName downloadFile4 txt SAGOutboundeWay_1 getServices getFileActClient get SAGOutbou
112. rt on page 40 Connection Pool Settings on page 42 3 4 1 Transport The Transport section of the SWIFT AG eWay Environment properties contains the top level properties displayed in Table 14 Table 14 Environment Transport Name Description Required Value Read From RA Specifies the manner in which you One of the Following CFG File provide the transport information You can get RA transport information in two Leave the value empty blank to use ways the transport information specified in the rest of this section Host 1 Enter the RA resource adapter Name Port Number etc configuration file name to read all transport information from an Enter the RA configuration file name existing RA configuration file for your All transport information is taken SAG RA environment from the existing RA configuration file for your SAG RA environment 2 Get them one by one from the eWay configuration parameters defined in the rest of this section If this parameter is specified not blank it indicates that you are choosing the first option and the RA configuration file name is expected for this parameter for example sagta_ra cfg The other parameters in this section Host Name Port Number etc will be ignored If this parameter is not specified blank it indicates that you are choosing the second option the other parameters in this section Host Name Port Number etc must be specified to provide the required tra
113. s Designer s Math menu select Add The Add box appears E From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter r n as the Literal value F Map the r n output node of the String Literal box to the Valuel input node of the Add box G Map the result Date output node of the Date constructor box to the value2 input node of the Add box SWIFTAlliance Gateway eWay User s Guide 62 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing a Project Using Java Collaboration Definitions JCD Creating the prjSagFA Project H From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter Ending collab of SAG FA r n r n r n r n as the Literal value Map the Ending collab of SAG_FA r n r n r n r n output node of the String Literal box to the Value3 input node of the Add box J Map the result output node of the Add box to Text under FileClient_1 in the right pane of the Business Rules Designer 13 The FileClient_1 write rule writes the data to the message Create the FileClient_1 write rule A From the Business Rules toolbar click the rule icon to add a new rule B Right click FileClient_1 in the left pane of the Business Rules Designer and click Select method to call from the shortcut menu C Select write from the method selection window The write method box appears 14 From the editor s toolbar click Validate to c
114. s Document This section provides a short description of the SWIFT AG eWay user s guide 141 What s in This Document This document provides information about installing configuring and using the SWIFT AG eWay and includes the following chapters Chapter 1 Introduction provides an overview of SWIFTNet and SWIFTAlliance Gateway as well as the SWIFT AG eWay and the guide Chapter 2 Installing the eWay provides the supported operating systems and system requirements for the SWIFT AG eWay It also includes directions for installing the SWIFT AG eWay and additional files and accessing the accompanying documentation and sample Projects Chapter 3 Configuring the eWay defines the SWIFT AG eWay properties and provides directions for configuring the SWIFT AG eWay properties at design time Chapter 4 OTD Overview generally describes the OTD used by the eWay and summarizes the OTD structure and functionality Chapter 5 Implementing a Project Using Java Collaboration Definitions JCD describes the implementation and functionality of the SWIFT AG eWay using the eGate Integrator with the eWay s sample Projects Appendix A Sample prjSAGCert Project Overview provides an overview of the prjsAGCert Project an example of a Project which demonstrates several important scenarios SWIFTAlliance Gateway eWay Javadoc A Javadoc is also provided that documents the Java methods available with the SWIFTAllianc
115. s in the left pane of the Business Rules Designer to the value4 input node of the Add box K Map the result output node of the Add box to Text under FileClient_1 in the right pane of the Business Rules Designer see Figure 20 Figure 20 Java Collaboration Editor jcdSagFA Business Rules Business Rules Designer 80 8 X pociean Comparson E_Math SaObject A String Hilaray 8 Operators Assignment Copy n new Date ExchangeFileResponseWn SAGOutboundeWay_1 Primitives SnIPrimitives Sw_ExchangeFileRequest to FileClient_1 Text Ge jodSAGFA jedSAGFA aw IS FileClient_1 FileClient_1 2 1 A ByteArray mo 9 IS input n 7 K Encoding Li E SAGOutboundeWay_1 result Date Text O O ier Configuration input MS 9 ier Constants a ne SAGOutboundeWay 1 LE Q BB sniPrimitives z 7 E Sw AbortFileReguest ExchangeFileRequest rin L pes O a Sw_AbortFileResponse a Sw ExchangeFileReguest Po values Sw FileReguest i SwSec_AuthorisationContext values Type L Version OTO m 9 a Sw_ExchangeFileResponse a Sw_ExchangeSnF Request a Sw_ExchangeSnF Response ea jedSAGFA 7 Create the FileClient 1 write rule A Follow the directions provided in step 4 of this section to create another FileClient 1 write rule 8 The Copy r n new Date ExchangeFileResponse r n SAGOutboundeWay 1 Primitives S
116. s section is specific for the RA connection pool of Sun Java System Application Server or Sun SeeBeyond Integration Server only The parameter settings in this section go into sun ra xml Please refer to the corresponding documentations along with your product for more details The Connection Pool Settings section of the SWIFT AG eWay Environment properties contains the top level properties displayed in Table 15 Table 15 Environment Connection Pool Settings Name Description Required Value Steady Pool Specifies the steady pool size This parameter maps to An integer indicating Size parameter steady pool size in sun ra xml which is the steady pool size specific for the Sun Java System Application Server or Sun SeeBeyond Integration Server see the corresponding documentations for more information The steady pool size represents the minimum number of RA connections to be maintained When it is set to greater than 0 the container not only pre populates the RA connection pool with the specified number but also attempts to ensure that there is always this many RA connections in the free pool This ensures that there are enough RA connections in the ready to serve state to process user requests This parameter does not necessarily guarantee that no more than steady pool size instances exist at a given time It only governs the number of instances that are pooled over a long period of time For example suppose an idle stateless s
117. ser s Guide 38 Sun Microsystems Inc Chapter 3 Section 3 3 Configuring the eWay SWIFT AG eWay Connectivity Map Properties 33 11 Connection Establishment The Connection Establishment section of the SWIFT AG eWay Connectivity Map properties defines configuration parameters used to control the connection establishment It contains the top level parameters displayed in Table 13 Table 13 Connectivity Map Connection Establishment Name Description Required Value Always Create Specifies whether to ALWAYS try to create a Select True or False New new connection for a connection Connection establishment request The options are The configured default is FALSE True a new connection is always created without trying to match an existing connection False an attempt to match an existing connection managed by container is made Auto Specifies whether the eWay closes the Select True or False Disconnect connection automatically after the work is Connection finished on the connection The configured default is FALSE True the connection is not re used False the connection is returned to the pool for reuse SWIFTAlliance Gateway eWay User s Guide 39 Sun Microsystems Inc Chapter 3 Section 3 4 Configuring the eWay SWIFT AG eWay Environment Properties 34 SWIFT AG eWay Environment Properties The SWIFTAlliance Gateway eWay Environment properties are organized into the following sections Transpo
118. ser s Guide 79 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing a Project Using Java Collaboration Definitions JCD The prjSaglA Sample Project Table 23 File eWay Environment Settings File eWay Environment Properties Inbound File eWay gt Parameter Settings Set as directed otherwise use the default settings Directory An input directory for example C temp Outbound File eWay gt Parameter Settings Set as directed otherwise use the default settings Directory An output directory for example C temp Configuring the SWIFT AG eWay Properties The SWIFT AG eWay properties are set in both the Connectivity Map and the Environment Explorer For more information on the SWIFT AG eWay properties and the Properties Editor see Configuring the eWay on page 21 Modify the SWIFT AG eWay Connectivity Map Properties 1 From the Connectivity Map double click the SWIFT AG eWay The Properties Editor opens to the SWIFT AG eWay properties 2 Modify the SWIFT AG eWay Connectivity Map properties for your system including the settings in Table 24 and click OK Table 24 SWIFT AG eWay Connectivity Map Properties SWIFT AG eWay Connectivity Map Properties Envelope Settings Set as directed otherwise use the default settings Application Id My_Al Sender SAG Operator name Sender Auth The password for the SAG Operator InterAct Client Set as directed otherwise use the def
119. shortcut menu C Select write from the method selection window The write method box appears 4 The Copy input Text to SAGOutboundeWay 1 Services InterActClient ReguestPayload rule adds the input text to the InterAct payload Create Copy input Text to SAGOutboundeWay 1 Services InterActClient ReguestPayload rule A From the Business Rules toolbar click the rule icon to add a new rule B Map Text under input in the left pane of the Business Rules Designer to RequestPayload under SAGOutboundeWay 1 gt Services gt InterActClient in the right pane of the Business Rules Designer To do this click on Text in the left pane of the Business Rules Designer and drag your cursor to ReguestPayload in the right pane A link now connects the two nodes see Figure 31 on page 75 SWIFTAlliance Gateway eWay User s Guide 74 Sun Microsystems Inc Chapter 5 Implementing a Project Using Java Collaboration Definitions JCD Section 5 6 The prjSaglA Sample Project Figure 31 Java Collaboration Editor jcdSAGIA Business Rules Business Rules Designer Gy jodSAGIA IS FileClient 1 MI input a ByteArray Encoding Text o z SAGOutboundeWay_1 jedsacia 80 498X Apooleany Comparisons Elmath Objecte String Hilaray 8 Operators Assignment Copy input Text to SAGOutboundeWay_1 Senices InterActClient RequestP ayload jedSAGIA Ge FileClient_1 3 me OOOO input SAGOutb
120. siness Rules Designer s Math menu select Add The Add box appears SWIFTAlliance Gateway eWay User s Guide 76 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing a Project Using Java Collaboration Definitions JCD The prjSaglA Sample Project From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter r n as the Literal value Map the r n output node of the String Literal box to the Valuel input node of the Add box Map the result Date output node of the Date constructor box to the value2 input node of the Add box From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter ExchangeResponse r n as the Literal value Map the ExchangeResponse r n output node of the second String Literal box to the Value3 input node of the Add box Map SwInt_ExchangeResponse under Primitives gt SnlPrimitives in the left pane of the Business Rules Designer to the value4 input node of the Add box Map the result output node of the Add box to Text under FileClient_1 in the right pane of the Business Rules Designer 9 Create the FileClient_1 write rule A Follow the directions provided in step 3 of this section to create another FileClient_1 write rule 10 The Copy r n new Date Ending collab of SAG_IA r n r n r n r n to FileClient_1 Text rule creates the Ending collab of SAG_IA comment and includes
121. splayed under the Results section If your eWay alert codes are not available displayed under Results do the following A From the Install New Alert Codes section browse to and select the eWay alert properties file for the application plug in that you added The alert properties SWIFTAlliance Gateway eWay User s Guide 15 Sun Microsystems Inc Chapter 2 Section 2 3 Installing the eWay Adding the SWIFTAlliance Gateway Component Package files are located in the alertcodes folder of your Sun Java Composite Application Platform Suite installation directory B Click Deploy The available alert codes for your application are displayed under Results A listing of available this eWay s alert codes is displayed in Table 2 Table 2 SWIFT AG eWay Alert Codes Alert Code Description User Action SAGEWAY CONNECT Failed to establish a Typically detailed error information FAILED000001 Failed to SWIFTNet connection is placed in the Integration Server connect log explaining the failure and the SAGEWAY EXCHANGE Failed to exchange aire a user actions FAILED000002 Failed to message with SWIFT 9 exchange message An alert code is a warning that an error has occurred It is not a diagnostic The user actions noted above are just some possible corrective measures you may take Refer to the log files for more information For information on managing and monitoring alert codes and logs see the Sun SeeBeyond eGate Integrator Sys
122. tarting time startTime track msg Sag PrimitiveName gt lt Sag ReadEventLogRequest gt Sag FromLogSysTime gt String readLog lt Sag ToLogSysTime gt Sag LogCorrelationId gt Sag EventClass gt SWIFTAlliance Gateway eWay User s Guide 91 lt Sag FromLogSequence gt lt Sag FromLogSequence gt lt Sag ToLogSequence gt lt Sag ToLogSequence gt lt Sag EventLogSelect gt lt Sag PrimitiveRequest gt lt Sag PrimitiveName gt ReadEventLog lt lt Sag PrimitiveRelease gt SAG 4 0 lt Sag PrimitiveRelease gt lt Sag EventLogSelect gt lt Sag FromLogSysTime gt from lt lt Sag ToLogSysTime gt to lt Sag LogCorrelationId gt lt lt Sag EventSeverity gt lt Sag EventSeverity gt lt Sag EventClass gt lt lt Sag StartEventLogRecord gt lt Sag LogSequence gt lt Sun Microsystems Inc Appendix A Section A 1 Sample prjSAGCert Project Overview The prjSAGCert Sample Project Collaboration Sag LogSequence gt lt Sag StartEventLogRecord gt lt Sag NumberOfRecord gt lt Sag NumberOfRecord gt lt Sag ReadEventLogRequest gt lt Sag PrimitiveRequest gt SAGOutboundeWay_1 getRemoteApis getClient getRequest getEnvelope setMsgFormat SAGOutboundeWay_1 getConstants getEnvelopeMsgFormat getSagPrimitive SAGOutboundeWay_1 getRemoteApis getClient getRequest setLetter readLog SAGOutbou
123. tboundeWay_1 gt Services in the left pane of the Business Rules Designer and click Select method to call from the shortcut menu C Select get from the method selection window The get method box appears see Figure 19 on page 59 SWIFTAlliance Gateway eWay User s Guide 58 Sun Microsystems Inc Chapter 5 Implementing a Project Using Java Collaboration Definitions JCD Section 5 5 Creating the prjSagFA Project Figure 19 Java Collaboration Editor jcdSagFA Business Rules Business Rules Designer 8 m E M 3 x TH Boolean Comparison Math gt Object A String Hilaray f Operators Assignment SAGOutboundeWay_1 Semices FileActClient get IS input o DateTime jedSAGFA 8 ileCli ms b a jedSAGFA FileClient 1 Le ss input I lt FileClient 1 SAGOutboundeWay_1 E E m ByteArray FileActClient Encoding L Text result String E SAGOutboundeti ay 1 om Configuration o aS Constants ca Primitives O aS RemoteApis Services GA FileAotClient gt E InterAotClient Response jedSAGFA 6 The Copy r n new Date ExchangeFileRequest r n SAGOutboundeWay_1 Primitives Sn Primitives Sw_ExchangeFileRequest to FileClient_1 Text rule gets the Primitive value File Request from the SAG server and includes time stamp Create the Copy r n new Date ExchangeFileRequest r n SAGOutboundeWay_1 Pr
124. tem using the Properties Editor 312 Modifying the SWIFTA liance Gateway eWay Properties A Project s eWay properties can be modified after the eWays have been created in the Connectivity Map and the External Systems have been added to the Project s Environment Modifying the SWIFT AG eWay Connectivity Map Properties 1 From the Connectivity Map double click the eWay icon located in the link between the associated Service and the External Application The eWay Properties Editor appears containing the Connectivity Map properties 2 Make any necessary modifications and click OK The Property Editor closes saving your new settings Modifying the SWIFT AG eWay Environment Properties 1 From the Environment Explorer tree right click the SAG External System and select Properties from the shortcut menu The Properties Editor appears 2 Make any necessary modifications to the Environment parameters of the SWIFT AG eWays and click OK to save the settings 313 Using the Properties Editor You can modify the current eWay configuration properties from the SWIFT AG eWay Properties Editor SWIFTAlliance Gateway eWay User s Guide 22 Sun Microsystems Inc Chapter 3 Section 3 1 Configuring the eWay Configuring the SWIFTAlliance Gateway eWay To modify the eWay properties do the following 1 Open the SWIFT AG eWay Properties Editor for the eWay you want to edit The SWIFT AG eWay has two sets of parameters those specific to that parti
125. tem Administration Guide 223 After Installation Once the eWay is installed and configured you must then incorporate it into a Project before it can perform its intended functions See the Sun SeeBeyond eGate Integrator User s Guide for more information on incorporating the eWay into an eGate Project 23 Adding the SWIFTAlliance Gateway Component Package The SWIFTAlliance Gateway SAG Component package provides OS specific code and JNI wrapper code which allows the SWIFT AG eWay to connect properly with SWIFTAlliance Gateway After uploading the SwiftAGeWay sar file download the appropriate SWIFTAlliance Gateway SAG Component package for your system from the Sun Java Composite Application Platform Suite Installer The download package includes the following files SWIFTAlliance Gateway SAG Component for Solaris or AIX libstcsagjni so sagjni jar SWIFTAlliance Gateway SAG Component for Win32 stcsagjni dll sagjni jar SWIFTAlliance Gateway eWay User s Guide 16 Sun Microsystems Inc Chapter 2 Installing the eWay Section 2 3 Adding the SWIFTAlliance Gateway Component Package To download the component package for your system do the following 1 From the Sun Java Composite Application Platform Suite Installer click the DOWNLOADS tab The List of Components to download displays three system specific SWIFTAlliance Gateway SAG Component packages see Figure 1 Figure 1 Sun Java Composite Applica
126. the starting time and date Create the Copy r n new Date Ending collab of SAG TAAr n r n r n r n to FileClient 1 Text rule A B From the Business Rules toolbar click the rule icon to add a new rule From the Business Rules Designer toolbar click the Class Browser icon The Class Browser dialog box appears From the Class Browser select Date as the class java util as the package and Date as the constructor Click Select The Date constructor box is added to the Business Rules Designer mapping canvas From the Business Rules Designer s Math menu select Add The Add box appears From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter r n as the Literal value Map the r n output node of the String Literal box to the Valuel input node of the Add box Map the result Date output node of the Date constructor box to the value2 input node of the Add box From the Business Rules Designer s String menu select Literal String The String Literal box appears Enter Ending collab of SAG _ TA r n r n r n r n as the Literal value Map the Ending collab of SAG_TA r n r n r n r n output node of the String Literal box to the Value3 input node of the Add box SWIFTAlliance Gateway eWay User s Guide 77 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing a Project Using Java Collaboration Definitions JCD The prjSaglA Sample Project J Map the res
127. tion Platform Suite Installer Downloads Java Composite Application Platform Suite Installer iH jm i E Administration TE HELP ABOUT Downloads available from Repository List of Components to download Enterprise Designer f Downloads Documentation ESR Management User Administrator Sun CommandLineCodegen eWays Base Enterprise Manager Plug In Deployment Command Line Client Windows Deployment Command Line Client UNIX Web Services Access Manager Enterprise Manager Runtime Java System Application server Deployer Enterprise Manager Runtime Java System Application server Event Management Enterprise Manager Runtime Java System Application server Logging Business Process Instance Manager API eInsight Enterprise Manager Plug In sac eWay Enterprise Manager Plug In SWIFT Alliance Gateway SAG Component for Win32 SWIFT Alliance Gateway SAG Component for Solaris SWIFT Alliance Gateway SAG Component for AIX WLM Monitor 2 Extract the package for your specific system to a local directory 3 Copy both files for your system to the following location Note lt JavaCAPS51 gt logicalhost is lib SWIFTAlliance Gateway eWay User s Guide 17 where lt JavaCAPS51 gt is the directory in which Sun Java Composite Application Platform Suite is installed Before deplo
128. tion of the eWay 16 connecting eWay components 64 Connection Establishment properties 39 Connection Pool Settings properties 42 Connectivity Map creating 63 78 populating 64 Context ID 25 conventions text 11 D Delivery Notification Queue Name 30 33 Deployment Profile Auto Map 69 81 SWIFTAlliance Gateway eWay User s Guide 93 creating 69 81 E Endpoints 53 Environment creating 66 78 Logical Host 66 79 SeeBeyond Integration Server 66 79 Environment Editor 66 78 Environment properties 40 External Application selecting 21 F File Description 37 File Info 37 FileAct overview 8 FileAct Client Get File properties 36 properties 32 Put File properties 37 SnF Fetch File properties 38 Store and Forward properties 35 Force Acquire 31 35 Ftla Port Number 41 H Host Name 40 Include XML Attributes in SNL Primitive 27 InterAct overview 7 InterAct Client properties 29 Store and Forward properties 31 J Java Collaboration Editor 86 jcdSAGFAI 65 L linking eWay components 64 Logical File Name 36 37 Sun Microsystems Inc Index M Max Pool Size 42 Max Wait Time in Millis 43 Maximum File Size 36 Message Partner adding 19 Messaging Services overview 7 Msg Format 26 N Non Repudiation 30 33 O operating systems requirements 13 supported 13 Order By 31 35 organization of information guide 10 OTD SAGOutboundeWay OTD overview 9 P Physical File Name 36 37
129. u select Literal String The String Literal box appears Enter ExchangeRequest r n as the Literal value Map the ExchangeRequest r n output node of the second String Literal box to the Value3 input node of the Add box Map SwInt_ExchangeRequest under Primitives gt SnlPrimitives in the left pane of the Business Rules Designer to the value4 input node of the Add box Map the result output node of the Add box to Text under FileClient_1 in the right pane of the Business Rules Designer 7 Create the FileClient_1 write rule A Follow the directions provided in step 3 of this section to create another FileClient_1 write rule 8 The Copy r n new Date ExchangeResponse r n SAGOutboundeWay 1 Primitives SnIPrimitives SwInt ExchangeResponse to FileClient 1 Text rule gets the Primitive value ExchangeResponse from the SAG server and includes the time stamp Create the Copy r n new Date ExchangeResponse r n SAGOutboundeWay 1 Primitives SnIPrimitives SwInt ExchangeResponse to FileClient 1 Text rule A B From the Business Rules toolbar click the rule icon to add a new rule From the Business Rules Designer toolbar click the Class Browser icon The Class Browser dialog box appears From the Class Browser select Date as the class java util as the package and Datel as the constructor Click Select The Date constructor box is added to the Business Rules Designer mapping canvas From the Bu
130. uide Help file Javadoc Readme and sample Projects select the following SwiftAGeWayDocs 3 Once you have selected all of your products click Next in the top right or bottom right corner of the Select Sun Java Composite Application Platform Suite Products to Install box 4 From the Selecting Files to Install box locate and select your first product s SAR file Select the SAR file and click Next Your next selected product appears Follow this procedure for each of your selected products The Installation Status window appears and installation begins after the last SAR file has been selected 5 Once your products installation is finished continue installing the Sun Java Composite Application Platform Suite as instructed in the Sun Java Composite Application Platform Suite Installation Guide The SWIFT AG eWay also requires additional JNI component files that are included with the installation For directions on how to install these additional files see Adding the SWIFTAlliance Gateway Component Package on page 16 Adding the eWay to an Existing Suite Installation If you are adding the eWay to an existing Sun Java Composite Application Platform Suite installation do the following 1 Complete steps 1 through 4 above 2 Once your product s installation is finished open the Enterprise Designer and select Update Center from the Tools menu The Update Center Wizard appears 3 For Step 1 of the wizard simply c
131. ult output node of the Add box to Text under FileClient_1 in the right pane of the Business Rules Designer see Figure 21 11 Create the FileClient 1 write rule Follow the directions provided in step 3 of this section to create another FileClient 1 write rule 12 From the editor s toolbar click Validate to check the Collaboration for errors 13 Save your current changes to the repository For more information on how to create Business Rules using the Collaboration Editor see the Sun SeeBeyond eGate Integrator User s Guide 564 Creating the Connectivity Map To create the Project s cmSAGIA Connectivity Map do the following 1 From the Project Explorer tree right click the new prjSagIA Project and select New gt Connectivity Map from the shortcut menu 2 The New Connectivity Map appears From the Project Explorer tree rename the Connectivity Map to cmSAGIA 565 Generate the Connectivity Map Using the Connectivity Map Generator The Connectivity Map Generator provides an alternative to manually populating and Binding the Connectivity Map components The Connectivity Map Generator populates the Connectivity Map and binds the components using the information provided by your Java Collaboration Definition To populate the cmSAGIA Connectivity Map using the Connectivity Map Generator do the following 1 From the Project Explorer tree drag and drop the jcdSAGIA Collaboration onto the cmSAGIA Connectivity Map Editor canv
132. undeWay_ SAGOutboundeWay_ SAGOutboundeWay_ getSw_SnFRequestControl SAGOutboundeWay_ SAGOutboundeWay_ SAGOutboundeWay_ getSw_SnFRequestControl SAGOutboundeWay_ SAGOutboundeWay_ track OK msg track msg SAGOutboundeWay_ SAGOutboundeWay_ track OK msg track msg msg r n r n track msg SAGOutboundeWay_ swift generic iast x SAGOutboundeWay_ getConstants getSw_Boolean getTRUE getConstants getSw Boolean getFALSE r n r n transactionSeg r n r n transactionSeq Section A 1 The prjSAGCert Sample Project Collaboration getServices getFileActClient snfPull getConfiguration getFileActClient getSnFFetchFile setSw PhysicalName C temp SAG_Cert fetch4FromSnF txt getServices getFileActClient snfFetch getPrimitives getSnlPrimitives getSw ExchangeSnFRequest getSw_SnFRequest getSwInt_NRIndicator setX__PCDATA___ getServices getFileActClient snfAck getPrimitives getSnlPrimitives getSw ExchangeSnFRequest getSw_SnFRequest getSwInt_NRIndicator setX__PCDATA___ getServices getFileActClient snfRelease Scenario 7 SAG Cert SnF Queue RecoveryMode getServices getInterActClient snfAcquire getServices getInterActClient snfRelease Scenario 8 SAG Cert InterAct NotifQueue Delivery transactionSeq Scen
133. unning the Projects For directions on creating an Endpoint or running the Remote File Handler Process refer to the SWIFTNet Service Design Guide available as part of the SWIFTAlliance Gateway Developers Toolkit SWIFTAlliance Gateway eWay User s Guide 53 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing a Project Using Java Collaboration Definitions JCD Creating the prjSagFA Project ss Creating the prjSagFA Project The following pages provide step by step directions for manually creating the prjSagFA Project s components 55 1 Creating a Project The first step is to create a new Project in the SeeBeyond Enterprise Designer 1 From the Enterprise Designer s Project Explorer tree right click the Repository and select New Project see Figure 13 A new Project Project1 appears on the Project Explorer tree Figure 13 Enterprise Explorer New Project x d D ner D Sort by Type Sort by Name Sort by Date Import Project Export Project Change Branch Create Branch Refresh All from Repository User Management Paste Properties 2 Rename the Project to prjSagFA 552 Creating the Collaboration Definition The next step in the sample is to create the jedSagFA Java Collaboration using the Collaboration Definition Wizard Java Once the Collaboration has been created the Collaboration s Business Rules can be written using the Collaboration Editor Java Creating the jcdSag
134. vaCAPS Integration Server host Hostname or IP Address of the SAG server Port number used by SAG to communicate with remote applications default is 48002 Port number that SAG uses for remote file transfer default is 48003 2 Initialize start the RA This is done using the swiftnet init command The steps to initialize RA vary depending on your operating system To initialize the RA do the following For Solaris and AIX A Open the Korn shell B Navagate to the SWIFTAlliance RA bin directory C Enter the following swiftnet init command swiftnet init If you have more than one instance of the Remote API configured use the following syntax swiftnet init S lt RA name gt where lt RA name gt is the name of your Remote API instance For Windows Your RA installation creates a shortcut on your desktop Double click the shortcut to initialize RA To initialize RA from a command prompt do the following A From the command prompt navagate to the SWIFTAlliance RA bin directory B Enter the following swiftnet init command swiftnet init SWIFTAlliance Gateway eWay User s Guide 18 Sun Microsystems Inc Chapter 2 Section 2 5 Installing the eWay Configuring the Application ID If you have more than one instance of the Remote API configured use the following syntax swiftnet init S lt RA name gt where lt RA name gt is the name of your Remote API instance 3 With your RA initialized start the Jav
135. ying and running your project on another supported application server copy both files sagjni jar and libstcsagjni so for Solaris and AIX or stcsagjni dll for Windows to the following location lt application server gt lib where lt application server gt is the installation directory of your specific application server Sun Microsystems Inc Chapter 2 Section 2 4 Installing the eWay Installing and Initializing the SWIFT AG Remote APls 24 Installing and Initializing the SWIFT AG Remote APIs Install the SWIFT Alliance Gateway Remote API RA on your JavaCAPS Integration Server host Initialize start and run the RA prior to starting your JavaCAPS Integration Server IS and deploying your Project Running the JavaCAPS IS on top of the RA fulfills the required environment variables Note The following directions assume that you will only have a single instance of the Remote API connecting with the Remote API Host Adapter of a single SAG instance for different scenarios see the SWIFTAlliance Gateway Remote API Operations Guide for more information Install the Remote API 1 From the JavaCAPS Integration Server host install the SWIFTAlliance Gateway Remote API See the SWIFTAlliance Gateway Remote API Installation Guide for directions The installation process creates the configuration file sagta_ra cfg containing the information necessary to connect to the SAG host You will need the following information to install RA on your Ja

Sun SeeBeyond eWay(TM) Adapter for SWIFT Alliance Gateway

Contents

Download Pdf Manuals

Related Search

Related Contents