Polycom 3725-49106-001 Rev A manuel d'utilisation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

Aller à la page of

Un bon manuel d’utilisation

Les règles imposent au revendeur l'obligation de fournir à l'acheteur, avec des marchandises, le manuel d’utilisation Polycom 3725-49106-001 Rev A. Le manque du manuel d’utilisation ou les informations incorrectes fournies au consommateur sont à la base d'une plainte pour non-conformité du dispositif avec le contrat. Conformément à la loi, l’inclusion du manuel d’utilisation sous une forme autre que le papier est autorisée, ce qui est souvent utilisé récemment, en incluant la forme graphique ou électronique du manuel Polycom 3725-49106-001 Rev A ou les vidéos d'instruction pour les utilisateurs. La condition est son caractère lisible et compréhensible.

Qu'est ce que le manuel d’utilisation?

Le mot vient du latin "Instructio", à savoir organiser. Ainsi, le manuel d’utilisation Polycom 3725-49106-001 Rev A décrit les étapes de la procédure. Le but du manuel d’utilisation est d’instruire, de faciliter le démarrage, l'utilisation de l'équipement ou l'exécution des actions spécifiques. Le manuel d’utilisation est une collection d'informations sur l'objet/service, une indice.

Malheureusement, peu d'utilisateurs prennent le temps de lire le manuel d’utilisation, et un bon manuel permet non seulement d’apprendre à connaître un certain nombre de fonctionnalités supplémentaires du dispositif acheté, mais aussi éviter la majorité des défaillances.

Donc, ce qui devrait contenir le manuel parfait?

Tout d'abord, le manuel d’utilisation Polycom 3725-49106-001 Rev A devrait contenir:
- informations sur les caractéristiques techniques du dispositif Polycom 3725-49106-001 Rev A
- nom du fabricant et année de fabrication Polycom 3725-49106-001 Rev A
- instructions d'utilisation, de réglage et d’entretien de l'équipement Polycom 3725-49106-001 Rev A
- signes de sécurité et attestations confirmant la conformité avec les normes pertinentes

Pourquoi nous ne lisons pas les manuels d’utilisation?

Habituellement, cela est dû au manque de temps et de certitude quant à la fonctionnalité spécifique de l'équipement acheté. Malheureusement, la connexion et le démarrage Polycom 3725-49106-001 Rev A ne suffisent pas. Le manuel d’utilisation contient un certain nombre de lignes directrices concernant les fonctionnalités spécifiques, la sécurité, les méthodes d'entretien (même les moyens qui doivent être utilisés), les défauts possibles Polycom 3725-49106-001 Rev A et les moyens de résoudre des problèmes communs lors de l'utilisation. Enfin, le manuel contient les coordonnées du service Polycom en l'absence de l'efficacité des solutions proposées. Actuellement, les manuels d’utilisation sous la forme d'animations intéressantes et de vidéos pédagogiques qui sont meilleurs que la brochure, sont très populaires. Ce type de manuel permet à l'utilisateur de voir toute la vidéo d'instruction sans sauter les spécifications et les descriptions techniques compliquées Polycom 3725-49106-001 Rev A, comme c’est le cas pour la version papier.

Pourquoi lire le manuel d’utilisation?

Tout d'abord, il contient la réponse sur la structure, les possibilités du dispositif Polycom 3725-49106-001 Rev A, l'utilisation de divers accessoires et une gamme d'informations pour profiter pleinement de toutes les fonctionnalités et commodités.

Après un achat réussi de l’équipement/dispositif, prenez un moment pour vous familiariser avec toutes les parties du manuel d'utilisation Polycom 3725-49106-001 Rev A. À l'heure actuelle, ils sont soigneusement préparés et traduits pour qu'ils soient non seulement compréhensibles pour les utilisateurs, mais pour qu’ils remplissent leur fonction de base de l'information et d’aide.

