External Application Implementation

An external application that wants to utilize SICS Live Desktop (SLD) functionality, must be able to communicate with SICS Naming Service and SICS Workstation via Web Service requests according to the WSDL files published by the SICS Naming Service and SICS Workstation.

The typical usage pattern is for the external application to use “client stubs” that are generated from the WSDL files.

The SICS desktop runtime installation provides Java client stubs for SNS as well as SLD.

The stubs for SNS are provided in
<SICS installation>\runtime\lib\sics.naming.service.api.jar

and the stubs for SLD are provided in
<SICS installation>\runtime\lib\sics.live.desktop.api.jar

An alternative to using the delivered client stubs, is to perform the stub generation yourself. For this you need access to the WSDL file, and there are two ways to get hold of these files.

1. Get the WSDL information from running instances of the SNS and SICS Workstation at the following URLs: http://<SNS hostname>:<SNS port>/<rootcontext>/webservice?wsdl and
   http://<Workstation IP>:<Workstation port>/sics/webservice?wsdl

2. Refer to the WSDL files that come with the SICS installation. The SNS WSDL file is named "SNS.wsdl" and can be found in
   <SICS installation>\runtime\lib\sics.naming.service.api.jar

   When using this file, please update the <soap:address> element at the end of the file to point to the SICS Naming Service.

   The SICS Workstation WSDL file is named "SLD.wsdl" and can be found in
   <SICS installation>\runtime\lib\sics.live.desktop.api.jar

   When using this file, please update the soap:address element at the end of the file with appropriate values.