Avaya 16-300272 Скачать руководство пользователя

Страница: 66 / 82

Appendix A

Push XML API

Preparing the Application Gateway and an Application to Use the Push XML API

Broadcast Server User Guide

Preparing the Application Gateway and an

Application to Use the Push XML API

To send alerts from a third-party application to IP phones through the

Push XML API, you must enable the Push XML API on the Application

Gateway and program the application to send XML to the Application

Gateway.

To enable the Push XML API on the Application Gateway:

Upload a Broadcast Server license to the Application Gateway.
The Broadcast Server license opens a port on the Application Gateway for

communication with a third-party application.

Enter the URL of the application in the Application Gateway

Administration Tool on the Operation > Voice Office > IP Phone page.
The Application Gateway needs the application URL so that it can send the

application the IP address and push port to use when sending XML to the

Application Gateway.

To program an application to use the Push XML API:

Configure the application to send XML requests and to receive XML

responses over the Application Gateway’s push port via HTTP.

Create an interface for composing and sending distribution list and alert

requests.

“Sample ASP Pages,” page 71

contains sample ASP pages for sending the

XML code for a distribution list and an alert to the Application Gateway.

To test the connection between the Application Gateway and the

application:

Compose a simple alert in your application and send it to one test phone.

Verify that the phone received the alert.

On the phone, click the OK or Exit soft key to dismiss the alert.

Verify that your application received confirmation that the alert was

delivered and viewed.

Содержание 16-300272

Страница 1: ...Broadcast Server User Guide Release 2 1 Service Pack 16 300272 Issue 2 1 April 2006...

Страница 2: ...s a malicious party is anyone including someone who may be otherwise authorized who accesses your telecommunications equipment with either malicious or mischievous intent Such intrusions may be either...

Страница 3: ...th Phones 5 Opening and Using the Broadcast Server Interface 6 Configuring Broadcast Server 6 Initial Configuration 7 Broadcast Server Maintenance 8 C H A P T E R 2 Application Gateway and Broadcast S...

Страница 4: ...A P T E R 7 Distribution List Management 27 The Distribution List Page 27 Automatically created distribution lists 28 List ownership 28 Sharing distribution lists 29 Quick FAQ 29 The Distribution Lis...

Страница 5: ...t Management 45 The Alert List 45 Column Descriptions 46 Alert Types 47 Emergency alerts 47 Normal alerts 47 Background alerts 47 Quick FAQ 48 The Alert Page 49 C H A P T E R 11 My Preferences 53 Chan...

Страница 6: ...mber 62 ServerRegistration Response 63 Subscribers Response 63 PushMessageResponse Response 63 Push XML Reference 64 Character Set and Character Entities 64 XML Declaration 64 ManagePushMessage 65 Man...

Страница 7: ...anized and its document conventions Audience This user guide is intended for administrators who will configure and use the Broadcast Server Related Documentation For deployment and installation inform...

Страница 8: ...Related Documentation viii Broadcast Server User Guide...

Страница 9: ...want to share Broadcast Server includes the following features Pushed priority alerts with audio notifications Flexible subscriber distribution lists Automatically generated and updated distribution...

Страница 10: ...Broadcast Server requires the Application Gateway for operation While Broadcast Server provides an interface for creating and scheduling alert delivery the Application Gateway manages alerts and trans...

Страница 11: ...ustomized as described in General user permissions page 20 Subscribers and Distribution Lists Subscribers IP telephones are added to Broadcast Server automatically You configure the Application Gatewa...

Страница 12: ...ng the subscriber to request outstanding alerts An alert might consist of a meeting reminder that is scheduled for delivery at a particular date and time or an Emergency announcement that takes preced...

Страница 13: ...ert is delivered to the phone regardless of phone state an in progress phone call is put on hold For Normal alerts Alert is delivered to the phone if the phone is idle whether on or off hook Alert is...

Страница 14: ...The home page for the Broadcast Server administrator provides access to all tasks The home page for a Broadcast Server user provides access to a subset of tasks Many pages in the Broadcast Server inte...

Страница 15: ...te Configuration Guide Chapter 2 LDAP CSV Directory Configuration 2 Create user accounts To enable a user to log in to Broadcast Server and work with alerts you must create an account for the user The...

Страница 16: ...rvices External services are network based applications that can be launched from IP telephones Users can provide IP phone users access to external services by adding a soft key to a broadcast alert T...

Страница 17: ...e in the appropriate format for display and delivery to IP telephones Note Sites using a cluster of Application Gateways should configure all Application Gateways in the cluster with the same Broadcas...

Страница 18: ...st Server where the information is used to update the subscriber list The Application Gateway also uses the phone extension to locate the associated department name in the directory The Application Ga...

Страница 19: ...Broadcast Server control parameters and for performing system level tasks such as temporarily disabling the system Component Versions This section lists the versions of the various components used by...

Страница 20: ...Configuration Wizard at any time Purge alerts after The period that inactive alerts will be retained in the Broadcast Server database before being automatically deleted Item Description Administrative...

