Siemens HiPath optiPoint 410 Manual de instrucciones

HiPath

optiPoint application module

XML Applications

Developer’s Guide

For internal distribution only

May 18, 2006

1optiPoint application module - XML Applications, Developer’s Guide

bkIVZ.fm

1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

1.2 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2 Functions and Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2.1 Infrastructure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2.2 Basic Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2.3 Push Technology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2.4 Using Predefined Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3 Installation and Starting the Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

3.1 Generating a Program on the Telephone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

3.2 Starting the Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

4 XML Object Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4.1 Phone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

4.2 Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4.3 Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4.4 Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

4.5 Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

4.6 Alert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

4.7 List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

4.8 TextBox. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

4.9 Ticker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

4.10 Hidden. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

4.11 Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

4.12 Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

5 Push Technology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

6 Appendix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

6.1 Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

6.2 XML Schema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

c01.fm

18. May 2006

optiPoint application module - XML Applications, Developer’s Guide 2

Introduction

Overview

1 Introduction

1.1 Overview

In conjunction with the optiPoint application module, users of Siemens optiPoint 410/420 410/

420 IP telephones have simple access to many applications.

In addition to local services such as the integrated address book, these applications also in-

clude those that can live anywhere on the network and which can be just as easily accessed

thanks to the existing IP connection.

The optiPoint application module uses not only a standard WAP browser for Internet or intranet

contents conforming to the WML standard, it can also be integrated with numerous application-

specific solutions.

The application platform for the Siemens optiPoint telephones described here represents a new

angle in the convergence between telephony and web applications. An XML interface makes it

possible, using only a suitably-equipped telephone, to interact with applications in the back of-

fice. Since XML and HTTP serve as interfaces, technologies normally used for web applications

can also be used for server-side applications: Apache, Microsoft IIS, Tomcat, Java servlets,

J S P, P H P, e t c .

An important characteristic of convergence is that the server-side application can initiate the

transfer of data to the application platform of the telephone, just as a phone not only makes calls

but also receives them.

In this way, you can extend the range of application of your optiPoint IP phone considerably and,

at the same time, optimize access to your applications using a highly available gateway – inde-

pendent of or as an addition to your other access options such as computer installations.

The XML communication interface is available in the firmware for the device types

optiPoint 410/420 standard and advance in the corenet IP variant (HFA). The application type

described here distinguishes itself in terms of installation, basic functionality and range of ap-

plication from Java MIDlets, which always function as stand-alone applications.

This document describes the XML interface as well as error handling for invalid XML data. In

view of this, note that error handling is not visible to the user. If some of the elements in an ob-

ject are missing, the existing elements are displayed anyway. When developing applications,

validation of the XML documents using an XML schema is recommended (see Section 6.2,

"XML Schema").

This document is meant for use by Siemens internal developers as well as by third party appli-

cation developers. It contains the following sections:

• Functions and Features

• Installation and Starting the Program

Introduction

18. May 2006

3optiPoint application module - XML Applications, Developer’s Guide

c01.fm

Prerequisites

• XML Object Reference

• Push Technology

• Appendix

1.2 Prerequisites

The following components and tools are required for developing applications for the application

platform:

1. optiPoint phone, type optiPoint 410 standard/advance or optiPoint 420 standard/advance

2. A DSM (display module) or APM (application module) must be connected to the telephone.

3. Infrastructure:

• IP network to which the IP phone is connected

• Web browser for creating programs for the telephone using the Web Based Manager

(e. g., Internet Explorer, Firefox, Opera)

• Web server for sending the XML data to the IP phone (e. g., Microsoft IIS, Apache,

Tomcat). It is important that the server is configured with the MIME type text/xml.

• For interactive applications: Application platform on the server for dynamically gener-

ating XML data (e. g., Java servlet, ASP, CGI, PHP).

4. XML editor:

An XML editor that can validate the documents using XML schema is recommended (e. g.,

Oxygen, XMLWriter, EditiX, XMLSpy).

5. For developing Java servlets: A suitable development environment, e. g., Eclipse, Net-

Beans, IBM Websphere Studio.

c01.fm

18. May 2006

optiPoint application module - XML Applications, Developer’s Guide 4

Functions and Features

