Cisco 7965G Administration Guide - Page 124

Creating Custom Background Images, List.xml File Format Requirements

Page 124 highlights

Creating Custom Background Images Chapter 6 Customizing the Cisco Unified IP Phone Creating Custom Background Images You can provide users with a choice of background images for the LCD screen on their phones. Users can select a background image by choosing Settings > User Preferences > Background Images on the phone. The image choices that users see come from PNG images and an XML file (called List.xml) that are stored on the TFTP server used by the phone. By storing your own PNG files and editing the XML file on the TFTP server, you can designate the background images from which users can choose. In this way, you can provide custom images, such as your company logo. 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-5. • 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/320x212x16 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. • URI-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 Cisco Unified IP Phone 7965G and 7945G Administration Guide for Cisco Unified Communications Manager 6.1 6-4 OL-14641-01

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205

6-4
Cisco Unified IP Phone 7965G and 7945G Administration Guide for Cisco Unified Communications Manager 6.1
OL-14641-01
Chapter 6
Customizing the Cisco Unified IP Phone
Creating Custom Background Images
Creating Custom Background Images
You can provide users with a choice of background images for the LCD screen on their phones. Users
can select a background image by choosing
Settings > User Preferences > Background Images
on the
phone.
The image choices that users see come from PNG images and an XML file (called List.xml) that are
stored on the TFTP server used by the phone. By storing your own PNG files and editing the XML file
on the TFTP server, you can designate the background images from which users can choose. In this way,
you can provide custom images, such as your company logo.
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-5
.
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/320x212x16
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.
URI—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/320x212x16/TN-Fountain.png”
URL=”TFTP:Desktops/320x212x16/Fountain.png”/>
<ImageItem Image=”TFTP:Desktops/320x212x16/TN-FullMoon.png”
URL=”TFTP:Desktops/320x212x16/FullMoon.png”/>
</CiscoIPPhoneImageList>