Cisco 9971 - Custom Background File Formats

Step 4
Use a text editor to edit the List.xml file. See Custom Background File Formats, on page 178 for the file
location, file, formatting requirements, and a sample file.
Step 5
Save your modifications and close the List.xml file.
When you upgrade Cisco Unified Communications Manager, a default List.xml file replaces your
customized List.xml file. After you customize the List.xml file, make a copy of the file and store it
in a different location. After upgrading Cisco Unified Communications Manager, replace the default
List.xml file with your stored copy.
Note
Step 6
To cache the new List.xml file, stop and start the TFTP service by using Cisco Unified Serviceability or disable
and reenable the Enable Caching of Constant and Bin Files at Startup TFTP service parameter that is located
in the Advanced Service Parameters area.
Custom Background File Formats
The List.xml file defines an XML object that contains a list of background images. The List.xml file is stored
in the following subdirectory on the TFTP server:
Desktops/640x480x24
If you are manually creating the directory structure and the List.xml file, you must ensure that the directories
and files can be accessed by the user\CCMService, which is used by the TFTP service.
Tip
For more information, see the documentation for your particular Cisco Unified Communications Manager
release.
The List.xml file can include up to 50 background images. The images are in the order that they appear in the
Background Images menu on the phone. For each image, the List.xml file contains one element type, called
ImageItem. The ImageItem element includes these two attributes:
•
Image: Uniform resource identifier (URI) that specifies where the phone obtains the thumbnail image
that appears on the Background Images menu on a phone.
•
URL: URI that specifies where the phone obtains the full-size image.
The following example shows a List.xml file that defines two images. The required Image and URL attributes
must be included for each image. The TFTP URI that is shown in the example is the only supported method
for linking to full-size and thumbnail images. HTTP URL support is not provided.
List.xml Example
<CiscoIPPhoneImageList>
<ImageItem Image="TFTP:Desktops/640x480x24/TN-Fountain.png"
URL="TFTP:Desktops/640x480x24/Fountain.png"/>
<ImageItem Image="TFTP:Desktops/640x480x24/TN-FullMoon.png"
URL="TFTP:Desktops/640x480x24/FullMoon.png"/>
</CiscoIPPhoneImageList>
The phone firmware includes a default background image. The List.xml file does not define this image. The
default image is always the first image that appears in the Background Images menu on the phone.
Each background image requires two PNG files:
Cisco Unified IP Phone 8961, 9951, and 9971 Administration Guide for Cisco Unified Communications Manager
10.0
178
Custom Background Images