Minibrowser

From Snom User Wiki

(Redirected from Xmlobjects)
Jump to: navigation, search

Contents

Overview

Author: Hirosh Dabui

snom phones are able to use services on standard web servers like Apache. You can use snom phones to deploy customized client services with which users can interact with the keypad. The snoms use the HTTP/HTTPS protocol. Typical services are:

  1. To-do lists
  2. Stock Information
  3. Weather
  4. Provisioning
  5. Daily schedule
  6. Telefon directory

Quickinstall

Supported XML Objects

In this section we describe the behavior and usage of each XML object. Creating interactive services is relatively easy when you understand the XML objects that are supported by firmware V7 on the snom 370, snom 360, snom 320, and snom 300. The easiest way to do this is to start with our examples (see Quickinstall). Snoms can use HTTP to load an xml page or receive a SIP-Notify.

  1. SnomIPPhoneText
  2. SnomIPPhoneImageFile
  3. SnomIPPhoneImage
  4. SnomIPPhoneMenu
  5. SnomIPPhoneDirectory
  6. SnomIPPhoneInput

Speedselect

Snom phones allow navigation to a specific line in the menu or directory by pressing numeric DTMF keys. The menu or directory diplays the actual number to be pressed on the left side of the display. Speedselect does not support more than 100 lines.

Softkeys

The softkey items make it possible to customize keys on the keypad to fetch the given page in the <URL> tag.

example: 

<SoftKeyItem>
<Name>5</Name>
<URL>http://snom.com/minibrowser/start.xml</URL>
</SoftKeyItem>


If key '5' is pressed, then the url will load.

possible softkeys names are:

  • CANCEL
  • ENTER
  • ONHOOK
  • RIGHT, F_RIGHT(snom 370)
  • LEFT, F_LEFT(snom 370)
  • REDIAL
  • SPEAKER
  • TRANSFER
  • CONFERENCE
  • HELP
  • F_MUTE
  • F_UP
  • F_DOWN
  • REC
  • SNOM
  • DND
  • for HOLD use RECALL

You can overwrite the function keys in the context of a snom tag!

  • F_MINIBROWSER_SELECT
  • F_MINIBROWSER_EXIT
  • F_MINIBROWSER_UPDATE
  • F_MINIBROWSER_SEARCH
  • F_MINIBROWSER_CANCEL
  • F_MINIBROWSER_BACK
  • F_MINIBROWSER_DIAL
  • F_MINIBROWSER_EDIT_DIAL
  • F_MINIBROWSER_EDIT_NEXT
  • 0..1
  • *
  • #

Don't overwrite the speedkey functionality of menus or directories with softkeys.

Loading of Xmlobjects

If the response time takes more then 500ms from the Xmlobject server, you will see an animation and the http-address.

Image:loading.gif

Extensions in the latest firmware releases

Version > 7.1.30

  • You can use sel attribute in <MenuItem> and <DirectoryEntry> to preselect an item in a list.

e.g. 

<DirectoryEntry sel=true>
 ...
</DirectoryEntry>

Version > 7.1.30

  • The <fetch> tag exists to load an xml object from an http server automatically after assigned milliseconds (mil attribute).

e.g.: 

<?xml version="1.0" encoding="UTF-8"?>
<SnomIPPhoneImageFile>
<LocationX>00</LocationX>
<LocationY>00</LocationY>
<URL>http://snom.com/minibrowser/wo.bmp</URL>                             
<fetch mil="1000">http://snom.com/minibrowser/hd.xml</fetch>
</SnomIPPhoneImageFile>
  • You can label the 4 softkeys F1..F4 by the <Label> tag with your own name and functionality.

e.g.: 

<?xml version="1.0" encoding="UTF-8"?>
<SnomIPPhoneImageFile>
<LocationX>00</LocationX>
<LocationY>00</LocationY>
<URL>http://snom.com/minibrowser/wo.bmp</URL>  
<SoftKeyItem>                            
<Name>F1</Name>
<Label>fone</Label>
<URL>http://snom.com/minibrowser/start.xml</URL>
</SoftKeyItem>
<SoftKeyItem> 
<Name>F2</Name>
<Label>ftwo</Label>
<URL>http://snom.com/minibrowser/start.xml</URL>
</SoftKeyItem>
<SoftKeyItem> 
<Name>F3</Name>
<Label>fthree</Label>
<URL>http://snom.com/minibrowser/start.xml</URL>
</SoftKeyItem>
<SoftKeyItem>  
<Name>F4</Name>
<Label>ffour</Label>
<URL>http://snom.com/minibrowser/start.xml</URL>
</SoftKeyItem>
#<fetch mil="1000">http://snom.com/minibrowser/hd.xml</fetch>
</SnomIPPhoneImageFile>
  • URL with credentials are possible e.g. http[s]://username:password@example.com/test.xml

Version > 7.1.30

For SnomIPPhoneText the <br/> tag is added to force line breaks. e.g.: 

<SnomIPPhoneText>
<Title>Demo</Title>
<Prompt>Prompt Text</Prompt>
<Text>
hello world!<br/>a<br/>b<br/>c<br/>
</Text>
</SnomIPPhoneText>

In old versions <br> was accepted, but the softkeys are not working. It is recommended to use <br/> instead.

For all versions built after 7.10.2007

In these firmware versions we implemented a clearlight attribute for the SnomIPPhoneDirectory tag to switch off the message LED from the minibrowser!

e.g.: 

<?xml version="1.0" encoding="UTF-8"?>
<SnomIPPhoneDirectory clearlight="true">
<Title>Phonelist</Title>
<Prompt>Prompt</Prompt>
<DirectoryEntry>
<Name>Support</Name>
<Telephone>444@intern.snom.com</Telephone>
</DirectoryEntry>
</SnomIPPhoneDirectory>

Firmware

You must be running a firmware version 6 or above -> see here. Stable version 5.x is not sufficient.

Applications

PhoneBook for Snom-Phones

The "PhoneBook for Snom-Phones" is a phone book browser with an integrated search function and includes an LDAP-, flatfile- and MySQL-backend.
Download at: http://www.bevuta.com/phoneapps/

IPPhone XML library for PHP

This is a set of PHP classes that allows rapid XML application development for the XML browsers implemented in both Cisco 79xx and snom phones. A T9-style phonebook application with flat file and MySQL backends is included.

PHP Toolkit for xml minibrowser, including T9 phonebook coded by Siggi Langauf.

Retrieved from "http://wiki.snom.com/Minibrowser"
Personal tools