Cisco CDR XML User Manual

CDR XML Tags and Attributes

This appendix details XML tags used to label data in the stored CDR .xml file, the attributes of each configurable tag, and the order in which the tags are arranged. Topics in this section include:

• Overview of the CDR XML Tag Index, page B-1

• Understanding the CDR XML Tags, page B-5

Note All references to “VCS” in this appendix are equivalent to “Resource Manager”.

Overview of the CDR XML Tag Index

The production and storage of CDR (Call Data Records) in Resource Manager is enabled via the Resource Manager Configuration Tool. CDR records are saved in XML format and provide comprehensive records of each call which can then be used for analysis of the system for diagnostic and billing purposes.

The CDR XML tag index is a detailed list of each element that can be configured to appear in the CDR.

For more information about configuring the CDR, see the “Using the CDR Configuration Tab” section

on page 11-14.

APPENDIX

Accessing the CDR XML Tag Index

A CDR file is generated each day, by default.

Procedure

Step 1 To access CDR .xml files, from the Windows Start menu, select Programs > Cisco Unified

Videoconferencing Manager > CDR files.

Step 2 Open the relevant CDR file.

The information configured to appear is listed within the tags. For a list (index) of the XML tags that can appear in the CDR, see Table B-1 on page B-2.

OL-13557-01

Cisco Unified Videoconferencing Manager Administrator Guide

B-1

Overview of the CDR XML Tag Index

Index of XML Tags in the CDR

The following is a list of the xml tags in the CDR, listed in their hierarchical relationship to each other.

Note In the tags, “VCS” is equivalent to “Resource Manager“, “conference” is equivalent to “meeting”, and

“service” is equivalent to “meeting type”.

Table B-1 Index of XML tags in the CDR

Element

<Scheduling-Data> </Scheduling-Data>

<Basic-Information> </Basic-Information>

<Virtual-Conference-ID />

<Master-Conference-ID />

<Slave-Conference-ID-List> </Slave-Conference-ID-List>

<Slave-Conference-ID />

<Reference-Code />

<MultiPoint-PointToPoint />

<Scheduled-Adhoc />

<Start-Time />

<VCS-Server-TimeZone />

<Auto-Extend />

<Advanced-Information> </Advanced-Information>

<Extra-IP-Ports-Reserved><Extra-IP-Ports-Reserved/>

<Extra-ISDN-Ports-Reserved />

<DateTime-Scheduled />

<DateTime-Cancelled />

<Conference-Lifecycle-Summary> </Conference-Lifecycle-Summary>

<Resources-Scheduled> </Resources-Scheduled>

<DateTime-Modified />

<Total-IP-Bandwidth />

<Total-ISDN-Bandwidth />

<Total-MCU-Connections-Number />

<Total-GW-Connections-Number />

<Conference-Service> </Conference-Service>

<VCS-Service-Id />

<MCU-Service-Prefix />

<Min-Video-Layout />

<Max-Video-Layout />

<Max-Bit-Rate-In />

<Max-Bit-Rate-Out />

<Max-Frame-Rate-In />

<Max-Frame-Rate-Out />

<Max-Picture-Format-In />

Appendix B CDR XML Tags and Attributes

B-2

Cisco Unified Videoconferencing Manager Administrator Guide

OL-13557-01

Appendix B CDR XML Tags and Attributes

Table B-1 Index of XML tags in the CDR (continued)

Element

<Max-Picture-Format-Out />

<Max-T120-Ports-Reserved />

<Max-Subconferences />

<Resources-Scheduled-At-Time-Of-Conference> </Resources-Scheduled-At-Time-Of-Conference>

<Total-IP-Bandwidth />

<Total-ISDN-Bandwidth />

<Total-MCU-Connections-Number />

<Total-GW-Connections-Number />

<Attendees-Terminals> </Attendees-Terminals>

<VCS-User-Id />

<Login-Id />

<First-Name />

<Last-Name />

<VCS-Customer-Id />

<Company-Name />

<Customer-Profile-Type />

<Customer-Billing-Phone />

<Is-Controller />

<VCS-User-Id />

<Login-Id />

<First-Name />

<Last-Name />

<VCS-Customer-Id />

<Company-Name />

<Customer-Profile-Type />

<Customer-Billing-Phone />

<Is-Controller />

<Attendees-Registered-to-VCS> </Attendees-Registered-to-VCS>

<Attendee-Registered-to-VCS> </Attendee-Registered-to-VCS>

<VCS-User-Id />

<Login-Id />

