XML API for Tiptel.com SIP Phones 31xx
When the user selects item 1 and presses soft key 3, the URI requested is
http://server/do_handle_selection.php?selection=dataToAppend_1
Notes:
•
If a "?" already exists in the URI, then a "&" is used to separate the parameters. Note the parameter name
"selection" is always added. If the Selection attribute is omitted, then nothing extra is appended to the URI.
•
The Selection attribute can contain more than one parameter, for instance, the following selection attribute
is valid <Selection>bla1&action=delete</Selection>
Don’t forget to escape encode the attribute for the '&' in the XML file. (→ 2.3)
Used XML objects
XML object
Position
Type
Description
TiptelIPPhoneTextM
enu
Root tag
Mandatory Root element
Beep
Root tag
Optional
Set = "yes" to generate a notification beep by phone.
Default = "no"
style
Root tag
Optional
"numbered", "none" and "radio" indicate the style of the
menu. Default is "numbered"
Timeout
Root tag
Optional
If there are no operations from users after entering into
the view within the time, the phone will exit to the
standby interface. Default is 45 s
See section 3.14.1 for more details.
LockIn
Root tag
Optional
See section 3.14.2 for details. Default is "no".
cancel Action
Root tag
Optional
Defines the URI to be called when the user cancels the
view.
defaultIndex
Root tag
Optional
Position of the cursor when the XML object is presented.
Default is 1 (valid values: 1..30)
destroyOnExit
Root tag
Optional
“yes” indicates that the object will be removed from the
XML browser stack after exit.
If not specified or set “no” the object is kept in the XML
browser after exit.
See section 3.14.3 for more details.
Page 16 / 50
<?
xml
version="1.0" encoding="UTF-8"?>
<
TiptelIPPhoneTextMenu
Beep
= "yes"
style
= "numbered"
defaultIndex
="1">
<
Title>
Menu</
Title>
<
MenuItem
>
<
Prompt>
First selection
</Prompt>
<
URI>
http://server/item_1.xml
</URI>
<Selection>
dataToAppend_1
</Selection>
</MenuItem>
<
MenuItem
>
<
Prompt>Second selection
</
Prompt>
<
URI>
http://server/item_2.xml
</URI>
<Selection>
dataToAppend_2
</Selection>
</MenuItem>
<
SoftKey
index="3">
<
Label>
Custom key</
Label>
<
URI>
http://server/do_handle_selection.php</
URI>
</SoftKey>
</
TiptelIPPhoneTextMenu
>