Table des matières du manuel d’utilisation

  • Page 1

    Polycom, Inc. 1 Web Application for Polycom ® Phones DEVELOPER GUIDE UC Software 5.0.0 | Se ptember 2013 | 3725 -49106- 001 Rev A[...]

  • Page 2

    Polycom, Inc. 2 Copyright ©2013, Polycom, Inc. All rights reserved. No part of this document may be reproduced, translated into another language or format, or transmitt ed in any form or by any means, electronic or mechanical, for any purpose, without the express written permis sion of Polycom, Inc. 6001 America Center Drive San Jose, CA 95002 USA[...]

  • Page 3

    Polycom, Inc. 3 Contents About This Guide ...................................................................................................... 5 Conventions Used in Thi s Guide .................................................................................................... 5 Information Elements ...............................................[...]

  • Page 4

    Polycom, Inc. 4 Receiving Call Line Information ..................................................................................................... 35 Receiving Device Informati on ........................................................................................................ 36 Receiving Network Configu ration ..........................[...]

  • Page 5

    Polycom, Inc. 5 About This Guide This guide uses a number of conventio ns that help you to understa nd information and perform tasks. Conventions Used in This Guide This user guide contains term s, graphical elements, and a few t ypographic conventions. Familiari zing yourself with these terms, elements, and conventions will help you perfo rm certa[...]

  • Page 6

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 6 Typographic Conventions A few typographic conventions, li sted next, are used i n this guide to distinguish types of in-tex t information. Typographic Conventions Used in This Guide Convention Description Bold Highlights interface items such as menus, soft keys, file names, and di[...]

  • Page 7

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 7 Coding Conventions Sample code is shown in this guide to assist you in writing your appl ications. All samples are presented in the following format. Table 1: Sample Code <html> <body> <br/> Click on the link to engage the DND feature <a href="Key:DoNotDi[...]

  • Page 8

    Polycom, Inc. 8 Getting Started 1: Getting Started provides you with infor mation on helpful resources and r ecommended software t ools that can aid you in Web applicat ion development on Polycom ® p hones with the Polycom UC software. This Web Application Dev eloper’s Guide provides you with information on how to install and use the Polycom Sof[...]

  • Page 9

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 9 The XML API is designed to provide y ou with flexibility when develo ping Polycom phone appli cations while securely integrating i nto the phone’s capabilities and functions. The XML AP I features are supported by the Polycom browser and microbrowse r, except where noted. You’[...]

  • Page 10

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 10  Positioning Soft Key s Use a hard key press simulation t o test your applicat ion, provided the phone supports this functio n. When working with simul ators, simulating key press es for call screen soft keys, such as EndCall and Tr ansfer call controls, are not r eliable. Dep[...]

  • Page 11

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 11  Minimizing Onscreen Information Make sure you do not include too much information at o ne time on the screen of the idle brow ser. Because the idle browser h as no scrolling capability, excessive information can not be viewed and slows down the perfo rmance of the phone and w[...]

  • Page 12

    Polycom, Inc. 12 Understanding Web Application 2: Development on Polycom Phones Polycom has two types of bro wser environments for Polycom phones running Polycom UC software: browser and microbrowser . Before you write your ap plication, you need to explo re both environments and choose the one that provid es the best mapping to the phone models yo[...]

  • Page 13

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 13 would on a computer, or a microbrowser that supports a limited set of XHTML tags and displays limited content. For a more information on w hich Polycom phones sup port a browser or a microb rowser, see What is the Browser ? and What is the Microbrowser?. Th is chapter covers the [...]

  • Page 14

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 14 The browser display is limited by the total display area available o n each Polycom phone mo del. If you are creating an application for a specific Polycom phone model, co nsider the display area as a factor in the design of your Web applicatio n. The following table shows the to[...]

  • Page 15

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 15  Dynamic XHTML These pages involve dynamic information updat es of XHTML pages by an application hosted on the Web server. The application residing o n the Web server retrieves information from an intranet or Internet data service provider lik e Yahoo, Exchange S erver, Call C[...]

  • Page 16

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 16 What is XHTML? XHTML, or eXtensible HyperText Markup Language, is a family of XML markup languages th at mirror or extend versions of the widely-used Hyp ertext Markup Language (H TML), the language used to write Web pages. XHTML is HTML 4.01 redesi gned as XML. You need to have [...]

  • Page 17

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 17 The SDK installation file installs the follo wing components on your computer:  Phone Simulators  The SDK Quick Start Guide  An Apache Tomcat Web Server  The XML API Web Testing Tool Launching the Polycom SDK The Polycom SDK is a set of tools designed to assist you in[...]

  • Page 18

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 18 covers the range of functional impr ovements that were int roduced with the latest UC soft ware updates from 4.0.1 to 5.0.0. Note: Supporting Legacy Phone Models Certain phone models, or legacy phones, are not supported in the Polycom UC Software 4.0.x release. For the appropriat[...]

  • Page 19

    Polycom, Inc. 19 Getting to Know the XML API 3: Application Interface Th e XML API provides you with flexibility in developing application s on Polycom phones while you securely integrate into the phone’s capabilities and functions. The XML API features are su pporte d by the microbrowser and browser, except where noted. This chapter covers the f[...]

  • Page 20

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 20 The following are ways to execute a n internal URI action:  If the file sent to the phone contains only internal URI a ctions, which you can send as Data Push, ensure the file content ty pe is application/x - com - polycom - spipx . Each internal URI action must be separated b[...]

  • Page 21

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 21 Action Type Action Tel 23 Number;LineIndex;ext=<extension_no>;postd=<DTMF> The Tel URI initiates a new call to the specified number on the specified line. The line number is optional . I f the line number is not supplied, then the first available line is used. The dig[...]

  • Page 22

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 22  If any invalid URI is present in a XHTML file, the execution of that URI is ig nored. For example, Table 7 shows the co de created for a link that behave s as if you pressed the Do Not Disturb key: Table 7: Sample Code - Simulate Pressing of Do Not Disturb Key <html> &l[...]

  • Page 23

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 23 HTTP URL Push The HTTP URL push ena bles an application to push a URL to a phone to open its microbrowser or browser, as for example, an HTML Web page. The U RL value sent within the pu sh request is relative to the URL configured by the apps.push.serverRootURL configur ation par[...]

  • Page 24

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 24 Phone State Priority Description Important The phone will display push request immediately. Normal The phone will display push request immediately. Non -Idle State Critical The phone will display push request immediately. High The phone will display push request immediately, but [...]

  • Page 25

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 25 HTML Data Push The data push enables you to send X HTML page content directly t o a phone without the over head of the phone having to fetch the XHTML. Use the following format when sendin g the HTML Data Push: <Data priority=”X” >Y</Data> When pushing data to a p[...]

  • Page 26

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 26 Phone State Priority Description High The phone will display push request immediately, but it will appear after critical push requests. The phone will check whether the last processed message is of the same or a higher priority. If it is the same or a higher priority, then the ph[...]

  • Page 27

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 27 Using Telephony Notifi cation Events Telephony events allow application pro grams insight into how the phones op erate. Using a combination of telephony events enables an a pplication to detect the starting of the ph ones, the signing on of users, and the ongoing condition of the[...]

  • Page 28

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 28 Attribute Permitted Values CallingPartyNumber number The number displayed on the phone. If the line is registered and the call is initiated from that line , the registered line number of the calling party is shown. If the line is not registered and the call is initiated using IP [...]

  • Page 29

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 29 Attribute Permitted Values State Outgoing call states: Dialtone, Setup, Ringback Incoming call states: Offering Outgoing/incoming call states: Connected, Hold, Held, Free, Disconnected Unknown call state: Ncas The call state. LineKeyNum number Line that is registered. For example[...]

  • Page 30

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 30 The following example shows the t ransmitted data for a call between two registered lin es when the telephone notification URI is set and t he incoming call event is enab led to gather information: Table 18 : Incoming Call Event <IncomingCallEvent> <PhoneIP>172.24.132[...]

  • Page 31

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 31 Use the following format whe n viewing the offhook event: Table 20 Code Snippet for Offhook Event <OffHookEvent> <PhoneIP> </PhoneIP> <MACAddress> </MACAddress> <TimeStamp> </TimeStamp> </OffHookEvent> Viewing an Onhook Event The On[...]

  • Page 32

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 32 Viewing a Phone Unlock Event The phone un lock event notifies the applicatio n when the phone is un locked. Instruction s sent to the phone in a locked state ar e ignored. Use the following format whe n viewing the phone unlock event: Table 23 : Phone Unlock Event <PhoneUnlock[...]

  • Page 33

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 33 Viewing a Line Registration Event The Line Registration Event occur s when a phone registers a line to a call se rver. This event is useful for flagging when the phone is on and run ning on the network. Use the following format when vi ewing the line registration event: Table 25 [...]

  • Page 34

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 34 Viewing a User Login/Logout Event The UserLogin/Logout Ev ent is used to detect when a profile is u sed to sign into or out of a phon e. Use the following format whe n viewing the user login/logout event: Table 27 : User Login/Logout Event <UserLoginOutEvent> <PhoneIP>[...]

  • Page 35

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 35 Two HTTP transactions o ccur:  The application sends an HTTP re quest to a particular han dler in the phone.  The Phone posts the state , in XML format, to a preconfigured Web server. See Configuring Phone Sta te Polling Parameters for the paramete rs that control this f ea[...]

  • Page 36

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 36 Attribute Permitted Values LineDirNum phone number The phone number associated with the line. For example, ‘1234’ . LineState Active, Inactive The line state. CallState Outgoing call states: Dialtone, Setup, Ringback Incoming call states: Offering Outgoing/incoming call state[...]

  • Page 37

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 37 The Device Information message is ret urned in the following form at: Table 30 : Device Information <DeviceInformation> <MACAddress> </MACAddress> <PhoneDN> </PhoneDN> <AppLoadID> </AppLoadID> <BootROMID> </BootROMID> <Mode[...]

  • Page 38

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 38 The Network Configuration message is returned in the following format: Table 32 : Network Configuration <NetworkConfiguration> <DHCPServer> </DHCPServer> <MACAddress> </MACAddress> <DNSSuffix> </DNSSuffix> <IPAddress> </IPAddress[...]

  • Page 39

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 39 Attribute Permitted Values DNSServer2 IP address The configured IP address of DNS Server 2. For e xample ‘192.168.1.250’. VLANID Null, 0 to 4094 The p hone’s 802.1Q VLAN identifier. For example ‘45’. DHCPEnabled Yes, No If DHCP is enabled and set to ‘Yes’.[...]

  • Page 40

    Polycom, Inc. 40 Writing Your Web Application 4: This chapter provides you with information you need to know while writing your Web appli cation. The topics in this chapter inclu de:  Developing Your Browser A pplication  Developing Microbrowser-Specific Ap plications Web Info: Polycom Developer Community Polycom has an active Developer Commu[...]

  • Page 41

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 41  HTTPS by HTTP over TLS The browser supports the TLS protocol v1 only . It is not backward compatible with SSL v2 or S SL v3.  Custom CA certificates Web Info: To View Trusted Certificate Authorities For more information on CA certificates, see Technical Bulletin 17877: Usi[...]

  • Page 42

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 42 Figure 2: VVX 500 Main Browser Navigati ng and Form Editing on the Main Browser Navigation and Form Editin g is slightly different on each phone. The different keyboard key s and the presence or absence of a touch-screen display affects the Navig ation and Form Editing. However, [...]

  • Page 43

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 43 Form editing in the browser behaves the same as any major Web b rowser. When an input field is invoked , t he keyboard displays at the b ottom of the screen, and the input field is centered at the top of the screen. The keyboard is removed from the screen once you click o n the s[...]

  • Page 44

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 44 Figure 4: VVX 500 Idle Browser Using Browser JavaSc ript DOM Extensions The browser provides access to phone- specific Document Object Model ( DOM) JavaScript ext ensions. The DOM is created by the bro wser after parsing an XHTML f ile. Jav aScript’s primary role in the brow se[...]

  • Page 45

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 45  PolySoftKey.setSoftkey Label(int, string) Sets the label of a gi ven custom soft key (0 to 3).  PolySoftKey.hideToolbar() Enables the application to hide the soft key toolbar.  PolySoftKey.sho wToolbar() Returns the soft key toolbar.  PolySoftKey.getSoftkey Point(int[...]

  • Page 46

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 46 // get the styled points of the SKs so app can add whatever object they // want to that area after calling hideToolBar() function getSKPoints(){ // Returns a JSON object with two properties, X & Y. To convert to // JS object you must use the eval function on the JSON object. [...]

  • Page 47

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 47 The PolyU ri custom DOM extension example is shown next. Ta ble 35 : PolyUri DOM Extension PolyUri.shownSig.connect(appShown); PolyUri.hiddenSig.connect(appHidden); function appShown(){ // Pushes a play request whenever the browser is shown PolyUri.pushUri("play:http://172.2[...]

  • Page 48

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 48  Table Tags  Meta Information Tags  Audio Tags  Ordered and Unordered List Tags Unsupported elements and att ributes are described in Unsupported X HTML elements on the Microbrowser . Basic Tags The following basic tags ar e supported:  <!DOCTYPE> — Defines[...]

  • Page 49

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 49 This tag does not support any attributes. Link Ta gs The following link tag is su pported:  <a> — Defines an anchor <a> Use the <a> tag to define an anchor. An anchor can be used to create a link to another document by using the HREF attribute or to creat e[...]

  • Page 50

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 50 Note: Nesting Forms Are Supported 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 can lead to unexpected results. <form> Use the <[...]

  • Page 51

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 51 The <input> tag supports the attributes listed in the following table. Table 40 : < input > Tag Attributes Attribute Value(s) checked 1 checked Indicates that the input element should be checked when it first loads. type checkbox, hidden, password, radio, reset, submi[...]

  • Page 52

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 52 You can scroll images up and do wn; however, images that are too wide will be truncated. Various platforms have diff ering limits due to memory . There are also differing pi xel limits for devices of differing pixel depth. A 1 bit per pixel image 160x80 requires o nly 1600 bytes.[...]

  • Page 53

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 53 Table Tags The following table tags are supporte d:  <table> — Defines a table  <caption> — Defines a table caption  <th> — Defines a table header  <tr> — Defines a table row  <td> — Defines a table cell  <thead> —[...]

  • Page 54

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 54 An example for the <table> tag is shown next. Table 44 : <table> Tag Example { <table align=”center” border=”1px” cellpadding=”1px” cellspacing=”1px” width=”100%” /> <caption> This element defines a tabl e caption. The <caption> t[...]

  • Page 55

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 55 <th> This tag defines a table header cell in a table. The text within the <th> element usually renders in bol d. The bgcolor , height , width , and nowrap attributes of the <th> element are not supported in XHTML 1.0 Strict DTD. The <th> tag supports the a[...]

  • Page 56

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 56 Attribute Value(s) lang language_code Sets the language. For example, EN=English, DE=German. nowrap no wrap Whether to disable or enable automatic text wrapping in this cell. Deprecated. Use styles instead. rowspan number Indicates the number of rows this cell should span. title [...]

  • Page 57

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 57 <td> This tag defines a cell in a table. The bgc olor , height , width , and nowrap attributes of the < td > element are not supported i n XHTML 1.0 Strict DTD. The <td> tag supports the attributes listed in the following table. Table 48 : < td > Tag Attri[...]

  • Page 58

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 58 Attribute Value(s) charoff pixels, % Specifies the alignment offset to the first character to align on. Used if align =char. class class_rule, style_rule The class of the element. dir ltr (left to right), rtl (right to left) Sets the text direction. id unique_name Defines a uniqu[...]

  • Page 59

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 59 The <tfoot> tag supports the attributes listed in the following table. Table 51 : < tfoot > Tag Attributes Attribute Value(s) align left, right, center, justify, char Specifies the horizontal alignment of cell content text. char character Specifies which character to [...]

  • Page 60

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 60 <head> The < head > element contains informati on about the document. The bro wser does not display the head information. The following tags can b e in the head section: <base> , <link> , <meta> , <script> , <style> , and <title> . [...]

  • Page 61

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 61 An example of the <audio> tag is shown next. Table 53 : <audio> Tag Example <audio src="flute16Ksps.wav" description="This is a short description" buttons="Details Back" links="details.xhtml SoftKey:Back" /> Ordered and Un[...]

  • Page 62

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 62 An example of an unordere d list is shown next. Table 55 : <ul> Tag Example <ul> <li><a href="target1">link 1</a></li> <li><a href="target2">link 2</a></li> <li><a href="target3">[...]

  • Page 63

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 63 Whenever there is an eve nt in the phone application that requi res your attention, the telephony application is brought to the foreg round automatically. While you are viewing the microbr owser, if there is an ev ent in the phone application t hat requires your attention, the ph[...]

  • Page 64

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 64 Viewing the Idle Browser The idle display microbrowser is inde pendent of the main microbrowser b ut is capable of rendering the same content. The idle browser’s home page i s configured via the mb.idleDisplay.home configuration parameter. The idle di splay microbrowser does no[...]

  • Page 65

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 65 Note: Careful When Copying Sample Code Be careful when copying the lines of code in the following tables because the lines may have wrapped over to the next line. If you cut and paste these lines, the code can in advertently contain li ne breaks. Check that the code is valid befo[...]

  • Page 66

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 66 To develop a dynami c XML application: 1 Use the following to create a addstock.xhtml example : Table 57 : Sample Code - addstock.XHTML Example <html xmlns="http://www.w3.org/1999/xhtml"> <!- - HEADER START - -> <head> <title>Stocks</title>[...]

  • Page 67

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 67 // DEFINE URL FROM WHERE CONTENT TO BE RETRIEVED String stockUrl = "http://ichart.yahoo.com/t?s="; // RETRIEVE THE STOCK SYMBOL FROM REQUEST String stockSymbol = "PLCM"; // DEFAULT TO PLCM if ( request.getParameter("stockname") != null ) { stockSymbo[...]

  • Page 68

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 68  A customer is browsing a company’s Web site on the internet. They come upon this web page, http://A_Web_Site/WebCallback.aspx , and enter their name and phone number as shown next.  After the customer clicks Send R equest, the page sho wn below is pushed to t he customer[...]

  • Page 69

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 69 To develop an XML API application: 1 Using your integrated development envi ronment (IDE) of choice, create a new file and name t his file webcallback.aspx . Table 59 : webcallback XHTML Example <%@ Page Language="C#" AutoEventWireup="true" CodeFile="W[...]

  • Page 70

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 70 2 Using the IDE of your choice, create a file called webcallback.aspx.cs . Table 60 : webcallback.aspx.cs Example using System; using System.IO; using System.Text; using System.Data; using System.Configuration; using System.Net; using System.Web; using System.Web.Security; using [...]

  • Page 71

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 71 string result = ""; // Create the web request HttpWebRequest request = (HttpWebRequest)WebRequest.Create(strLoc); WebRequestState myRequestState = new WebRequestState(); myRequestState.request = request; request.Method = "POST"; request.Credentials = myCache; [...]

  • Page 72

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 72 } } public class WebRequestState { public String postData = null; public WebRequest request; public WebRequestState() { request = null; } public String getPostData() { return postData; } public void createPostData(String phoneNum, String name) { postData = "<PolycomIPPhon[...]

  • Page 73

    Polycom, Inc. 73 Using Configuration Parameters 5: This chapter shows you how to configure Polycom phones to run your newly-created Web applicatio n us ing the configuration file s that accompany the Polycom® UC software. The configuration pa rameters dictate the behavior of the phone on ce it is running the executable specified in the master conf[...]

  • Page 74

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 74 Configuring Web Application Parameters Th e parameters shown in the followin g table control the home pag e, proxy, and size limits tha t are used by the microbrowser and brow ser when it is selected to provide s ervices. Table 61 : Microbrowser and Web Browser Parameters Paramet[...]

  • Page 75

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 75 Configuring Push Request P arameters The < apps.push/> parameters are used to control pus h server controls. Requests sent to the phone’s push server must be in the f ormat of http://<Phone IP>/push . The push control request parameters are listed in the following t[...]

  • Page 76

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 76 Configuring Telephone Event Notification Parameters The < apps.telNotification/> parameter is used to contr ol telephone notification eve nts. The telephone event notificatio n parameters are listed in the followi ng table. Table 63 : Telephone Event Notification Parameters[...]

  • Page 77

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 77 Configuring Phone State Polling Paramet ers The < apps.statePolling/> parameter is used to control state polling events. The telephone state polling notification event parameter s are listed in the following table. Table 64 : Telephone Event Notification Parameters Paramete[...]

  • Page 78

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 78 The <softkey> tag supports the attributes listed in the following table. Table 65 : <softkey> Tag Attributes Attribute Permitted Values index Numeric, 1 to 8 Position of the soft key. name String Text displayed on soft key when the Softkey:Submit action is used. It is[...]

  • Page 79

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 79 Action Default Action Name Description Key:Handsfree Hands-free Enables use of speaker Key:Messages Messages Opens the Messages menu Key:Applications Applications Opens the Applications menu Key:MicMute Mute Mutes the phone when the call state Key:Directories Directories Opens th[...]

  • Page 80

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 80  An index greater than eight is ignored.  By default, a Back soft key is placed on the graphic display even if one is n ot defined. Note: When the Back Soft Key Doesn’t Display W hen mb.main.autoBackKey is set to 0 , t he Back soft key will not display.  When using mor[...]

  • Page 81

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 81  mb.main.home is set to the URL used for the microb rowser or browser home page. For exa mple, http://10.11.32.128:8080/sampleapps/login .  apps.push.alertSound is set to 1, so a sound is played w hen an alert is pushed.  apps.push.messageType is set to the appropriate d[...]

  • Page 82

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 82  apps.telNotification.callStateChange is set to 1 to enable notifications for call state change events.  apps.statePolling.URL is set to the location where requested state polling information should be sent. For example, http://172.24.128.85:8080 .  apps.statePolling.res[...]

  • Page 83

    Polycom, Inc. 83 Getting Help 6: This section provides a list of Polycom documents referred t o in this guide as well as partner r esources you can use. If you are looking for h elp or technical suppo rt for your phones, the followin g types of documents are available on the Poly com Voice Support site:  Quick Start Guides, which describe how to[...]

  • Page 84

    Polycom, Inc. 84 Troubleshooting 7: The browsers that best match Polycom phone browsers are Chrome or S afari, as they are built on WebKi t as well. You can use Chrome or S afari to test rendering is sues on the computer before testing them on the phone’s browser. When debugging Web pages, the Ins pect Element in the phone s imulator and in Chrom[...]

  • Page 85

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 85 The following table describes po ssible solutions to brow ser application errors Table 70 : Troubleshooting Browser Application Errors Pushed message is not display ing in browser. Push message is displayed i n the browser based on the priority of the message. See Table 10 : How [...]

  • Page 86

    Polycom, Inc. 86 References 8: This chapter provides you with a list of recommen ded references that can help y ou when writing your application. When writing your appli cation, refer to the followin g resources for additional hel p.  You can locate Polycom's UC Softwa re 5.0.0 Administrator s’ Guide on the Polycom Support Web site.  Y[...]

  • Page 87

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 87 Tag Type Tag Description <big> — Defines big text. <strong> — Defines strong text. <small> — Defines small text. <sup> — Defines superscripted text. <sub> — Defines subscripted text. <bdo> — Defines the direction of text display. &l[...]

  • Page 88

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 88 Tag Type Tag Description <link> — Defines a resource reference. Frame Tags <frame> — Defines a sub window (frame). <frameset> — Defines a set of frames. <noframes> — Def ines a noframe section. <iframe> — Defines an inline sub window (frame[...]

  • Page 89

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 89 Tag Type Tag Description Image Tags <img>-Defines an image. The following attributes are not supported: alt, align, border, hspace, ismap, longdesc, usemap, vspace, id, class, title, style, xml:lang, and lang <map> — Defines an image map. <area> — Defines an[...]

  • Page 90

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 90 Tag Type Tag Description <param> — Defines a parameter for an object JavaScript Examples for the B rowser This section provides JavaScript examples that work in conjunction with t he browser on Polycom ® VVX ® 500 and 1500 phones. Note: Examples have Wrapped Lines The l[...]

  • Page 91

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 91 break; case 3: document.getElementById("eventStuff").innerHTML = "SK 4 was pressed"; break; } document.getElementById("eventValue").innerHTML = skEvent; } // hide the tool bar function hideSKs(){ PolySoftKey.hideToolBar(); } // show the tool bar func[...]

  • Page 92

    Web Application for Polycom Phones UC Software 5.0.0 Polycom, Inc. 92 </div> <div id="eventText"> <p>Last Click: <b id='eventStuff'>0</b> </p> <p>Event Value: <b id='eventValue'>0</b> </p> </div> <div id="clickPos"> <input type='b[...]