background image

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

>

Содержание 31xx series

Страница 1: ...XML API Guide en Version 2 6 tiptel 31xx tiptel...

Страница 2: ...3 3 2 IPPhoneConfiguration XML object 14 3 3 IPPhoneTextMenu XML object 14 3 4 IPPhoneTextScreen XML object 18 3 5 IPPhoneInputScreen XML object 20 3 6 IPPhoneDirectory XML object Type A 25 3 7 IPPhon...

Страница 3: ...able 1 Customizable hard keys in object SoftKey 39 Table 2 Customizable hard keys in object SoftKeyItem 40 1 Abbreviations API Application Programming Interface SIP Session Initiation Protocol UI User...

Страница 4: ...ync in Administrator Guide Wiki to configure this kind of URLs for corresponding events 2 1 2 Programmable function key Any Action URL can be triggered manually by hitting a function key configured ac...

Страница 5: ...the XML data directly to the phone 2 2 1 HTTP Remote Action URL The downloading of XML file can be triggered by using HTTP GET method calling remote URL on device build in Web Server http phoneip cgi...

Страница 6: ...phone using proprietary SIP NOTIFY event tiptel xml with XML content Example Page 5 50 POST xmlservice HTTP 1 0 User Agent Wget 1 11 4 Accept Host 192 168 1 20 Connection Keep Alive Content Type text...

Страница 7: ...ote quot Apostrophe apos Left angle bracket lt Right angle bracket gt 2 4 External URI formats The generic syntax of en external URI is defined by RFC 3986 All external URIs must begin with a scheme n...

Страница 8: ...SIP URI of the default local identity or of the active outgoing identity active_key The function key line key or SoftKey associated with the URL directive or the call For coding syntax see the coding...

Страница 9: ...Digits URI order the phone to send a sequence of DTMF tones This will be performed only if a connected call exist The method used to send DTMF tones In Band or RFC2833 must be configured for concerned...

Страница 10: ...ton 1 7 Key line2 SoftKeyN Emulate the soft key button below the display N is the number of soft key button 1 4 Key SoftKey3 keypadN Emulate numeric keypad button 0 9 N is the number of keypad button...

Страница 11: ...d since Firmware 3 0 0 on phones with colour displays Controls the LED icons of phone selection keys presented on the right side of the display NN is the number of function key 1 6 CCC is the color va...

Страница 12: ...ClearRedialList Clear redial list outgoing call record Command ClearRedialList ClearDirectory Clear local contact list Command ClearDirectory Example 2 6 4 Internal URI SoftKey Some user interface XML...

Страница 13: ...the menu items URI on the Menu Screen and copied to the dialing preparation view Availability of SoftKeys per object SoftKey IPPhoneTextMenu IPPhoneTextScreen IPPhoneInputScree n IPPhoneDirectory Type...

Страница 14: ...e device executes commands without promoting the user XML file description XML file example Used XML objects XML object Type Description TiptelIPPhoneExecute mandatory The root element Beep optional S...

Страница 15: ...If not present or 0 the default account is used 3 2 IPPhoneConfiguration XML object Not yet implemented 3 3 IPPhoneTextMenu XML object The IPPhoneTextMenu XML object can be used to display a non forma...

Страница 16: ...RI Dial 004921024280 Dial MenuItem MenuItem Prompt My dentist Prompt URI http server info_about_dentist xml URI Dial line 2 00800123412341234 Dial MenuItem SoftKey index 4 Label Dial Label URI SoftKey...

Страница 17: ...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 sec...

Страница 18: ...item Please define them global in the body of the root object Label SoftKey Body Mandatory Text of SoftKey URI SoftKey Body Mandatory Internal or external URI describing the action to be executed Defa...

Страница 19: ...URI is executed If cancelAction calls another UI XML object the previous view is kept on the stack Ok If LockIn is set no the function of the OK key will be the same as SoftKey Select if it is yes the...

Страница 20: ...reen Title Text Text of screen nthis was a manually set newline Text SoftKey index 3 Label Custom key Label URI http myserver2 de get_it php URI SoftKey TiptelIPPhoneTextScreen xml version 1 0 encodin...

Страница 21: ...See section 3 13 1 for details Default soft keys The following default soft key will be presented if the XML file of IPPhoneTextScreen does not include any soft key description SoftKey index Name URI...

Страница 22: ...URL target receiving the input URL Parameter name of param added to URL Parameter Default default value Default InputField type IP string number timeInt dateInt password yes no editable yes no Prompt...

Страница 23: ...er includes integers plus and password Root tag Optional Specifies if the input is masked by characters Default is no editable Root tag Optional Specifies if the user is allowed to modify the input De...

Страница 24: ...URL Parameter setting name user input contents Value is used as default for each input field Default Body Optional The default input content Value is used as default for each input field SoftKey Input...

Страница 25: ...SoftKey Exit 2 2ab 123 SoftKey ChangeMode no function on phone with alpha keyboard 3 SoftKey BackSpace 4 Ok SoftKey Submit 5 SoftKey Dot 6 space SoftKey NextSpace Default soft keys type time date Soft...

