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

Page of 53
Booking API reference
Cisco TMSBA Programming Reference Guide
Page 41 of 53
GetConferenceIdByExternalId 
This function is used to look up a conference that has been updated in the external source, and that must be 
updated in Cisco TMS. The ExternalSourceId and ExternalPrimaryKey fields must have been 
provided with the initial performance of the SaveConference function.
This function is typically used when information about a conference reserved in the external application is 
needed. First this function is call to get the corresponding conference is Cisco TMS. The GetConferenceById 
is used to get information about the conference from Cisco TMS.
Supported parameters:
ExternalSourceId
Unique identifier of the external source (server IP address).
ExternalConferenceId
Unique identifier of the conference within the external source (primary key 
in database).
RecurrenceIdUTC
Identifies an instance in a series of conferences. UTC-formatted datetime 
string.
Returned data:
 A ConferenceId, as defined in Cisco TMS.
GetRecurrentConferenceById 
Returns a Conference object with the given ConferenceId.  If the conference is a recurrent conference, 
existing exceptions to the recurrent series are returned in the RecurrencePattern Exceptions array of the 
returned Conference object.
Supported parameters:
ConferenceId
The ID of the conference, based on TMS IDs.
Returned data:
 A Conference object based on the ConferenceId.
If the provided ID does not exist, this will cause an error. See the section 
GetConferencesForSystems
This function returns all conferences for a list of systems between two dates. It is typically used to build a 
display of resource availability information in external application for a specific system when the external 
application does not store its own resource availability information.
The function should be used with caution. If a large number of conferences are booked between the two 
dates in Cisco TMS, it will take a long time to process the result of this function.
Supported parameters:
SystemIds
An array of IDs of the systems, based on Cisco TMS IDs.