Manuel d'utilisation / d'entretien du produit 1725-17693-210 Rev. A du fabricant Polycom
Aller à la page of 36
August, 2007 Edition 1725-17693-210 Rev. A SIP 2.2.0 W eb Application Developer’ s Guide for the SoundPoint ® IP/SoundStation ® IP Family SIP 2.2.0.
Polycom Inc. 4750 Willow Road Pleasanton, CA 94588-2708 USA No part of this document may be reproduce d or transmitted in any form or by any means, el ectronic or mechanical, for any purpose, without the express written permission of Polycom, Inc. Under the law, reprod ucing includ es translating into another language or format.
iii About This Guide The Developer’s Guide for the SoundPoint IP / SoundStation IP family is for developers of applications which use the Microbrowser on Soun dPoint IP / SoundStation IP phones.
Developer’ s Guide SoundPoint IP / SoundStation IP iv.
v Contents About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii 1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–1 What is the Microbrowser . . . . . . . . . . . . . . . . . . .
Developer’ s Guide SoundPoint IP / SoundStation IP vi.
1 - 1 1 Over view This chapter provides an overview of the Microbrowser available on SoundPoint IP 330/320, 430 , 501, 550, 600, 601, and 650 desktop phones and SoundStation IP 4000 conference phone. It also provides an introduction to XHTML and guidelines for the application development.
Developer’ s Guide SoundPoint IP / SoundStation IP 1 - 2 The XHTML pages displayed on the Micr obrowser can contain static or dynamic information. Static XHTML. These pages are created us ing XHTML editors and hoste d by the Web server. These pages are accessed from the Microbrowser (using HTTP protocol) by entering the URL to a ccess the page.
Over view 1 - 3 Modularization is also intended to help content cr eators. As more and more devices become web-enabled, the number of platforms a content creator will be asked to support will become unreasonable.
Developer’ s Guide SoundPoint IP / SoundStation IP 1 - 4 Dependin g on the type and complexity of the application, you might use one of the following tools for creation: • Text editor • XML editor • Microsoft Word When designing applicati ons, you migh t want to consider the following guidelines: 1.
2 - 1 2 Application Development This chapter provides informati on on supported XHTML elements. It describes HTTP support and the Microbrows er user interface.
Developer’ s Guide SoundPoint IP / SoundStation IP 2 - 2 • Table Tags • Meta Information Tags Unsupported elements and attributes are de scribed in Unsupported XHTML Elements on page A-1 . Basic T ags The following basic tags are supported: • <!DOCTYPE> —Defines the document type • <!--.
Application Development 2 - 3 <!--...--> The comment tag is used to insert a comment in the source code. A comment will be ignored by the browser. You can use comments to explain your code , which can help you when you edit the source code at a later date.
Developer’ s Guide SoundPoint IP / SoundStation IP 2 - 4 <form> The form element creates a form for user input. A form can contain text fields, check boxes, radio buttons and more.
Application Development 2 - 5 <input> The <input> tag defines the start of an input field where the user can enter data. In XHTML the <input> tag must be properly closed.
Developer’ s Guide SoundPoint IP / SoundStation IP 2 - 6 Image T ags The following image t ag is supported: • <img> —Defines an image Various platforms have di ffering limits due to memory. There are also differing pixel limits for devices of di ffering pixel depth.
Application Development 2 - 7 Ta b l e Ta g s The following tabl e tags are supported: • <table> —Defines a table • <tr> —Defines a table row • <td> —Defines a table cell • <tbody> —Defines a table body <table> The <table> tag defines a table.
Developer’ s Guide SoundPoint IP / SoundStation IP 2 - 8 <tr> This tag defines a row in a table. The following attributes are supported: <td> This tag defines a cell in a table. The following attributes are supported: Attribute Va l u e / s Des cription align right left center justify char Defines the text alignment in cells.
Application Development 2 - 9 <tbody> This tag defines a table body. The thead, tfoot and tbody elements enable you to group rows in a tabl e. The following attributes are supported: Meta Inform.
Developer’ s Guide SoundPoint IP / SoundStation IP 2 - 10 — Self-signed or custom CA certificates • There are the following exception s: — There is no sophisticated caching. The HTML cache refresh META tag is not supported. — Any images in the body of a document with the same URL are assumed to be the same image.
Application Development 2 - 11 • A n i n s t a n c e t h a t d o e s n o t s u p p o r t u s er input, but appears in a window on the idle display Launching the Microbrowser The first time the Services key is pressed, the main Microbrowser loads the homepage specified in the mb.
Developer’ s Guide SoundPoint IP / SoundStation IP 2 - 12 When the user has focused on a link that they would like to follow, or a form element they would like to toggle, they press the Select key. This will either generate a request for the linke d page or toggle the selection of an element in the form.
Application Development 2 - 13 3. Change mb.proxy t o t h e a d d r e s s o f t h e d e s i r e d H T T P p r o x y t o b e u s e d b y the Microbrowser. For example, mb.proxy=10.11.32.103:8080 where 10.11.32.103 is proxy server IP address and 8080 is the port number.
Developer’ s Guide SoundPoint IP / SoundStation IP 2 - 14 2. Configure the Web server to serve the above XHTML file. For example, if you are using Apache To mcat to try this example, then put this file into the webappsPLCM folder of Tomcat. 3. Configure SoundPoint IP and SoundStation IP phones to point to the XHTML file in the sip.
Application Development 2 - 15 <?xml version="1.0" encoding ="iso-8859-1"?> <!DOCTYPE html PUBLIC "-//W3 C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1 /DTD/xhtml1-strict.dtd"> <%@page import="java.
Developer’ s Guide SoundPoint IP / SoundStation IP 2 - 16 5. Configure SoundPoint IP and SoundStation IP phones to point to the XHTML file in the sip.cfg configuration file. For this example, change mb.main.home to http://< WEBSERVER_ADDRESS : PORT >/PLCM/ AddStock.
3 - 1 3 T roubleshooting This chapter presents problems, li kely causes, and corrective actions. Problems are grouped as follows: • XML Errors If you still need as sistance, c ontact your system administrator.
Developer’ s Guide SoundPoint IP / SoundStation IP 3 - 2.
A - 1 A Appendix This appendix provides information on unsupported XHTML elements. Unsuppor ted XHTML Elements The unsupported elements and attributes are: Ta g Ty p e T ag Description Basic T ags <html>—Defines HTML document. <body>—Defines docu ments’ body .
Developer’ s Guide SoundPoint IP / SoundStation IP A - 2 Output T ags <pre>—Defines preformatted text. <code>—Defines computer code text. <tt>—Defines teletype text. <kbd>—Defines keyboard text. <var>—Defin es a va ri ab l e.
Appendix A - 3 Input T ags <form>—Defines a form. The following attributes ar e not supp orte d: accept, accept charset, enctype, target, class, id, style, title, dir , lang, and accesskey .
Developer’ s Guide SoundPoint IP / SoundStation IP A - 4 Ta b l e Ta g s <t able>—Defines a table. The following atrribu te s are not supported: bgcolo r , frame, rules, summary , id, cla ss, title, style, dir , lang, and xml:lang. <caption>—Defines a table caption.
Appendix A - 5 Programming T ags <script>—Defines a script <noscript>—Defines a noscript section <applet>—Deprec ate d. Defines an applet <object>—Defi nes an embe dded.
Developer’ s Guide SoundPoint IP / SoundStation IP A - 6.
Index – 1 Index A application development process 2–12 B basic tags supported 2–2 unsupported A–1 block tags unsupported A–2 C character format tags unsupported A–1 configuration parameter.
Developer’ s Guide SoundPoint IP / SoundStation IP Index – 2 U unsupporte d attributes A–1 unsupported elements A–1 X XHTML, definition 1–2.
Un point important après l'achat de l'appareil (ou même avant l'achat) est de lire le manuel d'utilisation. Nous devons le faire pour quelques raisons simples:
Si vous n'avez pas encore acheté Polycom 1725-17693-210 Rev. A c'est un bon moment pour vous familiariser avec les données de base sur le produit. Consulter d'abord les pages initiales du manuel d'utilisation, que vous trouverez ci-dessus. Vous devriez y trouver les données techniques les plus importants du Polycom 1725-17693-210 Rev. A - de cette manière, vous pouvez vérifier si l'équipement répond à vos besoins. Explorant les pages suivantes du manuel d'utilisation Polycom 1725-17693-210 Rev. A, vous apprendrez toutes les caractéristiques du produit et des informations sur son fonctionnement. Les informations sur le Polycom 1725-17693-210 Rev. A va certainement vous aider à prendre une décision concernant l'achat.
Dans une situation où vous avez déjà le Polycom 1725-17693-210 Rev. A, mais vous avez pas encore lu le manuel d'utilisation, vous devez le faire pour les raisons décrites ci-dessus,. Vous saurez alors si vous avez correctement utilisé les fonctions disponibles, et si vous avez commis des erreurs qui peuvent réduire la durée de vie du Polycom 1725-17693-210 Rev. A.
Cependant, l'un des rôles les plus importants pour l'utilisateur joués par les manuels d'utilisateur est d'aider à résoudre les problèmes concernant le Polycom 1725-17693-210 Rev. A. Presque toujours, vous y trouverez Troubleshooting, soit les pannes et les défaillances les plus fréquentes de l'apparei Polycom 1725-17693-210 Rev. A ainsi que les instructions sur la façon de les résoudre. Même si vous ne parvenez pas à résoudre le problème, le manuel d‘utilisation va vous montrer le chemin d'une nouvelle procédure – le contact avec le centre de service à la clientèle ou le service le plus proche.
