Custom Background File Formats - Cisco 8821 Administration Manual

Cisco Unified Communications Manager Phone Configuration
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/800x480x24
If you are manually creating the directory structure and the List.xml file, you must ensure that the directories
Tip
and files can be accessed by the user\CCMService, which is used by the TFTP service.
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/800x480x24/TN-Fountain.png"
URL="TFTP:Desktops/800x480x24/Fountain.png"/>
<ImageItem Image="TFTP:Desktops/800x480x24/TN-FullMoon.png"
URL="TFTP:Desktops/800x480x24/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:
• Full size image: Version that appears on the on the phone.
• Thumbnail image: Version that displays on the Background Images screen from which users can select
an image. Must be 25% of the size of the full-size image.
Cisco Wireless IP Phone 8821 and 8821-EX Administration Guide for Cisco Unified Communications Manager
Custom Background Images
63