Temenos Web services

November 2, 202
4

2
 Objectives
Objectives

• Service oriented architecture (SOA)

• Understanding SOA
• Why to move to SOA framework
• Benefits of SOA
• Most common SOA Architecture types
• Web services building block
• Understanding WSDL
• SOAP
• Components of SOAP

3
 Some
Some Terminologies
Terminologies to
to be
be understood
understood

Service Oriented Architecture Web Service Definition Language

(SOA) (WSDL)

Simple Object Access Protocol Web Services

(SOAP)

Extensible Markup Language

(XML)

4
 What
What is
is SOA
SOA

• SOA – Service Oriented Architecture

• An architecture based on reusable , well defined services implemented by

IT components

• Components ( Providers and Consumers of the business services) are

loosely coupled. This greatly minimizes the impact of change.

• Provides platform, technology and language independence

• SOA is not a technology but an architectural approach to a software design

• Although SOA is often associated with Web services, it’s much more than
web services

5
 Understanding
Understanding SOA
SOA

Delivery Service Search

Service

Payment Service

6
 Traditional
Traditional Services
Services // Modular
Modular Services
Services

• Traditionally a business entity provided a service that belonged to their

core area of business.
• Modular Services gave much more that what their core business was

7
 Why
Why move
move to
to SOA
SOAframework
framework

3 - Tier Architecture Service Oriented Architecture

Mostly tightly Coupled Loosely coupled

Language dependent Language Independent

Centralized Application Tiers Massively distributed Services

Platform dependent Platform Independent

Request / Reply driven Request/Reply, Publish/Subscribe ,

Events driven
HTML Pages AJAX rich Internet applications

8
 Service
ServiceArchitecture
Architecture Type
Type II

Service request

Service Service
Consumer Service response
Provider

9
 Service
ServiceArchitecture
Architecture –– Type
Type IIII

Service descriptions

10
 Web
Web Services
Services

• Web service is a method of communication between two electronic devices

over a network

• Accepts a request and sends a response for a task or activity to be

performed

• Web Services are an implementation of the SOA framework

• Service requests / responses are done over the internet between systems

• Major industry developers of Web services are

– Apache
– IBM
– Microsoft
– HP
– Oracle

11
Sample
Sample services
services within
within aa website
website

12
 Web
Web Service
ServiceArchitecture
Architecture

Waiting Getting
for Results
Request
Communication protocol / Data Formats
Location / Sending
Port Response

Service Consumer Service Provider

13
Web
Web Services
Services building
building blocks
blocks

14
 Understanding
Understanding WSDL
WSDL

• WSDL – Web service Description Language

• It is an XML based language that is used for describing the service( Eg. a
business offering in T24) and to provide a way for individuals and other
businesses to access the service

• Divided into 2 section – Non functional ( What it does) / Functional ( how it

does)

• Using WSDL an individual or a business entity list will have to list all their
service offerings on an Internet registry called Universal Description,
discovery and Integration simply called UDDI.

• Jointly developed by Microsoft and IBM

15
 Information
Information required
required to
to call
call aa Web
Web service
service

• Location : This is required to know where the Service is located. This is a

called an Uniform Resource Identifier (URI). This is similar to the URL which
is used to locate a website on the Internet.

• Interface : To invoke a method we need to know the name of the method,

formal parameters and return value

• Transport Protocol : Web services are usually located on a remote system

and to invoke the web service it has to be sent using http or smtp as a
protocol

• Message Protocol : The format of the message and its structure

16
 WSDL
WSDLElements
Elements

• The WSDL file can be broken down into 3 specific areas that can be
combined or reused once defined
– Types
– Operations
– Binding

• The WSDL file has various elements but they can be contained within the
above three main elements
– Definition
– Data Types
– Message
– Operation
– Port Type
– Binding
– Port
– Service

17
 WSDL
WSDLElements
Elements

• Definition: It is the root element of the WSDL document. It defines the

name of the web service and contains all the service elements described
here

• Data Type: The data types are in the form of XML Schemas

• Message: an abstract definition of the data, it is in the form of a message

presented as an entire document or as arguments to be mapped for
invocation

• Operation: the abstract definition for a message, such as naming a method,

message queue or business process, that will accept and process the
message

• Port Type: set of operations mapped to one of more end points, defining
the collection of operations for a binding

18
 WSDL
WSDLElements
Elements

• Binding: The protocol and data formats for the operations and messages
defined for a particular port type.

• Port: A combination of a binding and a network address, providing target

address of service communication

• Service: a collection of related end points encompassing the service

definitions in the file.

19
 WSDL
WSDLElements
Elements
<definitions>
<types> definition of types........
</types>
<message>
definition of a message....
</message>
<portType>
<operation>
definition of a operation.......
</operation>
</portType>
<binding>
definition of a binding....
</binding>
<service> definition of a service....
</service>
</definitions>

20
Sample
Sample WSDL
WSDLfile
file of
of aa Web
Web service
service

21
 Simple
Simple Object
ObjectAccess
Access Protocol
Protocol (SOAP)
(SOAP)

• Process of sending information in a structured format generally in the

implementation of web services

• Uses the transport protocol mostly Hypertext Transfer Protocol (HTTP) or

Simple Mail Transfer Protocol (SMTP) for message transmission

• Relies on XML for its message format

• Defines an XML structure

– To call a method on a remote machine and pass arguments
– To return values
– Raise Error messages in case of errors

• It facilitates interoperability in a platform independent environment

22
 Components
Components of
of aa SOAP
SOAP message
message

