List.xml File Format Requirements - Cisco CP-7970G Administration Manual

Creating Custom Background Images
The following sections describe how you can customize the background images that are available at your
site by creating your own PNG files and editing the List.xml file:
•
•
•

List.xml File Format Requirements

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/320x216x16 for Cisco Unified IP Phone 7975G, 7965G, and 7945G
/Desktops/320x212x12 Cisco Unified IP Phone 7971G-GE and 7970G
Tip 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.
For more information, see
Administration Guide.
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:
•
•
The following example (for a Cisco Unified IP Phone 7971G-GE and 7970G) 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/320x212x12/TN-Fountain.png"
URL="TFTP:Desktops/320x212x12/Fountain.png"/>
<ImageItem Image="TFTP:Desktops/320x212x12/TN-FullMoon.png"
URL="TFTP:Desktops/320x212x12/FullMoon.png"/>
</CiscoIPPhoneImageList>
The Cisco Unified IP Phone firmware includes a default background image. This image is not defined
in the List.xml file. The default image is always the first image that appears in the Background Images
menu on the phone.
Cisco Unified IP Phone Administration Guide for Cisco Unified Communications Manager 8.5
6-4
List.xml File Format Requirements, page
PNG File Requirements for Custom Background Images, page
Configuring a Custom Background Image, page 6-6
Software Upgrades
Image—Uniform resource identifier (URI) that specifies where the phone obtains the thumbnail
image that will appear on the Background Images menu on a Phone.
URL—URI that specifies where the phone obtains the full size image.
Chapter 6 Customizing the Cisco Unified IP Phone
6-4.
6-5.
in Cisco Unified Communications Operating System
OL-23092-01