Page 1
Web Application Developer’s Guide ® for the SoundPoint ® IP/SoundStation IP Family SIP 3.0.2 April, 2008 Edition 1725-17693-300 Rev. A SIP 3.0.2...
Page 2
As between the parties, Polycom, Inc. retains title to, and ownership of, all proprietary rights with respect to the software contained within its products. The software is protected by United States copyright laws and international treaty provision.
Release Notes, which describe the new and changed features and fixed problems in the latest version of the software For support or service, please go to Polycom Technical Support at http://www.polycom.com/support/voip/. Polycom recommends that you record the phone model numbers, software (both the bootROM and SIP), and partner platform for future reference.
Page 4
Developer’s Guide SoundPoint IP / SoundStation IP...
Overview This chapter provides an overview of the Microbrowser available on SoundPoint IP 330/320, 430, 501, 550, 560, 600, 601, 650, and 670 desktop phones and SoundStation IP 4000, 6000, and 7000 conference phones. It also provides an introduction to XHTML and guidelines for the application development.
Developer’s Guide SoundPoint IP / SoundStation IP The XHTML pages displayed on the Microbrowser can contain static or dynamic information. Static XHTML. These pages are created using XHTML editors and hosted by the Web server. These pages are accessed from the Microbrowser (using HTTP protocol) by entering the URL to access the page.
Overview where XHTML was divided up into ‘modules’, where any features above and beyond a skeleton set were grouped into individual modules. User agent (UA) developers could then decide which extensions to support. A simple user agent can be considered a fully compliant user agent by supporting only the Basic module, whereas a more powerful browser can support all the official modules, as well as those developed by third parties.
Page 10
For step-by-step instructions on how to develop an XHTML application that can be run on the Microbrowser of all SoundPoint IP and SoundStation IP phones, refer to Application Development on page 2-1. Note Polycom is not responsible for troubleshooting any programming that you create for the Microbrowser. 1 - 4...
Developing an XHTML Application To troubleshoot any problems with your applications, refer to Troubleshooting on page 3-1. Polycom is not responsible for troubleshooting any programming that you create for Note the Microbrowser. Supported XHTML Elements The Microbrowser supports a subset of XHTML elements. Most are derived from HTML 4.01.
Developer’s Guide SoundPoint IP / SoundStation IP • Table Tags • Meta Information Tags Unsupported elements and attributes are described in Unsupported XHTML Elements on page A-1. Basic Tags The following basic tags are supported: • <!DOCTYPE>—Defines the document type •...
The following attributes are supported: Attribute Value/s Description href URL (Ex:” www.polycom.com”) The target URL of the link name section_name Names an anchor. Use this attribute to create a bookmark in a document.
Page 14
Developer’s Guide SoundPoint IP / SoundStation IP Note The Microbrowser supports both the GET and POST methods for submitting forms. Nesting forms within tables is supported. However, nesting of one form tag within another is not supported and may lead to unexpected results. <form>...
Page 15
Application Development <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. The following attributes are supported: Attribute Value/s Description checked checked Indicates that the input element should be checked when it first loads.
Developer’s Guide SoundPoint IP / SoundStation IP Image Tags The following image tag is supported: • <img>—Defines an image The Microbrowser supports images stored in uncompressed .bmp format. While all BMP bit depths will be displayed to the best of the phone’s ability, it is recommended that the image format most suitable for the target platform be chosen.
Application Development Table Tags The following table tags are supported: • <table>—Defines a table • <tr>—Defines a table row • <td>—Defines a table cell • <tbody>—Defines a table body XHTML tables must be properly formatted (should include <tbody> and </tbody> Note tags).
Page 18
Developer’s Guide SoundPoint IP / SoundStation IP <tr> This tag defines a row in a table. The following attributes are supported: Attribute Value/s Description align right Defines the text alignment in cells. left center justify char <td> This tag defines a cell in a table. The following attributes are supported: Attribute Value/s...
Application Development <tbody> This tag defines a table body. The thead, tfoot and tbody elements enable you to group rows in a table. The following attributes are supported: Attribute Value/s Description align right Defines the text alignment in cells. left center Meta Information Tags The following meta information tags are supported:...
Developer’s Guide SoundPoint IP / SoundStation IP — HTTP over SSL/TLS — Self-signed or custom CA certificates • There are the following exceptions: — 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 • An instance that does not support user input, but appears in a window on the idle display SoundPoint IP 430 SoundPoint IP 650 SoundPoint IP 501 SoundStation IP 4000 Launching the Microbrowser The first time the Applications key is pressed, the main Microbrowser loads the home page specified in the mb.main.home configuration parameter.
Application key (or select the Application feature item). For more information on why to create another configuration file, refer to the Note “Configuration File Management on SoundPoint IP Phones” whitepaper at www.polycom.com/support/voice/ 2 - 12...
For more information on configuration parameters, refer to the Administrator’s Guide for the SoundPoint IP / SoundStation IP Family at http://www.polycom.com/support/voicedocumentation/. Sample Applications This section presents two sample applications that you can use as a starting point for writing your own application.
Page 24
Developer’s Guide SoundPoint IP / SoundStation IP To develop a static XHTML application: 1. Create a Sample.xhtml page with static information to be displayed. In this case, the static information will be "Hello World!". <html> <head> <title>Sample Application</title> </head> <body> <p>HelloWorld!</p>...
Page 25
Application Development <!- - BODY END - -> </html> 2. Configure the Web server to serve the above XHTML file. For example, if you are using Apache Tomcat to try this example, put this file into the webapps\PLCM folder of Tomcat. 3.
Page 26
Developer’s Guide SoundPoint IP / SoundStation IP <!-- START DISPLAY BMP FILE --> <img src="quote.bmp"/> <!-- END DISPLAY BMP FILE --> </body> </html> 4. Configure the Web server to deploy the above JSP file. For example, if you are using Apache Tomcat to try this example, put this file into the webapps\PLCM folder of Tomcat.
Troubleshooting This chapter presents problems, likely causes, and corrective actions. Problems are grouped as follows: • XML Errors If you still need assistance, contact your system administrator. XML Errors Symptom Problem Corrective Action Improperly formatted tables A table tag was improperly Correct the improperly formatted table.
Page 28
Developer’s Guide SoundPoint IP / SoundStation IP 3 - 2...
Appendix This appendix provides information on unsupported XHTML elements. Unsupported XHTML Elements The unsupported elements and attributes are: Tag Type Tag Description Basic Tags <html>—Defines HTML document. <body>—Defines documents’ body. <h1> to <h6>—Defines header 1 to header 6. <p>—Defines a paragraph. <br>—Inserts a single line break.
Page 30
Developer’s Guide SoundPoint IP / SoundStation IP Tag Type Tag Description Output Tags <pre>—Defines preformatted text. <code>—Defines computer code text. <tt>—Defines teletype text. <kbd>—Defines keyboard text. <var>—Defines a variable. <dfn>—Defines a definition term. <samp>—Defines sample computer code. <xmp>—Deprecated. Defines preformatted text. Block Tags <acronym>—Defines an acronym.
Page 31
Appendix Tag Type Tag Description Input Tags <form>—Defines a form. The following attributes are not supported: accept, accept charset, enctype, target, class, id, style, title, dir, lang, and accesskey. <input>—Defines an input field. The following attributes are not supported: accept, align, alt, disabled, maxlength, readonly, size, arc, type:button, type:file, type:image, class, is, style, title, dir, lang, accesskey.
Page 32
Developer’s Guide SoundPoint IP / SoundStation IP Tag Type Tag Description Table Tags <table>—Defines a table. The following atrributes are not supported: bgcolor, frame, rules, summary, id, class, title, style, dir, lang, and xml:lang. <caption>—Defines a table caption. <col>—Defines attributes for table columns. <th>—Defines a table header.
Page 33
Appendix Tag Type Tag Description Programming Tags <script>—Defines a script <noscript>—Defines a noscript section <applet>—Deprecated. Defines an applet <object>—Defines an embedded object <param>—Defines a parameter for an object A - 5...
Page 34
Developer’s Guide SoundPoint IP / SoundStation IP A - 6...
Need help?
Do you have a question about the SIP 3.0.2 and is the answer not in the manual?
Questions and answers