<First-Name />

<Last-Name />

<VCS-Customer-Id />

<Company-Name />

<Is-Controller />

<External-Attendees> </External-Attendees>

<External-Attendee> </External-Attendee>

<First-Name />

<Last-Name />

<Predefined-Terminals> </Predefined-Terminals>

<Predefined-Terminal> </Predefined-Terminal>

<Terminal-Id />

<Dial-String />

<IP-ISDN-SIP />

Overview of the CDR XML Tag Index

OL-13557-01

Cisco Unified Videoconferencing Manager Administrator Guide

B-3

Overview of the CDR XML Tag Index

Table B-1 Index of XML tags in the CDR (continued)

Element

<External-Terminals> </External-Terminals>

<Attendees-Terminals-Association> </Attendees-Terminals-Association>

<Network-Devices> </Network-Devices>

Appendix B CDR XML Tags and Attributes

<Dial-in-Dial-out />

<MCU />

<Zone-Prefix />

<External-Terminal> </External-Terminal>

<Dial-String />

<IP-ISDN-SIP />

<Dial-in-Dial-out />

<MCU />

<Zone-Prefix />

<GK-Proxy-Information> </GK-Proxy-Information>

<VCS-ID />

<IP-Address />

<Zone-Prefix />

<SIP-Domain />

<GK-Device-Association> </GK-Device-Association>

<MCU-Information> </MCU-Information>

<VCS-ID />

<Master-Slave />

<Zone-Prefix />

<Service-Prefix />

<List-of-Assigned-Terminals> /<List-of-Assigned-Terminals>

<Gateway-Information> </Gateway-Information>

<VCS-ID />

<Phone-Number />

<Service-Prefix />

<Service-Bandwidth />

<Country-Code />

<Area-Code />

<Zone-Prefix />

<Terminal-Gateway-Association> </Terminal-Gateway-Association>

B-4

Cisco Unified Videoconferencing Manager Administrator Guide

OL-13557-01

Appendix B CDR XML Tags and Attributes

Table B-1 Index of XML tags in the CDR (continued)

Element

<Room-Information> </Room-Information>

<VCS-ID />

<Terminal-Room-Association> </Terminal-Room-Association>

<Completed-Conference-Data> </Completed-Conference-Data>

<Conference-Status />

<Reason-Failed />

<Actual-Start-Time />

<Actual-End-Time />

<Terminals-Registered-to-VCS> </Terminals-Registered-to-VCS>

<Terminal-Registered-to-VCS> </Terminal-Registered-to-VCS>

<VCS-Terminal-Id />

<IP-ISDN-SIP />

<Dial-String />

<Total-Connection-Time />

<List-of-Connection-Records /> <List-of-Connection-Records />

<Actual-External-Terminals> </Actual-External-Terminals>

<Actual-External-Terminal> </Actual-External-Terminal>

<IP-ISDN-SIP />

<Dial-String />

<Total-Connection-Time />

<List-of-Connection-Records /> <List-of-Connection-Records />

Understanding the CDR XML Tags

Understanding the CDR XML Tags

Table B-2 on page B-6 provides details about each CDR tag and includes a reference to information

about configuring the tag in the CDR.

Note For reference purposes, tags in the table are cross-referenced to tags listed in Table B-1 on page B-2 and

vice-versa.

Cisco Unified Videoconferencing Manager Administrator Guide

OL-13557-01

B-5

Understanding the CDR XML Tags

Note In the tags, “VCS” is equivalent to “Resource Manager“, “conference” is equivalent to “meeting”, and

“service” is equivalent to “meeting type”.

Table B-2 CDR XML Tag details

Appendix B CDR XML Tags and Attributes

Tag

Description Attribute Type Example

Defines the beginning of all conference data. Contains data for the conferences of an entire day or for a single conference depending on the configuration.

<Event></Event> Defines the

conference type. Indicates if the conference is upcoming, cancelled, changed, etc.

Defines the beginning of data recording for a meeting instance.

<Scheduling-Data> </Scheduling-Data>

Contains data directly related to meeting scheduling, such as which resources are reserved and which attendees and/or terminals are invited as part of meeting scheduling.

Contains meeting scheduling data such as the meeting ID, meeting start time, meeting duration, amount of extra IP/ISDN ports reserved, etc.

--- --- ---

B-6

Cisco Unified Videoconferencing Manager Administrator Guide

OL-13557-01

Appendix B CDR XML Tags and Attributes

Table B-2 CDR XML Tag details (continued)

Understanding the CDR XML Tags

