T24 Service Connector.pdf
Transcript of T24 Service Connector.pdf
-
You are here: Enterprise Frameworks > Webservices > T24 Service Connector
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
1 of 17 13.03.2015 09:13
-
Introduction
T24Service Connector is a component deployed in IIS and widely used by TWS.NET and TOCF.NET to connect to T24. This T24 Service Connector is also available as ActiveX library. This type of T24 ServiceConnector allows a native vbs client to communicate with T24 by two message formats such as OFS & OFSML and it allows the native client to get the advantage of having simple load balancing , multiple ofs sourcetargets etc.
This user guide explains how to deploy and configure T24 Service Connector as a web service and as an ActiveX library.
Overview
T24Service connector provides the following:
Connection factory/connection pooling establishes connection with the configured TAFC agents.
Load balancing /high availability provides load balancing within the configured TAFC agents.
OFSML-OFS Parser Converts incoming OFSML request message to respective OFS request message format and sends it to T24. Then the OFS response message is converted into the respective OFSMLresponse message.
Assumptions
This document describes many concepts and methodologies that are highly technical in nature, and as such prerequisite knowledge of the following is considered essential:
Microsoft .NET Framework 4.0
IIS 5.1 or later
MS Office Excel
Prerequisites
T24 with R13 WS module installed.
T24 Service Connector as Web Service
Microsoft .NET Framework 4.0
IIS 5.1 or later
T24 Service Connector as ActiveX library
.NET Framework 4.0
MS Office Excel
Installation
T24 Service Connector as Web Service
T24 Service Connector
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
2 of 17 13.03.2015 09:13
-
T24ServiceConnector can be hosted in IIS by endpoint configuration. This type of architecture implements a scalable mechanism to add additional connectors to T24ServiceConnector and leverages WCF connectionhandling properties. For example: service throttling.
Copy the T24ServiceConnector directory from the install kit to the deployment server machine
Open IIS (start > Run > inetmgr)
Select the site to be hosted. (In this case, it is assumed as Default Web Site).
Right Click on it and select Add Virtual Directory
Provide the Alias name and the path of the T24ServiceConnector(copied)
After the virtual directory is created in IIS 7, right click and select Convert to Application. (because T24 Connector should be loaded as IIS Application.)
Refer configuration section of T24ServiceConnector to configure the connectors
After configuring, select and right click on T24ServiceConnector.svc in the hosted directory and select browse to get the WSDL URL that can be used in TWS .NET or TOCF .NET to use T24 Serviceconnector.
Installing T24 Service Connector as ActiveX library
The distribution pack (T24ServiceConnector [VERSION].zip) contains all the required contents of the T24 Service Connector and the Service Connector ActiveX Installer.
This installer has to be used only to install Service Connector as ActiveX compatible library.
To install the T24 Service Connector as ActiveX library, double click the setup.exe under the ServiceConnectorActiveX. This initiates the setup wizard.
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
3 of 17 13.03.2015 09:13
-
Click next to continue
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
4 of 17 13.03.2015 09:13
-
Select the installation location and continue with the installation
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
5 of 17 13.03.2015 09:13
-
The user is prompted to specify the location where MS Office is installed. Specify the location and click next to continue with the installation.
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
6 of 17 13.03.2015 09:13
-
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
7 of 17 13.03.2015 09:13
-
Click close to complete the installation.
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
8 of 17 13.03.2015 09:13
-
T24ServiceConnector Logging
T24 Service Connector logging is configured in:
web.config for web service based deployment - this file is available under the T24ServiceConnector directory.
machine.config for ActiveX component- this file is available under the config folder of .NET Framework installed location.
The logging technology used by T24ServiceConnector is Microsoft Enterprise Logging. There are five different categories of logging such as:
Info Provides the information logs
Timing Provides the time consumed in each layer
Trace Provides detailed descriptive logs
Warning Provides the warning logs
Error Provides the error logs
By default Logging is enabled and the category filter is defaulted to Info and Error. The logs are stored in the below path:
\External\Logs\ T24ServiceConnector.txt
This logging ensures that the log entries are consistent and that messages can be inter-related by means of the request id.
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
9 of 17 13.03.2015 09:13
-
Configuration
connectors.xml - The connection properties to T24 (TAFC agent) are specified in the connectors configuration file and this file is available under conf folder under the deploy location of T24 Service Connector andfor ActiveX component the configuration file is available under conf folder located under the installed location of MS Office
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
10 of 17 13.03.2015 09:13
-
Connectors.xml:
ID- Identifies the T24 service connector instance
URL- Unique T24 service connector instance (WCF Service) URL
Namespace reservation has to be done for this url. Namespace reservation assigns the rights for a portion of the HTTP URL namespace to a particular group of users. A reservation gives those users theright to create services that listen on that portion of the namespace. This has to be achieved by the OS level tools such as httpcfg /netsh.
For more info refer http://msdn.microsoft.com/en-us/library/ms733768.aspx
Open the HttpConfig.exe (as administrator)
Click on Permissions tab1.
Click on Add button2.
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
11 of 17 13.03.2015 09:13
-
Enter the url for which the namespace has to be reserved3.
Click Ok4.
Choose Add in the pop up5.
Enter the user name
For example:
Provide the user/object name as IIS_IUSRS (should have administrator rights) in the object names text box
(or)
Provide the user/object name as Everyone in the object names text box
6.
Click on check names and then Click Ok7.
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
12 of 17 13.03.2015 09:13
-
Click Apply and then Click Ok to complete the process of namespace reservation for the specified user.8.
Click Apply and then Click Ok in the HttpConfig.exe utility window to save the changes & close the tool window.9.
OFSSourceId - T24 OFS.SOURCE record used by this connection
HostIP - Comma separate list of TAFC agent instance. Syntax: -,-,
LoadBalancing- When enabled, T24ServiceConnector creates a connection pool with evenly allocated connections among the list of available servers. If disabled then only High availability is ensured.
High availability - T24ServiceConnector attempts to access the first mentioned TAFC agent host details and creates connection pool, based on the configuration settings while the first request is initiated. While the
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
13 of 17 13.03.2015 09:13
-
TAFC agent connected goes down for an unavailable state, then the request is routed to the next available TAFC agent configured. Based on the Retry count configured the retry attempts are done.
Note: High availability of the Web service deployed in IIS is to be achieved by the user having the mechanisms available in the market.
Charset - Character set configured in T24 (for example: UTF-8, ISO-8859-1, etc.)
MaxPool - The max. number of TAFC agent connections to spawn.
MinPool - The min. number of TAFC agent connections to spawn. This option pre-fills the pool.
IdleTimeout - Timeout (in milliseconds) after which an idle TAFC agent connection is released to the pool.
IncrementFactor - Increment factor used when spawning new TAFC agent connections.
ActionTimeout - Timeout (in seconds) after which TAFC agent terminates a connection that has not processed a request in the specified number of seconds.
RetryInterval - Wait interval (in milliseconds) before re-connecting after a second connection failure.
RetryAttempts - No. of reconnection attempts
SSL - Indicates whether to enable SSL encryption between T24ServiceConnector and TAFC agent.
DN - Specifies the SSL certificates distinguished name. Only used when enabling SSL.
Compression - Indicates whether to enable data compression between T24ServiceConnector and TAFC agent.
CompressionThreshold - Specifies the minimum size (in bytes) for data packets to be compressed.
AllowInput - Indicates whether to allow users to enter data on the console output when requested by T24 (for example: due to T24 input request, JBC debugger prompt, etc.)
EnvironmentVariables - Semicolon separated list of additional environment variables to be applied to a TAFC agent connection (for example: .MYVAR1=AA; MYVAR2;BB)
AgentUser - TAFC agent user to use when TAFC agent is started in user authentication mode.
AgentPassword - TAFC agent password to use when TAFC agent is started in user authentication mode.
OFSConnector - T24Service Connector can connect to T24 through classic agent mode or through web service. This property when set to True T24Service Connector connects to T24 using the OFSConnectorservice deployed in IIS. If not the connectivity is done through agent.
OFSConnectorUser, OFSConnectorPassword and OFSConnectorCompany - Used to specify the user credentials to connect through OFSConnector Service
Creating multiple T24 Service connectors to service multiple OFS.SOURCE
There are system scenarios which require different requests to be processed by different T24 instances, possibly configured with different OFS.SOURCE entries. The following Connectors.xml configuration filedefines two T24 Service connectors pointing to two TAFC agent instances configured to use different OFS.SOURCE settings.
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
14 of 17 13.03.2015 09:13
-
Web.config is used in configuring T24ServiceConnector logging, WCF service binding properties/reader quotas/Connector properties as shown below. This configuration file is used only for web service baseddeployment. For ActiveX based component these configuration is done in machine.config file.
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
15 of 17 13.03.2015 09:13
-
Using T24 Service Connector as ActiveX library
As mentioned earlier, T24 Service Connector as ActiveX library allows a native vbs client to communicate with T24 by two message formats such as OFS & OFSML and allows the native client to get the advantage ofhaving simple load balancing , multiple ofs source targets etc. The method SendMessage is used to send a request to T24 and to get response from T24 as a string. SendMessage method takes 5 parameters:
SendMessage (REQUEST MESSAGE,REQUEST ID,SERVICE CONNECTOR URL, SERVICE CONNECTOR ID,MESSAGE FORMAT);
REQUEST MESSAGE OFS/OFSML request message
REQUEST ID- unique id used for logging and tracing per message
SERVICE CONNECTOR URL- the URL in service connector conf file
SERVICE CONNECTOR ID the service connector id in service connector conf file
MESSAGE FORMAT OFS/OFSML respective to the request message format
The installer has a sample vbs sample in it to test the working of T24 Service connector as ActiveX library. To do so:
Open the T24withActiveX.xlsm which is at Service connector installed directory\Sample\
Enter the OFS request and click Send OFS button
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
16 of 17 13.03.2015 09:13
-
The Activex (VBA code) used for this sample is
NowT24 Service Connector allows native VBS client to communicate with T24.
Resources
Namespace reservation: http://msdn.microsoft.com/en-us/library/ms733768.aspx
Published on : 21/05/2014
T24 Service Connector file:///D:/T24/Temenos/R14/R14AMR-CD-V1/Subsystems/R14SOAID/Content/T24 Service Connect...
17 of 17 13.03.2015 09:13