Cisco Cisco TelePresence Management Suite (TMS) Version 15 Developer's Guide
Setting up your environment
Cisco TMSBA provides a Web Services API that interfaces with the Cisco TMS booking engine. Web
Services allows for simple integration into most common language and programming environments.
Services allows for simple integration into most common language and programming environments.
See your development tool reference for information on how to build implementation stubs to help speed the
development of applications that use Web Services.
development of applications that use Web Services.
API locations
n
The WSDL file for the Cisco TMS remote setup API is located at: http://[Cisco TMS server]
/tms/external/booking/remotesetup/remotesetupservice.asmx
/tms/external/booking/remotesetup/remotesetupservice.asmx
n
The WDSL file for Cisco TMSBA is located at: http://[Cisco TMS server]
/tms/external/booking/bookingservice.asmx
/tms/external/booking/bookingservice.asmx
Microsoft Visual Studio .NET users can reference the APIs by selecting
Project > Add Web Reference
, or
entering the URLs above. You will be required to authenticate through web services to create the reference.
In a network load balancing scenario, use the virtual IP address or DNS name of the cluster for this task to
allow failover for the API.
allow failover for the API.
Security
We strongly recommend using SOAP for all requests. For security reasons, HTTP GET and POST are only
accessible from localhost. To change this, modify the Cisco TMS web.config file.
accessible from localhost. To change this, modify the Cisco TMS web.config file.
Optional elements
Optional elements are indicated in different ways in the WSDL:
n
minOccurs = 0
means the element can be omitted from the request XML altogether.
n
nillable="true"
means the element can hold an empty value.
The combination of these two is an element that can be skipped and be set to null (not a value).
Boolean values
The boolean lexical forms "1" and "true" are interchangeable in SOAP.
Cisco TMSBA Programming Reference Guide
Page 15 of 68
Using the APIs for remote setup and booking