Infrastructure

2 Functions and Features

2.1 Infrastructure

The following diagram shows the lines of communication between the various components:

LAN

optiPoint optiPoint

optiPoint

Application Server /

Web Server

optiPoint

application module

Functions and Features

18. May 2006

5optiPoint application module - XML Applications, Developer’s Guide

c01.fm

Basic Functionality

2.2 Basic Functionality

The following diagram shows the basic functions of the application:

The functional process of an application can be described as follows:

1. The user installs an application on the optiPoint phone.

2. The user calls an application from the list of programs installed.

3. The phone calls the URL of the program on the server.

4. The server-side program generates an XML document that corresponds to the specified

XML schema (see Section 6.2, "XML Schema"). The web server sends the XML document

to the phone via an HTTP connection.

5. The XML document is parsed and shown on the display of the DSM or the APM.

6. The user enters commands and data via the touchscreen or the keyboard of the DSM or

the APM.

7. The user’s commands and entries are detected by listeners in the telephone software.

8. The phone passes the user entries as key/value pairs on to the server-side program.

>When the program starts, the HTTP GET request that requests the XML document

from the server also contains the IP address and the telephone number of the IP

phone, e.g., ipaddress=137.223.238.174&phonenumber=2256.

IP Phone 410/420

DSM or APM

Display

Keypad XML

Parser

Java

Environment

XML

Application

Business

Logic

XML

HTTP/HTTPS Webserver

Server

c01.fm

18. May 2006

optiPoint application module - XML Applications, Developer’s Guide 6

Functions and Features

Push Technology

2.3 Push Technology

Push technology makes it possible for the program to be started and, therefore, the data to be

pushed from the server-side.

With Push technology, a program on the server calls a specified URL for the IP phone and

prompts it to load a specific XML document from a specific server. After this, the XML document

is also parsed and displayed as in normal operation.

2.4 Using Predefined Images

In addition to being able to link any images saved on a server within an XML document, prepre-

pared images, for example, for buttons, are also available. These images are already included

in the telephone software. One advantage of this is reduced data traffic and, therefore, in-

creased application speed. For more information about linking images, see Section 4.12, "Im-

age".

Installation and Starting the Program

18. May 2006

7optiPoint application module - XML Applications, Developer’s Guide

c01.fm

Generating a Program on the Telephone

3 Installation and Starting the Program

3.1 Generating a Program on the Telephone

Programs for the application platform described here are generated using the Web Based Man-

ager. For this, the following steps are necessary:

1. Enter the IP address of the telephone in the web browser. The introduction page appears.

2. Go to Administration and enter the administrator password. In the Administration menu,

select New Program. The following input screen is displayed:

3. Now enter the following information:

•Display Name: The name of the program as it appears in the program menu on the

APM or the DSM. The display name must meet the following criteria:

• It must be a unique name on the telephone.

• It cannot contain ’^’ characters.

• It cannot be empty.

• It cannot be longer than 100 characters.

•Application Name: This is used internally by the application to identify the program

running on the telephone. The application name must meet the following criteria:

• It must be a unique name on the telephone.

• It cannot contain any non-alphanumeric characters.

• The first character must be a letter.

• It cannot be empty.

c01.fm

18. May 2006

optiPoint application module - XML Applications, Developer’s Guide 8

Installation and Starting the Program

Generating a Program on the Telephone

• It cannot be longer than 20 characters.

•Server Address: The IP address or domain/host name of the server (example,

www.domain.de) that provides the application or the XML document.

•Server Port Number: The number of the port that the server uses to provide the ap-

plication or the XML document.

•Program Name on Server: The relative path to the servlet or to the first XML page of

the application on the server. The relative path refers to the root directory for docu-

ments on the web server, e. g., for Apache htdocs. For instance, if an XML document

is saved in C:\programs\Apache Group\Apache\htdocs\ipp\ippTest.xml, the entry

is ipp/ippTest.xml. The information cannot be longer than 100 characters.

•Use Proxy: This specifies whether a proxy should be used. If Yes has been set, the

program uses the default Java proxy. This can be configured in the Web Based Man-

ager under Administration > Applications > Java. In order to use a proxy, not only