Страница 21: ...splay in the first blue tip box on the Broadcast Server home page Tip 2 The text to display in the second blue tip box on the Broadcast Server home page Tip 3 The text to display in the third blue tip...

Страница 22: ...Chapter 3 System Management Home page tips 14 Broadcast Server User Guide...

Страница 23: ...FAQ Icon Description The message is informational only The message is a critical error The message has not been viewed How do I Description View message details Click the message in the record you wan...

Страница 24: ...Chapter 4 System Messages Quick FAQ 16 Broadcast Server User Guide...

Страница 25: ...of an alert that users may modify and so on You create and manage login IDs user names and passwords within Broadcast Server The User Management List The user management page presents the list of Bro...

Страница 26: ...n at the top of the list This will open the User Page Edit a user Click the user ID in the record you want to modify This will open the User Page Delete one or more users Check the box next to each re...

Страница 27: ...ID and a name defined You can also provide a department name or number but this information is not required for the user to be considered valid within Broadcast Server Password The password section o...

Страница 28: ...ce over all other types of alerts and cause Broadcast Server to ignore subscriber specific settings such as Do Not Disturb and whether the subscriber wishes to receive priority alerts or not Most ordi...

Страница 29: ...r private distribution lists Most non administrative Broadcast Server users should not have this privilege assigned to them Instead the system administrator should create distribution lists and share...

Страница 30: ...Chapter 5 User Management The User Page 22 Broadcast Server User Guide...

Страница 31: ...ist The subscriber management page presents the list of subscriber records that fulfill your current filter criteria Individual entries are displayed with helpful icons to the left of each entry where...

Страница 32: ...box in the list s title to select all records displayed Then click the Delete Selected button See which distribution lists a subscriber belongs to Edit the subscriber record The Distribution list mem...

Страница 33: ...the subscriber will receive alerts posted by Broadcast Server users The IP Address field contains the network address for the subscriber IP telephone The value of this field is especially important t...

Страница 34: ...on list to edit the membership for that list Setting Description Types of alerts to receive Dictates the types of alerts that can be delivered to the subscriber Emergency alerts are not subject to thi...

Страница 35: ...eway uses the phone extension to locate the associated department name in the directories The Application Gateway sends the department information to Broadcast Server where it is used to update the di...

Страница 36: ...Note Automatically created distribution lists cannot be renamed or have their recipients changed Broadcast Server updates this information By default an automatically created distribution list is priv...

Страница 37: ...dcast Server users who will be able to send alerts to the distribution list To unshare a list simply change the ownership to Administrator Private and assign ownership to another Broadcast Server user...

Страница 38: ...st s title to select all records displayed Then click the Delete Selected button Note that the Broadcast Server re instates created distribution lists during its next synchronization if these are dele...

Страница 39: ...ions if any even if you are not the owner of the list You will not however be able to change information of a list you do not own The Distribution List Membership Page This page contains two columns s...

Страница 40: ...t members To add members check the boxes in the right side column next to the items you want to add and click the Add Selected button To remove members check the boxes in the left side column next to...

Страница 41: ...want to add and click the Add Selected button To select all users click the box in the column heading to the left of Name Users who have been granted rights to send to the lists can select the list as...

Страница 42: ...Chapter 7 Distribution List Management The Distribution List User Permissions Page 34 Broadcast Server User Guide...

Страница 43: ...libraries maintained by the system administrator and or individual Broadcast Server users Not all phones support the display of images Both image and audio files stored in the media library can be sel...

Страница 44: ...clips used internally by Broadcast Server available to the system administrator only Note While all sections are visible to the Administrator user regular Broadcast Server users are restricted to Shar...

Страница 45: ...mmediately reflected throughout the system in all alerts as soon as the media item is changed Quick FAQ How do I Description Add a new media item Click the Add Media button at the top of the list This...

Страница 46: ...rent file name Uploading a media file If you want to replace the existing media item if any you need only enter the name of a file on your computer or click the Browse button to open a selection box O...

Страница 47: ...depth of the picture For best results use a file with a resolution and color model appropriate for the IP phone screen Supported audio formats Note Broadcast Server is capable or converting most wave...

Страница 48: ...Chapter 8 Media Management The Media Page 40 Broadcast Server User Guide...

Страница 49: ...cast Server system administrator must first define the service using the External Service Management functionality of Broadcast Server before a user can link to an external service Available services...

Страница 50: ...oadcast Server users when they create alerts How do I Description Add a new External Service Click the Add Service button at the top of the list This will open the External Service Page Edit an Extern...

Страница 51: ...phones must be capable of accessing the URL exactly as typed For instance If your IP phones cannot use DNS to resolve a URL you must enter an IP address instead of a host name in the URL In addition t...

Страница 52: ...Chapter 9 External Service Management The External Service Page 44 Broadcast Server User Guide...

Страница 53: ...e to the currently logged in user Broadcast Server will display an alert to a user if a The user is the current owner of the alert or b The user can send alerts to a distribution list that the alert h...

Страница 54: ...been delivered The alert is owned by the currently logged in user Click this icon to change ownerships of the alert Only available to the system administrator Click this icon to contract or expand th...

