Cisco Cisco TelePresence MCU 4510 Developer's Guide

Page of 120
API reference 
Cisco TelePresence MCU API 2.8 
Page 29 of 120
 
cdrlog.enumerate 
This call allows the calling application to download CDR log data without having to return the entire 
CDR log. The call returns a subset of the CDR log based on the optional filter, index and numEvents 
parameters: 
Parameter 
Type 
Comments 
filter 
Array 
Optional. List of event types you are 
interested in. 
If omitted, all event types are returned. 
For the MCU, the call can request any / all 
of the following event types: 
 
scheduledConferenceStarted 
 
ad-hocConferenceStarted 
 
conferenceFinished 
 
participantJoined 
 
participantLeft 
index 
Integer 
Optional. Index from which to get events. 
The device returns the nextIndex so the 
application can use it to retrieve the next 
enumeration of CDR data.  
If index is omitted or negative, the device 
will enumerate events from the beginning 
of the CDR log. 
numEvents 
Integer 
Optional. Specifies maximum number of 
events to be returned per enumeration. 
If omitted (or not between 1 - 20 inclusive), 
a maximum of 20 events will be returned 
per enumeration. 
 
The response provides reference information such as time and log position, and an array of events 
that meet the call parameters requested: 
 
Parameter 
Type 
Comments 
startIndex 
Integer 
Either the revision number provided, or if 
that is lower than the first record the device 
has, it will be the first record it does know 
about.  
Comparing this with the index provided 
gives the user the number of dropped logs. 
nextIndex 
Integer 
Revision number of the data being 
provided, reusable in a subsequent call to 
the API. 
eventsRemaining 
Boolean 
Whether there is data remaining after this. 
Provided to avoid putting all data in a single 
call.