Open Interfaces CCT SDK_img_0

CCT Open Interfaces SDK

Frequently Asked Questions

1.            How to manually generate the Proxy Code. 2

Java - Apache CXF - wsdl2Java. 2

C# - Visual Studio – wsdl.exe. 2

For Single Service. 2

For Multiple Services. 3

2.            The difference/reason for using NotificationProducer as opposed to NotificationConsumer  4

Notification Producer. 4

Notification Consumer. 4

3.            The difference/reason for using User and Session services. 4

User Service. 4

Session Service. 4

4.            The length of time the session is kept in CMF. 4

 

 

 

 

1.            How to manually generate the Proxy Code

Java - Apache CXF - wsdl2Java

To manually generate the proxy code using Apache CXF Services Framework - WSDL to Java, please see the following tutorials:

·          Tutorial 1

·          Tutorial 2

C# - Visual Studio – wsdl.exe

For Single Service

To use Visual Studio’s WSDL.exe please follow these steps:

a)      Make Sure you update your hosts file

image005

 

b)      Open up the Visual Studio Command Prompt

 

 

c)      Type in the command

·          wsdl

·          Location of your service

·          /out: Location of Generated Proxy

 

Example

wsdl http://cs1ktest:9180/SOAOICCT/services/AddressService?wsdl /out:c:\generatedProxyCode.cs

 

 

d)      The generated proxy code will be saved to the Microsoft Visual Studio directory

 

 

For Multiple Services

For multiple services, you need to generate the proxy code for all your required services into one single file and include the option /sharetypes.

To use Visual Studio’s WSDL.exe for multiple services please follow these steps:

a)      Please see step A above

b)      Please see step B above

c)      Type in the command

·          wsdl

·          /sharetypes

·          Location of your service. Your services should be separated by a single space

·          /out: Location of Generated Proxy

 

Example

wsdl /sharetypes  http://cs1ktest:9180/SOAOICCT/services/SessionService?wsdl http://cs1ktest:9180/SOAOICCT/services/AddressService?wsdl http://cs1ktest:9180/SOAOICCT/services/AgentService?wsdl /out:c:\generatedProxyCode.cs

 

d)      The generated proxy code will be saved to your specified directory. Please note you can

 

 

 

 

2.            The difference/reason for using NotificationProducer as opposed to NotificationConsumer

Notification Producer

A Notification Producer is capable of producing a set of Notification messages. One uses the NotificationProducer to send out requests to the web services.

 

Notification Consumer

A Notification Consumer represents the endpoint to which the Notification Producer sends events. One uses the NotificationConsumer to receive responses from the web services.

 

Please see a detailed description of both the NotificationProducer and NotificationConsumer here:

·          Quick Start

 

 

 

3.            The difference/reason for using User and Session services

User Service

The User Service models a user in the system. This service provides methods to read attributes such as address(s), Terminals(s) etc. For more list of features this service provides, please see here:

·          User

Session Service

This is a summary service and represents a subset of all the other services exposed and as such can be used in place of them in many cases. The Session Service exposes a higher level API thus making it easier to use. For more list of features this service provides, please see here:

·          Session

 

 

4.            The length of time the session is kept in CMF

If there is no activity related to the SSO token for 2 hours (see configuration) the session will timeout and subsequent calls using this session will fail. If the user has registered for events then a SessionTermination imminent event will notify that the session is about to expire and must be refreshed. If the Open Interfaces service is interrupted (planned or unplanned) the session will be invalidated and an exception will be thrown the next time this session is used.