Installation of the LionScreens Webservices

The LionScreens web service can be found in the same directory as the Provided web services, which is the folder ‘[Binaries\]Common\WebProvider’ of the application. Among other files, this folder will contain the service itself, LionScreens.svc ,the configuration files LionScreens.ini and Web.Config as well as a pre-generated wsdl file, LionScreens.wsdl.

The WebProvider folder should be added as <IIS Application> to the IIS in order to make the LionScreens web service reachable, if this was not done already for an AMT Provided Web Services.

Configuration file LionScreens.ini

The LionScreens web service uses a configuration file LionScreens.ini. This file contains information on how to reach the correct application server either by directly connecting the application server (USEAPPMANAGER=False) or by first connecting the an application manager (USEAPPMANAGER=True).
Also information on how to log on to the web service needs to be defined here.

Default values are shown in bold.

Setting	Value	Description
ADDRESS	Hostname/IP	Contains the address of the application server/manager either by hostname or IP Address.
PORT	TCP port number	Contains the port of the application server/manager.
SPAREADRESS	Hostname/IP	Optional setting. Contains the address of a spare application server/manager either by hostname or IP Address.
SPAREPORT	TCP port number	Optional setting. Contains the port of a spare application server/manager.
TIMEOUT	Seconds	How long the service will wait on a response before it will time out in seconds. Default value is 60.
USEAPPMANAGER	TRUE/FALSE	Must be set to TRUE when the application uses an application manager. Default value is false.
CONNECTIONTIMEOUT	Seconds	The webservice inactivity timeout. When the Lionscreens webservice is inactive longer than the time set here the connection will be terminated. Default value is 180.
CONCURRENTCALLS	Number of connections	The number of maximum concurrent connections to the webservice. Default value is 100.
VERIFYUSERACCOUNT	TRUE/FALSE	Determines whether to verify the user which logs on to the system. An empty username is not allowed. Configuration of useraccounts can be done in the User and Roles pages of the Control Center. Default value is false.
GENERATEUSERACCOUNT	TRUE/FALSE	When set to true a unique username and station name will be generated for this logon. These values will be passed to the Application server and SI-NTLOGIN and SI-INITIATOR will be filled with those values. Default value is false.
SECUREFORMACCESS	TRUE/FALSE	When set to TRUE the forms-security of the user/role in the Control Center will be used. Default value is false.
DELETESESSIONDATA	TRUE/FALSE	If the value for this parameter is "TRUE", the data that was used during the web service session will be deleted after the session ends. Otherwise, this data will be stored as retained session data items. Default value is false.

Configuration file Web.config

To access the LionScreens web service, the Web.config file should be edited by searching for the following section:

The property httpGetEnabled needs to be set to true.

For debugging purposes the includeExceptionDetailsInFaults property can be set to true, in order to show detailed information about errors that may occur when accessing the web service.

LionScreens.svc

By accessing the LionScreens service, a wsdl file can be generated automatically which is needed for consumable web services that want to connect to the LionScreens web service. The WSDL that you load into the consumable web service should be the singlewsdl option of the LionScreens web service, this singlewsdl can be accessed by adding it as parameter to the web service. Example: http://<IIS host>/<Virtual Dir>/LionScreens.svc?singlewsdl

LionScreens.wsdl

While it is advised to use the single wsdl generated by the web service directly, it is also possible to use the pre-generated LionScreen.wsdl file for consumable web services that want to connect to the LionScreens web service.

Before this file can be used, the line containing the endpoint soap address for the LionScreens.svc service definition file should be set to the correct URL.

<soap:address location="http://<IIS host>/<Virtual Dir>/LionScreens.svc"/>

Where <IIS host> is the host that provides the Webservice and <Virtual Dir> is the virtual directory which points to the WebProvider folder.

Form options

The application initial form as well as all the forms to be accessed by the web service, must be web service enabled in the Form Options in the AMT Developer Studio: