Custom Phone Ring Creation; Ringlist-Wb.xml File Format Requirements - Cisco 8831 Administration Manual

Custom phone ring creation

For more information, see the Cisco Intercompany Media Engine Command Line Interface Reference Guide.
Custom phone ring creation
The default ringtone implemented in the conference phone hardware is Chirp1. Cisco Unified Communications
Manager also provides a default set of additional conference phone ring sounds that are implemented in
software as pulse code modulation (PCM) files. The PCM files, along with an XML file, Ringlist-wb.xml,
which describe the ring list options that are available at your site, are found in the TFTP directory on each
Cisco Unified Communications Manager.
Both file formats can be used simultaneously on the conference phone.
The conference phone ringtone formats are backward compatible with the G.711ulaw/8-bit/8000 Hz raw
format as well as with previous Cisco Unified Communications Manager versions.
For more information, see the Cisco Unified Communications Manager System Guide, "Cisco TFTP" chapter,
and Cisco Unified Communications Operating System Administration Guide, "Software Upgrades" chapter.
The following sections describe how you can customize the conference phone ringtones that are available at
your site by creating PCM files and editing the Ringlist-wb.xml file.

Ringlist-wb.xml file format requirements

The Ringlist-wb.xml file defines an XML object that contains a list of conference phone ring types.
This file can include up to 50 ring types. Each ring type contains a pointer to the PCM file that is used for
that ring type and the text that will appear on the Ring Type menu on a conference phone for that ring. The
Cisco TFTP server for each Cisco Unified Communications Manager contains this file.
The
information:
<CiscoIPconference stationRingList>
<Ring>
<DisplayName/>
<FileName/>
</Ring>
</CiscoIPconference stationRingList>
The following characteristics apply to the definition names. You must include the required
FileName
•
•
Note The
This example shows a Ringlist-wb.xml file that defines two conference phone ring types:
<CiscoIPconference stationRingList>
<Ring>
<DisplayName>Analog Synth 1</DisplayName>
<FileName>Analog1.rwb</FileName>
</Ring>
<Ring>
Cisco Unified IP Conference Phone 8831 Administration Guide for Cisco Unified Communications Manager
9.0
104
CiscoIPconference stationRingList
for each conference phone ring type.
defines the name of the custom ring for the associated PCM file that will display on the
DisplayName
Ring Type menu of the conference phone.
specifies the name of the PCM file for the custom ring to associate with
FileName
and
DisplayName FileName
Cisco Unified IP Conference Phone 8831 customization
XML object uses the following simple tag set to describe the
fields must not exceed 25 characters.
and
DisplayName
.
DisplayName