Specifications

3-30

Cisco Unified IP Phone Services Application Development Notes

OL-22505-01

Chapter 3 CiscoIPPhone XML Objects

XML Considerations

If any custom softkeys are defined in the XML object, then all default softkeys are removed from that

object. To retain default softkey behavior, then you must explicitly define it in the XML object using a

tag. The internal Softkey URIs can be used in the <URL> tag of <SoftKeyItem> to invoke

default softkey actions from custom softkeys. See

Chapter 5, “Internal URI Features” for more

information on invoking internal softkey features.

Note If there are no custom softkeys and there is no default softkey placed in position 1, either a Next or

Update softkey is assigned automatically. If the URL is a Refresh URL, the softkey will be “Next.” If

not, the Update softkey is assigned.

Example

The following softkey definitions would provide the custom softkey, without losing the default “Select”

behavior:

<Name>Select</Name>

<URL>SoftKey:Select</URL>

</SoftKeyItem>

<Name>Custom</Name>

<URL>http://someserver/somepage</URL>

</SoftKeyItem>

XML Considerations

The XML parser in Cisco Unified IP Phones does not function as a fully capable XML parser. Do not

include any tags other than those defined in your XML display definitions.

Note All CiscoIPPhone element names and attribute names are case sensitive.

Mandatory Escape Sequences

By XML convention, the XML parser also requires that you provide escape values for a few special

characters.

Table 3-6 lists characters and their escape values.

Escaping text can be tedious, but some authoring tools or scripting languages can automate this task.

Table 3-6 Escape Sequences for Special Characters

Character Name Escape Sequence

Ampersand &

“

Quote "

Apostrophe '

Left angle bracket <

Right angle bracket >