Cisco Systems OL-15790-01 manual List.xml File Format Requirements, List.xml Example

Chapter 6 Customizing the Cisco Unified IP Phone

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, page 6-4.

•PNG File Requirements for Custom Background Images, page 6-4.

•Configuring a Custom Background Image, page 6-5

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

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 the “Cisco TFTP” chapter in Cisco Unified Communications Manager System Guide and the “Software Upgrades” chapter in Cisco Unified Communications Operating System 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:

•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—URL 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/320x216x16/TN-Fountain.png” URL=”TFTP:Desktops/320x216x16/Fountain.png”/>

<ImageItem Image=”TFTP:Desktops/320x216x16/TN-FullMoon.png” URL=”TFTP:Desktops/320x216x16/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.

PNG File Requirements for Custom Background Images

Each background image requires two PNG files:

•Full size image—Version that appears 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 Unified IP Phone 7975G Administration Guide for Cisco Unified Communications Manager 7.0 (SCCP and SIP)

6-4 OL-15790-01