Universal Banking 12.0 Interface Getting started Release 1.0 May 2012
Contents 1 Preface... 3 1.1 Audience... 3 1.2 Related documents... 3 1.3 Conventions... 3 2 Introduction... 4 2.1 How to use this Guide... 4 3 Interface Getting started... 4 3.1 Gateway Overview... 5 3.1.1 FLEXCUBE UBS Generic Gateway ( and Web Services)... 5 3.1.2 FLEXCUBE UBS Electronic Messaging Gateway (EMS)... 5 3.1.3 FLEXCUBE UBS Switch Gateway... 5 3.1.4 FLEXCUBE UBS ASCII Generic Interface Gateway... 5 3.1.5 FLEXCUBE Upload Adapter... 6 4 FLEXCUBE UBS Generic Gateway... 6 4.1 Web Services ( in SOAP)... 7 4.2 Simple HTTP ( over HTTP)... 8 4.3 Enterprise Java Bean ( over RMI/IIOP)... 9 4.4 Providers using Message Driven Bean ( over )... 10 4.5 Notifications... 11 5 FLEXCUBE UBS EMS Gateway... 12 5.1 Integration with SWIFT Alliance... 12 5.2 E-mailing of FLEXCUBE UBS Advices... 13 6 FLEXCUBE UBS Switch Gateway... 14 6.1 ATM-POS Switch Integration... 14 7 FLEXCUBE UBS ASCII Generic Interface... 15 8 FLEXCUBE Upload Adapter... 15 FD04-01-01 Interface Getting Started 2
1 Preface This document gives a top level overview of FLEXCUBE UBS Integration Gateways and helps user to get started using various Integration frameworks. 1.1 Audience This Interface Getting started is intended for FLEXCUBE Application Developers/Users who require: Overview knowledge of Integration framework To configure new Generic Interface incoming/outgoing To Develop EXECL based upload adapter 1.2 Related documents For more information on Interfaces, see these resources: FCUBS-FD01-01-01-Development Overview Guide FCUBS-FD04-02-01-Generic Interface Configuration Guide FCUBS-FD04-03-01-Upload Adapter Development Guide 1.3 Conventions The following text conventions are used in this document: Convention Meaning boldface italic monospace Boldface type indicates graphical user interface elements (for example, menus and menu items, buttons, tabs, dialog controls), including options that you select. italic type indicates book titles, emphasis, or placeholder variables for Which you supply particular values. Monospace type indicates language and syntax elements, directory and file names, URLs, text that appears on the screen, or text that you enter. FD04-01-01 Interface Getting Started 3
2 Introduction 2.1 How to use this Guide Chapter 2, Introduction This is an introduction section Chapter 3, Interface Getting started This section deals with Interface and its requirements Chapter 4, FLEXCUBE UBS Generic Gateway This section introduce FLEXCUBE UBS Generic Gateway Chapter 5, FLEXCUBE UBS EMS Gateway This section introduce FLEXCUBE UBS EMS Gateway Chapter 6, FLEXCUBE UBS Switch Gateway This section introduce FLEXCUBE UBS Switch Gateway Chapter 7, FLEXCUBE UBS Generic ASCII Gateway This section introduce FLEXCUBE UBS Generic ASCII Gateway Chapter 8, FLEXCUBE UBS Upload Adapter This section introduce FLEXCUBE UBS Upload Adapter 3 Interface Getting started Integration of different applications and solutions is a key area in today s systems. A variety of specialized applications deployed on disparate platforms and using different infrastructure need to be able to communicate and integrate seamlessly with each other in order to exchange data. One of the design goals of FLEXCUBE has been that it should integrate easily with external systems for which FLEXCUBE provides an Integration Gateway. This Integration Gateway uses a service and notifications based approach to integration under the principles of Service Oriented Architecture. The architecture provides for interfaces supporting open standards that can be used to easily integrate with other applications. The Gateway provides for various deployment patterns, all of which can co-exist, to enable these various integrations. FD04-01-01 Interface Getting Started 4
The below diagram provides a high level view of some sample integrations that could be in place in a typical bank. 3.1 Gateway Overview The Integration Gateway provides for the following gateways. 3.1.1 FLEXCUBE UBS Generic Gateway ( and Web Services) Generic Gateway is built on a service based architecture leveraging industry standards like and web services. This Gateway can be utilized to integrate FLEXCUBE UBS with any system in an online real-time manner using different mechanisms. 3.1.2 FLEXCUBE UBS Electronic Messaging Gateway (EMS) EMS Gateway provides specific integration with SWIFT Alliance (basic as well as MQ based) and integration to e-mail for advices generated by FLEXCUBE UBS. 3.1.3 FLEXCUBE UBS Switch Gateway Switch Gateway provides integration to ATM-POS switches using the industry standard ISO 8583 message formats. 3.1.4 FLEXCUBE UBS ASCII Generic Interface Gateway ASCII Gateway provides generic integration to systems where the integration needs to be based on flat files (ASCII files) FD04-01-01 Interface Getting Started 5
3.1.5 FLEXCUBE Upload Adapter FLEXCUBE Upload Adapter framework provides mechanism to create the spread sheet based data uploads. This mechanism helps to get spreadsheet data into FLEXCUBE Database. 4 FLEXCUBE UBS Generic Gateway The Generic Gateway can be deployed in various deployment patterns to support various mechanisms of integration. Gateway is message based in nature. The message for executing an Operation in any Service of FLEXCUBE UBS is the same irrespective of the deployment pattern used to invoke the service. The approach to integration is based on - Services for inbound integration These services can be to Create, Modify or Query data into/from FLEXCUBE UBS Notifications of business events for outbound integrations These notifications notify the systems which subscribe to them of the business events that occur within FLEXCUBE UBS. A top level view of the various deployments patterns of Gateway is as shown in the below diagram. FD04-01-01 Interface Getting Started 6
4.1 Web Services ( in SOAP) The various services available in Gateway are deployed and exposed as web services in this deployment pattern. The web services are synchronous in nature. The services are Document-Literal and follow a message based style wherein the payload (both request and response) is embedded into the SOAP message. The web services have servlet endpoints to ensure a low footprint. Internally the web services invoke the Gateway EJB for performing the necessary operations External s Application Layer External J2EE 1.4 Application Server Java/ Non-Java Client Application SOAP / HTTP 1 8 Oracle FLEXCUBE WS 7 2 EJB (Stateless Session Bean) JDBC Legend 6 3 Database Layer Message format Protocol / Specification Message flow Responsibility Zone Message Handler Layer Oracle Database Server DMZ Business Schema 5 4 Service Layer Schematic: WS Synchronous Integration Deployment Pattern FD04-01-01 Interface Getting Started 7
4.2 Simple HTTP ( over HTTP) The various services available in Gateway are deployed and exposed as a servlet in this deployment pattern. There is only one Gateway servlet and irrespective of the service being invoked the payload will have to be sent to this servlet as simple messages in the body of the HTTP message. Internally the servlet invokes the Gateway EJB for performing the necessary operations. External s Application Layer External J2EE 1.4 Application Server Java/ Non-Java Client Application / HTTP 1 8 Oracle FLEXCUBE Servlet 7 2 EJB (Stateless Session Bean) JDBC 6 3 Database Layer Legend Message format Protocol / Specification Message flow Responsibility Zone DMZ Business Schema Message Handler Layer 5 4 Oracle Database Server Service Layer Schematic: Servlet Synchronous Integration Deployment Pattern FD04-01-01 Interface Getting Started 8
4.3 Enterprise Java Bean ( over RMI/IIOP) The various services available in Gateway are deployed and exposed as a Enterprise Java Bean (EJB) in this deployment pattern. There is only one Gateway EJB and irrespective of the service being invoked the payload will have to be sent to this EJB as a method call ( over RMI/IIOP). The Gateway EJB is the true synchronous entry point into the FLEXCUBE database which is responsible for processing the messages and contains the business logic for all the services. External s Application Layer External J2EE 1.4 Application Server Java Client Application RMI / IIOP 1 6 EJB (Stateless Session Bean) JDBC 5 2 Database Layer Legend Message format Protocol / Specification Message flow Responsibility Zone DMZ Business Schema Message Handler Layer 4 3 Oracle Database Server Service Layer Schematic: EJB Synchronous Integration Deployment Pattern FD04-01-01 Interface Getting Started 9
4.4 Providers using Message Driven Bean ( over ) Message oriented Middleware (MoM) like Oracle Weblogic, IBM MQ Series, TIBCO EMSc are very popular means of integration. The Gateway provides a mechanism to integrate via these MoMs using a Message Driven Bean that supports standard. The integration will be asynchronous in nature (from the invoking system s perspective). The various services available in Gateway can be invoked using this deployment pattern. The request can be placed in a queue and the response obtained in another queue. External s Queue Server Application Layer Request Queue 1 J2EE 1.4 Application Server Queue Server 8 MDB 7 2 Response Queue JDBC Legend Database Layer Message format Protocol / Specification Message flow Responsibility Zone Message Handler Layer Oracle Database Server DMZ Business Schema 6 3 Service Layer Schematic: MDB Asynchronous Application Integration Deployment Pattern FD04-01-01 Interface Getting Started 10
4.5 Notifications This deployment pattern is used to publish the business events that occur in FLEXCUBE UBS asynchronously. These events are published in the form of messages on to one or more queues or topics hosted in a provider. External s Presentation Layer Application Layer Queue Server Integration Server(s) J2EE 1.4 Application Server Queue Server Notify MDB Notification Notification 3 2 1 Queue Topic Legend Database Layer Message format Protocol / Specification Message flow Responsibility Zone DMZ transactions Integration GW administration Business Schema Notify Layer Service Layer Oracle Messaging Gateway AQ2 Notification AQ1 Trigger Business Process Oracle Database Server Schematic: J2EE Notify Application Integration Deployment Layer Refer FCUBS-FD02-05-01-RAD Notification Development for more information on how to develop Notifications in FLEXCUBE UBS. FD04-01-01 Interface Getting Started 11
5 FLEXCUBE UBS EMS Gateway 5.1 Integration with SWIFT Alliance EMS Gateway provides file based (local folder or FTP) connectivity to SWIFT Alliance. EMS Gateway can be used to connect to Queue based deployment of SWIFT MQSA. Both incoming and outgoing connectivity to SWIFT Alliance and MQSA is provided by EMS. External s EMS Admin Presentation Layer Application Layer EMS Interface Server Queue Server EMS Incoming Interface [POJO] SWIFT SWIFT 1 SWIFT Alliance Access Using MQSA EMS In Queue FTP/File Server SWIFT 1 SWIFT Alliance Access Using Folders SWIFT EMS In Folder Poll / FTP or File I/O 2 SWIFT / JDBC Legend Database Layer Message format Protocol / Specification Message flow FLEXCUBE transactions FLE administration Responsibility Zone DMZ Host Schema Oracle Database Server Schematic: EMS Incoming Interface Deployment Pattern FD04-01-01 Interface Getting Started 12
5.2 E-mailing of FLEXCUBE UBS Advices Advices generated by FLEXCUBE can be e-mailed to the customer. This is achieved by the EMS Gateway by connecting to a configurable SMTP server External s EMS Admin Presentation Layer Application Layer SWIFT Advices SWIFT Alliance Access Using MQSA Queue Server EMS Out Queue SWIFT Advices SWIFT Alliance Access Using Folders TO Email ID End User SWIFT Advices FTP/File Server E-mail Exchange Server Advices EMS Out Folder Mail Store SWIFT Advices FTP or File I/O Advices SMTP EMS Interface Server EMS Outgoing Interface [POJO] 3 2 1 SWIFT Poll / JDBC Advices Legend Database Layer Message format Protocol / Specification Message flow transactions FLE administration Responsibility Zone DMZ Host Schema Oracle Database Server Schematic: EMS Outgoing Interface Deployment Pattern FD04-01-01 Interface Getting Started 13
6 FLEXCUBE UBS Switch Gateway 6.1 ATM-POS Switch Integration The Switch Gateway enables integration of FLEXCUBE UBS with ATM-POS switches. Communication is over TCP/IP using ISO 8583 messages. Support is available for On Us and Remote On Us and Off us transactions. FD04-01-01 Interface Getting Started 14
7 FLEXCUBE UBS ASCII Generic Interface FLEXCUBE UBS provides Generic Interface ( GI ) framework for ASCII based interface with external systems. GI is used to define incoming ASCII data upload or outgoing data handoff. GI framework uses the FLEXCUBE UBS RAD generated database units to route the upload actions. Refer the FCUBS-FD04-02-01-Generic Interface Configuration Guide for more information 8 FLEXCUBE Upload Adapter FLEXCUBE UBS provides the spread sheet macro based upload framework, which is used for one time data upload into FLEXCUBE. Upload Adapter framework provides mechanism to push data into staging tables and upload into master table using designated function ID Refer the document FCUBS-FD04-03-01-Upload Adapter Development Guide to know on how to develop the FLEXCUBE Upload adapter. FD04-01-01 Interface Getting Started 15
FD04-01-01 Interface Getting Started May 2012 1.0 Oracle Corporation World Headquarters 500 Oracle Parkway Redwood Shores, CA 94065 U.S.A. Worldwide Inquiries: Phone: +1.650.506.7000 Fax: +1.650.506.7200 www.oracle.com/ financial_services/ Copyright 2012 Oracle Financial Services Software Limited. All rights reserved. No part of this work may be reproduced, stored in a retrieval system, adopted or transmitted in any form or by any means, electronic, mechanical, photographic, graphic, optic recording or otherwise, translated in any language or computer language, without the prior written permission of Oracle Financial Services Software Limited. Due care has been taken to make this document FD04-01-01 Interface Getting Started and accompanying software package as accurate as possible. However, Oracle Financial Services Software Limited makes no representation or warranties with respect to the contents hereof and shall not be responsible for any loss or damage caused to the user by the direct or indirect use of this FD04-01-01 Interface Getting Started and the accompanying Software. Furthermore, Oracle Financial Services Software Limited reserves the right to alter, modify or otherwise change in any manner the content hereof, without obligation of Oracle Financial Services Software Limited to notify any person of such revision or changes. All company and product names are trademarks of the respective companies with which they are associated. FD04-01-01 Interface Getting Started 16