• Envelop package
• Header / Body pattern

Header

Body

23
 What
What constitutes
constitutes SOAP
SOAP

• Envelope
– The top element of the XML document representing the message

• Header
– Determines how a recipient of a SOAP message should process the message
– Adds features to SOAP message such as authentication, txn management,
message routing, security etc.

• Body
– The top element of the XML document representing the message

• All the above are represented as XML nodes as separate TAGs.

24
 Temenos
Temenos Web
Web services
services

• Temenos web services is designed to provide robust SOA web services of

T24.

• TWS exposes business services and business operations Web services –

Interoperability ( WS- I) compliance

• TWS is a replacement for Temenos Application Gateway (TAG) a previous

web service tool offering

• TWS composer is a part of the SOA framework suite of applications

• TWS provides both the .NET and JEE flavours

• TWS contains an eclipse plugin and also a WAR file containing web service
implementation

25
 Temenos
Temenos Web
Web services
services

• The eclipse plugin presents a list of ‘Business Services’ defined in the T24

• Each business service is a collection of ‘Business Operations’

• Business Services are stored in a T24 table called EB.SERVICE

• Business Operations are stored in a T24 table PW.ACTIVITY

• A Business Operation can be either a contract ( VERSION in T24) or a

query (ENQUIRY)

• Selected business operations are exposed as Web services via web APIs.

26
 Software
Software requirements
requirements for
for TWS
TWS (EE)
(EE)

• Eclipse : Requires JDK 6 or higher

• Ensure JAVA_HOME environment variable is set

• Ensure JAVA_HOME\bin folder is appended to PATH variable

• TOCF(EE) compatible Application Server

• Temenos Design Studio

• Eclipse 3.5 (Galilieo) with Web Tools Platform (WTP) or eclipse 3.6

• TWS related plug-ins provided by Temenos

27
 T24
T24 setup
setup to
to support
support TWS
TWS (EE)
(EE)

• Product to be installed in T24 : WS

• Application to be used

– OFS.SOURCE
– PW.ACTIVITY
– EB.SERVICE

28
TWS
TWS –– Service
Service definition
definition

29
Setup
Setup of
of jremote
jremote

‘Attributes’ field should be left

blank to receive OFS Response
from the ‘callOFS’ method as
native OFS response as shown
below

30
Connection
Connection for
for jbase_agent
jbase_agent

31
 Install
Install Temenos
Temenos Design
Design studio
studio

• Install Temenos Design Studio and any Eclipse editor that supports temenos
plug-ins for TWS(EE)

32
T24
T24 Plug-ins
Plug-ins for
for TWS
TWS

33
Various T24 related plugins

34
T24
T24 Plug-ins
Plug-ins for
for TWS
TWS

35
T24
T24 Plug-ins
Plug-ins for
for TWS
TWS

36
T24
T24 Plug-ins
Plug-ins for
for TWS
TWS -- TAFC
TAFC

37
T24
T24 Plug-ins
Plug-ins for
for TWS
TWS -- TAFJ
TAFJ

38
Creating
Creating TWS
TWS project
project in
in design
design studio
studio

39
Creating
Creating TWS
TWS project
project in
in design
design studio
studio

Click here
to create
the service

40
Exporting
Exporting Web
Web Service
Service using
using design
design studio
studio

41
Exporting
Exporting Web
Web Service
Service

42
 Exporting
Exporting Web
Web Service
Service

Jboss-web.xml

t24-ds.xml

43
 Strong
Strong typed
typed WSDL
WSDL

• WDSL with strong data types is selected the schema that has generated will
be mapped with the corresponding data types.

44
Strong
Strong typed
typed WSDL
WSDL

45
 Deploy
Deploy the
the service
service required
required
tws.properties

46
 Deploy
Deploy the
the service
service required
required
tws.properties

47
 Data
Data type
type mapping
mapping

• The T24 data type : String, Currency, Date, Recurrence, Frequency,

Password, Amount, BlockText and imUpload

• The Java types that are getting mapped with the fields in XSD as:
– String – for T24 types string like Currency, BlockText, imUpload,
Recurrence, Frequency, Password
– Date - for T24 type Date
– Decimal - for T24 type Amount

48
 Data
Data type
type mapping
mapping

• Example to show that the date is passed as string data in the earlier TWS
java version.

• With the new TWS java version the data type of the field is read from the SS
and the schema are mapped to the specific data type

49
 Data
Data type
type mapping
mapping

• You know that the CURRENCY field holds data of three char length. Earlier
it was allowed to enter any three char input for the CURRENCY field.

• But the new TWS java applies restrictions and hence the web service will
accept only three alphabets as an input

50
 Accessing
Accessing the
the service
service

• Start the application server ( Run the run.bat in your jboss)

• Test whether the web services are successfully deployed by browsing to the
following URL.
• http://<host>:<http port> / TWS Project name > / services

51
 Open
Open the
the SOAP
SOAP UI
UI software
software

• Start the SOAP UI software

• Test whether the web services

52
Trigger
Triggeran
anOFS
OFSevent
event directly
directlyin
inWeb
WebService
Service

53
Use
Use

54
Export
Export the
the war
war file
file to
to deploy
deploy folder
folder

55
Launch
Launch the
the SOAP
SOAP UI
UI to
to test
test the
the WSDL
WSDL

56
CUSTOMER
CUSTOMER OFS
OFS string
string is
is passed
passed

57
Customer
Customer record
record updated
updated successfully
successfully

58
Enquiry
Enquiry request
request via
via OFS
OFS

59