Страница 26: ...rectory XML object can be used to display a simple phone register Since the term IPPhoneDirectory is used in several XML objects the phone auto detects the correct application XML file description Not...

Страница 27: ...14 2 for details Default is no Cancel Action Root tag Optional Defines the URI to be called when the user cancels the view destroyOnExit Root tag Optional yes indicates that the object will be removed...

Страница 28: ...ectory 4 Dial SoftKey Dial 8 plus SoftKey Edit_and_Dial Key processing Key Function description Cursor up down Move focus in list up down Digit key 1 9 0 Select menu item whose index value equals to n...

Страница 29: ...n IPPhoneStatus can be any string also can be left empty XML file example Full screen presentation of all messages in a scrollable tree view XML file example Removing message with index 0 XML file exa...

Страница 30: ...section 3 14 3 for more details Session Body Optional Session Id can be any string Session ID used to identify the application displaying message It allows message change and message reset Message Bo...

Страница 31: ...n be used to display a simple phone register Since the term IPPhoneDirectory is used in several XML objects the phone auto detects the correct application This XML object is supported since Firmware 2...

Страница 32: ...ses the SoftKey or Hardkey Label SoftKeyItem Body Mandatory Text of SoftKeyItem URL SoftKeyItem Body Mandatory Internal or external URL describing the action to be executed Default soft keys The follo...

Страница 33: ...edit the number and dial the number Selection keys same function as SoftKey Dial SoftKey Exit Present previous displayed xml view if available Else return to idle screen Cursor left same function as S...

Страница 34: ...tScreen does not include any soft key description SoftKey index Name URI 1 Exit SoftKey Exit Key processing Key Function description Cursor up down Scrolling in text up down SoftKey Exit Present previ...

Страница 35: ...can be left empty XML file example Used XML objects XML object Position Type Description TiptelIPPhoneMenu Root tag Mandatory Root element track Root tag Optional no indicates that the object will be...

Страница 36: ...does not include any soft key description SoftKey index Name URI 1 Exit SoftKey Exit 4 Select SoftKey Select Key processing Key Function description Cursor up down Scrolling in text up down SoftKey Ex...

Страница 37: ...UTF 8 PbookIPPhoneDirectory DirectoryEntry Name Bob Name Telephone 49116117 Telephone DirectoryEntry DirectoryEntry Name Alice Name Telephone alice myserver local Telephone Telephone 2010 inthecloud c...

Страница 38: ...oft key behavior native to each XML screen type The phone has two layers with four soft keys The user can toggle the soft key layer with the lowermost select key on the right side of the display if an...

Страница 39: ...ftKey URI SoftKey Body Mandatory Soft key Internal URI 2 6 4 or external URI describing the action to be executed Hard key External URI describing the action to be executed 3 13 2 Using the internal o...

Страница 40: ...XML objects IPPhoneText 3 9 IPPhoneDirectory 3 8 and IPPhoneMenu 3 10 It allows developers to link arbitrary URIs to keys in the XML screens and invoke soft key behavior native to each XML screen type...

Страница 41: ...Hard key External URI describing the action to be executed Since Firmware 2 0 65 Since Firmware 3 1 1 0 1 9 0 1 9 UP DOWN LEFT RIGHT OK ESC DEL MENU DIRECTORY NEWDIRECTORY REDIAL MUTE SPEAKER RKEY VO...

Страница 42: ...defined by the object Default is no Setting LockIn will disable the default timeout feature 45 seconds unless the Timeout attribute is also set in the root tag Note An incoming call still cancels the...

Страница 43: ...TP GET Service URLs Device Info FW 1 2 25 or later service devinfo xml CgiServiceAPI XmlDeviceInfo SIP Trace File cgi bin webcgi sip txt CgiServiceAPI Siptrace Wireshark network traffic trace cgi bin...

Страница 44: ...s to take effect if Asterisk is already running CLI config reload etc asterisk sip_notify conf Page 43 50 bin sh postfile push xml response result htm pushurl http 192 168 1 30 xmlservice addhdr Conte...

Страница 45: ...isk configuration file etc asterisk sip_notify cfg the XML event To trigger the XML service on device 5566 enter on CLI Page 44 50 bin sh response result htm aurl http 192 168 1 1 tiptel3020xml TestAc...

Страница 46: ...name TiptelIPPhoneExecute xs complexType xs sequence xs element name ExecuteItem minOccurs 0 maxOccurs 30 xs complexType xs attribute name URI type textURI xs complexType xs element xs sequence xs at...

Страница 47: ...and_Dial added in IPPhoneTextMenu and IPPhoneDirectory 1 3 19 08 2013 1 1 120 3 3 IPPhoneTextMenu Optional SIP line selection for dialing added 1 3 26 08 2013 1 1 123 3 13 2 3 3 3 4 3 6 Hard keys 0 9...

Страница 48: ...XML API for Tiptel com SIP Phones 31xx Page 47 50...

Страница 49: ...4 843 13 23 E mail tiptel tiptel online ch Internet www tiptel online ch Tiptel B V Camerastraat 2 NL 1322 BC Almere Telefoon 036 53 666 50 Fax 036 53 678 81 E mail info tiptel nl Internet www tiptel...

Отзывы: