Cisco Cisco TelePresence Management Suite (TMS) Version 15 Developer's Guide

Page of 74
GUI pattern
Cisco TMSBA can supply data to the front-end GUI of an external booking application. There are three 
information types.
System information
Information on Cisco TMS resources can be exported to an external application. By using 
the remote setup 
API
, data on systems in Cisco TMS can be exported to a front-end GUI and used to display system entities 
available in Cisco TMS.
Get a list of available systems in Cisco TMS by using either:
 
n
GetSystems
 
n
GetSystemsForUser
These functions return lists of TMSSystem objects, that include information such as the ID of the system, to 
show in the front-end GUI. GetSystems will return all systems in Cisco TMS, while GetSystemsForUser 
will only return the systems the user has booking privileges for. If the external GUI application controls 
system access, use GetSystems and filter the systems in the application.
Availability information
Information on the availability Cisco TMS entities can be exported to an external application. Reservations in 
the Cisco TMS internal reservation database can be displayed and bookings filtering by users.
 
n
Get all Cisco TMS reservations between two specified dates by using GetConferencesForUser.
 
n
Get system availability information by using GetConferencesForSystems.
 
n
Get a specific conference, including any exceptions if it is a recurring conference, by using 
GetRecurrentConferenceById
. This information can be used, for example, by an external application 
to display an availability calendar.
 
n
Filter availability information by using the Conference object.
 
n
The Remote Setup API function GetUsers returns all users registered in Cisco TMS. The output of this 
function can be used to display a drop-down list of all users in Cisco TMS, or show conferences booked by 
a specific person.
Booking management
The API allows you to forward booking requests from an external booking system to Cisco TMS, and reserve 
resources in Cisco TMS. (Information exchange: 
External Booking System > TMS
).
 
n
Get Conference objects with default values for Conference properties defined in Cisco TMS by using the 
GetDefaultConference
 function. 
 
n
Retrieve existing conferences by using GetConferenceByIdGetConferenceIdByExternalId or 
GetRecurrentConferenceById
.
 
n
Save changes to a conference by editing the conference properties and using the function 
SaveConference
. This will save the conference to Cisco TMS if the properties validate. If not, an 
exception will be raised.
Cisco TelePresence Management Suite Extension Booking API Programming Reference Guide (14.4)     
Page 20 of 74
Using the APIs for remote setup and booking