must the telephone be visible to the proxy but also the server.

4. Click the Create Program button to start generating the program.

3.1.1 Configuring and Deleting Programs Using the Web Based Man-

ager

Complete the following steps to configure or delete a program:

1. Enter the IP address of the telephone in the web browser. The introduction page appears.

2. Go to Administration and enter the administrator password. In the Administration menu,

select Configure/Delete Program. The following input screen is displayed:

>The information entered is validated after being sent. If the information is incorrect,

the program is not generated and an error message is returned.

Installation and Starting the Program

18. May 2006

9optiPoint application module - XML Applications, Developer’s Guide

c01.fm

Starting the Program

select the program that you would like to configure or delete from the Program List pull-

down menu.

If you would like to reconfigure the program, change the respective parameters. For more

information about these parameters, see Section 3, "Installation and Starting the Program".

Click the Submit Changes button to confirm the changes.

If you would like to delete the program, click the Delete Program button.

3.2 Starting the Program

If the user starts a program on the telephone, the application calls the URL of the program from

its end on the server.

The telephone tells the server its IP address and telephone number using key/value pairs within

the URL. The key/value pairs are sent in the following format:

ipaddress=<telephone-IP-address>&phonenumber=<telephone number>

Este manual sirve para los siguientes modelos

Tabla de contenidos

Otros manuales de Unidad de control de Siemens

Siemens

Siemens PM330 Instrucciones de montaje

Siemens

Siemens SIMATIC ET 200SP Manual de usuario

Siemens

Siemens SIRIUS 3RA2711 C Series Manual de usuario

Siemens

Siemens SINUMERIK 840D Hoja de instrucciones

Siemens

Siemens Synco 700 RMB795 Manual de usuario

Siemens

Siemens SIRIUS 3TK2834 Manual de usuario

Siemens

Siemens SIMATIC S7-1500R/H Manual de usuario

Siemens

Siemens SIMATIC ET 200AL Manual de usuario

Siemens

Siemens SIMATIC NET Manual de usuario

Siemens

Siemens SIMOCODE pro C Guía del usuario

Siemens

Siemens SIMATIC NET Manual de usuario

Siemens

Siemens CM 1243-5 Manual de usuario

Siemens

Siemens LOGO! Series Manual de usuario

Siemens

Siemens SIMATIC ET 200SP Manual de usuario

Siemens

Siemens SIWAREX JB Manual de usuario

Siemens

Siemens Logo! CM EIB Manual de usuario

Siemens

Siemens K60R Manual de usuario

Siemens

Siemens OLM/P11 V4.0 Manual de usuario

Siemens

Siemens SIMATIC Manual de usuario

Siemens

Siemens SIMATIC ET 200SP Manual de usuario

Siemens

Siemens SIMOCODE pro 3UF7400-1AA00-0 Manual de usuario

Siemens

Siemens SINUMERIK 840D sl Manual de usuario

Siemens

Siemens SIPROCESS GA700 Manual de usuario

Siemens

Siemens SINAMICS G120 Guía del administrador

Manuales populares de Unidad de control de otras marcas

Festo

Festo Compact Performance CP-FB6-E Manual de lista de piezas

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Manual de usuario

JS Automation

JS Automation MPC3034A Manual de usuario

JAUDT

JAUDT SW GII 6406 Series Guía rápida

Spektrum

Spektrum Air Module System Manual de usuario

BOC Edwards

BOC Edwards Q Series Manual de usuario

KHADAS

KHADAS BT Magic Manual de usuario

Etherma

Etherma eNEXHO-IL Manual de usuario

PMFoundations

PMFoundations Attenuverter Manual de usuario

GEA

GEA VARIVENT Manual de usuario

Walther Systemtechnik

Walther Systemtechnik VMS-05 Manual de usuario

Altronix

Altronix LINQ8PD Instrucciones de montaje

Eaton

Eaton Powerware Series Manual de usuario

WAGO

WAGO 750-407/040-000 Manual de usuario

Sony

Sony CCU-590 Manual de usuario

Graco

Graco 25D614 Manual de usuario

Task Force Tips

Task Force Tips YE-RF-900 Manual de programación

Shini

Shini SPV-U Series Manual de usuario