OF ANY KIND, EITHER EXPRESS OR IMPLIED. The information and/or products described in this document are subject to change without notice. Nortel, the Nortel logo, the Globemark, SL-1, Meridian 1, and Succession are trademarks of Nortel Networks. All other trademarks are the property of their respective owners.
Related Documentation Introduction to Broadcast Server C H A P T E R Broadcast Server Overview Opening and Using the Broadcast Server Interface Configuring Broadcast Server Application Gateway and Broadcast Server Operation C H A P T E R System Management...
Page 4
The Distribution List Membership Page The Distribution List User Permissions Page Media Management C H A P T E R The Media List Quick FAQ Broadcast Server User Guide User information Password Shared distribution list access General user permissions Alert access...
Page 5
Preparing the Application Gateway and an Application to Use the Push XML API Push XML API Operation Uploading a media file Supported graphic formats Supported audio formats Emergency alerts Normal alerts Background alerts PushMessage Request Broadcast Server User Guide Contents...
Page 6
Contents Push XML Reference Sample ASP Pages Broadcast Server User Guide Recipient Subject, Body, Image, Audio, Button Schedule DistributionList Request Member ServerRegistration Response Subscribers Response PushMessageResponse Response Character Set and Character Entities XML Declaration ManagePushMessage ManageDistributionLists ServerRegistration Subscribers PushMessageResponse distribution_list.asp...
Preface This preface describes who should read the Broadcast Server User Guide, how it is organized, and related documentation. Audience This user guide is intended for administrators who will configure and use the Broadcast Server. Organization This guide is organized as follows:...
Troubleshooting Appendix A Push XML API Related Documentation For deployment and installation information for Broadcast Server, refer to the “Broadcast Server Installation” chapter in the Application Gateway Administration Guide. For upgrade information, refer to the Application Gateway Release Notes. viii...
Chapter 1 Introduction to Broadcast Server With Broadcast Server you can create alerts for display on the screens of your Nortel IP telephones. You direct alerts to distribution lists. The phones to receive alerts might be in reception areas and conference rooms, guest rooms, staff members’...
Broadcast Server Overview Broadcast Server, a server-based application, manages alerts created by Broadcast Server users and sent to subscribers, according to rules and schedules defined by the Broadcast Server administrator and the individual alert creators. Broadcast Server users are individuals with an account on Broadcast Server.
Broadcast Server controls. The Broadcast Server Administrator can create accounts for other users who will compose and send alerts in Broadcast Server. Users log in to the Broadcast Server through Microsoft Internet Explorer from anywhere in the organization or securely over the Internet.
For more information on distribution lists, see Management” on page Alerts An alert is the basic content item in the Broadcast Server and represents the information to be pushed to a phone. Alerts are delivered to the subscriber without requiring the subscriber to request outstanding alerts.
Sending Alerts Creating and sending an alert is easy through the Broadcast Server. You use a Web-based interface to configure the alert, a delivery schedule, and the distribution list(s) to receive the alert. An alert can consist of plain text and/or a graphic, audio, and soft keys.
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 interface contain icons that you can mouse over to view helpful information as well as click to make changes.
Directory Configuration” chapter in the Application Gateway Administration Guide. 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 user privileges are described in...
IP telephones. Users can provide IP phone users access to external services by adding a soft key to a broadcast alert. To enable Broadcast Server users to include a soft key link to an external service in an alert, you must specify the service URL, as described in “External Service Management”...
Sites using a cluster of Application Gateways should configure all Note Application Gateways in the cluster with the same Broadcast Server. The Application Gateway Administration Guide explains the IP phone setup required for Broadcast Server. To enable communication between the...
Page 18
Application Gateway also uses the phone extension to locate the associated department name in the directory. The Application Gateway sends the department information to Broadcast Server where it is used to update the distribution list. Any time that a particular telephone is updated, the Application Gateway collects the updated extension, user name, and department and sends that information to Broadcast Server.
Chapter 3 System Management The System Management page is a single location for defining all 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 Broadcast Server and its supporting software.
Click this button to temporarily disable the Broadcast Server messaging functionality. Only use this feature if you believe that the Broadcast Server is causing a problem on your network or Communication Manager system. Click this button to re-run the Configuration Wizard at any time.
Home page tips Item Description Tip 1 The text to display 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.
Page 22
Chapter 3 System Management Home page tips Broadcast Server User Guide...
Note that these messages are not sent to subscribers or distribution lists – they are reserved for the Broadcast Server system administrator only. When you are logged into the Broadcast Server as the administrator, the system will check the messages list for any critical error messages. Each Broadcast Server page will display a red note indicating if you have critical messages waiting.
Page 24
Chapter 4 System Messages Quick FAQ Broadcast Server User Guide...
Chapter 5 User Management Broadcast Server users are individuals who can log in to Broadcast Server to create and manage content. The administrator’s task is to define users and assign privileges to those individuals. Privileges dictate to which distribution lists a user may send alerts, which portions of an alert that users may modify, and so on.
Then, click the Delete Selected button. Note that Broadcast Server will not allow you to delete the Administrator user. Edit the user record, uncheck the Active checkbox and save your changes.
User information The Active checkbox indicates whether the user record is active in Broadcast Server – that is, whether the user may log in to the system. At minimum, a Broadcast Server user must have a user ID and a name defined.
Broadcast Server to ignore subscriber-specific settings such as Do-Not-Disturb and whether the subscriber wishes to receive priority alerts or not. Most ordinary Broadcast Server users should not have this privilege assigned to them. If checked, allows the user to send alerts to every subscriber in Broadcast Server.
If this option is checked, a user will be able to add subscribers to their 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 them among selected users.
Page 30
Chapter 5 User Management The User Page Broadcast Server User Guide...
Chapter 6 Subscriber Management Subscribers are IP telephones that can receive content posted by Broadcast Server users. A subscriber entry is created when Broadcast Server receives subscriber information from the Application Gateway when an IP telephone comes online. The Subscriber Management List The subscriber management page presents the list of subscriber records that fulfill your current filter criteria.
Chapter 6 Subscriber Management Quick FAQ Broadcast Server will display the name of the user who is currently logged Note into a device. Quick FAQ How do I … Change my filter criteria Delete one or more subscribers See which distribution lists a...
Subscriber information The Active checkbox indicates whether the subscriber record is active in Broadcast Server – that is, whether the subscriber will receive alerts posted by Broadcast Server users. The IP Address field contains the network address for the subscriber (IP telephone).
Emergency alerts are not subject to this setting. If set, prevents alert delivery for the period specified. Emergency alerts are not subject to this setting. If checked, allows Broadcast Server to play an audio alert associated with priority alerts on the device.
The Application Gateway sends the department information to Broadcast Server where it is used to update the distribution list. For information on configuring connections to LDAP and CSV directory sources, refer to the “LDAP/CSV Directory Configuration” chapter in the Application Gateway Administration Guide.
Automatically created distribution lists If you have configured the Application Gateway to obtain department information from a directory source (LDAP or CSV), Broadcast Server will automatically create and update distribution lists based on the department corresponding to each IP telephone extension. Department names longer than 50 characters are truncated.
Sharing distribution lists Sharing distribution lists is a way to standardize on a set of distribution lists across the organization and is easy to do in the Broadcast Server. Only the system administrator can perform this function. Users can share only the lists that are owned by the Administrator user.
Server. A distribution list must be named; comments are optional. Distribution list names can be a maximum of 50 characters. Unless you are creating a new distribution list, Broadcast Server displays a link titled Edit recipients next to the list’s name. Clicking this link will take you to the Distribution List Membership page where you can select the subscribers that are members of the list.
A shared distribution list will also have a link titled Edit user permissions – allowing you to link to the Distribution List User Permissions page where you can select the Broadcast Server users who can send alerts to the distribution list.
US lists. You could do the same for locations in other cites in other countries, or any combination or configuration that suits your needs. Like other screens in Broadcast Server, the records displayed on this page contain icons that show the status of an item.
Distribution Lists page if ownership of the list has been shared, as described in This page contains two columns showing on the left side Broadcast Server users that can send alerts to the list and, on the right, those that cannot.
Page 42
Chapter 7 Distribution List Management The Distribution List User Permissions Page Broadcast Server User Guide...
Chapter 8 Media Management Media in Broadcast Server consists of image and audio files stored on the Broadcast Server. These files are stored in media libraries maintained by the system administrator and/or individual Broadcast Server users. Not all phones support the display of images.
Broadcast Server is installed with some system media items, including an audio clip used for notifying subscribers of priority alerts. You can change the system media items (except the Broadcast Server logo) Note but you cannot delete them, share them, or change their ownership.
The administrator can change ownership of audio items, assigning them to another user, or sharing them among all other Broadcast Server users. Sharing media items is a way to conserve disk space usage on Broadcast Server and to standardize on a set of media across the organization.
All media items must have a name and a short description, as well as a file containing the actual media. If the media item is a graphic, Broadcast Server displays a thumbnail of the original graphic below the current file name.
IP phone screen. Supported audio formats File Type Broadcast Server is capable or converting most wave files into a format Note compatible with IP phones. For best results use a wave file in G.711 or PCM format, 8 KHz sampling rate, with 8 or 16 bits per sample.
Page 48
Chapter 8 Media Management The Media Page Broadcast Server User Guide...
External Service Management External Services are network-based applications that can be launched from IP telephones. Broadcast Server allows users to link their alerts to such services in order to provide content and functionality beyond the scope of the Broadcast Server system. Such applications may include third-party products, solutions from other vendors, or applications developed internally by your IT staff.
The External Service Page The Active checkbox indicates whether the External Service record is active in Broadcast Server – that is, whether the service is available to Broadcast Server users when they create alerts. At minimum, an External Service definition must have a name, description, and URL. You must provide this information before you can save the record.
Page 51
URL will return information that the IP phone can display. Be sure to verify that the URL does display information correctly on the phone. Chapter 9 External Service Management The External Service Page Broadcast Server User Guide...
Page 52
Chapter 9 External Service Management The External Service Page Broadcast Server User Guide...
The alert list page shows the alerts available 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 has been sent to.
Column Descriptions Column Title Main Page Extended Information Recipients Broadcast Server User Guide Description The alert has been disabled and will not be sent to subscribers. The alert’s delivery schedule dictates that the alert should be delivered at the current time.
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 that alert and then move on to the next alert.
Change the delivery schedule for an alert Add or remove buttons on an alert Broadcast Server User Guide Description Click the Add Priority alert button at the top of the list to create an alert. This will open the alert Page.
(from the current time) that an alert should be sent to subscribers). The default is 10 minutes but you can choose a custom delivery schedule by selecting Set a custom delivery schedule. Broadcast Server User Guide Broadcast Alert Management The Alert Page...
Page 58
Extended Alert: Alert graphic Extended Alert: Alert Text Button definitions Broadcast Server User Guide Informs Broadcast Server how it should treat the alert. Emergency alerts take precedence over Normal alerts and are not subject to subscriber settings that would prevent barge-ins.
Page 59
Broadcast Alert Management The Alert Page 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 the Media Library is used for all alert audio notifications.
Page 60
Chapter 10 Broadcast Alert Management The Alert Page Broadcast Server User Guide...
The alert list has numerous options for display including a feature that divides the entire alert list into manageable pages. This setting allows you to indicate to Broadcast Server how many alert records you want displayed on a single page.
Page 62
Chapter 11 My Preferences Setting the maximum list entries to display Broadcast Server User Guide...
Priority alerts typically take about 5 seconds to propagate to phones. This procedure may take longer to a particular phone if Broadcast Server had encountered errors with that phone in the last 2 minutes. Broadcast Server transmits audio in ITU G.711 ULaw format in 30ms frames.
Page 64
Chapter 12 Troubleshooting Common problems Broadcast Server User Guide...
Appendix Push XML API Broadcast Server communicates with the Application Gateway through the Push XML API. You can use that same interface to send alerts from other applications to IP phones. For example, you might wish to send call center statistics, sales updates, or automated IT alerts.
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 >...
Immediately and take control of the audio. Priority = emergency. • When the phone is idle. Priority = normal. • Only to the alert history item in the Voice Office menu. Priority = • background. Appendix A Push XML API Push XML API Operation Broadcast Server User Guide...
URL to display. (OK and Exit soft keys are automatically added to an alert. OK returns to the alert list; Exit returns to the Voice Office menu.) Broadcast Server User Guide for a detailed explanation of the...
(if applicable) and also to the phones. To change the Application Gateway time zone, go to the Administration > Date page of the Application Gateway Administration Tool. Appendix A Push XML API Push XML API Operation Broadcast Server User Guide...
One or more Member elements can be included in a DistributionListRequest element. The Member element has one attribute that specifies the device ID (that is, the MAC address of the phone). Broadcast Server User Guide 63. You can then use your application to for a detailed explanation of the...
(indicating an error condition). “PushMessageResponse,” page 70 Note XML. Appendix A Push XML API Operation for a detailed explanation of the XML. for a detailed explanation of the XML. for a detailed explanation of the Broadcast Server User Guide Push XML API...
XML reference documentation. XML Declaration The Push XML string should begin with the following XML declaration: <?xml version="1.0" encoding="utf-8"?> The XML declaration must not be preceded by comments, whitespace, or processing instructions. Broadcast Server User Guide Character Entity & ' > <...
The following table describes the ManagePushMessage element and its child elements. Element Parent Element ManagePushMessage none Appendix A Attributes Enumeration Description none Parent element of one or more PushMessage elements. Broadcast Server User Guide Push XML API Push XML Reference...
Page 74
Subject PushMessage Body PushMessage Image PushMessage Audio PushMessage Broadcast Server User Guide Attributes Enumeration Description Parent of the elements that define the content, recipient, and schedule of an alert. Multiple PushMessage elements can be sent in the same HTML string.
Page 75
The time to start and stop the push, formatted as hh:mm:ss AM | PM. For example, noon is 12:00:00 PM. The time is based on the Application Gateway time. Broadcast Server User Guide Push XML API Push XML Reference...
Element Parent Element ManageDistributionLists none DistributionList ManageDistributionLists Member DistributionList Broadcast Server User Guide Attributes Enumeration Description none Parent element of one or more DistributionList elements. Parent element of zero or more Member elements. A numeric value that uniquely identifies the distribution list.
Application Gateway and can be named as alert recipients or distribution list members. name Either the user name associated (in an LDAP directory) with the device or the phone model. Broadcast Server User Guide Push XML API Push XML Reference...
PushMessageResponse, sent from the Application Gateway to your application, provides the application with error response codes which describe the status of the response and can assist in troubleshooting. The XML for PushMessageResponse follows: <PushMessageResponse id="123">-200</PushMessageResponse> Broadcast Server User Guide Attributes Enumeration Description dept The department associated...
Sample ASP Pages You can use the script language of your choice to generate XML code. We have provided sample Microsoft Active Server Pages (ASP) scripts to help you get started. Your application will need to generate two ASP files: One file to create a distribution list and one file to create an alert.
Page 80
(NewDoc.Xml) private function xmlsend(url, docSubmit) Set poster = Server.CreateObject("MSXML2.ServerXMLHTTP") poster.open "POST", url, false poster.setRequestHeader "CONTENT_TYPE", "text/xml" poster.send docSubmit Set NewDoc = server.createobject("Microsoft.XMLDOM") newDoc.ValidateOnParse= True newDoc.LoadXML(poster.responseTEXT) Set XMLSend = NewDoc Set poster = Nothing end function %> Broadcast Server User Guide...
Page 81
NewDoc = xmlSend (sURL, SendDoc)'xmlString) 'We receive back another XML DOM object! <BeginDate>09/2/2005</BeginDate>" & vbcrlf <EndDate>10/25/2005</EndDate>" & vbcrlf <Days sunday='1' monday='1' tuesday='1' wednesday='1' <BeginTime>10:00:00 AM</BeginTime>" & vbcrlf <EndTime>11:59:50 PM</EndTime>" & vbcrlf Appendix A Push XML API Sample ASP Pages Broadcast Server User Guide...
Page 82
"<br><a href='push_message.asp'>Send Push </a></body>" private function xmlsend(url, docSubmit) Set poster = Server.CreateObject("MSXML2.ServerXMLHTTP") poster.open "POST", url, false poster.setRequestHeader "CONTENT_TYPE", "text/xml" poster.send docSubmit Set NewDoc = server.createobject("Microsoft.XMLDOM") newDoc.ValidateOnParse= True newDoc.LoadXML(poster.responseTEXT) Set XMLSend = NewDoc Set poster = Nothing end function %> Broadcast Server User Guide...