Tag

<Basic-Information> </Basic-Information>

Description Attribute Type Example

Contains basic information about the scheduling of a meeting.

<Virtual-Conference-ID /> Contains the

Vir t u al Conference ID number of a specific conference.

<Master-Conference-ID /> Contains the ID

used to identify the meeting on the master MCU.

<Slave-Conference-ID-List> </Slave-Conference-ID-List >

Contains a list of meeting IDs on the slave MCUs

<Slave-Conference-ID /> Contains the

meeting ID for a single slave MCU.

<Subject /> Contains the

meeting subject as entered during meeting scheduling.

<Reference-Code /> Contains any

internal department, billing, client or account numbers used to track resource use within a company, that are entered during meeting scheduling.

<Description /> Contains the

description of the meeting, which is entered during meeting scheduling.

--- --- ---

value Integer <VCS-Confer

ence-ID value="1307" />

--- --- ---

value Zone Number +

Service Prefix ID + Physical Conference ID

<SlaveConference-I D value="175-8 0-4417" />

value String <Subject

value="Quart er 3 Results Discussion" />

value String <Reference-C

ode value="10123 6" />

value string <Description

value="Let’s get together to discuss Q3 results and Q4 prospects." />

OL-13557-01

Cisco Unified Videoconferencing Manager Administrator Guide

B-7

Understanding the CDR XML Tags

Table B-2 CDR XML Tag details (continued)

Appendix B CDR XML Tags and Attributes

Tag

Description Attribute Type Example

<MultiPoint-PointToPoint /> Displays whether a

multipoint meeting or a point-to-point meeting is scheduled.

<Scheduled-Adhoc /> Displays whether

the meeting is scheduled to start at a future time or if it is created immediately (ad hoc) via Resource Manager or an endpoint.

<Start-Time /> Contains the

scheduled start time of the meeting.

<Duration /> Contains the

scheduled meeting duration.

<VCS-Server-TimeZone /> Contains time

zone information of the Resource Manager server.

<Auto-Extend /> Determines

whether or not Auto Extend is selected during meeting scheduling.

<Advanced-Information> </Advanced-Information>

Contains advanced meeting scheduling information.

<Extra-IP-Ports-Reserved>< Extra-IP-Ports-Reserved/>

Contains the number of additional IP ports that are reserved for the meeting during meeting scheduling

value Multipoint/Poin

tToPoint

value VCS Scheduled/

VCS Ad Hoc/ Endpoint Initiated Ad

Hoc

value yyyy-mm-ddTh

h-mm-ssZ

<Start-Time value="200303-29T11:35: 47Z" />

value Integer Minutes <Duration

value="30 Minutes" />

value GMT+/-XX:XX <VCS-Server

-TimeZone value="GMT +08:00" />

value Boolean <Auto-Exten

d value="false" />

--- --- ---

value Integer <Extra-IP-Por

ts-Reserved value="2" />

B-8

Cisco Unified Videoconferencing Manager Administrator Guide

OL-13557-01

Appendix B CDR XML Tags and Attributes

Table B-2 CDR XML Tag details (continued)

Understanding the CDR XML Tags

Tag

<Extra-ISDN-Ports-Reserve d />

Description Attribute Type Example

<Extra-ISDN-Port s-Reserved />

<Priority /> Displays the

Priority option selected during meeting scheduling.

<DateTime-Scheduled /> Contains the date

and time that the meeting is scheduled via the Resource Manager.

<DateTime-Cancelled /> If a meeting is

cancelled prior to its scheduled start time, the tag contains the date and time of cancellation.

<Conference-Lifecycle-Sum mary> </Conference-Lifecycle-Sum mary>

Contains lifecycle information for a single instance of a scheduled meeting, including basic statistics captured during meeting scheduling, as well as records of any modifications prior to the actual meeting.

<Resources-Scheduled> </Resources-Scheduled>

Contains a list of resources scheduled when a meeting is created or modified.

<DateTime-Modified /> Contains the date

and time of modification of a scheduled meeting.

value Integer <Extra-ISDN

-Ports-Reserv ed value="1" />

value Unspecified/

Bandwidth/Dela y

value yyyy-mm-ddTh

h-mm-ssZ

value yyyy-mm-ddTh

h-mm-ssZ

<DateTime-C ancelled value="N/A" />

--- --- ---

value yyyy-mm-ddTh

h-mm-ssZ

OL-13557-01

Cisco Unified Videoconferencing Manager Administrator Guide

B-9

+ 21 hidden pages