Страница 55: ...barge priority Alerts automatically rotate for their display duration This means that if multiple alerts are sent to a phone Broadcast Server will display each alert for the display period set for th...

Страница 56: ...from the popup list Send an alert containing a graphic Edit the alert record check the alert graphic option and select a graphic from the media library using the Select a Graphic button Then save your...

Страница 57: ...e checkbox Indicates whether the alert is active Inactive alerts are not delivered to subscribers Title The title of the alert This text displays in the title are of a phone s screen A title can be a...

Страница 58: ...this page An alert can be a maximum of 1000 characters Button definitions This section allows you to define buttons displayed on each page of an alert Subscribers reading the alert can press the butto...

Страница 59: ...ement The Alert Page 51 Use audio alert If checked indicates to Broadcast Server that an audio alert must be played on the phone when the alert is pushed to the device The current System Audio clip in...

Страница 60: ...Chapter 10 Broadcast Alert Management The Alert Page 52 Broadcast Server User Guide...

Страница 61: ...chosen to allow blank passwords and you have a password defined Set the number of alerts per page The alert list has numerous options for display including a feature that divides the entire alert list...

Страница 62: ...Chapter 11 My Preferences Setting the maximum list entries to display 54 Broadcast Server User Guide...

Страница 63: ...in 30ms frames Verify that your network devices are optimized for this framing size or contact Support for assistance in changing these parameters Host not found is displayed on the phone s screen The...

Страница 64: ...Chapter 12 Troubleshooting Common problems 56 Broadcast Server User Guide...

Страница 65: ...Application Gateway then sends a response back to your application containing alert status and error information The response returned to your application is an XML string sent over HTTP The XML that...

Страница 66: ...on Voice Office IP Phone page The Application Gateway needs the application URL so that it can send the application the IP address and push port to use when sending XML to the Application Gateway To p...

Страница 67: ...at are deleted or expired Notifies the application about the status of the pushed alerts The following topics provide a general description of the XML elements used in those operations PushMessage Req...

Страница 68: ...ML Recipient One or more Recipient elements can be included in a PushMessage element Recipient element attributes specify the destination phone s and or distribution list s of the alert Subject Body I...

Страница 69: ...ration Date page of the Application Gateway Administration Tool days The days element contains an attribute for each day of the week For each day you specify whether or not the alert is to be sent on...

Страница 70: ...ateway uses the DistributionListRequest element to maintain the distribution lists specified with PushMessage To send more than one DistributionListRequest you wrap the elements in a ManageDistributio...

Страница 71: ...with the Application Gateway The Subscribers element attributes define the following The device which is either the user name associated in an LDAP directory with the device or the phone model The dep...

Страница 72: ...Character Entities The Push XML API supports the UNICODE character set Use character entity references to escape the following special characters For more information on character references and char...

Страница 73: ...off line this week as follows Body Audio http mysite com alerts alert wav Audio Button index 1 type url caption Server Usage http mysite com it info matrix html Button Button index 2 type dial caption...

Страница 74: ...e schedule and alert list reloaded true false Alert has been pushed to the phone Alert has not been pushed to the phone Push it according to the schedule Recipient PushMessage id A numeric value that...

Страница 75: ...ers Schedule PushMessage none Parent element of the Schedule elements begin_date end_date Schedule none The date to start and stop the push formatted as mm dd yyyy For example January 15 2006 is 01 15...

Страница 76: ...istributionLists The following table describes the ManageDistributionLists element and its child elements Element Parent Element Attributes Enumeration Description ManageDistributionLists none none Pa...

Страница 77: ...s the application with the subscribers which you can specify as individual alert recipients and or members of a distribution list Sample XML for Subscribers and its child elements follows Subscribers...

Страница 78: ...sageResponse id 123 200 PushMessageResponse dept The department associated with the device obtained from an LDAP or CSV directory source device_id The MAC address of the device extn The extension asso...

Страница 79: ...and add members to a distribution list send the list to the Application Gateway and then send report status to the application from the Application Gateway You must send a distribution list to the App...

Страница 80: ...er XML DOM object Tell the user what happened response Write b XML DOC posted off b br response write SendDoc XML br response write b Target URL b sURL br response write b XML DOC Received back b br r...

Страница 81: ...ungry Body vbcrlf xmlString xmlString Image http 192 168 1 16 push_image png Image vbcrlf xmlString xmlString Audio http 192 168 1 16 moo wav Audio vbcrlf xmlString xmlString Schedule vbcrlf xmlString...

Страница 82: ...wDoc Xml response write br a href schedule_message asp Send Schedule a body response write br a href push_message asp Send Push a body private function xmlsend url docSubmit Set poster Server CreateOb...

Результаты поиска

Содержание 16-300272

Отзывы:

Похожие инструкции для 16-300272

Бренды по названию

Популярные бренды

Avaya 16-300272, Руководство пользователя

Результаты поиска

Содержание 16-300272

Отзывы:

Похожие инструкции для 16-300272

Бренды по названию

Популярные бренды