Professional Documents
Culture Documents
Interaction between the client and the web service is independent of the operating
system, SOAP processor, client software platform/programming language and
geographical location. This is due to the interoperability provided by the SOAP
format and the fact that XML can be represented/transmitted easily as plain ASCII
characters.
1 -> A user creates a project using TWS project template and communicates with T24
application server.
2 -> After connection is established, a list of Business Services and Operations is fetched.
3 -> The user selects the list of Business Operations from the Business Service to be
published as Web API.
4 -> TWS then creates a web service for the selected Business Services and Operations
and configures T24ConnectorService.
5-> The user then publishes the newly created WCF web service to the web server.
Certificate Server: It’s a virtual layer which validates the SSL certificate between Web Server
and Application Server.
1 -> External interface communicates with web services published in the web server.
2 -> The wrapper code communicates with the T24 application server and executes the
intended function or operation.
3 -> The web server receives the OFS response which is parsed to the respective class
object. CallOFS is the web method provided by default on creation of any web service, to
send OFS message as native OFS. To get the OFS response as Native OFS, create
OFS.SOURCE record as:
• Syntax Type : OFS
• Source : TELNET
4 -> The output is then picked up by the external interface from the web server.
Certificate Server: It’s an optional layer which validates the SSL certificate between Web
Server and Application Server.
Note : TWS uses jRemote.dll for connectivity, it is been mentioned as nremote, and so it
refers .NET not java.
2. Microsoft .NET 4.0 (Automatically gets installed when visual studio is installed)
3. WCF 4.0 (is part of the .NET frame work and get installed automatically along with it)
5. Secure Sockets Layer (SSL) is an optional component registered at TAFC Agent level
(must be started with it) and at TWS Composer (deployed in the OS where it is run) / IIS
(has to be deployed inside IIS, not enough if it is just available at the OS)
Note:
1. Components 2 and 3 have been included to ensure their availability, once visual studio
is installed.
2. Check whether WPFToolkit.dll is available in your machine. The command to check the
same:
gacutil /l | findstr WPFToolkit
3. If WPFToolkit.dll is not there, then you can download and add it to Global Assembly
Cache. The command to do the same is:
The path to the installation files must not contain any spaces.
Start the installation by executing ‘TWSSetup.vsix’ file. Since this adds an extension to VS
2010, you may not see TWS in ‘Add / Remove Programs’ as you had in the older version of
TWS.
Once the above step is completed, execute TWSConsole.exe. TWS Console setup will ask
you to supply two paths:
Please enter the Visual Studio 2010 IDE path: Enter the path where the devenv.exe is
present
Please enter the Microsoft SDK path: Enter the path where the xsd.exe is present
Note:
1. As a pre check make sure the user is signed in as an administrator.
2. Close all Visual Studio instances.
The default file in which you have to configure the URL, OFS Source, Host and Agent is
MyConnectors.xml. But you can also have a different configuration file, in such case the
web.config file of T24ServiceConnector has to be updated with the new configuration file.
In the URL tag, you have to specify the T24 Service Connector URL.
Ex: http://localhost:6066/ServiceConnectorT24
1. Go to Start > Accessories > Command Prompt > Right-Click (Run as Administrator).
2. Execute this at the command prompt:
netsh http add urlacl url=http://+:6066/T24ServiceConnector user=DOMAIN\username
6066 here is your port number, you can replace this with a port number of your choice (using
which your WCF service is hosted)
Example:
C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC> netsh http add urlacl
url=http://+:6066/ServiceConnectorT24 user=IIS_IUSRS
You should get a message saying “URL reservation successfully added”.
For Windows XP you can use httpcfg tool or a utility known as httpconfig.
3. TWS connects to T24 through the standard architecture. nRemote uses the jRemote
API to ‘talk’ to the TAFC Agent.
gt1 A WCF client connects to a WCF service via an Endpoint. Each service exposes its contract via one or
more endpoints. An endpoint has an address, which is a URL specifying where the endpoint can be
accessed, and binding properties that specify how the data will be transferred.
Business Operations
•Business Operations are specified in PW.ACTIVITY.
•A Business Operation can either be a contract (i.e.- a VERSION and function) or a
query(i.e.- an ENQUIRY).
The descriptions provided in PW.ACTIVITY and EB.SERVICE should be unique and not
contain special characters.
The selected Business Operations are exposed as web services via Web APIs which
connect to T24 via nRemote.
The EB.SERVICE record will show a multi-valued list of Activity Ids. One or more
EB.SERVICE records define all the activities which are exposed as Web Service operations.
Note: The description provided while creating records in PW.ACTIVITY & EB.SERVICE
should satisfy the below conditions,
• The description should not be repeated.
• The description should not have special characters.
• Record IDs for PW.ACTIVITY and EB.SERVICE need not necessarily be the same.
This is because from R12 onwards the description field in PW activity will be used for
naming the Web Service operation.
PW.Activity ID should start with WS., in order to bypass the PW.Activity ID validation.
The record we use for connecting TWS should have Source Type set to “Telnet”, Syntax
Type to “OFS” and Attribute value to “TWS”. The attribute PREAUTHENTICATED is
discussed later.
Note:
1. If there is a requirement to receive the OFS responses from the “callOFS” methods as
native OFS responses, then the Attributes field should be left blank.
2. 2. Refer to the OFS courseware for more details on the OFS.SOURCE application.
jbase_agent –p 20001 (If the port number is not specified, it will default to 20002).
Note: Before starting jbase agent, make sure the OFSSOURCE key is configured with the
ID of the OFS. Source record in web.config / devenv.exe.config is as follow:
<appsettings>
<add key=“OFSSOURCE value=“GCS”/>
</appsettings>
Note: For other options and instructions on how to start TAFC Agent as a service, please
refer the nRemote / TAFC Agent user guide.
Once the connection is established, Refresh and Disconnect option will be enabled and
Connect option will be disabled. The Refresh option is provided to reload the Landscapes
from T24.The disconnect option clears the landscape tree view and keeps the TWS
composer in a disconnected state.
Once the logon screen appears, type the IP address (e.g., Localhost if T24 is available in the
same machine where Visual Studio is running), the Port Number (20005) where jbase_agent
is listening and the OFS Source ID.
‘WSDL with Strong Data Types’ is an option available in the ‘Log On’ screen. Select the
option as of now. We will discuss about this option in detail later in this session.
Note: Each function against each service will generate at least one web method. For every
'Input' web method created, an equivalent 'Validate' web method is also created. In addition
to this, the CallOFS web method is also created by default for any version/enquiry to send
OFS messages to T24.
When a saved project is reopened, only the check box next to the operation (PW.ACTIVITY)
for which web service has been generated is checked and not the parent node. This is to
inform the user as to what are the operations for which web services has been generated
under this project.
If the user wants to add more services as part of the same project, they have to select the
operations along with the parent node. If you want the existing service also to be part of the
changed product, mere selection of operation is not enough, its parent node should also be
selected. If not, the old information will be lost and a new web service with only the new
operations will be created.
Note: While creating a project, the information for creating the metadata will be fetched from
the T24 system. Once the project is closed, the user is reconnected to the project and the
meta data will be loaded from the already saved XML file (found under the folder <project
path>\<project name>\External\LandScape). Only Refresh button will connect to T24 to
rebuild the meta data for some changes.
While connecting to T24 in your TWS project, you can select ‘WSDL with Strong Data
Types’. This ensures that the schema created for the VERSION and ENQUIRY holds typed
data not just string. This ensures simple data validation happens at Web Service itself.
By itself, this does not validate data. To validate the request based on the XSD, you have
add a key “ValidateRestrictions” and set its value to true in the web.config file.
Note: Either of the options can be selected. It will just affect the UI behavior, but the
business functionality will not be affected.
This screen shot shows the result of executing an Enquiry. There you need to specify the
T24 user name and password. In the response you can see the result and the status
message of TWS. You can scroll down to check the complete response.
1. All the dll files under bin folder except the dll named as <Project Name>.dll.
2. All the XML Schemas. These XML Schemas are available under External\XSD.
3. TWS service. The name of this file would be <Project Name>.svc.
Now right click the selected files and choose ‘Include In Project’ option.
A1
The WCF service throttling feature enables us to limit the number of concurrent WCF
connections. We recommend setting the maxConcurrentCalls attribute to the same value as
the T24 Service Connector ’s MaxPool property.
Note: Please refer .NET Windows Communication Framework documentation for further
details.
In general :
1. WCF service configuration should be given in "devenv.exe.config" (and not in app.config
file in a solution).
2. Addins and Plugins configuration can be specified in devenv.exe.config
Note: The displayed values for App settings / Configuration parameter have to be modified
based on the environment where executed.
Logging plays a vital role in any application/product, TWS provides quality logging and ease
in its configuration. There are two files for logging configuration:
devenv.config – Used for logging purpose of TWS composer.
web.config – Used for Web service logging.
The logging technology used by TWS is Microsoft Enterprise Logging and configured under
<loggingConfiguration> element in the config file. There are 5 different categories of logging
such as:
Info – Provides the informative logs
Timing – Provides the time consumed in each layer
Debug – Provides detailed descriptive logs
Decrypted – Provides the decrypted message (OFS)
content
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 for every project created respectively:
T24ServiceConnector\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.