Televantage 6.0 Upgrade Manual

Transcription

Televantage 6.0 Upgrade Manual
TeleVantage 6.0 Upgrade Manual
Copyright 2004 by Artisoft, Inc.
Disclaimer:
This document is provided for your information only. This manual and the information contained
herein does not in any way constitute a promise by Artisoft that the TeleVantage 6.0 software will
perform as described in this manual. This manual and its contents are provided as-is, without
any implied or express warranties or guarantees of suitability. The content of the course material
is subject to change without notice. Artisoft, Inc. is not liable for any damages resulting from any
defect in this manual or its contents. The user assumes all risks as to the suitability and quality of
this manual and use of its content.
This manual is a product of the Artisoft Training Department. Please report any and all problems
and corrections to the Training Department at [email protected].
-2-
Table of Contents
Table of Contents ............................................................................................................................ 3
Introduction ...................................................................................................................................... 7
Scope ........................................................................................................................................... 7
Audience ...................................................................................................................................... 7
Organization................................................................................................................................. 7
Windows Desktop Client.................................................................................................................. 8
Client renamed to “ViewPoint” ..................................................................................................... 8
Call Monitor Tab Sort Order and Visibility.................................................................................... 8
MDAC 2.7 SP1A Installed............................................................................................................ 9
Mute/Un-mute All Conference Parties in Call Monitor ................................................................. 9
“Access Tools Menu in ViewPoint” Permission ......................................................................... 10
ViewPoint Client Add-ins............................................................................................................ 10
Busy Station Routing List Final Action....................................................................................... 12
Calling As Identity Control in ViewPoint..................................................................................... 14
Camp-on .................................................................................................................................... 15
3rd-party Control Update............................................................................................................. 16
Drag & Drop External Address into Call Monitor ....................................................................... 16
Navigator Bar for ViewPoint....................................................................................................... 17
Play Audio into a Call................................................................................................................. 20
User and Contact Enhancements .............................................................................................. 22
French Localized Client ............................................................................................................. 24
Web Services................................................................................................................................. 25
French Localization.................................................................................................................... 25
External Station Support ............................................................................................................ 26
Navigation Pane......................................................................................................................... 26
Play Audio Into a Call................................................................................................................. 26
Contact and User Enhancements .............................................................................................. 27
Camp on Busy............................................................................................................................ 27
Telephone User Interface .............................................................................................................. 29
Record Call Feature Code ......................................................................................................... 29
Transfer to External Number via Telephone.............................................................................. 29
*91 and *99 Support for Extensions Routed to Trunks .............................................................. 30
Assign Stations to Existing Extensions via *0............................................................................ 31
Permissions Restricting Access to TUI Features....................................................................... 31
Contact Manager Support ............................................................................................................. 32
ACT! Version 6.0 for Windows 2004 Support ............................................................................ 32
Platform Requirements.................................................................................................................. 33
Windows 2000 Service Pack 4 Support..................................................................................... 33
Windows 2003 Server for TeleVantage Workstation Applications and TeleVantage Server .... 33
Windows XP for TeleVantage Server ........................................................................................ 33
Microsoft Data Engine 2000....................................................................................................... 33
MSDE 2000 for MSDE 7.0 upgrades ......................................................................................... 33
Windows NT Server and Workstation No Longer Supported .................................................... 34
Telephony Hardware & Drivers ..................................................................................................... 35
Updated Dialogic DMU Utility..................................................................................................... 35
Dialogic System Release 5.1.1 Feature Pack 1 ........................................................................ 35
Dialogic Driver Updates ............................................................................................................. 35
Dialogic GlobalCall 4.0 Protocol support ................................................................................... 35
DI/0408LSA Revision 2 Integrated Trunk & Station Board........................................................ 36
General Description................................................................................................................ 36
Electrical and Mechanical Characteristics.............................................................................. 37
Automatic failover................................................................................................................... 38
Voice Resources .................................................................................................................... 38
-3-
Support for Revision 2 of DI/SI16, DI/SI24, and DI/SI32 Station Boards .................................. 39
Support for DM/IP0821A-T1 and DM/IP0821A-E1-120............................................................. 39
DMV160LP Analog Trunk Board Support.................................................................................. 40
Toshiba Digital Telephone Support and New Features................................................................. 41
Introduction ................................................................................................................................ 41
Supported Toshiba Hardware .................................................................................................... 41
Installation .................................................................................................................................. 43
Configuration.............................................................................................................................. 44
Toshiba Boards ...................................................................................................................... 44
Toshiba Stations..................................................................................................................... 44
Telephone Features................................................................................................................... 45
Hot Keypad............................................................................................................................. 45
Ring Controls.......................................................................................................................... 45
Pickup Behavior ..................................................................................................................... 46
Voice-first Answering.............................................................................................................. 47
Hands-free Answering............................................................................................................ 47
Background Ring for Call Waiting .......................................................................................... 47
LCD Display & Controls.......................................................................................................... 48
Feature Buttons...................................................................................................................... 50
New Features for Toshiba Stations ........................................................................................... 60
Personal Status Strata Buttons .............................................................................................. 60
Custom Speed Dials............................................................................................................... 61
Ringing Line Preference for Toshiba phones......................................................................... 61
Server Functions............................................................................................................................ 62
Business Hours Enhancements................................................................................................. 62
Hold Audio Input Support........................................................................................................... 63
Call Recording Reminder Beeps................................................................................................ 66
Dialogic Firmware Dump Automation ........................................................................................ 67
Toshiba Station Board Timeslot Allocation ................................................................................ 69
Drop Loop Current on Idle Station ............................................................................................. 69
Monitor, Coach, and Join Non-queue Calls ............................................................................... 71
Null Stations ............................................................................................................................... 74
External Stations ........................................................................................................................ 75
Statically-assigned External Stations ..................................................................................... 76
Automatic update of External Station Address for an IP Telephone...................................... 79
Null Stations ........................................................................................................................... 80
Dynamically-created External Stations .................................................................................. 80
Delayed Connection ............................................................................................................... 80
Associating a Call with an External Station............................................................................ 81
Call Log Entries ...................................................................................................................... 82
Ring Cadences....................................................................................................................... 82
Call Waiting on External Stations ........................................................................................... 82
Upgrading Existing IP Telephone Users to External Stations................................................ 82
Reserve Station Licenses for IVR Plug-ins................................................................................ 84
Customizable Locations for Database Files .............................................................................. 85
Voice Message Archiving........................................................................................................... 85
Automatic Archiving................................................................................................................ 85
Manual Archiving.................................................................................................................... 87
TeleVantage Recording Browser ........................................................................................... 88
Dial a Voice Mailbox Directly ..................................................................................................... 90
Default Flash Behavior............................................................................................................... 91
Park/Hold Ring Back Behavior................................................................................................... 92
MSDE SA Password .................................................................................................................. 92
SMTP Support for Email Notifications ....................................................................................... 93
Trunk Configuration ....................................................................................................................... 94
Delayed Answer......................................................................................................................... 94
-4-
ISDN Setting Changes............................................................................................................... 96
Called Party Number Default Plan ......................................................................................... 97
Called Party Number Default Type ........................................................................................ 97
DNIS wait time........................................................................................................................ 97
Dump call info......................................................................................................................... 97
Facility feature or service ....................................................................................................... 97
Facility feature type ................................................................................................................ 97
Handle disconnect with audio................................................................................................. 98
Minimum length of DNIS ........................................................................................................ 98
Overlapped DNIS ................................................................................................................... 98
Send call proceeding.............................................................................................................. 98
Two B channel transfer supported ......................................................................................... 98
Device Monitor and Trunks View Enhancements ...................................................................... 98
Conferencing using Selected IP Trunk Boards and a Host-based Stack ................................ 100
Dialogic GlobalCall IP With Split Call Control Support ............................................................ 100
Embedded and Host-based H.323 Stacks ........................................................................... 100
Configuring IP Boards for Host-based Stack ....................................................................... 101
Configuring Boards for Embedded Stack............................................................................. 104
Codec Assignments ............................................................................................................. 104
Two B-channel Transfer for NI2............................................................................................... 105
Dialing and Routing Services ...................................................................................................... 106
Paging Ports............................................................................................................................. 106
User Configuration....................................................................................................................... 107
Permissions Restricting Access to TUI Features..................................................................... 107
User Permissions ..................................................................................................................... 107
User Number Enhancements................................................................................................... 110
Hold Music Controls................................................................................................................. 111
Drop Loop Current When Idle .................................................................................................. 111
Enable Multiple Line Appearances .......................................................................................... 111
Flash Behavior ......................................................................................................................... 112
Imitate a Station Control .......................................................................................................... 112
Coach, Monitor, and Join Personal Calls................................................................................. 114
Use Navigation Pane ............................................................................................................... 115
Workgroups ................................................................................................................................. 116
Transfer to Workgroup Action in Auto Attendants ................................................................... 116
Simultaneous Ring for External Stations ................................................................................. 116
*91 and *99 Support for Extensions Routed to Trunks ............................................................ 117
Auto Attendants ........................................................................................................................... 118
Modify Default Auto Attendant Extension ................................................................................ 118
User login transfers to an extension ........................................................................................ 118
Hold Music Controls................................................................................................................. 120
Transfer to a Workgroup Menu Action..................................................................................... 121
Voice-over-IP and IP Gateways .................................................................................................. 122
Uniden UIP300 Phone Support................................................................................................ 122
Relay PSTN Caller ID Information from H.323 Gateways ....................................................... 124
Call Center................................................................................................................................... 125
Call Center Queue Wait time announcements in seconds ...................................................... 125
Agent Status Enhancements ................................................................................................... 125
Mail Usage Column in Queues View ....................................................................................... 126
Overflow Call Routing Enhancements ..................................................................................... 127
Hold Music Source Selection ................................................................................................... 129
Call Center Reporter.................................................................................................................... 130
Call Center Reporter Options................................................................................................... 130
Toll free Options ................................................................................................................... 130
In-state Options .................................................................................................................... 130
Criteria for counting calls...................................................................................................... 131
-5-
Grouped Service Level Report................................................................................................. 132
Unanswered Calls During Business Hours.............................................................................. 134
Call Summary Report............................................................................................................... 136
Outbound Call Comparison Report.......................................................................................... 138
Trunk Usage Report................................................................................................................. 139
Outbound Long Distance Summary......................................................................................... 141
Outbound Calls by Phone Number .......................................................................................... 142
Call Transfer Report................................................................................................................. 143
User Call Trends Report .......................................................................................................... 145
Agent Call Trends Report ........................................................................................................ 146
Maintenance and Administration ................................................................................................. 147
System Shutdown Enhancements........................................................................................... 147
Delayed shutdown................................................................................................................ 148
Prevent new calls ................................................................................................................. 148
Terminate existing calls........................................................................................................ 148
Service shutdown options .................................................................................................... 148
Capture Dialogic firmware dump .......................................................................................... 149
Restart TeleVantage server after shutdown......................................................................... 149
Shutdown Reason ................................................................................................................ 149
Device Types and Names in the Device Monitor..................................................................... 149
ISDN Red Alarm Notification via NT Events ............................................................................ 151
Maintenance Log Enhancements ............................................................................................ 152
TeleVantage Server Process Dumps ...................................................................................... 153
Problem Report Wizard Enhancements .................................................................................. 154
Include a Database Backup ................................................................................................. 154
Command Line Interface ...................................................................................................... 155
Include Dialogic Firmware Dumps ....................................................................................... 157
Default Contact Information and Email Options ................................................................... 157
Automated Collection of Server Information ........................................................................ 157
Server Log Improvements........................................................................................................ 158
TeleVantage Event Log ........................................................................................................... 159
Trunk Log ................................................................................................................................. 159
Identify Active Party on a Device ............................................................................................. 164
Dial Plan View .......................................................................................................................... 165
TeleVantage 6.0 Upgrade Procedure.......................................................................................... 167
Installation CDs ........................................................................................................................ 167
Shut Down and Back Up TeleVantage 5.0 Server................................................................... 167
Shutdown the Dialogic SR 5.1.1 SP1 Drivers......................................................................... 170
Upgrade Intel Dialogic SR 5.1.1 Drivers .................................................................................. 171
Install Intel Dialogic Driver Updates ......................................................................................... 175
Upgrade MSDE (Optional) ....................................................................................................... 178
Upgrade TeleVantage Server .................................................................................................. 182
Upgrade Workstation Applications........................................................................................... 191
Upgrade TeleVantage Web Services ...................................................................................... 198
Enter and Activate Licenses .................................................................................................... 204
-6-
Introduction
Scope
This document describes the new features in TeleVantage Version 6.0. It also describes the
changes made to existing features for Version 6.0 relative to TeleVantage Version 5.0. The final
section of this manual provides instructions on how to upgrade from TeleVantage Version 5.0 to
TeleVantage 6.0.
Although an attempt is made to document all the changes and additions from Version 5.0 to
Version 6.0, some information may be omitted, as this manual was originally published some
time before the release of the TeleVantage 6.0 product. Refer to the documentation included with
your TeleVantage 6.0 software for a complete description of the product.
Audience
This manual is intended for use primarily by those existing TeleVantage value-added resellers
that are currently authorized to sell, install, and maintain TeleVantage Version 5.0. The
information in this document may also be of interest to TeleVantage distributors, and to any
technical personnel responsible for installing, configuring, or maintaining TeleVantage 6.0. The
reader is assumed to be familiar with the features and operation of TeleVantage 5.0, the various
Windows operating systems, Intel’s Dialogic telephony hardware and software, and the public
telephone network.
New value-added resellers are required to attend the TeleVantage 6.0 Essentials Training course.
Refer to the Training page on the Artisoft website for more information.
Organization
The content is divided by application. The new features of the Viewpoint Client, Web Client,
Telephone User Interface (TUI), Administrator and server are each listed separately. Where
controls for a new feature appear in more than one application program, there is a section
describing that feature for each application program.
-7-
Windows Desktop Client
Client renamed to “ViewPoint”
The client application for TeleVantage 6.0 is called “ViewPoint”. The web-based version of the
client is called “ViewPoint Web Access” .
Call Monitor Tab Sort Order and Visibility
Figure 1. Show Tabs Dialog in Call Monitor
The user can now specify which Call Monitor tabs appear in the Call Monitor view and call pane
of the ViewPoint client. The order in which these tabs appear can also be specified.
To change the visibility or display order of the Call Monitor tabs, right-click on one of the tabs in
Call Monitor and choose “Show Tabs…”. (See Figure 1) The Show Tabs dialog box appears.
To make a tab visible, select the tab’s name in the “Available tabs:“ column and choose “Add >”. To hide a currently shown tab, select the tab’s name in the “Show these tabs in this order”
column and choose “<- Remove”.
The tabs are displayed in the Call Monitor, from left to right, in the order they appear in the “Show
these tabs in this order” column. To change the order the tabs are displayed, select a tab’s
name in this column and then use the up or down arrow to modify its position in the list.
-8-
Figure 2. Parked Tab in Call Monitor
In addition, a new Call Monitor tab, the Parked tab (Figure 2), displaying the parked calls on the
system, can be made visible. (This is the same information shown in the Tools>Unpark dialog.)
To display this tab, check the “Show all parked calls” checkbox. The Parked tab appears in
the ”Available tabs” field. Highlight Parked with the mouse and hit the “Add ->“ button.
MDAC 2.7 SP1A Installed
The TeleVantage server, workstation application, and web services installers install Microsoft
Data Access Version 2.7 Service Pack 1 Refresh ( also known as Service Pack 1a) if MDAC
Version 2.7 or higher is not already installed on the target machine.
Mute/Un-mute All Conference Parties in Call Monitor
The ViewPoint program now allows a user to mute or un-mute individual parties in a conference.
By selecting more than one party (using the Shift key or Ctrl key), multiple parties in the
conference can be muted or un-muted simultaneously. (See Figure 3.)
-9-
Figure 3. Mute for Multiple Parties to a Conference
To mute one or more parties, highlight those parties in the Call Monitor, then right-click and select
Mute. The same procedure is used to un-mute one or more parties that have been muted.
When a party to a conference has been muted, that person’s audio is no longer mixed with that of
the conference. That person hears the remaining un-muted parties in the conference, as do all
conference participants. (Muted parties do NOT hear hold music.)
“Access Tools Menu in ViewPoint” Permission
The new user permission “Access Tools Menu in ViewPoint” has been added to the properties
of users and roles. When a user has this permission set to a value of “Disallow”, the Tools menu
no longer appears in ViewPoint, preventing the user from accessing these menu choices. Note
that many of the functions on this menu can be accessed through other controls in the ViewPoint
client, for example, audio output can be switched between the telephone and speakers using the
controls in the status bar, even though the Audio Output menu is not accessible from the Tools
menu. Also, this permission does not limit access to the Options dialog in ViewPoint Web
Services.
ViewPoint Client Add-ins
Add-Ins are software components you can develop that communicate with the executable for the
TeleVantage ViewPoint application. An add-in application is loaded when ViewPoint is loaded
and is notified of changes in the ViewPoint session, such as when folders are changed and when
menu items are selected. Add-Ins can add custom menus and toolbar buttons to the ViewPoint
client, display messages on the ViewPoint status bar, and more. Most importantly, an add-in has
access to ViewPoint’s Client API session object, so it can receive the same events that ViewPoint
receives and has access to the same data on the user’s calls and the status of the server. An
add-in can do anything a Client API application can do, without the need to log in or consume
additional memory, since it shares ViewPoint’s Session object. Unlike regular Client API
applications, add-Ins have the advantage of knowing exactly what the user is doing in ViewPoint.
- 10 -
A sample add-in application, Reverse Phone Number Lookup, is supplied with TeleVantage 6.0.
This sample application adds the Reverse Phone Number Lookup menu item (Figure 4) to the
shortcut menus for call log entries, voice mail message, and other items in ViewPoint that have
telephone numbers associated with them. When this menu choice is selected, the add-in opens
a web browser and passes the telephone number to a web-based search engine.
Figure 4. Reverse Phone Number Lookup Add-in Menu Item
Add-ins are installed and managed using Add-ins Manager (Figure 5), found in ViewPoint under
the Tools menu. The name, creator, and version number of all the add-ins installed on the
workstation are displayed.
- 11 -
Figure 5. Add-in Manager Dialog
To install an add-in from the Add-ins Manager, choose “Add…”and navigate to the location of the
add-in executable to be installed. (TVReversePhoneLookup.dll, the executable for the sample
application, is found in the \Netsetup folder.)
The “Options…” button allows the user to configure a selected add-in, if the add-in has any usersettable parameters. (See Figure 6.)
Figure 6. Add-in Manager's Options Dialog
Busy Station Routing List Final Action
The busy station final action in a routing list allows a user to have an call that comes to his
extension when his station is busy handled differently from when his station is idle. By checking
the “Handle busy calls differently from calls not answered” checkbox (Figure 7) in a routing
list, he can specify a routing list final action for calls that attempt to ring his station when the
station is off-hook.
- 12 -
Figure 7. Busy Station Final Action in a Routing List
With this control checked, a list box appears that allow the user to specify one of two final actions:
•
•
Final action if the call is not answered (ring no-answer final action)
Final action if the station is busy (busy station final action)
Both final actions allow the user to specify if a greeting is played to the caller, and if so, select a
greeting to be played. The user can select an action that determines how the call is treated in
each situation (busy or ring no-answer).
The options for the greeting and actions settings in the ring no-answer case are the same as
those found in TeleVantage 5.0 routing list final actions. See Using routing lists on Page 15-7 of
Using TeleVantage.
For the busy station case, the Play greeting control’s list box includes one additional greeting:
“System camp on greeting”.
The Action field of the busy station final action has the following available values:
•
•
•
•
•
•
•
Take Message
Hang up
Prompt to hang up
Transfer to an extension
Transfer to other voicemail
Pause and repeat
Camp on station
- 13 -
All of these actions, with the exception of “Camp on station”, are found in the ring no-answer
final action, and in TeleVantage 5.0 routing list final actions, and operate in the same manner as
they did in TeleVantage 5.0.
The “Camp on Station” final action allows the user to “queue” a call to his extension while his
station is busy. The system places the incoming call on hold. The caller hears either the system
camp on greeting or a similar greeting that the user records: “The person you have attempted to
reach is on the phone. To hold for your party, remain on the line. Otherwise, to leave a message,
press 1. To end this call, press 2.” The greeting repeats every 60 seconds. the caller can press
“1” to go to your voice mail or “2” to disconnect the call. In between greetings, the caller hears
hold music, if configured.
The busy station final action is performed whenever the server attempts to route an incoming call
to an internal or external station and that station device is busy. A single-line station is busy if it is
off-hook. A station device with multiple line appearances, such as a Toshiba phone, is
considered busy if one line appearance is in use. (The call rings an available line appearance,
and if it is not answered, the busy station final action is performed.)
The Standard routing list behavior is to camp-on the station if the extension is busy. This default
setting, like all settings in the Standard routing list, cannot be changed. However, the Standard
routing list does allow the user to uncheck “Handle busy calls differently from calls not
answered”, thereby disabling the camp-on feature.
Calling As Identity Control in ViewPoint
A user can now change his “calling-as” identity from the status bar in ViewPoint. For a user who
is an agent in a Call Center queue, the name and extension field in the right-hand side of the
ViewPoint Status bar is a drop-down list box (Figure 8). By clicking on this control and selecting
the desired name and extension, the user can change his calling-as identity to that of any Call
Center queue he is an agent in. He can change his calling-as identity back to his own extension
by choosing his name in the drop-down list. The *14 quick command can still be used to change
a user’s calling-as identity via the telephone keypad. Changes to the calling-as identity made
from the handset are reflected in the status bar.
- 14 -
Figure 8. Calling As Identity Controls in ViewPoint
ACD Workgroup queues do not appear in the drop-down list, so this control cannot be used to
change the user’s calling-as identity to that of an ACD Workgroup queue. This must be done
using the *14 quick command.
Camp-on
If a user wishes to speak to another user whose station is busy, he can camp-on that person’s
extension using the ViewPoint client. The system waits until both user’s stations are idle and
then automatically places the call. The initiating user’s station is alerted first. When the initiating
user picks up, the camped-on user’s phone is then rung. The system waits a maximum of 30
minutes for the two stations to go idle. If, in that time, both stations were never simultaneously
idle, the camp-on call is cancelled.
To start a camp-on call, select a busy user to call in the Extensions view (Figure 9) or In the
Phonebook pane of another view. Right-click on the busy user and select “Camp on busy”. The
camped-on user is displayed in bold type, indicating that a camp-on call is pending to that user.
To cancel a camp-on call, select a camped-on user, right-click and choose “Cancel Camp-on”.
The “Camp on busy” and “Cancel Camp-on” menu items also appear in the Actions menu of
the Extensions view.
- 15 -
Figure 9. Camp On Busy Menu Item in the Extensions View
This feature is implemented in the ViewPoint client (not the TeleVantage server), so the client
program must be running - the operation will be terminated if the client is closed.
For users with multi-line stations, such as the Toshiba telephones, the server waits for phone to
go completely idle to start the camped-on call. (It does not use an idle line appearance.)
3rd-party Control Update
ViewPoint for TeleVantage 6.0 uses a newer version of actbar2.ocx than used in TeleVantage 5.0.
Drag & Drop External Address into Call Monitor
ViewPoint allows the user to call a telephone number by dragging and dropping selected text onto
the Call Monitor window. The call is placed over the default IP or phone number dialing service.
If the telephone number is less than seven digits, the Place Call dialog is displayed. If the text
contains any non-numeric characters (except comma “,”) either the special characters are
removed from the string before dialing or the drag and drop operation is ignored. If a “+”
precedes the number then it is interpreted as a globally-scoped number, “+ (country code)
(national number)”. Some examples are shown in Table 1 .
- 16 -
Table 1. Examples of Drag-and-dropping a Telephone Number into Call Monitor
String
617333$%3456
ABC-AUTO
61733334#5
192.168.0.8
(617) 333-3456
411
011-2-80-727-9595
+27759495
Action
Dialed
Ignored
Ignored
Dialed
Dialed
Place Call dialog
Dialed
Dialed
Dialed Number
6173333456
192.168.0.8
16173333456
0112807279595
01127759495
Navigator Bar for ViewPoint
By default, what was the View bar in the previous versions of TeleVantage client is replaced by
Navigation Pane in ViewPoint. The Navigation Pane allows the user to group folders (views) into
categories and quickly maneuver from one related group of folders to another. The default
arrangement of the Navigation Pane is shown in Figure 10.
As shown, the Navigation Pane includes a Favorites Folder pane and a Navigation Bar – a set of
buttons at the bottom of the pane that allows the user to display a particular ViewPoint view and
set of Favorite Folders. The buttons that appear on the Navigation Bar are listed in Table 2 .
Figure 10. ViewPoint with Navigation Bar
- 17 -
Table 2. Navigation Buttons
Button
Call Monitor
Default View
Call Monitor
Voice Mail
Inbox
Contacts
Contacts
Call Log
Call Log
Configuration
Greetings
All Folders
Folder List
More Buttons
(Current View)
(Current View)
(Current View)
Favorite Folders (Defaults)
Call Monitor
Extensions
Queue Monitor
Deleted
Inbox
Shared
(Other message folders)
Public\Contacts
Contacts
(Other contact folders)
Call Log
(Other call log folders)
Call Rules
Greetings
Personal Statuses
Public\Workgroups
Workgroups
(All folders accessible to user)
(Current Favorite Folders)
(Current Favorite Folders)
Notes
Displays the Folder List
Displays the Navigation Bar
menu
Buy choosing a Navigation Bar button, the user can display a set of related folders in the Favorite
Folders list, and the default view in the main pane of the ViewPoint application. By clicking on a
folder in the Favorite Folders list, the user can display the view for any folder in that list. This
operation is similar to that seen in the Folder List in the previous versions of TeleVantage Client.
The Favorite Folders list for each of the Navigation Bar buttons (except the All Folders button) is
customizable. The user can add or remove folders from the list. To remove a folder, right-click
on the folder and choose “Remove from Favorite Folders”. To add a folder to Favorite Folders,
navigate to the Folder List by clicking on the All Folders button, then right-click on the folder and
select “Add to Favorite Folders”.
Clicking the “More Buttons” button displays a menu (Figure 11) that allow the user to configure
the navigation pane. The “More Buttons” menu includes the following menu items:
•
•
•
•
Show More Buttons
Show Fewer Buttons
Navigation Pane Options (disabled)
Add or Remove Buttons
- 18 -
Figure 11. More Buttons Menu
The folder group buttons can be made large (added to the “button list”) by selecting “Show More
Buttons”. The left-most button on the button bar disappears and that button appears in the button
list. The “Show Fewer Buttons” menu item moves the bottom-most button in the button list back
to the Navigation Bar.
If the Navigation Pane is not wide enough to display all the buttons configured to appear on the
button bar, the right-most, hidden-buttons appear on the bottom of the More Buttons menu
instead. For example, the Folder List and All Folder buttons may be configured to appear in the
button bar, but, if the Navigation Pane is too narrow to display them, they appear in the More
Button menu. If the user was to drag the right edge of the Navigation Pane over to make it wider,
the buttons would disappear from the More Buttons menus and reappear on the Navigation Bar.
The “All Folders” button displays the Folder List instead of the
Favorite Folders pane. The “Folder List” button adds a separate
Folder List pane to the Navigation Pane, just under the Favorite
Folders Pane. (See Figure 12.)
Figure 12. Navigation
Pane with Folder List
- 19 -
Play Audio into a Call
Using TeleVantage 6.0’s ViewPoint program, a user can play a audio recording into a call. All
parties in the call hear the audio. The audio content can be a voicemail message, a call
recording, or a pre-recorded greeting that appears in a voice message folder the user has
access to. To play an audio message into a call, right-click on the call in the Call Monitor and
select “Insert Audio” from the shortcut menu (Figure 13).
Figure 13. Insert Audio Menu Item in Call Monitor
Then choose “Play audio into call …” to display the “Play Audio Into Call” dialog box (Figure
14). In this dialog, navigate to the folder containing the message to be played, and select OK.
Figure 14. Play Audio Into Call – Select Message Dialog
- 20 -
The audio is then heard by all parties in the call. To stop playback of the audio before the end of
the recording is reached, choose the “Stop Audio” menu item under “Insert Audio”.
Alternatively, this function can be initiated from the voice message folder in which the recording to
be played resides. Select the desired recording, right-click and choose “Play into call” (Figure
15). A fly-out menu with two choices appears: “Current Call” and “Other Call …”. If “Current
Call” is selected, the recording is immediately played into the currently active call.
Figure 15. Play into Call Menu Item in a Message View
If “Other Call …” is selected, the “Play audio into call” dialog box in Figure 16 appears. Select
the call into which the audio should be played and choose OK.
Figure 16. Play Audio Into Call - Select Call Dialog
- 21 -
You cannot play audio into a call in the following states:
•
•
•
•
•
•
Ringing
Listening to a greeting in a routing list or to a voice menu generated by the system
Recording voice mail
Queued in a ACD/WG queue
Monitored or coached by a supervisor, including both personal and Call Center queue
calls.
Owned by another user or queue
Essentially, the call must be either active or on hold before recorded audio can be played into the
call.
User and Contact Enhancements
In ViewPoint, the user now has access to his personal telephone numbers through the
Personal>My Numbers page of the Tool>Options dialog. In addition to the “Home”, “Home 2”
and “Mobile” numbers found in previous versions of TeleVantage, the user can now record two
different email addresses (Email and Email 2) and an instant messaging (IM) address (IM
address). (See Figure 17.)
Figure 17. E-mail and IM Address Fields
The e-mail and IM address information is not currently used in TeleVantage, but it is accessible to
3rd-party applications through the Client API.
To enter an e-mail address or IM address, select the desired field and choose Edit. A dialog box
similar to that shown in Figure 18 appears. Enter the address in the provided text box.
- 22 -
(ViewPoint and TeleVantage server does no check the format of this information in any way, at
present.)
Figure 18. E-mail Address Dialog Box
The E-mail, E-mail2, and IM address properties have also been added to contacts.
Any of the addresses in My Numbers can be made public by checking the “Public” checkbox in
the appropriate edit dialog. A public number can be:
•
Viewed by other TeleVantage users, in the Extension or Phonebook panes of the
ViewPoint program. (See Figure 19.) Another user can then start a call to that public
number by selecting the owner’s name in one of these views, opening the shortcut menu,
and selecting the number from a list.
•
Used by TeleVantage server to match incoming calls to a user account. An inbound call
arriving with a Caller ID or ANI number matching the user’s public address is identified as
coming from that user. The user’s name appears on calls in Call Monitor, and the server
treats the calls as from that user when applying call rules to the call.
Figure 19. Pubic Numbers in the Speed Dial Menu
- 23 -
French Localized Client
Figure 20. Canadian French Localized ViewPoint
The ViewPoint client for TeleVantage 6.0 included localizations for Canadian French and Parisian
French (Figure 20). The localizations are installed on the workstation by default. To change
languages, open the “Regional Options” applet in Windows Control Panel, and change the “Your
Locale” setting to French locale.
- 24 -
Web Services
TeleVantage 6.0 ViewPoint Web Services incorporates many of the same improvements found in
the ViewPoint Windows client.
Figure 21. ViewPoint Web Services Logon Dialog
French Localization
Two French localizations, Parisian and Canadian, have be added. As in previous versions of the
product, the user can select the language the web client is displayed in at logon. (See Figure 21.)
- 25 -
External Station Support
The ViewPoint Web Client Logon dialog has been modified added options to log on using an
external station.
If the user is assigned to a statically-assigned external station, then he can enter his external
station ID in the Station field of the web client. This allows him to perform call control operations
on calls routed to the external station. By entering an external telephone number or IP address
in the “Remote number” field, the user can dynamically create an external station and achieve the
same results.
Also, the “Imitate a station when routing incoming calls to external numbers” control can be
found in the Options dialog of the web client. When this control is checked, the server
associates a dynamically-created external station with the user’s incoming call, allowing the user
to perform call control operations on the call through the web client interface. See External
Stations on Page 75 for more information on external stations.
A user who does not intend to route calls or perform audio operations can log on to the web client
using the None option on the Logon page, as in the Windows client. The “None” option
eliminates the need to enter a station number of “0”, as was the practice in earlier versions of
TeleVantage
Navigation Pane
Figure 22. ViewPoint Web Services Page with the Navigation Pane
As in the Windows client, the Navigation Pane (Figure 22) replaces the View Bar in ViewPoint
Web Services. The function of the controls on the web client Navigation Pane. The “More
Buttons” button and its associated menus are not implemented in the web client. The Navigation
Bar wraps to multiple lines if resized smaller than default size. See Navigator Bar for ViewPoint
on Page 17.
Play Audio Into a Call
TeleVantage 6.0’s web client include support for playing a voice message, call recording, or
greeting into a call. The function of this control (Figure 23) is similar to those of the Windows
ViewPoint client, as described in Play Audio into a Call on Page 20.
- 26 -
Figure 23. Insert Audio Control in Web Client
Contact and User Enhancements
In the web client Options dialog, a new “My Numbers” section appears (Figure 24). The user
can specify the Home, Home2, and Mobile telephone numbers supported in previous versions of
TeleVantage, and the E-mail, E-mail2, and “IM address“ properties added in TeleVantage 6.0.
Figure 24. My Numbers Section of the Options Page
Further, any of these addresses can be made visible to other users by checking the “Public”
checkbox.
The E-mail, E-mail2, and “IM address“ fields also appear in the web client’s contact property
pages.
See User and Contact Enhancements on Page 22 more details on these changes.
Camp on Busy
In the Extensions view of the web client, the Camp on Busy control (Figure 25) has been added
for each extension with a local station. This allows the user to camp on an extension through
using the web client.
See Camp-on on Page15 for more information on the camp on busy feature.
- 27 -
Figure 25. Camp on Busy Control in Web Client
- 28 -
Telephone User Interface
Record Call Feature Code
A user with the appropriate permissions and configuration can now record a call via his telephone
keypad. To initiate call recording during an active call, the user hits Flash and then enters *16.
The user must have a value of “Allow” for the “Record Calls” permission. If not, the server plays
"I'm Sorry, you do not have permission to use this feature", and then reconnects the user to the
call.
The call recording created using this feature is stored in the mailbox specified in the “Send
personal recordings to this user:” field in the user’s properties in the Administrator program. If
this user no longer has a voice mailbox, then the server plays "I'm sorry, your account is not
configured to make call recordings" to the user after he presses *16, and then reconnect the user
to the call. If the target mailbox is full, the server plays "I'm sorry, your recording mailbox is full"
and reconnect the user to the call.
When the user successfully starts a recording using the telephone keypad, the server plays
“Recording started” to the user and then automatically reconnects the user to the call. (The farend of the call is on hold and does not hear this prompt.)
While a call is being recorded, the user can stop the recording by pressing Flash and *16. The
server plays “Recording stopped” and then reconnects the call.
The user can also start recording before dialing a number by pressing *16 at internal dial tone.
The server will play “Recording started” and return the user to dial tone for the user to enter the
desired telephone number or extension.
The ViewPoint client works in conjunction with the new *16 feature code. A recording initiated
from the ViewPoint client can be stopped using *16, and a recording started from the telephone
keypad can be stopped using ViewPoint. ViewPoint displays the record or stop control as
appropriate to the current state of the recording.
Transfer to External Number via Telephone
Users can now transfer a call to an external number using the telephone keypad. During an
active call, the user presses Flash (or performs a hook flash). The user then selects Option 1 to
transfer. The server then prompt the user: “Enter an extension or phone number or press 411 for
a name directory”. The user can then enter an access code and external telephone number or IP
address. If the dialed number matches an internal extension or starts with a valid access code,
the call is transferred. If not, the server plays the prompt "That number is incorrect. If dialing an
external # please include the access code such as (default access code)”. The server then reprompts the user to enter a number to transfer to.
- 29 -
*91 and *99 Support for Extensions Routed to Trunks
The feature codes to pick up a ringing workgroup call (*99) and pick up a call ringing a specified
extension (*91) can now be used when logged in to TeleVantage on a trunk. This permits a user
who connects to TeleVantage using a voice-over-IP phone or gateway, or any other device that
automatically logs the user on to the system and takes them to internal dial tone, to pick up a call
on another extension simply by entering *99 or *91 and the extension, as he would from a station
attached to the system directly.
This feature is particularly useful in situations where a VoIP-to-analog gateway is being used to
attach multiple stations to TeleVantage, for example, at a remote office. If one of these remote
extensions is ringing, another user in the same location can now re-route the ringing call to his
station using these feature codes.
More steps are required to used these features when a user is connecting to TeleVantage from
an external device that does not automatically provide internal dial tone to the user. For example,
a certain user may have his mobile phone configured as an external station. To pick up a call
ringing another extension, the user must call into the system, log on to TeleVantage using his
own extension and password, enter # to navigate to internal dial tone, and then enter *99 or *91
to re-route the ringing call.
If the user is already on an active inbound call routed to the external station by TeleVantage, then
the trunk is already associated with this user and it is not necessary for him to log in. He can
press ** to put the active call on hold, enter # to get internal dial tone, and then enter *99 or *91.
An outbound call initiated from the client, where the near-end of the call is routed to an external
number because the user is assigned to an external station, or has logged into ViewPoint by
specifying a remote number in the Options section of the Log On dialog (Figure 26), is also
considered “logged in” to TeleVantage and does not have to log in to get to internal dial tone.
Figure 26. ViewPoint Log On Dialog
Note that calls forwarded to an external number, either by changing the user’s default location or
using the “At another location”, is not considered “logged on” to the system, except when the
“Prompt recipient for password” option is used in a routing list action. In these situations, a user
on an active call to the system must still log on before he can get to internal dial tone.
- 30 -
Assign Stations to Existing Extensions via *0
An option to assign an open station to an existing user has been added to the *0 quick command
menu in TeleVantage 6.0.
After pressing *0 on a station that is not currently assigned to any station, the server plays: "This
telephone is station number <station id>. This telephone doesn't have an extension. To create a
new extension and new user for this phone, enter an extension number followed by the pound
key, otherwise hang up." At this prompt, the user can either:
•
Enter an extension that does not currently exist on the server. The server will create a
new user with that extension and assign this station’s ID to that new user. This is the
same behavior as seen in previous version of TeleVantage.
•
Enter the extension of an existing user who is not currently assigned to a station. The
server changes the target user’s station ID to this telephone’s station ID.
If the user enters a valid extension (as defined below), he hears a confirmation prompt: “To
assign extension <target extension> to this station, press 1. Otherwise, press * to enter another
extension” . If the user presses “1”, then he hears default *0 quick command menu: "This
telephone is station number <station id> and the current extension is <target extension> .”
The target extension’s current default station ID must be “0” (zero). If the target extension is
already assigned to a non-zero station, then the server plays “I’m sorry, extension <target
extension> is already assigned to Station <extension’s station id>. Please enter another
extension followed by the pound key”.
This feature allows users to pre-configure users an extensions on a server. Users can be
associated with their stations, using only commands entered from the telephone handset, at the
time the TeleVantage server is put into place at the end-user site.
Permissions Restricting Access to TUI Features
TeleVantage 6.0 includes new user permissions that can be used to restrict a user’s access to
most telephone user interface features. See Permissions Restricting Access to TUI Features on
Page 107 for a list of the new permissions.
- 31 -
Contact Manager Support
ACT! Version 6.0 for Windows 2004 Support
ACT! Version 6.0 can be used with Version 6.0 of TeleVantage’s TAPI Service Provider.
TeleVantage provides the same level of function as found with earlier supported version of ACT!
with regard to outbound dialing and pop-up notifications for incoming calls.
See Using TeleVantage, Page 16-13, for more information on using ACT! with TeleVantage.
- 32 -
Platform Requirements
Windows 2000 Service Pack 4 Support
Both the TeleVantage 6.0 server and the workstation applications can run on platforms running
Windows 2000 with Service Pack 4.
Windows 2003 Server for TeleVantage Workstation Applications and
TeleVantage Server
TeleVantage 6.0 server runs on Windows 2003 Server, Standard and Enterprise Editions. The
server product should not be installed on the Datacenter or Web editions of Windows 2003
Server.
The TeleVantage 6.0 workstation applications, including ViewPoint Web Services, run on
Windows 2003 Server, Standard and Enterprise Editions. The workstation applications are not
supported on the Datacenter or Web editions of Windows 2003 Server. Web Services is also
supported on the Web Edition of Windows 2003.
Windows XP for TeleVantage Server
TeleVantage 6.0 server runs on Windows XP, Home and Professional Editions.
Microsoft Data Engine 2000
New installs of TeleVantage 6.0 run on MSDE 2000 Service Pack 3a. The “Microsoft Data
Engine” option on the Master Setup CD installs this version of MSDE if no other version of
Microsoft SQL server is present on the machine.
MSDE 2000 for MSDE 7.0 upgrades
TeleVantage 6.0 server install program automatically upgrades MSDE 1.0 installs to MSDE 2000
without warning. If the server already has MSDE 2000 installed, it is upgraded to Service Pack
3a, without warning.
The installer can also upgrade servers with MS SQL 7.0 Desktop or Enterprise Editions to MSDE
2000 SP3a. The user is warned before the upgrade is performed. If he chooses not to upgrade
to MSDE 2000, the server installer continues using the existing install of MS SQL 7.0.
If a server undergoing an upgrade to TeleVantage 6.0 already has MS SQL 2000 Standard or
Enterprise Editions with SP3 installed, the installer program does not attempt to install MSDE
2000 or its service pack. If the current version of MS SQL 2000 is not running SP3, the user is
warned that he must manually upgrade the database engine to SP3 before continuing, and the
upgrade stops.
The server installer does not support upgrades from versions of TeleVantage using MS SQL 6.5.
Servers running TeleVantage Version 2.1 or earlier versions must be upgraded to Version 3.x, 4.x,
or 5.0 before running the TeleVantage 6.0 installer.
- 33 -
Windows NT Server and Workstation No Longer Supported
TeleVantage Server running on Windows NT (both Windows NT Workstation and Windows NT
Server) is no longer a supported configuration. The Intel Dialogic Drivers are not certified to run
on this operating system and future versions of the drivers will not be tested no Windows NT.
Windows NT is still supported as a platform for the TeleVantage workstation applications and for
TeleVantage 6.0 ViewPoint Web Services.
- 34 -
Telephony Hardware & Drivers
Updated Dialogic DMU Utility
The TeleVantage 6.0 Drivers CD includes the Dialogic MakeCall Utility (DMU) Version 1.4, the
replacement for Version 1.3 associated with Dialogic’s DNA Version 3.3 drivers and used with
previous versions of TeleVantage. The new version of DMU can be found in the
\Dialogic\drivers\support\dmu folder on the CD.
Dialogic System Release 5.1.1 Feature Pack 1
As part of the installation process for TeleVantage 6.0, Feature Pack 1 for Dialogic’s System
Release 5.1.1 for Windows is installed on the TeleVantage server machine. Feature Pack 1
includes:
•
•
•
•
•
•
Support for the DI/SI16 and DI/SI24 station boards
Support for the DI/0408-LSA Revision 2
Support for the DMV160LP analog trunk board
Support for DM/IP0821A-T1 and DM/IP0821A-E1-120
Windows 2003 Support for TeleVantage Server
Support for Windows XP Platform
Dialogic Driver Updates
As in previous versions of TeleVantage server, the TeleVantage server installation process
includes a “Dialogic Driver Updates” step. This step installs:
•
•
•
The Windows drivers for the Toshiba station boards
A number of post-Feature Pack 1 patches to the Dialogic drivers.
The Dialogic GlobalCall 4.0 Protocol package
Dialogic GlobalCall 4.0 Protocol support
A standard installation of TeleVantage 6.0 includes the Dialogic GlobalCall Protocol Package,
Version 4.0. This package provides country-specific and equipment-specific protocol
implementations for T1 and E1 lines.
This update to the Global Call Protocol Package supplants Version 3.0, supported under
TeleVantage 5.0. Unlike that previous version, Version 4.0 of this package is now automatically
installed on the server as part of the Dialogic Driver Updates installation step.
For more information, refer to Intel’s website at
http://resource.intel.com/telecom/support/releases/protocols/GCProtocols40/index.htm.
To determine which version of the GlobalCall Protocol Package is installed on your server, check
the value of the registry key:
HKEY_LOCAL_MACHINE\SOFTWARE\Dialogic\Intel Dialogic Global Call Protocols
- 35 -
The “Release” value within this key indicates the current version of the package installed on your
server.
(Refer to Page 5-19 of Administering TeleVantage for more information on using these protocols
when configuring E1 CAS spans.)
DI/0408LSA Revision 2 Integrated Trunk & Station Board
General Description
The DI/0408-LSA is a multi-purpose telephony board. A member of the DM3 family of Intel
Dialogic boards, the number and type of network resources available using this board is
determined by the firmware file and parameters (also called “media load”) assigned to this board.
The firmware and configuration of the board is determined by the contents of the product
configuration description (PCD) file assigned to the board when it is configured in the DCM.
Three separate configurations are supported:
Analog Stations with Analog and IP Trunks (Using PCD File @DI0408LSA_ML3)
4 analog loop-start trunks
8 analog stations
4 IP trunks
12 shareable voice resources
Music-on-hold input
Integrated failover
Analog Stations & Trunks (Using PCD File @DI0408LSA_ML4)
4 analog loop-start trunks
8 analog stations
9 conference resources w/ 9-party max
8 shareable voice resources
Music-on-hold input
Integrated failover
IP Trunks Only (Using PCD File @DI0408LSA_ML5)
12 IP Trunks
(All other features are disabled)
The firmware and configuration assignments are also referred to a “media loads”, and so the
setups above are referred to as “Media Load 3”, “Media Load 4”, and “Media Load 5”,
respectively.
- 36 -
Electrical and Mechanical Characteristics
The DI/0408LSA-R2 is shown in Figure 27. The host interface is Universal PCI V2.2 33MHz, and
the board requires a single, PCI long-card slot.
Figure 27. DI/0408LSA Revision 2
The DI/0408LSA-R2 includes a standard 68-pin CT-bus connector, and operates in both CT-bus
and SC-bus compatibility mode.
Stations 5-8
Stations 1-4
Trunks 1-4
Audio Input
Power Supply
Connector
Figure 28. DI/0408LSA-R2 Connectors
The back plate (Figure 28) of the DI/0408LSA-R2 includes five separate connectors used to
connect the board to external devices. There are three RJ-61 connectors: two (S1-4, S5-8)
provide connections for analog telephone handsets (four stations on each connector) and the
third (T1-4) is used to connect the board to up to four analog loop-start trunks. Immediately
above these connectors is a 1/8 inch phono jack, which is a 1000 ohm, 600mV peak-to-peak
input for music-on-hold audio. Lastly, the pigtail terminated in a 6-pin DIN connector is used to
connect the DI/0408LSA-R2 board to an MSI Global power supply. The external power supply
provides loop current and ring voltage for the analog stations attached to the board.
A breakout box and cable (Figure 29) to take the eight station and four trunk connections on the
RJ-61 connectors to individual RJ-11 connectors is available. The cable shown is approximately
6 feet in length and both ends are clearly marked with the mating connector identifiers.
The board does NOT include an Ethernet port. When the DI/0408LSA-R2 is used with either of
the media loads that support IP trunks, the DI/0408LSA-R2 communicates with the network using
the host machine’s NIC(s), and a host-based stack is required. See Dialogic GlobalCall IP With
Split Call Control Support on Page 100 for more information on host-based stacks.
- 37 -
Automatic failover
The DI/0408LSA-R2 has on-board relays which are used to provide a fail-over capability. When
the TeleVantage server machine loses power, or when the Dialogic drivers are stopped, the first
four analog station ports are connected to the first four analog trunk ports through these relays.
(Note that removing power to the board's external power supply does NOT cause the failover
mechanism to engage.)
Figure 29. Breakout Box and Cable for the DI/0408LSA-R2
Voice Resources
The voice resources on the DI/0408LSA and those on Springware boards (such as the
D/120JCT-LS and D/240SC-T1) perform similar functions but their programming interfaces are
markedly different, and currently TeleVantage does not support the full use of both types of voice
resources in the same system. When the server starts, if there are any Springware boards
present in the system, TeleVantage server only uses Springware-based voice resources for voice
processing. The voice resources on the DI/0408LSA boards are then used only to send Caller ID,
Caller ID on Call Waiting, or message-waiting information to CLASS phones. When performing
this type of signaling to a station attached to DI/0408LSAR2 board, the TeleVantage server does
not require a voice resource from the shared voice resource pool. Instead, one of these “tone
resources" on the DI/0408LSA board is used.
- 38 -
If the system contains no Springware boards, then the TeleVantage server can use the
DI/0408LSA-based voice resources. This is termed “DI/0408LSA standalone mode”.
Systems running in this mode should have “Generate tones using software”, in the General
category of the Tools>System Settings dialog of the Administrator program, checked.
Support for Revision 2 of DI/SI16, DI/SI24, and DI/SI32 Station Boards
As a result of the move to Feature Pack 1 for the Dialogic drivers, TeleVantage 6.0 supports
Revision 2 of the DI/SI32 station board. Where the initial version of this board supplied only 12
useable conference resources, Revision 2 has 16 conference resources, and supports up to 16party conferences.
Also, Revision 2 of the DI/SI16 and DI/SI24 station boards are supported in TeleVantage 6.0.
The DI/SI16 and DI/SI24 are identical to the DI/SI32 Revision 2 station board, except the DI/SI16
has 16 station ports and the DI/SI24 has 24 station ports. Both boards supply 16 conference
resources and up to 16-party conferences, like the DI/SI32 Revision 2 board.
Support for DM/IP0821A-T1 and DM/IP0821A-E1-120
Support for the DM/IP0821A-T1 and DM/IP0821A-E1-120 IP trunk boards returns in TeleVantage
6.0. The DM/IP0821A series boards were not supported in TeleVantage 5.0. However,
TeleVantage 4.1 and earlier versions, which used the DNA Version 3.3. Dialogic drivers,
supported these boards and many TeleVantage customers purchased this equipment in the past.
The firmware files in Table 3 can be assigned to these boards in DCM:
Table 3. Firmware Files for DM/IP0821A IP Trunk Boards
Board
DM/IP0821A-T1
DM/IP0821A-E1-120
PCD File
@IPT_ISDN_5ESS1D.PCD
@IPT_ISDN_NET51D.PCD
- 39 -
DMV160LP Analog Trunk Board Support
The DMV160LP is a 16-port analog trunk board. It is approved for use in North America, Japan,
and non-European Union countries.
Figure 30. DMV/160LP Analog Trunk Board
The DMV160LP is shown in Figure 30. It is a single slot, Universal PCI long card. The board
includes a CT-bus connector and can operate in both CT-bus and SC-bus compatibility mode.
Figure 31. DMV160LP Connectors
The DMV160LP connects to the telephone system through six RJ-25 connectors (Figure 31) on
back plate of the board. Each connector supports three analog loop-start trunks, except the
bottom-most connector, which connects only a single trunk.
As the part number suggests, the DMV160LP is a member of the DM3 family of Intel Dialogic
boards. Unlike the Springware boards (like the D/80SC-4LS or D/120JCT-LS), the DMV160LP
provides no usable voice resources to the TeleVantage system. Therefore, a system using this
board requires at least one Springware board in the system to provide both voice resources. Also,
when the DMV160LP is initially configured in DCM, a firmware file must be specified. The
currently recommended firmware file is “@DMV160LP.PCD”, or “@DMV160LP_JP.PCD” (in
Japan).
The DMV160LPEU is the version of this board approved for use in the European Union. The
currently recommended firmware file is “@DMV160LP_EU.PCD”.
- 40 -
Toshiba Digital Telephone Support and New Features
Introduction
TeleVantage (Version 4.0 and higher) supports some of Toshiba’s proprietary digital telephone
sets. These telephones have a number of important features, some of which are only available
using Toshiba stations:
•
•
•
•
•
•
•
Multiple Line Appearances
Up to 20 Programmable Feature Buttons
Voice-first Answering
Hands-free Answering
Multiple, programmable ring tones and distinctive ring
Secondary Directory Numbers - allowing limited control of another user’s/station’s calls
Out-of-band signaling
Toshiba phones are often used when:
•
•
Replacing an existing key system, where the end-user’s current work patterns are
already oriented to the “button-per-line” operation of the telephone system.
Providing ready access to more complex functions for users who cannot or do not wish to
use the ViewPoint client.
The main advantage of digital handsets is out-of-band signaling. Unlike traditional analog phones
where the user must interrupt the conversation in order to initiate a telephony system function, a
digital telephone allows signaling to occur while a call is active. As a Toshiba set uses out-ofband signaling to communicate with the server, TeleVantage does not need to allocate a voice
resource to send or receive signals with the station.
Supported Toshiba Hardware
A typical Toshiba telephone set is shown in Figure 32. The handsets listed in Table 4 can be
used with TeleVantage 6.0.
Table 4. Supported Toshiba Telephones
Model
DKT-2001
DKT-2010-S
DKT-2010-SD
DKT-2020-H
DKT-2020-SD
DKT-3001
DKT-3010-S
DKT-3010-SD
DKT-3020-SD
Description
Single-line phone
10-button multi-line speakerphone
10-button multi-line speakerphone w/ LCD display
20-button multi-line phone w/ handsfree answerback*
10-button multi-line speakerphone w/ LCD display
Single-line phone
10-button multi-line speakerphone
10-button multi-line speakerphone w/ LCD display
20-button multi-line speakerphone w/ LCD display
Notes:
“D” – includes LCD display,
“S”- includes speakerphone mode,
“H”- includes “handsfree answerback”: built-in speaker and microphone for intercom,
page, handsfree, and voice-first modes, no Mic key, no Spkr key on DKT20x0-H
telephones.
- 41 -
Each Toshiba telephone set has an RJ-11 jack which accepts a standard telephone patch cord.
This input is not polarity sensitive. (The Toshiba phones will operate properly with reverse
polarity.)
Figure 32. Toshiba Digital Telephone
To use Toshiba telephone sets with TeleVantage, one or more Toshiba CS-DKTU station boards
(Figure 33) must be installed in the TeleVantage server. Voice, signaling, and power are supplied
to the phones via a single two-wire connection from this board to each telephone. The station
board output is wired to an RJ-21X connector (Figure 34) located on the faceplate of the board.
Bail lock clips are used for strain relief (so no tools are required to connect an output cable to the
board). The cable can routed to a breakout box, patch panel, or punch-down block.
Figure 33. Toshiba CS-DKTU Station Board
- 42 -
Each Toshiba station board supports 16 digital stations. The boards requires a 5V PCI Version
2.0 slot. The boards attach to the TDM bus through a 68-pin CT-bus connector, and support
both “H.100” mode and SC-bus compatibility mode operation
The station board has a 68-pin card edge connector on the top of the board to accept a standard
CT-bus cable. There is no CT-bus ID selector switch. The logical address of the card is
assigned by the (Toshiba) driver software.
Toshiba boards are assigned station numbers above those of any MSI, DI/SI, DI/0408, or HDSI
board. If there are multiple Toshiba boards in the system, station numbers are assigned by PCIslot number of the station board. The station number and CT-bus timeslot assignments are made
by the TeleVantage server application software at run-time.
Station Connector
Power Supply
Connector
Figure 34. Toshiba CS-DKTU Connectors
These boards also supply four (4) conference resources to the system. A maximum of four
parties can be conferenced into a single call.
The Toshiba station boards require an external power supply for proper operation. The power
supply provides +24VDC at a rated maximum output of 2.3A (max) to the board. Power is
supplied to the board through a pigtail extending from the faceplate of the card and terminating in
a two-conductor low-voltage DC power barrel connector.
The stations board, power supply, and cable are sold as a kit or separately.
Installation
To install one or more Toshiba station boards on an existing TeleVantage server:
•
•
•
•
•
•
•
•
Set TeleVantage server service to Manual.
Shut down and power down TeleVantage server machine.
Insert Toshiba station board(s) in an available, compatible PCI slot.
Connect CT-bus ribbon cable to board(s).
Connect output cable to RJ-21X connector on station board.
Connect power supply to DIN connector on station board.
Connect the power supply to an available power outlet.
Boot the TeleVantage server machine.
The boards should be recognized by the operating system automatically. The Toshiba drivers are
installed as part of the Dialogic Driver Updates at server install time. The board driver runs as a
Windows driver. The PC-DKSC boards appear in Device Manager as “CTS: PCDKSC” under
System Devices. A Toshiba board uses a PCI shared interrupt (typically IRQ9).
- 43 -
The Toshiba boards do not communicate with the Intel Dialogic drivers and do not appear in the
Dialogic Configuration Manager (DCM).
Configuration
Toshiba Boards
There is no configuration required for the board or drivers. The system resources (IRQ, memory)
and CT-bus addresses used by these boards are automatically assigned by the Toshiba drivers.
The TeleVantage server software assigns CT-bus timeslots and stations identifiers to the station
devices on the Toshiba boards at run-time. However, it is recommended that the Dialogic drivers
be forced to SC-bus compatibility mode when using PCDKSC boards.
Toshiba Stations
Station features and settings can be configured both through the ViewPoint client and the
TeleVantage Administrator program. In ViewPoint, the user-accessible settings are found in
Tools>Options in the Phone, Phone>Feature Buttons, and Phone>Ring Patterns categories
(Figure 35) . In the Administrator program, a similar set of controls are found in the user’s
properties in the Phone and Phone>Feature Buttons categories.
Figure 35. Toshiba Station Settings in ViewPoint
- 44 -
Telephone Features
The buttons and controls on a typical Toshiba telephone are shown in Figure 36.
Figure 36. Toshiba DKT-2020-SD Controls
Hot Keypad
The keypads on the Toshiba telephones are active even when the telephone is on-hook (receiver
in the cradle and the telephone is not in speakerphone mode.) When any digit key on the
keypad is pressed, the telephone is placed into speakerphone mode immediately. The telephone
passes the digits to the server (out-of-band) as they are dialed, and each digit is displayed on the
telephone’s LCD display (if present).
Ring Controls
A Toshiba telephone supports five different ring tones. A station can be configured to produce
different ring tones to distinguish between internal and external calls. The user can also specify
if and how the station should ring when a call arrives on one of his assigned secondary directory
numbers (SDN, see below) . Table 5 describes the available ring tones.
- 45 -
Table 5. Ring Patterns
Pattern
Low
Medium
High
Combined
Single
Characteristics
500Hz & 640Hz, 1s on, 3s off, repeating
860Hz & 1180Hz, 1s on, 3s off, repeating
1300Hz & 1780 Hz, 1s on, 3s off, repeating
860Hz & 1180 Hz, 0.5s on, 1300Hz & 1780 Hz, 0.5s on, 3s off, repeating
500Hz, 1s on, 3s off, repeating
The controls for setting the ring behavior are on the Phone>Ring Patterns of the Tools>Options
dialog in ViewPoint. (See Figure 37.) Select the type of ring that you want for internal calls and for
external calls.
Figure 37. Ring Pattern Controls
To test a ring pattern, click the button to the right of the drop-down list. Your phone rings three
times in a demonstration of that ring. The first ring cycle might be truncated. Listen for the
subsequent rings to hear the full pattern.
There are also controls for setting the ring duration and volume.
“Ring phone for __ seconds” determines the number of seconds that TeleVantage rings the
user’s extension before continuing to the next step in the user’s routing list. This control is found
in the Administrator program in the user’s properties, in the Phone category. In the client, the
corresponding control is ”Default ring duration”, located on the Phone category in
Tools>Options.
The “Ring volume” slider bar, under “Station Features”, adjusts the default ring volume for the
phone.
Pickup Behavior
By default, if a call appears on an SDN, the station will ring, but the user must press the SDN
button to answer the call. If the “Pickup answers ringing SDN” control is checked, then if a call
is ringing on an SDN, that call can be answered by simply taking the station off-hook by picking
up the receiver or pressing the Spkr button. This control is located under Phone>Station
Features in the ViewPoint and Phone in Administrator program.
When a call on a PDN rings, going off-hook always connects the user to the call.
- 46 -
Voice-first Answering
The “Use voice-first answering” control enables voice-first answering. With voice-first answering,
internal calls are connected to the user’s speakerphone automatically without the phone ringing
or needing to be picked up. All external callers ring the phone normally. This control is located
under Phone>Station Features in the ViewPoint and Phone in Administrator program.
To use this field, voice-first answering must be enabled at the system level. (See Administering
TeleVantage on Page 3-5.)
Figure 38. Hands-free Answering Controls
Hands-free Answering
Toshiba stations with speakerphone capabilities can be put into hands-free mode, just like their
analog counterparts. (See Figure 38). For more information, see Administering TeleVantage,
Page 7-14.
Background Ring for Call Waiting
If the user has call waiting enabled (via the “Enable Call Waiting” checkbox in the Phone
category of Tools>Options in ViewPoint, Figure 39), then his Toshiba station will ring for
incoming calls even if all his PDNs are busy with other calls.
- 47 -
With call waiting disabled, if all PDNs are busy, then an incoming call does not ring the Toshiba
station, but is sent to the next step in the user’s routing list.
Figure 39. Enable Call Waiting Control
LCD Display & Controls
Some of the Toshiba phones (see Table 4) include a 2-line by 16 character LCD display. This
display is used by TeleVantage to provide Caller ID number and name and call status information
to the user. It also allows TeleVantage to provide some simple function menus. Table 6
summarizes what information is found on the display.
Table 6. LCD Display Information
Status
Active Call
Alerting
Dialing
Hold
Idle
Line
Top
Bottom
Top
Bottom
Top
Bottom
Top
Bottom
Top
Bottom
Displayed Information
Caller Name or CID
Call Duration + Line Number (PDN or SDN)
Caller Name or CID
Date + Day + Time
(Blank)
Call Duration
HOLD
Date + Day + Time
Station Idle Message
HANDSFREE if in hands-free mode
Date + Day + Time
The station’s idle message is configured using the “LCD Idle Message” control. This control
appears in both the Administrator and ViewPoint client programs. The idle message is displayed
whenever the station is idle. It is typically set to the name of the user assigned to the phone (e.g.
“Alicia Anderson”) or the location of the phone (“Lobby”). To set the idle message, simply type in
the desired text and close the dialog box by clicking OK. The display on the phone is updated
immediately.
- 48 -
Display buttons
Beneath the LCD display (on phones equipped with displays) are a row of three buttons, labeled
“Mode”, “Page”, and “Scroll”. These buttons are context-sensitive – their function changes with
the state of the station or call. The functions these buttons can performed can be divided into two
categories: LCD display control and soft-key functions.
The display buttons are assigned their LCD display control functions in most circumstances. The
operations associated with each button are described in Table 7.
Table 7. LCD Display Button Functions
Button
Mode
Page
Scroll
Function
The Mode button performs no function in idle or during an active call.
The Page button toggles the first line of the display between the caller’s name
and the caller’s telephone number when pressed when an incoming call is
ringing or active. The setting is not persistent – a new call always displays the
caller’s name
When there are multiple calls on the station (active or on hold), the Scroll
button scrolls through caller name/CallerID information for each call. The line
number (button number of call) is displayed, also.
Soft-key Functions
When the user initiates a special function, like recording a call, from the Toshiba telephone set,
the display buttons are assigned “soft menu” functions which allow the user to control that
function. The bottom line of the LCD display changes to indicate which context-specific function
(if any) is assigned to each key. In TeleVantage 6.0, there are two functions that use such menus.
When the station is in direct transfer mode ( see Primary and Secondary Directory Numbers on
Page 53), if the user presses the Cfn/Trn button, the display buttons are used to allow the user to
choose between transfer or conference. (See Figure 40.) The Mode button is pressed to choose
to transfer the active call and the Page button begins a conference.
Beth Brown
TRN
CONF
Mode
Page
Scroll
Figure 40. LCD Display During a Transfer
When a user records a call, the display buttons are used to pause or resume the recording. (See
Figure 41.) The Mode button is used to pause while recording the call and resume the recording
after it has been paused. See Page 58, Record Call.
Recording
Pause
Mode
Page
Scroll
Figure 41. LCD Display During Recording
- 49 -
Feature Buttons
The Toshiba telephones have two types of feature buttons – fixed and flexible. (See Figure 36.)
Fixed Function Buttons
The fixed function buttons are located just below the keypad. With the exception of the Cnf/Trn
button, the operation of these buttons cannot be modified in any way.
Cnf/Trn
By default, Cnf/Trn places user in the Call Handling menu, with options to transfer (Option 1) or
conference (Option 5, if there are multiple calls on hold). This mode of operation can be selected
by setting the Cnf/Trn control to “Menu Assisted Transfer”.
Optionally, Cnf/Trn can return user to internal dial tone. The user can then start a transfer by
dialing an internal extension or access code and external address. The Mode and Page buttons
under the LCD display are now used to transfer or conference. TRN appears on the LCD display
above the Mode button after dialing. If the user pushes the Mode button while the dialed
telephone is ringing, the call is blind transferred to the target. Otherwise a consultation call to the
transfer target is created. After the consultation call is answered, CRN also appears, above the
Page button, If the user pushes the Mode button after the consultation call is answered, the call
is transferred to the target and the Toshiba phone returns to idle (on-hook). If the Page button is
pushed while the consultation call is active, the user, the original caller, and the transfer target are
conferenced together. This emulates the supervised transfer operation in ViewPoint. Select
“Direct Transfer” in the Cnf/Trn button control for this mode of operation..
Hold
The Hold button puts the active call on (system) hold. The caller hears hold music (if configured).
Unlike flash on an analog phone, Hold places a caller on hold without starting the Call Handling
menu. The user hears silence and the PDN button light flashes green.
See Primary and Secondary Directory Numbers on Page 53 for a discussion of directed hold.
Mic
The Mic button toggles the Toshiba handset’s microphone on and off when the phone is off-hook
in speakerphone mode. When the microphone is off, the Mic button LED is dark, and the caller
hears silence (not music).
The Mic button is a local mute. It does not initiate the Mute function available in the ViewPoint
client applications.
- 50 -
Spkr
The Spkr button toggles speakerphone mode on or off. In speakerphone mode, audio is routed
to the speaker and the microphone is active for audio input. Both the Mic and Spkr LEDs are lit.
If the receiver is off-hook, pressing the Spkr button toggles audio input and output between the
receiver and speaker/microphone.
Msg
The Msg button provides direct access to the user’s voice mailbox.
When the Msg button is pressed, the user is placed in the Account menu. The system assumes
the current user’s extension. The user is asked for a password and can then listen to voicemail
or perform any other function provided in the Account menu.
If the handset is not already off-hook when the Msg button is depressed, the phone is also put
into speakerphone mode.
The Msg button does not function when in an active call.
The Msg button LED operates as a message waiting indicator. When there is an unheard
message in the current user’s voice mailbox, the LED flashes. If there are no unheard messages,
the LED is dark.
Redial
Redial redials the last extension or access code and telephone number or IP address entered
through the handset. The system saves the address even if the last call to the address did not
complete (ring no answer or failed). Quick commands (*nn) and pound (#) are not saved and
cannot be redialed using the Redial button. The Redial button works only from internal dial tone.
Vol▲ and Vol▼
The Vol▲ and Vol▼ buttons are used to adjust the volume of the telephone’s audio outputs and
ringer. When the phone is on-hook, these buttons adjust the ringer volume. When the phone is
off-hook with the receiver out of the cradle, the buttons change the audio volume on receiver.
When in speakerphone mode, they change the audio volume on speaker. All these setting
persist through an on-hook.
- 51 -
Flexible Function Buttons
A flexible function button on the Toshiba phones can be assigned one of a number of different
functions.
Figure 42. Feature Button Assignments in the Administrator Program
Note: Before the server is started and the Toshiba terminals are initialized, the Administrator
program is not aware of the type of phone (single line, 10-button, or 20-button) connected to a
particular Toshiba station port. Therefore, only the Cnf/Trn button definition appears in the
Phone>Feature Buttons category (Figure 42).
- 52 -
Available Functions
There are fourteen different features that can be assigned to a Toshiba phone flexible button,
listed below:
Primary Directory Number (PDN)
Secondary Directory Number (SDN )
Account Code
Call Forwarding
Call Menu
Do Not Disturb
Flash
Park/Unpark
Phone Page
Record Call
Release
Send to Voicemail
Speed Dial (Extension, Phone Number, Direct Dial)
Take Call
With the exception of SDNs, these functions can be assigned to flexible buttons through both the
ViewPoint client and the Administrator program. An SDN can only be assigned to a user’s station
button by an administrator, through the Administrator program.
The default assignments for a 20-button phone are shown in Figure 43.
Button
10
9
8
7
6
5
4
3
2
1
Function
Unassigned
Do Not Disturb
Park/Unpark
Send to Voicemail
Call Menu
Function
Unassigned
Unassigned
PDN
PDN
Button
20
19
18
17
16
15
14
13
12
11
Figure 43. Default Flexible Button Assignments
Primary and Secondary Directory Numbers
A primary directory number (PDN) is a line appearance associated with the extension of the
current user assigned to the Toshiba telephone. The user of Toshiba station can designate how
many PDNs are on his station (using Phone>Feature Buttons). Incoming calls are routed to the
lowest number idle PDN button (bottom-to-top). Outbound calls made using the hot keypad or
client are routed to the highest number idle PDN (top-to-bottom). The user can press a PDN
button to get internal dial tone in order to place an outbound call.
A secondary directory number is a line appearance associated with another user’s station. If the
administrator has configured an SDN button for one of User B’s PDNs on User A’s phone, a call
on User B’s PDN appears on User A’s SDN.
- 53 -
When User B receives an incoming call on his station, his phone rings and the LED for the PDN
of the call flashes green. User A’s corresponding SDN LED simultaneously flashes red, and, if
configured to do so, User A’s telephone also rings.
If User B answers the call, User A’s SDN LED changes to solid red. User A cannot take the call
away from User B. If User B now puts the call on hold, User A’s SDN LED flashes solid red,
indicating that the call is on hold. User A can now take the call by pressing his SDN button. His
SDN LED changes to solid green, and User B’s PDN LED changes to solid red. This transfer of
a call from one user’s PDN to another’s SDN is called directed hold.
If User B is away from his phone and does not answer the call, User A can take the call by
pressing the SDN button. User A’s SDN LED changes to solid green. User B’s PDN LED
changes to solid red, indicating that User A has taken the call. User B cannot take the call away
from User A at this time. Directed hold also works from SDN to PDN – if User A now puts the call
on hold, User B’s PDN LED flashes red, and User B can take the call by pressing his PDN button.
Incoming calls ringing another user’s extension, active calls owned by another user, and calls on
hold belonging to another user do not appear in the ViewPoint Call Monitor even if the call
appears on your phone on an SDN. (The owner of the call must have shared his Call Monitor to
you for you to see and control such calls.)
Typically, for each PDN User B has on his station, User A should have a corresponding SDN. (It
is the responsibility of the administrator to insure that the number of SDNs and PDNs match. The
Administrator program displays a pop-up warning (Figure 44) if the administrator changes the
number of SDNs or PDNs assigned to a user in such a way that there is a conflict.)
Figure 44. PDN/SDN Mis-match Warning
Table 8 summarizes the various states the line appearance buttons assume.
Table 8. Line Button LED States
Call State
Idle
Ringing
Active
On Hold
To PDN user
To SDN user
By PDN user
By SDN user
PDN
Dark
Blinking Green
Solid Green
Solid Red
Blinking Green*
Blinking Red
SDN
Dark
Blinking Red
Solid Red
Solid Green
Blinking Red
Blinking Green*
* All-short blink indicates near-end has put the call on hold.
Long-short-short blink indicates the far-end caller has placed you on hold.
Corresponding SDN/PDN on the other user’s phone shows solid red (active).
- 54 -
To configure a button as an SDN, select the desired button in the Feature Buttons dialog and
choose “Secondary Directory Number” in the Feature list box. Then click on the ” … “symbol to
the right of the Parameter field. The Secondary Directory Number dialog box (Figure 45) will
appear. Choose the desired user extension in “Select the station to monitor” list.
The “Ring this phone when the extension is called” determines if the Toshiba station will ring
when an incoming call appears on this SDN. If unchecked, the phone will never ring for a call on
the SDN. If checked, the phone will either ring immediately, if “Ring immediately” is selected, or
after the delay time specified in the “Ring after _ seconds” control. If the phone is configured
to ring for the SDN, then the user can specify which ring tone will be heard by selecting the
desired tone in the “Ring pattern” list box. See Ring Controls on Page 45 for a description of the
available ring patterns.
Figure 45. Secondary Directory Number Dialog
Account Code
The Account Code function allows you to enter an account code for the active call.
Press the account code button and enter the desired account code. Terminate the account code
by pressing the Account Code button again.
- 55 -
When the Account Code button is pressed, “Enter Acct Code:” is shown on the bottom line of the
LCD display of the telephone (Figure 46). The account code digits, displayed as each digit is
pressed, are then displayed on the top line.
123456
Enter Acct Code:
Mode
Page
Scroll
Figure 46. LCD Display During Account Code Entry
If the user is configured for a verified account code mode, the account code entered is verified
against the list of valid account codes as each digit is pressed. When a digit is pressed that
would cause the account code entered to be invalid, “Code Invalid” is displayed on the telephone,
prompting the user to re-enter.
Since the Account Code button functions only during an active call, it is not possible to “pre-dial”
an account code using the programmable button. ( You can still pre-dial an account code using
*11+ account code from internal dial tone on the Toshiba phone.)
Call Forwarding
The Call Forwarding function allows a user to toggle call forwarding on or off by pressing a
button on the Toshiba telephone. The target address to which calls are forwarded must be
assigned to the button beforehand through either the Administrator or ViewPoint client program.
If the user’s calls are not forwarded, pressing the Call Forwarding button will change the user’s
default location (“Where I Am” setting) to the pre-configured extension, telephone number, or IP
address. The LED next to the button will also be lit. To turn off call forwarding, the active button
is press again, and the LED is extinguished. The change in call forwarding status is reflected
both in the ViewPoint client and the TUI. If the call forwarding setting is changed via the client or
TUI, the change is reflected in the state of the LEDs on the telephone.
A user can assign the Call Forwarding function to multiple buttons, each with a different target
address, for example. The LED for each button is lit only when calls are being forwarded to the
target address associated with the button. For example, if a user has two buttons configured, one
to forward calls to his home telephone and another to forward calls to his mobile phone, if he
uses ViewPoint to forward calls to his mobile phone, the LED of the first button would be dark and
the LED of the second but would be lit.
Call Menu
The Call Menu button places the active call on hold and presents the Call Handling menu to the
user. In the Call Handling menu, the user is given options to transfer, conference, park,
disconnect or reconnect to calls.
This button can be used whenever there is one or more calls on a PDN, either active or on hold.
In particular, it is often used in lieu of the Cfn/Trn button, especially when the station is configured
in direct transfer mode. See Cnf/Trn on Page 50 for more information.
- 56 -
Do Not Disturb
The Do Not Disturb function allows the user to change his personal status. Pressing the Do Not
Disturb key toggles the user’s personal status between his current personal status and the “Do
Not Disturb” personal status. When in “Do Not Disturb”personal status, the LED associated with
the Do Not Disturb button is lit. This occurs even if the user changes to “Do Not Disturb”
personal status through the client or TUI menus. When in “Do Not Disturb”, pressing the Do Not
Disturb button will return the user to his last non-Do Not Disturb personal status.
For example, if the user is in “In A Meeting”, pressing the DND button will change personal status
to Do Not Disturb. Pressing the DND button a second time will change back to “In A Meeting”.
If the user is in Available (Queue Only) and puts himself in Do Not Disturb using the client, TUI
menu, or *5x quick command, when he then presses the DND button on the Toshiba phone he is
returned to Available (Queue Only) (not Do Not Disturb).
Flash
Flash sends a trunk flash (equivalent to Flash-8 on an analog phone) on the active call.
Park/Unpark
From idle or internal dial tone, the Park/Unpark button can be used to unpark a parked call. The
system prompts the user to enter the park orbit number of a parked call. If a call is parked on that
orbit, the user is connected to the call. (Same effect as *92n.) If there is no call at the specified
orbit, the system announces “There is no call at parking number n”.
If the Park/Unpark button is pressed during an active call, the call is parked in the next available
park orbit. The system announces “The call has been parked at number n” and the LCD display
on the phone (if present) displays “Pk Orbit: n” where n is the orbit number the call has been
parked on. The phone then returns to internal dial tone on the PDN the call was on.
If a call on a Toshiba station line appearance is parked, the LED for that line appearance blinks
as if the call has been put on hold. The call can be retrieved (unparked) by pressing the PDN
button. However, another user with an SDN for that line appearance cannot unpark the call by
pressing the SDN button (like a call on hold). The user can see the call on the SDN, but must
use the Park/Unpark button, client, or *92 feature code to unpark the call.
Phone Page
Toshiba phones support commanded off-hook. The server can send an instruction to the
telephone to go into speakerphone mode. This capability is used in voice-first answering and
page/intercom. Since signaling is done out-of-band on the Toshiba phones, these phones go
off-hook more quickly than their ADSI counterparts. Also, no voice resource is required to page a
Toshiba digital telephone, so, potentially, the number of Toshiba telephones that can be paged
simultaneous is not limited by the number of shared voice resources available on the server.
Phone page button has the same effect as the *15 feature code. The system prompts the user
to enter the extension of a user or workgroup to page. If a user’s extension is entered, the result
is an intercom connection (two-way audio). If a workgroup extension is entered, the system
- 57 -
performs a page (one-way audio from dialing user to all telephones in the workgroup). When the
page is finished, the Toshiba phones automatically return to the on-hook state.
The phone must be on-hook with the receiver in the cradle to participate in a page (target).
Record Call
The Record function allows the user to start, stop, or pause recording of an active call. The
flexible button itself is used to start and stop the recording function. The associated LED is lit
during recording. The LED blinks fast when recording is paused.
When recording, the Mode button is used to pause or resume during record. (See Figure 47.)
Recording
Pause
Mode
Page
Scroll
Figure 47. LCD Display During Active Recording
The recording is automatically paused if call is placed on hold (e.g. using the Hold or Cnf/Trn
button). Hitting the Mode button to resume recording automatically reconnects the call. (See
Figure 48.)
Recording Paused
Resume
Mode
Page
Scroll
Figure 48. Display with Recording Paused
The appropriate changes to client interface occur when the Record or Mode button is used. For
example, the record toolbar icon changes to a pause icon. Conversely, the phone’s display and
button states change when recording is initiated from the client.
Release
The Release function disconnects the active call on the current PDN and returns the station to
internal dial tone or the call menu. The user gets internal dial tone if the active call is only call on
the device (PDN). The Release button returns the phone to the Call Handling menu if there are
any other calls on hold on the station. This button can also be used in some TUI menus, where
the phone is returned to dial tone.
Send to Voicemail
The Send to Voicemail (SVM) feature is typically used in conjunction with call screening.
Depressing the SVM button sends the call to the voice mailbox of a specified user. The system
announces “Enter an extension or press 411 for a name directory”. Simultaneously, the LCD
display on the phone show “Enter Extension:”. The user enters the extension of the target voice
mailbox. To send call to his own mailbox he must enter his own extension. The system will
announce “That extension does not exist” if the extension entered does not exist, otherwise
- 58 -
“Sending caller to voicemail of <name or extension>” is heard. The phone is then returned to
internal dial tone.
Speed Dial
Speed dial allows the user to assign a internal extension, external number, or arbitrary dial string
(such as a feature code) to a button. The server automatically dials that number or string and
connects the call to the user’s next available PDN.
The target address is specified when the button is configured in Tools>Options under
Phone>Feature Buttons (ViewPoint) or in the user’s properties under Phone>Feature Buttons
(Administrator program).
Figure 49. Speed Dial Dialog
A speed dial button can be used from idle (station automatically goes into speakerphone mode),
internal dial tone (call is placed using current PDN), during an active call (first available PDN is
used, active call placed on hold), and some TUI menus (e.g. phone page, but not logon prompt).
To set a particular button for the Speed Dial function, select the button in the Feature Buttons
dialog and choose Speed Dial in the Feature drop-down list box. Click the ” …” symbol to the
right of the Parameter field for that button. The Speed Dial dialog (Figure 49) will appear,
allowing you to specify a target address for the dialing function.
Choose Extension to dial an extension and select the desired user/extension in the drop-down
list.
Choose Phone number to dial an external telephone number or an IP address. Specify the
dialing service you wish to use to place the call.
Choose Direct Dial to assign an arbitrary sequence of DTMF digits to a button. The server will
process this string as if it was dialed from internal dial tone. This can be used to assign a quick
command or other command sequences to a button.
- 59 -
Examples:
*14300# Change Calling-as identity to the Call Center queue at x300.
*14#
Return Calling-as identity back to user
*57102# Monitor queue call currently being handled by agent at x102
##1234# Log on to system using current extension and password “1234”
*91103# Answer call ringing Extension 103
Take Call
The Take Call function operates similarly to the Take Call function in ViewPoint client. If there is
a single ringing call on the Toshiba telephone, pressing a Take Call button automatically takes
the phone off-hook and connects the user to that call. (If the telephone is already off-hook and on
an active call when an incoming call starts ringing, pressing the Take Call button has no effect,
though.)
If the user has call screening enabled, when the user picks up an incoming call and is presented
the call screening announcement, pressing the Take Call button connects the user to the caller
(in the same way as pressing the “1” key does).
If the user chooses Option 3 – Send to Voicemail and Screen in the Call Screening TUI menu,
and then wishes to retrieve the call from voicemail, he can do so by pressing the Take Call button.
New Features for Toshiba Stations
Personal Status Strata Buttons
A user assigned to a Toshiba station can assign flexible function buttons on his phone to change
his personal status. Unlike the DND button implemented in earlier versions of TeleVantage (and
still supported in Version 6.0, see Do Not Disturb on Page 57), the Set Personal Status function
toggles between Available and the personal status the user assigns to that key. For example,
the user might assign a key for the “In A Meeting” personal status. If the user is in Available
(Queue only) and then presses the key, his personal status is changed to “In A Meeting”. The
LED for that flexible button is then lit. If the user then presses the same key to move out of “In A
Meeting”, the LED goes dark, and the user’s new personal status becomes Available (not
Available (Queue only).
Changes to personal status made using these flexible function buttons are reflected in both the
TUI and in ViewPoint. The Extensions view displays the user’s new personal status, as does the
personal status field in the ViewPoint status bar.
Conversely, changes to personal status made from ViewPoint or from the TUI cause the
appropriate flexible button LED to light. For example, when the user is in Available, no LED on
his phone is lit. If he changes his personal status to “In A Meeting” using the ViewPoint client,
the LED for his “In A Meeting” flexible key lights up.
- 60 -
Any of the following system-defined personal statuses can be mapped to a flexible key:
•
•
•
•
•
•
•
Available (Non-queue)
Available (Queue only)
On Break
Do Not Disturb
In A Meeting
On Vacation
Out of the Office
Custom personal statuses cannot be mapped to a key. (The Available personal status also
cannot be mapped to a key.)
This feature is particularly useful for Call Center queue agents who do not use the ViewPoint
client.
Custom Speed Dials
TeleVantage 6.0 allows a flexible button assigned to the Speed Dial function to dial any arbitrary
sequence of DTMF digits. This “Direct Dial” function did not exist in previous versions of the
product. See Speed Dial on Page 59 for details.
Ringing Line Preference for Toshiba phones
TeleVantage 6.0 allows the user or an administrator determine if a call ringing an SDN on a
Toshiba telephone will be picked up if the user takes the telephone off-hook. See Pickup
Behavior on Page 46 for details.
- 61 -
Server Functions
Business Hours Enhancements
The business hours settings for TeleVantage 6.0 now allow a greater degree of flexibility when
specifying work hours. The interface now:
•
Allows multiple work hour time ranges per workday.
o Disjoint time ranges can specified as a comma-separated list:
10:00am – 5:00 pm, 8:00pm – 11:00pm
o Overlapping ranges are allowed: 10:00am – 5:00pm, 3:00pm – 6:00pm
•
Handles midnight correctly. Time ranges can start or end at midnight:
Monday, 12:00am – 6:00am or Wednesday, 8:00pm-12:00am.
Figure 50. Night Shift Business Hours
For example, in Figure 50, a set of business hours called “Night Shift” have been defined for a
group in the organization who start work at 11:00pm on weekdays and leave work at 7:00am the
following morning.
In previous versions of the product, the day started at 12:00am and ended at 11:59pm, and only a
single time range could be configured for each day.
A single range still cannot span midnight, for example: 8:00pm – 6:00am
- 62 -
Hold Audio Input Support
A new dialog has been added to allow administrators to manage the list of available music-onhold audio sources. The interface is found under the Audio > Hold Sources category in the
Tools > System Settings dialog of the Administrator program. The dialog presents a list of the
current audio sources configured on the system, allowing new ones to be added and existing
ones to be edited or deleted.
Figure 51. Audio Hold Sources List
Each audio source has the following fields (Table 9):
Table 9. Fields in the Audio Hold Sources List
Name
Required
Type
Required
Value
Required
Description
Optional
A simple string displayed in the drop down lists on other
dialogs. The string must be unique in the list
A dropdown list of source types. The value is either “Station”
or “Audio Input”.
A text string identifying the source location. This value is the
station number for a station port-based source and a board
number for a audio input jack type source. The value must
be unique within a particular type.
A longer description of the audio source, only displayed in
the list and the Add and Edit dialogs.
To edit or delete an existing audio source, highlight the desired source in the list and choose
either Edit or Delete, respectively. To add an audio source to the list, click on Add…. A dialog
box similar to that shown in Figure 53 appears.
- 63 -
Enter a unique name for this source in the Name field. The name appears as an available hold
audio source for auto attendants, Call Center queues, users, and other objects that can be
assigned custom hold music. (See Figure 52.)
Figure 52. Hold Music Control for an Auto Attendant
As in previous versions of TeleVantage, TeleVantage 6.0 supports hold audio sources connected
to analog station ports. (Hold audio can also be connected to a Toshiba station board using an
external adapter.) Station-based audio sources are assigned a value of “Station” for the Type
parameter. (See Figure 53.) When “Station” is selected, the value field holds the station port
number to which the audio source is connected.
Figure 53. Hold Audio Source Dialog for a Station-based Source
In addition, Version 6.0 supports hold audio connections to the audio input jacks on the DI/SIseries station boards and the DI/0408LSA-R2 PBX board. An audio source connected to one of
these dedicated audio inputs should be assigned a type of “Audio Input” (Figure 54).
Figure 54. Hold Audio Source Dialog for an Audio Input-based Source
- 64 -
In the Board number field, enter the number of the board with the audio input port. To determine
the board number for a particular board, count only your DI/SI and DI0408LSAR2 boards in order
of SC-bus or CT-bus ID. For example, if you have a DISI board at ID 4 and a DI0408LSAR2
board at ID 6, you would specify the DI0408LSAR2 board by entering 2. If you are using
geographical addressing (multiple boards are assigned to ID 0), the board numbers for those
boards are assigned in order of their PCI slots.
The controls for selecting music-on-hold (Figure 55) for auto attendants, users, and other objects
on the server that support this customization have been changed to a drop-down list showing the
names of the existing audio sources. A standard new/edit button (*) has been added next to each
list to allow for the addition of a new source or editing of an existing source.
Figure 55. Hold Audio Controls for an Auto Attendant
As a result of an upgrade, all existing hold audio stations will be converted into audio source
called "Station n" where n is the old station number.
- 65 -
Call Recording Reminder Beeps
TeleVantage 6.0 is capable of generating recorder warning tones during calls recorded by the
system either automatically or through the actions of a user. All the parties in the call will hear the
tone, and the tone will also appear in the call recording. The administrator can configure the
system to generate these “reminder beeps” during:
•
•
•
Calls recorded by a user (either using ViewPoint, the *16 telephone command, or a
Toshiba flexible button),
Calls recorded by a Call Center queue (using the agent or queue nth-call recording
features),
Calls recorded automatically through the system call recording feature,
Or any combination of the above. These options appear in the Tools>System Settings dialog in
the Administrator program, under Call Recording (Figure 56).
Figure 56. Call Recording Reminder Beep Controls
The administrator can customize both the characteristics of the tone and the interval between
tones. The tone is played from a VOX file. The name of the file containing the tone is specified
in the Artisoft\Server\CallRecordingBeepFile setting in the database, accessible through the
Advanced Settings Editor (on the Tools menu in the Administrator program). By default, the
system assumes the VOX file is located in the \vfiles\user directory on the TeleVantage server.
The interval between tones is controlled by the Artisoft\Server\CallRecordingBeepInterval setting,
also found in the Advanced Settings Editor. By default, the interval between beeps is 15s. If the
beep duration is greater than the beep interval, the server will automatically set the beep interval
to be equal to the beep duration plus 1s. The server caches the beep file to a buffer on startup to
reduce disk accesses. If the beep file or the beep interval is changed at runtime, the server will
stop generating tones immediately, load the new values, and then start generating tones.
- 66 -
By default, the beep is a 500ms 1400Hz tone. The default VOX file is called
StdCallRecordingBeep.vox. A second VOX file, ShortCallRecordingBeep.vox, with a 200ms
tone duration is also provided.
Whenever any reminder beep control is enabled, the system requires additional resources to
support conversion of the VOX file data into a audible tone and mixing of the tone with calls.
•
Whenever there is at least one call that requires reminder beeps being recorded on the
system, the server requires one voice resource to generate the tone. This single voice
resource is used for all calls needing reminder beeps system-wide.
•
For each call being recorded, the server must allocate a conference resource to mix the
tone with the call (even for two-party calls). If a conference call is recorded and reminder
beeps are enabled for the recording, the maximum number of parties that can be
included in the conference is reduced by one. (The recording beep audio stream counts
as a party in the call.)
Note: When reminder beeps are enabled, there may be a noticeable change in the volume of a
two-party call when recording begins and ends.
Dialogic Firmware Dump Automation
TeleVantage 6.0 is capable of initiating a dump of the firmware running on the Intel® Dialogic
telephony boards when a TeleVantage server error occurs or during a TeleVantage server
shutdown.
When this feature is enabled, if a Dialogic fatal error occurs, the server will stop with Exit Code
100. The watchdog process (tvwatch.exe) that runs on the server, in response to this error code,
exits. (When the feature is disabled, the watchdog process restarts the TeleVantage server
service when a fatal error occurs.) Upon exiting, the watchdog process calls an external program
that generates the firmware dump.
The operation of this feature is controlled primarily by registry keys located under the
key on the server. The values shown in Table 10
are used to enable and configure this function.
HKLM\Software\Artisoft\TeleVantage\Server
Table 10. Dialogic Firmware Dump Registry Values
Registry Value
ExitOnFatalDialogicError
Type
DWORD
ExitCode100
STRING
Description
Enables firmware dumps
1 - Enabled
0 - Disabled
Full path of the external dump
management utility
Default
0 (Off)
(SystemFilesPath)\TvDlgFatalError.exe
The only registry value that must be modified to enable this feature is ExitOnFatalDialogicError,
which should be created and set to “1”. The value of ExitCode100 is set by the server installer to
point to the TvDlgFatalError.exe program in the TeleVantage server base directory.
- 67 -
Table 11. Additional Registry Values for Dialogic Firmware Dumps
Registry Value
SystemFilesPath
LogPath
FatalErrorDumpApplication
FatalErrorDumpFile
Type
STRING
STRING
STRING
STRING
FatalErrorDumpPrefix
FatalErrorMaxDumps
FatalErrorReboot
STRING
DWORD
DWORD
Description
Directory path to the firmware dump application
Directory path for dump files
Name of the dump application
Name of the file produced by the dump
application
Filename prefix for firmware dump files
Number of dump files to keep on the server
Enable reboot of the server machine after
dump is complete
1 – Reboot
0 – Do not reboot
Default
(Set by server installer)
(Set by server installer)
TestDumpUD.exe
TestDump.txt
R4FDump
5
1 (Reboot)
More control over the processing of the dump files is available through the operation of the
registry keys listed in Table 11. SystemFilesPath and LogPath are used by the server and their
values are set by the server installer when TeleVantage server is installed on the machine
The remaining registry values are optional (assuming the provided TvDlgFatalError.exe program
is used) as the utility will assume the default values shown if the registry values are not present.
Figure 57. Shut down server Dialog in Administrator
The processing of the firmware dump proceeds as follows when using the default values. When
TeleVantage server exits with Error Code 100, the watchdog process calls TvDlgFatalError.exe.
This program calls another program (TestDumpUD.exe) which actually collects the firmware
dump and writes it to a temporary file. TvDlgFatalError.exe renames this temporary file to a file
name R4Fdumpn.txt. The program maintains the last m firmware dumps on the server, where m
is the value of FatalErrorMaxDumps, which is set to “5” by default. When the number of dump
- 68 -
files would exceed m, the oldest file is overwritten. After renaming the dump file,
TvDlgFatalError.exe checks the value of FatalErrorReboot. If the value is “1”, the server machine
is reset. If the value is “0”, the program exits without restarting the machine or TeleVantage
server.
TvDlgFatalError.exe also generates its own log file, TvDlgFatalError_n.txt. The TestDumpUD.exe
program generates log files named R4FDumpn.log. (Do not confuse this with the firmware dump
file, R4FDumpn.txt.) These files are found in the TeleVantage Server\Logs directory by default.
The Problem Report Wizard utility collects these files, if present, into its output file when run on
the server.
The same process occurs as the result of an administrative shutdown of the server if the
“Capture Intel Dialogic firmware dump” checkbox (Figure 57) is checked. See System
Shutdown Enhancements on Page 147 for more information on server shutdown options.
Toshiba Station Board Timeslot Allocation
In previous versions of TeleVantage server, Toshiba station boards are always assigned station
numbers above those of any MSI, DI/SI, or HDSI station board. The timeslots were placed at the
end of the SC-bus or CT-bus. (Each board requires 48 timeslots, 16 for stations and 32 for the
conference resources on the board.) For example, if a system running in SC-bus mode
contained two Toshiba station boards, the boards would be assigned timeslots in the range of
928 to 1023. With multiple Toshiba boards in the system, the board with the lowest PCI ID (PCI
slot) is assigned the lowest Toshiba station numbers and timeslots. Toshiba stations are
assigned timeslots by TeleVantage at application startup.
In TeleVantage 6.0, the TeleVantage server makes a call to a Dialogic driver function that
reserves a block of timeslots on the SC-bus or CT-bus. TeleVantage server then assigns these
timeslots to the Toshiba board devices. The block of timeslots is no longer arbitrarily placed at
the end of the TDM bus. Otherwise, the process and ordering of stations and timeslots is similar
to that of TeleVantage 5.0.
Drop Loop Current on Idle Station
TeleVantage 6.0 can be configured to provide positive far-end disconnect supervision to a thirdparty device attached to an analog station port. By default, when the far-end caller hangs up, the
server does not drop loop current to a station involved in the call. If the user at that station does
not place the telephone on-hook, TeleVantage plays internal dial tone to the station.
- 69 -
Figure 58. Phone Settings for a User
If the “Drop loop current when idle” checkbox in the Phone category of the user’s properties
(Figure 58) is checked, the TeleVantage server interrupts loop current to the station for a
specified period of time. This time period is specified in the “Drop loop current for _
milliseconds” control, also located on the Phone page. When the far-end caller ends the call,
the station goes to the “Pre-idle” state (as shown in Device Monitor) while the loop current to the
station is interrupted.
This feature is designed to facilitate the integration of third-party hardware connecting to
TeleVantage through analog station ports, such as voice mail systems, fax servers, public
address systems, and door-strikers. Many of these devices expect to see loop current interrupted
as a signal that the call is over. This feature may also be useful when connecting a TeleVantage
system behind another TeleVantage system (as the Dialogic analog trunk boards also expect
positive disconnect supervision).
For shared stations, if any user assigned to a station has this feature enabled, all calls to the
station are affected. The control is not available for users assigned to Toshiba station ports or
external stations.
- 70 -
Monitor, Coach, and Join Non-queue Calls
The monitor, coach and join features available for Call Center queue calls have been extended to
any call on the system. A user with the appropriate permissions can supervise (monitor, coach,
or join) the personal call of another user even if neither user is an agent in a Call Center queue.
There are three sets of controls that determine if a user can supervise the personal calls of
another user.
1. A set of controls for the user being supervised that determine if another user can
supervise the user’s calls,
2. A set of controls on Tools>System Settings>Security page that establishes system-wide
defaults for the controls described above, and,
3. A set of user permissions for the supervising user that determine if the user can
supervise another user’s calls.
The first set of controls (Figure 59) is located in the properties of the user whose calls will be
supervised. These controls determine if another user can supervise this user’s personal calls.
The “Personal calls can be monitored” control determines if another user can monitor this
user’s personal calls. Possible values are “Yes”, “No”, and “System default”. When set to “No”,
this user’s personal calls cannot be monitored by any user. If set to “Yes”, then another user,
with the appropriate permissions (see below), can monitor this user’s personal calls.
If the value of this control is “System default”, the value of the system-wide “Personal calls can
be monitored control” (see below) is used as the value for this user’s “Personal calls can be
monitored” setting.
The “Personal calls can be coached” setting determines if another user can coach this user’s
personal calls. If it has a value of “No”, this user’s personal calls cannot be coached by any
user. If set to “Yes”, then another user, with the appropriate permissions, can monitor this user’s
personal calls. This control can also be set to “System default”, in which case it inherits the value
of the system-wide “Personal calls can be coached” setting.
The “Personal calls can be joined” control determines if another user can join this user’s
personal calls. If it has a value of “No”, this user’s personal calls cannot be coached by any user.
If set to “Yes”, then another user, with the appropriate permissions, can monitor this user’s
personal calls. This control can also be set to “System default”.
(These setting do not affect an agent’s ability to supervise Call Center queue calls. Permission to
supervise Center queue calls are controlled by the settings of the queue.)
- 71 -
Figure 59. Personal Call Supervision Controls for a User
If the call involves multiple users, the call can be monitored if any one of the users
allows his calls to be monitored. By default, external parties can be monitored.
For join, a personal call can only be joined if all parties in the call have a value of “Yes” (either
explicitly assigned or inherited from the system default) for “Personal calls can be joined”.
For coach, any party in the call for which “Personal calls can be coached” resolves to the value
“Yes” can be coached. A party in the call that does not allow coaching cannot be coached.
External parties can be coached by default.
All three controls for a user can be set to “System default”. The value of the system default for
each control is configured in Tools>System Settings in the Security category (Figure 60). The
three system defaults can be set to either “No” or “Yes”, as desired.
- 72 -
Figure 60. Personal Call Supervision Controls - System Defaults
The third set of controls (Figure 61) are used to determine if a user can act as a supervisor and
monitor, coach, or join another user’s calls. Three new permissions appear in the Standard
group of user permissions, now found on the Security>Permissions page in Tools>Systems
Settings dialog:
•
•
•
Allow monitoring user calls
Allow coaching user calls
Allow joining user calls
Each of these permissions can have a value of either “Allow”, “Disallow”, or “Use roles”, as with
any other TeleVantage user permission.
The telephone commands *57, *58, and *59 can be used to initiate monitor, coach, and join
operations (respectively) for personal calls. The extension of the user whose call is to be
supervised is entered after the feature code and followed by the pound key.
By default, a supervisor (a user that is monitoring or coaching a call) is disconnected if the call
being supervised is transferred or parked and unparked by third party. This behavior can be
modified using the Server\DropMonitorsAfterTransferComplete parameter found in the
Advanced Settings Editor. The default value for this parameter is “1”. When set to “0”, a
supervisor remains with the until the call ends or a third party prohibiting supervision becomes a
party to the call. Note that a supervisor is always disconnected if the supervised user
leaves the call, or if a user who prohibits supervision enters the call.
- 73 -
Figure 61. Personal Call Supervision Permissions
Null Stations
There are several situations where a “dummy” station may be required. In particular, a Client API
application that performs call handling functions (such as parking or conferencing calls) may be
installed on the server. (An example of this is the TeleVantage Conference Manager.)
In such cases, a non-zero station number is required because the station alerting and call control
code is implemented in the station manager component of TeleVantage server. In previous
versions of TeleVantage, a “dummy” station required a physical station (or at least a station port).
TeleVantage 6.0 introduces the concept of a null station. A null station has a fixed (run-time
settable) hook state, and neither receives nor generates audio. Otherwise, from the point of view
of the server and client programs, it is indistinguishable from any other terminal type. Null
stations are an extension of external stations. (See External Stations on Page 75).
To configure a null terminal, first configure an external station in Tools>System Settings in the
General category. Then create a utility user to associate an extension with the external station.
Assign the external station number to utility user. In the Phone category of the utility user’s
properties, set the Destination field to a value of “None”.
- 74 -
The “Hook state:” control determines the fixed hook state of the null station mentioned above. If
this control is set to “On-hook” , the station appears to be always on-hook. Incoming calls will
ring the station as if it was an idle telephone handset. If the control is set to “Off-hook”, the null
station appears to always be off-hook. This is useful when combined with hands-free mode, as
the null station will always answer every call.
In the example mentioned above, a Client API application might use the extension and password
of the utility user to create a session on the server, and would then be allowed to perform call
control operations on calls directed to the utility user’s extension and null station.
External Stations
TeleVantage 6.0 introduces external stations, which allow the use of IP and PSTN telephones
with TeleVantage as if they were stations. This provides better support for remote and local
users using IP telephones.
Ordinarily, a user connecting to TeleVantage through a trunk encounters a number of limitations.
In particular, such a user is not able to use the ViewPoint client to control or initiate calls to his
external telephone. The station alerting and call control code is implemented in the station
manager component of TeleVantage server, and so many call control operations require the call
to be routed to a physical station port within the TeleVantage server.
An "external station" is a device that is connected to TeleVantage via an external network, such
as the Internet or the PSTN, but behaves as a station. The call from the external device is routed
over a trunk, the TeleVantage server associates this trunk call with a station ID, and the station
manager can then perform the same type of operations on the call that it can on calls to physical
station ports.
- 75 -
External stations can be statically-assigned by an administrator, or created dynamically. A
dynamically-create external station can be created by a user as part of the ViewPoint logon
process, or by the server, when an incoming call is routed to an external number.
Dynamic external stations do not count against the number of statically-configured stations.
Statically-assigned External Stations
Configuring statically-assigned external stations is done in two steps:
•
•
Specify the total number of external stations to add to the system.
Assign external station IDs to users and configure the stations’ properties.
In the “Tools > System Settings” dialog in the Administrator program, the “Number of external
stations” setting, found in the “Server” category (Figure 62), is used to specify the number of
statically-assigned external stations on the server. Enter the desired number of external stations.
Figure 62. Server Category of the System Settings Dialog
A range of station ID’s are then assigned to these external stations when the TeleVantage server
is started. Statically-assigned external station IDs begin where the physical station IDs end. For
example, if the TeleVantage server includes an DI/SI16-R2 board, with 16 station ports, and a
Toshiba station board, also with 16 stations, and the “Number of external stations” setting has a
value of “4”, then the external stations will have station IDs from 33 to 36, inclusive. (See Figure
63.)
- 76 -
Figure 63. External Station IDs in Device Monitor
Once the external station IDs are established on the server, they can be assigned to users, by
entering the external station ID into the “Station ID” field in the user’s properties. (See Figure 64.)
Figure 64. Station ID Setting for a User
If you assign the station ID of an external station to a user in this way, the Administrator program
then allow you to enter the type and external address of the external telephone, and configure
other options for the external station. These settings are found under the “Phone” category in the
user’s properties (Figure 65).
- 77 -
Figure 65. External Station Settings for an External Number
The Destination field is used to set the external station’s device type. The possible values are:
•
•
•
•
•
External Number
Generic H.323 Device
Intel PBX-IP Media Gateway
Uniden IP Phone
None
Use “External number” when the user’s calls shall be routed to a telephone number on the
PSTN. Select the dialing service the server should use to allocate a trunk on which to route
connections to the terminal in the “Call using” list box. Specify the telephone number the server
should dial on the trunk to connect to the external device in the “Number” field.
TeleVantage recognizes the DTMF sequence “** “ (two asterisks) on a trunk as a flash signal. In
order to detect DTMF signaling on a trunk, TeleVantage must have a voice resource monitoring
the audio on the trunk. If the “Interpret ** as flash” checkbox is checked, the server will allocate
a voice resource for any call originating from or routed to this external station. This uses a voice
resource from the shared pool for the duration of the call. A change to the state of this control
takes effect the next time the station connects to the server.
A user may find that when he hangs up his external station and then immediately places
a new call using ViewPoint, their phone does not ring to connect them to the call. In some cases,
there is a delay between the time the external station goes on-hook and the time the telephone
network signals the disconnect to the TeleVantage-end of the call, so the server sees the external
station as still off-hook. When “Disconnect when idle” is checked, the TeleVantage server
disconnects the trunk immediately whenever it detects either side of the call hang up..
- 78 -
Figure 66. External Station Settings for an IP Terminal
For IP phones or terminals, use the “Generic H.323 Device” choice, unless, of course, the user
has a Uniden IP300 IP handset or is attached to an Intel PBX-IP Medial gateway. These two
devices have features for which TeleVantage 6.0 has special support.
The Hold button function is supported on the Uniden IP300 and Intel PBX-IP Media Gateway
phones. However, after placing a call on hold using the button on the phone, the user cannot
take it using ViewPoint, but must rather do so using the telephone’s button. The message waiting
indicator on these two types of devices are also supported.
For IP telephones with multiple line appearances, only one line appearance can be associated
with an external station at a time. For example, if a user places a call on hold using the Hold
button on a Uniden IP300, and then presses another line appearance button, TeleVantage treats
the call from the second line appearance as a trunk call, not as an external station call.
Automatic update of External Station Address for an IP Telephone
TeleVantage 6.0 can be configured to automatically update the IP address assigned to an
external station when the station is used to connect to the TeleVantage server. For this to occur,
the IP telephone must be capable of storing and sending the log on information for the user to the
server when the station goes off-hook. If the IP address of the terminal logging on to the server
does not match the IP address for the external station, the server can automatically update the IP
address stored for the external station to the IP address of the currently logged-on terminal. To
enable this feature, check the “Automatically change address to location of last logon” checkbox
shown in Figure 66.
- 79 -
Null Stations
A utility user might be assigned a value of “None” in the Destination field for an external station.
This allows the administrator to create a “null station” that has a fixed hook-state. See Null
Stations on Page 74 for a more detailed discussion of null stations.
Dynamically-created External Stations
External stations can be used by roaming users who are not assigned to one of the pre-defined
external station numbers. During ViewPoint logon a user can specify their location as a remote
number. Specifying a remote number when logging into ViewPoint allows the user to initiate and
control outbound calls (from the user’s remote phone) with ViewPoint using that remote phone,
just as for a statically-assigned external station.
However, without additional configuration, calls to the user routed to the external telephone
(through call forwarding or the actions of a routing list) are still handled by TeleVantage as
external trunk calls, and the user has no control of the call within ViewPoint. The user can
configure TeleVantage to dynamically create an external station for the call when it routes it to the
external address. This option is located under the “Phone” category of the Tools>Options dialog
in ViewPoint. When this option is enabled, TeleVantage creates an external station for each
remote number in the user’s routing list. If the user is currently logged on to the client application
at one of those numbers, the incoming call can be manipulated in ViewPoint.
Just as statically-assigned external station have station ID, so do these dynamically-created
external station. The server assigns station IDs greater than “16386” to these external stations.
(These temporary station IDs might appear in the server logs or workstation applications.)
Delayed Connection
When TeleVantage uses analog or robbed-bitT1 trunk to ring an external station, it uses
combination of timers and call progress analysis to determine the state of the connection. After
call is placed over analog or robbed-bit T1 trunk to an external station, TeleVantage performs call
progress analysis and, if the analysis does not result in a certain connect or failure within a
certain time, a connect is assumed. This prevents situations in which the called party answers a
call but the call is not connected end-to-end because the server is still waiting on the call progress
analysis.
This behavior has the following implication when the external station is being alerted from within a
routing list. If the user does not have call screening enabled, the caller and called party are
connected after expiration of the timeout mentioned earlier. The caller will hear an alert tone, and
is able to interrupt the call and go to the next node in the routing list by pressing “#” key. This will
be useful in the scenario where the external station does not answer, or if an answering machine
or external voicemail system answers the call.
Further, when using ViewPoint to play or record audio (such as a voice message), there may be a
slight delay before the operation begins, as the server must wait until either the call progress
analysis completes or the timeout expires before starting the playback or recording.
- 80 -
Associating a Call with an External Station
There are three ways incoming trunk calls are associated with external stations.
For IP stations, there are two different methods of association. If the IP terminal supports private
line automatic ring-down (PLAR), the device can be configured to send the extension and
password of the user to TeleVantage when the phone goes off-hook. If TeleVantage receives a
connection from an IP telephone with these credentials, and the user for that extension is
assigned to an external station, the server associates that connection with the external station. If
the IP telephone does not support PLAR, or is not configured to send the PLAR logon string,
TeleVantage checks the IP address of the inbound call. If it matches an IP address of one of the
external stations defined on the server, it will automatically associate the call with the external
station and play internal dial tone to the caller.
The second way to associate a trunk call with an external station is to use the *17 feature code.
The user call into the server, navigates to a logon prompt, and logs on to the TeleVantage server
as a user assigned to a statically-assigned external station. Then navigate to internal dial tone
(typically by pressing “#”) and enter “*17”. The call is then associated with that user’s external
station. The association between a trunk call and an external station ends when the trunk call
disconnects. The association is identified in the Status field of the Device Monitor. (See Figure
67.)
Figure 67. Device Monitor with External Station-Trunk Association
Note that at most one trunk call can be associated with an external station at the same time. This
limitation may appear in complex situations where multiple calls are active. For example, if there
is a currently ringing call to an external station, and simultaneously the user attempts to associate
a trunk call with that same station using the *17 feature code, the association will fail.
- 81 -
Call Log Entries
Calls that involve external stations appear in the call logs as internal calls with corresponding
station IDs.
Ring Cadences
The ring cadences on external terminals are not controlled by TeleVantage. Even if an external
terminal has the ability to set specific ring cadences, this will be out of control of TeleVantage.
This means, for example, that the ring cadence for incoming calls will be the same as the ring
cadence for hold recall.
Call Waiting on External Stations
A user that has call waiting enabled for his extension will hear the call waiting alert tone when his
external station is in use and another call attempting to connect to his external telephone.
Sometimes it is desirable to modify the properties call waiting tone played. As with the call
waiting tones for local station ports, the call waiting tone for external stations is defined in the
Windows registry, under the following key:
[HKEY_LOCAL_MACHINE\SOFTWARE\Artisoft\TeleVantage\Server\EXTBoard1\ZipTone]
"Frequency"="1250"
"Amplitude"="-23"
"Duration"="50"
Where:
•
•
•
“Frequency” is the frequency of the tone in Hz.
“Amplitude” is the amplitude of the tone in db
“Duration” is in 10ms units, so that “50” corresponds to 500ms
Upgrading Existing IP Telephone Users to External Stations
TeleVantage 6.0 provides a special feature to facilitate the conversion of users with IP
telephones to statically-assigned external stations. This feature accessed through the “Upgrade
Remote Phones” menu choice on the Tools menu in the Administrator program.
- 82 -
Figure 68. Upgrade Remote Phones Item in the Tools Menu
In previous versions of TeleVantage, an IP telephone user was typically assigned a station ID of
“0”, indicating the user was not using a local station port on the server. The “Upgrade Remote
Phones” feature (Figure 68) identifies all the users on the system with both a station ID of “0” and
with the “Using a VoIP phone” control checked. In the “Upgrade Remote Phones“ dialog box
(Figure 69), the names of all such users appear. Next to each name is an action drop-down list
box. The administrator can assign an external station to the user by choosing from the available
external station IDs in the list box. The change takes effect when the dialog box is dismissed by
hitting the OK button. When a remote phone is “upgraded” in this fashion, the user’s station ID is
changed from “0” to the one specified for the user, and the user’s call forwarding is turned off.
Figure 69. Upgrade Remote Phones Dialog
- 83 -
Reserve Station Licenses for IVR Plug-ins
Through the Administrator program, a specific number of station licenses can be reserved for use
by IVR plug-ins. The desired number of reserved licenses can be specified through the “Reserve
_ station licenses for calls involving IVR Plug-ins” control. This control is located in
Tools>Systems Settings, on the Licenses>Reserved page (Figure 70). The default value for
this control is “0” (zero). If a non-zero value is entered, the number of stations available for
assignment to users becomes the total number of station licenses on the system minus this
number.
Figure 70. Licenses > Reserved Category in System Settings Dialog
The maximum value that can be assigned to “Reserve _ station licenses for calls involving
IVR Plug-ins” is equal to the total number of station licenses on the server minus the number of
unique station IDs currently assigned to users on the system. If an attempt is made to assign a
larger number to this setting, the Administrator issues a warning “This would exceed your
licensed number of stations. You are currently licensed for n stations and m are already in use.”
For example, if this setting is set to 10 on a system with 15 station licenses and 5 stations are
already assigned to users on the system, then when the administrator attempts to assign an
unassigned station ID to a user, the Administrator program issues the error '“This would exceed
your licensed number of stations. You are currently licenses for 15 stations of which 5 are in use
and 38 are reserved.”
- 84 -
Customizable Locations for Database Files
Both the TeleVantage Administrator program and the server installer allow the user to specify the
locations of the TeleVantage database files. The location of the database file (TVDBDEV_5.DAT),
the transaction log file (TVLOGDEV_5.DAT), and the database backup file (TVDB.DMP) can
each be specified through the controls under the Storage > Special Directories category of the
Administrator program’s Tools > System Settings dialog (Figure 71).
Figure 71. Special Directories Category of the System Settings Dialog
The current directory in which the database, transaction log, and backup file resides is shown in
the corresponding text box. To move any of these files, select the “Move…” button adjacent to
the file path to be altered. The interface allows the files to be moved to any local partition. The
TeleVantage server must be shut down to move database or transaction log file locations.
For new installs of TeleVantage 6.0, the location of the database, transaction log, and backup file
can be specified as part of the installation process. See Installing TeleVantage, Page 11-3.
Voice Message Archiving
TeleVantage Version 6.0 adds facilities to archive voicemail messages and call recordings for
one or multiple users, and manage these archives.
Automatic Archiving
Administrators can configure the server to transfer voicemail messages and call recordings from
one or more users’ mailboxes to an archive. The settings for archiving are found in the
Tools>System Settings dialog of the Administrator program, in the Recordings>Archive
- 85 -
category (Figure 72) . When the “Archive recordings daily” checkbox is checked, messages
and recordings are moved from the database and voice files directory to the archive each day.
Figure 72. Recording Archive Controls in the System Settings Dialog
The archive feature moves a recording to the archive after it has been on the system for a
specified number of days. The number of days a recording remains on the server is set using the
“Archive voice mail older than _ days” control.
When recordings are moved to the archive, the administrator can choose to leave them in their
native VOX format or have the server convert them to the more space-efficient WAV format.
Choose between these two options by setting the “Archive audio format” control to either “VOX”
or “WAV”.
The “Archive location” field displays the location to which the archived files are moved. To
change the location, click on one of the icons next to the control’s text box. Use the left icon to
select a folder on the server. Use the right icon to select a location on the network Note the
service account for the MSSQL Server Service on the TeleVantage Server must have sufficient
permissions to access the specified location. Changes require both the TeleVantage Server and
MSSQL Server services to be restarted to take effect. The default location for the archive is the
\Voice Mail Archive share created on the server machine by the server installer. The default file
path for this share is \Program Files\TeleVantage Server\Voice Mail Archive.
The “Archive the following mailboxes” list shows the users whose voice mailboxes will
be automatically archived. To add or remove a user, click “Change”. The “Select Mailboxes To
Archive” dialog box (Figure 73) is displayed.
- 86 -
Figure 73. Select Mailboxes To Archive Dialog
Users in the “Selected mailboxes” list will have their mailbox recordings automatically
archived. Use the Add and Remove buttons to modify the list. Click OK to return to
the Archive category page.
To change which of a user’s mailboxes are archived, click the value in the Folders column
(Figure 72) for that user. From the drop-down list select one of the following:
•
“Inbox only” - Only messages in the user’s Inbox are archived.
•
“All folders except Deleted” - All the user’s messages are archived except for those in
the Deleted folder, including custom folders.
Manual Archiving
To perform an ad-hoc archive operation on a single user’s mailbox recordings, right-click on the
user in the Administrator program’s Users view (Figure 74) and select “Archive Voice Mail…”.
- 87 -
Figure 74. Archive Voice Mail Shortcut Menu Choice
The Archive Voice Mail dialog box (Figure 75) appears, allowing the administrator to specify the
folders to archive, and the recording age, and audio format to use in the archive operation. The
“Options…“ button displays the Tools > System Settings > Recordings > Archive category.
Figure 75. Archive Voice Mailbox Dialog
The recordings are sent to the path specified in “Archive location” discussed earlier.
The archive itself is a directory containing an top-level index file (Index.xml) and one or more
subfolders, one for each mailbox in the archive. The index file is simply a list of mailbox names
and corresponding subfolder names. Each subfolder contains the recording files a single mailbox
and an archive index file (Archive.xml), which contains the details of each recording.
TeleVantage Recording Browser
The TeleVantage Recording Browser program (Figure 76) allows a user or administrator to view a
list of recordings contained in an archive and play them. The program is installed TeleVantage
- 88 -
Workstation Setup program. (This is the same program used to install ViewPoint on a
workstation.) See Installing TeleVantage, Page 13-4 for more details.
The program can be started by choosing the “TeleVantage Archived Recording Browser”
shortcut in the “Artisoft TeleVantage” program group of the Windows Start menu.
Figure 76. TeleVantage Recording Browser
The browser opens to the last archive opened. To open an archive, choose “View another
archive …“ in the File menu, navigate to the location of the archive directory on the network,
select it, and choose OK.
The “Archived mailboxes” list shows all the mailboxes contained in the archive. Click on a
mailbox to display the recordings contained in that mailbox’s archive.
The “Recordings” list enumerates all the voicemail messages, call recordings, or greetings in the
selected mailbox’s archive, along with details. To play a recording, select the recording and click
on the Play button. Double-clicking a recording will also start playback. The program uses the
local machine’s sound card and speakers for playback. (The Recording Browser has no option to
play audio over a TeleVantage-attached station.) The Stop, Rewind, Forward, and Pause
buttons, and slider bar controls for audio operate in the same manner as those found in the
ViewPoint client.
To display the details of a particular recording, choose “Open Call Details … “, which displays
the Call Details dialog (Figure 77) for that recording.
The “Restore Recording” menu item will remove the selected recording from the archive and
restore it to the user’s TeleVantage mailbox.
Both options are found in the Tools menu, or on the shortcut menu, displayed by right-clicking on
the recording.
- 89 -
Figure 77. Call Details Dialog
A recording can be deleted from the archive (without restoring it to the user’s mailbox, by
highlighting the recording and choosing “Delete” on the Edit menu.
Dial a Voice Mailbox Directly
TeleVantage 6.0 can be configured to allow callers to dial a voice mailbox directly without ringing
the owning extension. The caller can enter the mailbox owner’s extension followed by “*” at
internal dial tone or at an auto attendant. The server immediately transfers the caller to that
extension’s voice mailbox without invoking any routing list actions (for a user) or queuing the call
(for Call Center queues). If the user or queue has no mailbox or the mailbox is full, an error
message is played to the caller. Otherwise, the caller hears the user’s or queue’s default mailbox
greeting.
To enable this feature, check the ”Allow callers to directly leave a voice mail” control in the
Administrator program, found in the Tools > System Setting dialog under the Server category.
(See Figure 78.) Enabling this feature cause an additional (3 second) delay in the inter-digit
timeout for dialing extensions, as the server now must wait for a possible “*” character following
any extension dialed.
- 90 -
Figure 78. Server Category in System Settings
Default Flash Behavior
In previous versions of TeleVantage, when a user performs a flash while in an active call, the
server played the Call Handling menu: “To transfer, press 1. To send to voicemail, press 2….”.
In TeleVantage 6.0, this is still the default behavior. However, the administrator can reconfigure
the server to return the user to internal dial tone instead of playing this menu.
The “Default flash behavior while in a call” control in Tools > System Settings, under the
Server category (Figure 78), can be set to either “Menu assisted transfer” or “Direct transfer”.
When “Menu assisted transfer” is selected, the server responds to flash in a call with the Call
Handling menu. When “Direct transfer” is selected, the server returns the user to internal dial
tone. This is a system-wide default for all users.
With the direct transfer option:
•
A flash on an analog station brings the user to “direct transfer” dial tone.
•
If the user flashes again, he is reconnected to the call on hold. If the station goes onhook after the first flash (at “direct transfer dial tone”), the caller is put on hold.
•
If the station is on-hook and the user has a call on hold, he can go off-hook and flash.
The server plays the Call Handling menu, allowing the call to be reconnected.
Trunk-based calls (such as to external stations) are always presented the Call Handling menu,
regardless of any system-wide or per-user setting for direct transfer.
- 91 -
An administrator can customize the flash behavior for a individual user. The behavior for a
particular user is set on the Phone category of the user’s properties in the Administrator program
(Figure 79), using the “Flash behavior while in a call” control. The possible values for this
control are “System default”, “Menu assisted transfer” and “Direct transfer”. If the control is
set to “System default”, the user’s flash behavior is controlled by the system-wide setting
discussed earlier. If it is set to either of the other values, the system-wide default is ignored.
Figure 79. Flash Behavior Controls for a User
Park/Hold Ring Back Behavior
The ‘Park/Hold ring back” setting controls what happens when a user answers an automatic
ring back resulting from a call left parked or on hold beyond the ring back timeout. This control is
located in the “Tools > System Settings” dialog in the Administrator program, under the Phone
category (Figure 78). It can have two possible values: “Announce” and “Direct connect”.
Choose Announce to have TeleVantage announce the caller.
Choose Direct connect to have the user connected immediately with the caller.
MSDE SA Password
When installing or upgrading TeleVantage server, the Installer prompts the administrator for a
new SA password or database engine if the existing password is blank or set to the Artisoftdefault secure password (set by the TeleVantage 5.0 installer). The new password cannot be
blank.
- 92 -
SMTP Support for Email Notifications
Figure 80. E-mail Notification Settings in Tools > System Settings
TeleVantage 6.0 includes built-in support for sending email notifications using the Simple Mail
Transport Protocol (SMTP). In previous version of TeleVantage, a server must have Microsoft’s
MAPI subsystem installed and configured for email notification to be enabled. Email notification
messages were sent using these MAPI services.
In TeleVantage 6.0, an administrator can choose between using MAPI or the new SMTP
implementation by setting the appropriate value for the “Send email notification using” control,
found in the Administrator program, in the Tools > Server Settings dialog (Figure 80), on the
Email Notifications page. The possible values for this The default value is MAPI.
Changes in this control requires a restart of the TeleVantage server to take effect.
Choose MAPI for the legacy behavior. TeleVantage uses the transport services defined in the
default MAPI profile of the interactive user logged on to the TeleVantage server console. For
upgrades, if the server is already configured for email notification and/or synchronization and this
approach is working, selecting MAPI allows your server to continue to operate in this manner –
no additional configuration is required.
Choose SMTP to configure TeleVantage to communicate directly with an email server using
SMTP. TeleVantage connects to the email server specified in the SMTP server field, on the
TCP port specified in the Port field.
Sender name and Sender address are the name and email address sent as the From: field
information in the notification email.
If the email server requires clients to authenticate in order to relay, check SMTP server requires
authentication. Enter the username and password required to authenticate on the relay server.
- 93 -
Trunk Configuration
Delayed Answer
In TeleVantage 5.0 and previous versions, the server always “answered” an incoming call
immediately after it appeared on the trunk.
In TeleVantage 6.0, the administrator can enable “delayed answer” on some or all trunks. When
“delayed answer” is enabled, TeleVantage will not answer an inbound network call until one of the
following happens:
•
•
•
•
The call is routed to a station, and the station answers the call. (If caller announcement
is on, the recipient of the call must “1” to accept the call.)
The call is routed to an external number (e.g, via call forwarding, or RL node) and the
external destination answers the call. (If caller announcement is on, until recipient of the
call presses “1” to accept the call)
TeleVantage plays a prompt to the trunk caller, such as a auto attendant welcome
greeting or a voice mailbox greeting.
TeleVantage plays dial tone to the trunk caller, such as in the case for an IP telephone
user assigned to an external station.
If none of the above happens before TeleVantage disconnects the inbound network call, for
example, as the result of a “Hangup” action in a user routing list or Call Center queue redirection,
the call will be disconnected and the network is sent a specific disconnect reason. The value of
this reason is determined by the last connection target within TeleVantage: a station, an external
number, or Call Center queue, as follows:.
•
•
•
If the last connection target was a station:
o If the station has not answered, or the user declined the call, TeleVantage will
disconnect the network call. On networks that support it, the server also sends
the reason “normal clearing”. (RELEASE COMPLETE, Disconnect Cause 16)
o If the station is busy (for example, in another call with call waiting disabled),
TeleVantage will disconnect the network call with the reason “busy”.
If the last connection target has was external number:
o If connection timeout expired, TeleVantage will disconnect the inbound network
call with the reason “normal clearing”.
o If connection to the external number failed due to some specific reason caused
the external network, TeleVantage will propagate that reason when
disconnecting the inbound network call. For example, if connection to the
external number failed due to destination number being “busy”, TeleVantage will
disconnect the inbound network call with the reason “busy”.
If the last connection target was a Call Center queue:
o If the queue is closed, TeleVantage will disconnect the network call with the
reason “rejected”.
o If the queue is too busy, TeleVantage will disconnect the network call with the
reason “busy”.
o If the call has exceeded maximum wait time for the queue, TeleVantage will
disconnect the network call with the reason “busy”.
On analog, TeleVantage delays closing the loop until the station, queue, or external target picks
up. The far-end caller hears ring generated by the far-end switch until TeleVantage answers the
call by closing the loop.
- 94 -
On ISDN networks, a delayed answer means TeleVantage does not send a CONNECT message
until the call is considered answered. If the call is not answered, TeleVantage disconnects the
call by sending a RELEASE COMPLETE with the appropriate disconnect cause code, given
parenthetically above. The TeleVantage server will send ALERTING messages while ringing a
station, queue, or external destination.
Figure 81. Delayed Answer Controls for a T1 ISDN Span
The behavior is enabled using the “Connect inbound calls” controls in the Administrator
program. The controls for ISDN, robbed-bit T1, E1 CAS, and IP trunks are located on the
General tab of the properties of each span. (See Figure 81.) The control for analog trunk
delayed answer is located under Tools>System Settings>Analog Trunks. This single setting
controls the behavior of all analog trunks.
The “Connect inbound calls” control has two possible values:
•
•
Immediately when received
When answered or handled
A setting of “Immediately when received” means the trunk will answer the call when it arrives.
Choosing “When answered or handled” means the trunk will delay answer to the network as
describe earlier.
After an upgrade, analog and robbed-bit T1 trunks are set to “immediately when received”, and
all other trunk types default to “When answered or handled”.
- 95 -
ISDN Setting Changes
TeleVantage 6.0 has eliminated many of the settings that appeared in the Tuning tab of ISDN
spans, and added a number of new settings. The layout and operation of the Tuning tab controls
(Figure 82) has not changed significantly.
Figure 82. Tuning Tab for an ISDN T1 Span
T
The following settings now appear in the Tuning tab:
Alternate Called Number plan
This setting is the numbering plan used for numbers that begin with Alternate Called Number
prefix. The default value is “ISDN”.
Alternate Called Number Prefix
If a called number begins with this prefix, the number will be dialed without the prefix and with the
Alternate Called Number plan and Alternate Called Number type instead of the default plan and
type. The default value is blank.
- 96 -
Alternate Called Number type
This setting is the number type used for numbers that begin with Alternate Called Number prefix.
The default value is “International”.
Set in service on startup
This setting determines the signaling sent by TeleVantage server to the network when the server
starts and shuts down. If set to “Yes”, TeleVantage places the trunks in this span in service
during server startup and take them out of service during shutdown. If this setting is set to “No”,
the server does not perform these operations. Setting the value of this setting to “No” can
decreases the time required to start up the server when connecting to some types of ISDN lines
that do not respond to the in-service signaling. The default value is “Yes”.
Called Party Number Default Plan
This setting is the Q.931-defined Called Number Plan passed to the network in the SETUP
message. The default value is “ISDN”.
Called Party Number Default Type
This setting is the Q.931-defined Called Number Type passed to the network in the SETUP
message. The default value is “National”.
DNIS wait time
The DNIS wait time is a numeric value specifying the maximum amount of time to wait for the
FACILITY message carrying the DNIS information to arrive after receiving a SETUP message for
a call. This setting is ignored unless “Overlapped DNIS” is set to “Yes”. The value is in
milliseconds and the default is “2000”.
Dump call info
Dump call info enables logging of raw call-event information elements from E1 and T1 trunks
(ISDN PRI, robbed-bit, E1 CAS) in the TeleVantage Server logs. When set to “Yes” this detailed
information is included in the logs. When set to the default value of “No”, the information is not
logged.
Facility feature or service
This setting specifies a special feature or service that TeleVantage should request from the
network when placing an outbound call on the span. The default value is “Default”.
Facility feature type
This setting specifies if a facility request sent by TeleVantage to the network is a facility request
or a service request.
- 97 -
Handle disconnect with audio
This setting is used to disable audio cut-thru when TeleVantage receives a DISCONNECT
message with a Progress indicator suggesting a trunk message for the call is available on the Bchannel. Setting this parameter to “Yes” enables audio cut-thru after receipt of an appropriately
formed DISCONNECT message. This is the default value. Setting this parameter to “No”
disables the feature. TeleVantage server immediately hangs up the call when it receives a
DISCONNECT message without connecting audio end-to-end.
Minimum length of DNIS
This setting specifies the minimum number of DNIS digits the server must receive before
processing the call. The default value is “0” (zero).
Overlapped DNIS
The “Overlapped DNIS” setting indicates if the span receives overlapped DNIS from the network.
(If so, DNIS will appear in a FACILITY message received after the initial SETUP message for the
call.) If set to “Yes”, then the span is configured to receive overlapped DNIS. If set to “No”, the
server does not expect to receive overlapped DNIS on the span. The default value is “No”.
Send call proceeding
If the span has delayed answer enabled , this setting controls the server when to send the CALL
PROCEEDING message for an incoming to the network. If set to “Yes”, the server send CALL
PROCEEDING immediately after receiving SETUP message. The default value is “No”.
Two B channel transfer supported
If the value of this setting is “Yes”, this indicates the span supports two B-channel transfer. If set
to “No”, TeleVantage will not attempt a two B-channel transfer on the span. The default value is
“No”. See Two B-channel Transfer for NI2 on Page 105 for more information.
Device Monitor and Trunks View Enhancements
TeleVantage 6.0 includes several improvements to the Trunks and Device Monitor views that
make it easier to create trunks and assign users to stations.
The Device Monitor view (Figure 83) in the Administrator program gives the user the ability to
create users and trunks on the currently selected device. The Station section has a "Create
User" option displays the "New user" dialog with the station set to the currently selected station.
Since stations can be shared this is always enabled.
- 98 -
Figure 83. Device Monitor View in Administrator
The Trunk section has a "Create Trunk" option that will bring up the appropriate "new" dialog for
the current trunk. This option is disabled if a trunk already exists on the device. For spans this
will open the span dialog with the data defaulted to create the right span to include the currently
selected trunk. Even if the trunk is in the middle of the span the initial trunk will be set correctly.
Figure 84. Trunks View in Administrator
- 99 -
The Trunks view (Figure 84) displays all the trunk devices detected by the server at the last
startup. Devices installed on the server which have not been configured in the Trunks view
appear as trunks of the proper type, but are displayed in a light grey font. Only the trunk number
and type are displayed for these unconfigured devices. The "New Trunk" submenu has a new
choice called "Automatic" that will automatically create a trunk or span of the proper type for the
selected device.
Conferencing using Selected IP Trunk Boards and a Host-based Stack
The DM/IP241-1T1-P100 and DM/IP301-1E1-P100 IPLink boards can, when appropriately
configured, simultaneously support both voice-over-IP and conferencing. If the TeleVantage
server is configured to use a host-based stack (split call-control), then sufficient DSP processor
time is made available to support 30 conference resources on each of these boards. To use
these boards with a host-based stack, the PCD file shown in Table 12 below should be assigned
in DCM.
Table 12. IP Trunk Boards Supporting Conference
Board
DM/IP241-1T1-P100
PCD File
@ipvs_evr_isdn_5ess_ml11_311.pcd
DM/IP301-1E1-P100
@ipvs_evr_isdn_net5_ml11_311.pcd
Dialogic GlobalCall IP With Split Call Control Support
TeleVantage 6.0 supports split call control when using a host-based H.323 stack with supported
Dialogic IPLink boards or the DI/0408-LSA Rev 2 board.
Embedded and Host-based H.323 Stacks
Simplistically, there are two major components to the H.323: call control processing and audio
processing. In previous versions of TeleVantage, the H.323 protocol stack was implemented
entirely on the IP trunk board. Both call control and audio processing occurred entirely on this
“embedded stack”.
In TeleVantage 6.0, it is now possible to split the call control processing and the audio processing.
The audio processing remains on the IP trunk board. However, the call control processing can
now occur either on the IP trunk board or can run on the host machine. The later is called a
“host-based stack”, because much of the protocol processing is performed by the host machine’s
processor.
In both host-based and embedded stack configurations, the audio processing is performed by the
digital signal processors on the IP trunk board. The available processing power on the Dialogic
board is divided into “RTP resources”, which always reside on the IP trunk board. RTP stands
for Real-time Protocol, the underlying transport mechanism H.323 terminals use to exchange
audio.
Call control information is transferred between H.323 terminals separately from the audio. When
an H.323 call is set up, the far-end terminal sends protocol packets to the destination terminal to
- 100 -
initiate the call. As part of the call setup process, the near-end terminal tells the far-end which IP
address to communicate with for the audio (RTP) connection.
Using an embedded stack, all connection required to support H.323 traffic are made using the
Dialogic board’s on-board Ethernet interface. With a host-based stack, the call setup and call
control connection is made to the host machine’s NIC, while the audio connection is still made
through the Dialogic board’s Ethernet interface.
IP trunk cards require a statically-assigned IP address. They do not support DHCP, and cannot
participate in the various dynamic name-address binding mechanisms implemented (Dynamic
DNS, WINS) on most networks. Using a host-based stack, the administrator of a TeleVantage
server can work around these limitations in the IP trunk boards. Call control processing occurs on
the host machine, and the host-based stack uses the host’s network interfaces to communicate
with the far-end terminal. With a host-based stack, the administrator can arbitrarily group or
divide RTP resources amongst one or more call control IP addresses. This is the main advantage
to a host-based stack, as this arrangement provides great flexibility in assigning IP addresses to
IP trunks.
The disadvantages of using host-based stacks include:
•
As the host machine’s processor is now performing the work, more host resources must
be provided to support the same number of IP trunks. This could mean the host machine
running a host-based stack might require a faster CPU or more RAM than the same
configuration running an embedded stack.
•
There is less isolation between the H.323 connection to the remote machine and the
operating system. Failures in the processing of H.323 traffic can potentially result in an
application error that might affect the operation or performance of the host machine.
The boards in Table 13 support the split call control under SR 5.1.1 FP1:
Table 13. Dialogic Boards with Support for Host-based Stacks
Board
DM/IP241-1T1-P100
DM/IP301-1E1-P100
DM/IP481-2T1-P100
DM/IP601-2E1-P100
DM/IP241-1T1-P10
DM/IP301-1E1-P10
DI/0408LSA-R2
PCD File
@ipvs_isdn_5ess_ml11_311.pcd
@ipvs_evr_isdn_5ess_ml11_311.pcd
@ipvs_isdn_net5_ml11_311.pcd
@ipvs_evr_isdn_net5_ml11_311.pcd
@ipvs_2isdn_5ess_311.pcd
@ipvs_2isdn_net5_311.pcd
@ipvs_isdn_5ess_307.pcd
@ipvs_isdn_net5_307.pcd
@DI0408LSA_REV2_ML3.pcd
@DI0408LSA_REV2_ML5.pcd
Configuring IP Boards for Host-based Stack
When configuring the Dialogic board in DCM, select a firmware file for the board that supports
host-based stack. Examples are given in Table 13.
In the Administrator program, an Internet span is created. The properties of the span are then
specified, starting with the settings on the General tab (Figure 85).
- 101 -
The “Span type” control can be set to “Host-based stack “ or “Embedded stack”. Choose
“Host-based stack” .
The “IP address” specifies the IP address on which the TeleVantage server should listen for
connections. This must be an address bound to one of the host machine’s NICs. A common
configuration is the host machine has a single NIC bound to a single IP address, in which case
this single IP address would be entered into this field. However, if the server has multiple NICs or
multiple IP addresses bound to a single NIC, the administrator can choose the IP address that
H.323 calls should connect to. The control displays the existing IP addresses on the server a the
list box. As an administrator might add an IP address to an existing NIC on the server, or add a
NIC to the server machine, an arbitrary address can be typed in also.
The “Protocol” determines which voice-over-IP protocol is used to make calls. Currently only
H.323 is supported.
The “H.323 listener port“ specifies the TCP port on the IP address specified above that the
server should listen on for H.323 connection requests.
Figure 85. General Tab for a Internet Span with a Host-based Stack
After these controls on the General tab are set, the TeleVantage server needs to be restarted
before the trunks of the host-based span are instantiated.
A span of type “Host-based Stack” has an “RTP Resources” tab (Figure 86).
The RTP (or “IPMedia”) resources are responsible for audio processing and reside on the
Dialogic hardware Each RTP resource is bound to the IP address on which the audio connection
for that resource is made. For RTP resources residing on an IP trunk board, this IP address is
the address assigned to the board in DCM. For the DI0408LSA-R2, this is the IP address that the
- 102 -
IPLink Media Service (IPMedia.exe) is bound to, specifically, an IP address assigned to a one of
the host machine’s NICs.
The host-side of the stack has call control channels, each assigned a trunk number and bound to
the IP address on which the call control connection is made. This is IP address assigned to the
span on the General tab of the span’s properties. This is always one of the addresses bound to
one of the host machine’s NICs.
Each trunk in the span needs to be assigned an RTP resource that will process the audio stream
for any call connecting to that trunk. If “Automatically assign RTP resources” is selected, these
assignments are made automatically by the server. If the administrator wishes to control these
assignments, he should select “Use these specific RTP resources”. The assignments can then
be made using the remaining controls on this tab. The default for a new host-based IP span is
automatic assignment.
Figure 86. RTP Resources Tab for a Host-based IP Span
To assign a particular RTP resource to a particular trunk, select an available resource in the
Resources list. An RTP resource is available if it is not yet assigned to an IP “board”, so
available resources have no number in the “Assigned Board” column. Then in the
Assignments list, select the trunk to which that resource should be assigned and click “Add>>”.
To remove an assignment, select the desired trunk and click “<<Remove”. The “Clear” button
clears all assignments in the Assignments list. The up and down arrow can be used to move a
particular RTP resource to the next higher or lower trunk number, respectively.
- 103 -
Configuring Boards for Embedded Stack
Embedded-stack IP spans are configured just as an IP span in previous versions of TeleVantage.
The only difference is that the “Span Type” control on the General tab of the IP span must be set
to “Embedded stack”.
Remember that the “IP Address” for an embedded-stack IP span should be set to the IP address
assigned to IP trunk board’s Ethernet interface in DCM. The DI0408lSA-R2 board does not have
an on-board Ethernet interface and so cannot be configured to use an embedded stack.
Codec Assignments
The Codecs tab (Figure 87) for IP spans has been modified in TeleVantage 6.0, but the function
is essentially the same as in previous versions of the product. The tab displays a list of all
possible codecs available for use. To enable a codec for use, check the “Enable” checkbox next
to the codec’s name. The enabled codecs are listed in order of preference. To change the
preference for a particular code, highlight the codec in the list and use the up or down arrow
buttons to move it to a different position in the list.
Figure 87. Codecs Tab for an IP Span
- 104 -
Two B-channel Transfer for NI2
Two B-Channel Transfer (TBCT) is a ISDN service that allows TeleVantage to drop out of a call
when transferring an inbound call to an external telephone number. Without TBCT, the
TeleVantage server must switch the inbound call to the external number, and doing so ties up an
inbound and outbound trunk for the duration of the call. With TBCT, TeleVantage can request the
telephone network transfer the inbound call to the external number, enabling it to release both
trunks.
To use ISDN Two B-Channel Transfer, the following conditions must be met:
•
The routing list action transferring the call to the external number must have “Attempt
Centrex/PBX transfer” enabled.
•
The ISDN carrier must support the TBCT feature and it must be enabled for the ISDN
span connected to TeleVantage. (On most networks that support TBCT, it is not enabled
by default.)
•
“Two B Channel Transfer Supported” a control found on the Tuning tab of the ISDN
span, must be set to “Yes”. See ISDN Setting Changes on Page 96 for more
information on the Tuning tab.
The ISDN Two B-Channel Transfer test utility is included on the master installation CD in the
\Support\ISDN2BCT directory. This utility can be used to verify the ISDN line TeleVantage is
connected to supports TBCT. See Appendix B, Configuring ISDN Parameters, of Installing
TeleVantage for more information on running this utility.
- 105 -
Dialing and Routing Services
Paging Ports
The “Prevent hold, transfer, and other call control” checkbox can be used to limit the
operations that can be performed on calls to a trunk. When this box is checked, an active
outbound call dialed using this dialing service can only be disconnected. Such a call cannot be
placed on hold, transferred, or conferenced. All call control operations except disconnect are
disabled. The telephone commands and ViewPoint’s Call Monitor commands are both disabled
for the duration of the call. All calls to this dialing service appear in the Call Log with the result
“Connected,” even if they were placed to a number that was busy or never answered.
This feature is designed to prevent users from manipulating calls to public address systems that
are attached to TeleVantage through a trunk port. Typically, such calls should not be put on hold
or transferred to other users.
The “Prevent hold, transfer, and other call control” control (Figure 88) is available only for
Centrex/PBX Extension-type dialing services. The public address system is typically connected
to TeleVantage through an analog trunk port. Users dial the access code of a Centrex/PBX
Extension dialing service to access this port. This dialing service has only one trunk, the analog
trunk connected to the PA system, in the Selected Trunks column of the Trunks tab, and
“Prevent hold, transfer, and other call control” checked on the General Tab.
Figure 88. General Tab of a Centrex/PBX Extension Dialing Service
- 106 -
User Configuration
Permissions Restricting Access to TUI Features
A number of new permissions restricting access to certain telephone user interface
features appear in TeleVantage 6.0.A new permissions group, Phone Commands, has been
added to the Security>Permissions category for a user (Figure 89) in the Administrator
program. The new permissions in this group are listed in
Table 14.
Figure 89. Security>Permissions Dialog for a User
User Permissions
TeleVantage 6.0 includes a number of new permissions controlling a user’s access to system
features. Each new permission, along with a short description of the permission and its default
value, is listed in
Table 14.
- 107 -
Access saved messages
Callback last incoming number
Dial-by-name
Disable call waiting
Enter account code
Manage account settings
Manage calls on hold
Redial
Disconnect (remote)
Send message to all
Set personal status: Available (Non-queue)
Set personal status: Available
Set personal status: Available (Queue only)
Set personal status: Do Not Disturb
Set personal status: In A Meeting
Access external station settings
Access Tools menu in ViewPoint
Access system call log via API
Add parties when replying to voice mail
Allow coaching user calls
Allow joining user calls
Allow monitoring user calls
ViewPoint call control
Forward voice mail
Lock/Unlock the layout of ViewPoint views
Play audio into a call
Reply to voice mail
Send voice mail
Set calling-as
Show menu bar in ViewPoint
Permission Name
- 108 -
Use the Call Monitor in ViewPoint
Forward a voice message to other users via the TUI or ViewPoint
Use the View>Lock the layout menu choice to lock the ViewPoint layout
Use the Insert audio feature in ViewPoint
Reply to a voice message via the TUI or ViewPoint
Send a new voice message to other users via the TUI or ViewPoint
Change calling-as identity via ViewPoint or *14
Show/hide the program menu in ViewPoint
View or modify the settings for an external station in ViewPoint’s Tools>Options menu.
Also limits access to Option 6-9 in the TUI Account menu.
Phone Commands
User Option 2 in the TUI Account menu to listen to voice message in the Saved folder
Dial *69 to return the last incoming call
Dial *93 to access the dial-by-name directory
Dial *70 to disable call waiting
Dial *11 to enter an account code
Use Option 6 in the TUI Account menu
Dial *95 to access the TUI Call Handing menu
Dial *66 to redial the last number dialed
Dial *96 to log off a remote session
Use 8888# special extension to broadcast a voice message to all users via the TUI
Change personal status using the TUI Account menu
See Monitor, Coach, and Join Non-queue Calls on Page 3
Standard
Hide/show the Tools menu in ViewPoint
Use the System.GetSystemCallHistory method in the Client API.
Add additional mailboxes to the
Description
Table 14. New User Permissions in TeleVantage 6.0
Allow
Allow
Allow
Allow
Allow
Allow
Allow
Allow
Allow
Allow
Allow
Allow
Allow
Allow
Allow
View & Edit
Allow
Disallow
Allow
Disallow
Disallow
Disallow
Allow
Allow
Allow
Allow
Allow
Allow
Allow
Allow
Default
Access Trunk Log folder
Access Dial Plan folder
Access Maintenance Log folder
Permission Name
Set personal status: On Break
Set personal status: On Vacation
Set personal status: Out Of The Office
Start a new call via #
Toggle hands-free
Toggle voice-first
Universal pickup
Unpark
Workgroup pickup
- 109 -
View or modify the Trunk Log view in Administrator
Access internal dial tone by pressing # in the TUI Account or Call Handling menus
Dial *10 to turn hands-free answering on or off
Dial *12 to turn voice-first answering on or off
Dial *91 to answer a call ringing a specific extension
Dial *92 to unpark a parked call
Dial *99 to answer a call ringing a station within a workgroup
Administration
Show/hide the Dial Plan view in Administrator
View or modify the Maintenance Log view in Administrator
Description
No access
Disallow
No access
Default
Allow
Allow
Allow
Allow
Allow
Allow
Allow
Allow
Allow
User Number Enhancements
TeleVantage 6.0 adds access to a user’s personal telephone number fields through the
Administrator program, specifically, in the User > Numbers category (Figure 90) in the user’s
properties. In addition to the Home, Home2, and Mobile numbers found in previous versions of
TeleVantage, the values E-mail, Email2, and IM Address for the user can now be specified by
an administrator or by the user. Any of these can be made visible to other users on the system
by checking the “Public” setting for the number of address.
Figure 90. User > Numbers Category for a User
Also, TeleVantage 6.0 adds the “NT Account” property for the user, found under the User
category of the user’s properties.
For more information see User and Contact Enhancements on Page 22.
- 110 -
Hold Music Controls
The “Change hold music to” control for users (Figure 91) has changed to reflect the modification
to hold audio source setup in TeleVantage 6.0. For more information see 4 on Page 63.
Figure 91. Hold Music Controls for a User
Drop Loop Current When Idle
A new control, “Drop loop current when idle”, appears under the Phone category for a user
(Figure 92) in the Administrator program. When this feature is enabled, the server will interrupt
loop current to the user’s station when the far-end of the active call disconnects. See Drop Loop
Current on Idle Station on Page 69.
Enable Multiple Line Appearances
Use the Enable multiple line appearances field (Figure 92) to give a user more than two line
appearances for simultaneous incoming calls.
A typical user with call waiting enabled for his extension has at most two line appearances, an
active call and a call ringing his extension. (The user hears the call waiting tone in the active call.)
Further incoming calls are treated using the next action in the user’s routing list. If the Enable
call waiting control is unchecked and Enable multiple line appearances is checked, the user
can then has the number of line appearances specified in the textbox.
When the user is on the phone, he hears the call waiting beep and can press Flash to accept
incoming calls until all the lines are in use. When all the lines are in use, new incoming calls go
straight to the next routing list step alerting the user.
- 111 -
Flash Behavior
The “Flash behavior while in a call” control (Figure 92) allow the administrator to determine
how the server behaves when the user flashes during an active call. See Page 91, Default Flash
Behavior for a detailed discussion of this feature.
Figure 92. Phone Category Page for an Standard Analog Station
Imitate a Station Control
The “Imitate a station when routing incoming calls to external numbers” control, when
checked, directs the server temporarily create an external station and use it for any incoming
calls to this extension that are routed to an external network. The control is located under the
Phone>Remote Call Control category for the user. (See Figure 93.)
For a more detailed discussion of external station, see External Stations on Page 75.
- 112 -
Figure 93. Imitate a Station Control for a User
- 113 -
Coach, Monitor, and Join Personal Calls
The “Personal calls can be monitored”, “Personal calls can be coached”, and “Personal
calls can be joined” controls are found on under the Security category in a user’s properties
(Figure 94). These settings determine if this user’s personal calls can be supervised by another
user on the system. See Monitor, Coach, and Join Non-queue Calls on Page 71 for more
information on supervising personal calls.
Figure 94. Security Category for a User
- 114 -
Use Navigation Pane
The “Use Navigation Pane” control is located in the user’s properties under the ViewPoint
category. (See Figure 95.) If checked, the user’s ViewPoint application displays the Navigation
pane on the left side. If unchecked, ViewPoint displays the view bar instead, which restores the
look of the client to that of earlier versions of TeleVantage.
Figure 95. ViewPoint Category for a User
- 115 -
Workgroups
Transfer to Workgroup Action in Auto Attendants
Auto attendants can now transfer a call directly to a public workgroup (Figure 96). See Transfer
to a Workgroup Menu Action on Page 121 for more details.
Figure 96. Transfer to Workgroup Action in an Auto Attendant
Simultaneous Ring for External Stations
In previous versions of TeleVantage, a call to a workgroup (using the speed dial option in the
client or by dialing the extension of a public workgroup) would only ring the extensions routed to a
local station on the TeleVantage servers. In TeleVantage 6.0, a call to a workgroup also rings
user extensions forwarded to an external number or routed to an external station. For the
external address to ring, the default location (as seen in the Active Setting dialog) must point to
the external number – so the user must be assigned to an external station or have forwarded their
calls to the external address. (If the workgroup member forwards his calls to the external number
through a routing list action, the routing list action is ignored, and the user’s default location is
rung instead. This is the same behavior as in previous versions of TeleVantage.) Contacts that
are part of the workgroup still are not rung.
- 116 -
These rules for routing calls to workgroup members also apply when the workgroup is rung
simultaneously through a user’s or ACD Workgroup user’s routing list.
*91 and *99 Support for Extensions Routed to Trunks
A user logged in on a trunk can pick up a call ringing another extension using the *91 and *99
feature codes. See *91 and *99 Support for Extensions Routed to Trunks on Page 30.
- 117 -
Auto Attendants
Modify Default Auto Attendant Extension
The extension of the Default Auto Attendant (Figure 97) can be modified in TeleVantage 6.0. In
previous versions, the extension was fixed to the value “8000”.
Figure 97. General Tab of Default Auto Attendant
As in previous versions of the product, the Default Auto Attendant remains the default value for
the “Calls are sent to” field for all trunk types, and this auto attendant cannot be deleted.
User login transfers to an extension
The menu option “User Login” in an auto attendant now can be configured to transfer the caller
to an extension after the user logs in. When the caller selects the “User login” menu choice, the
server prompts the user for his extension and password. When the user successfully logs in, the
call is then immediately transferred to the specified internal extension. The user does not hear
the account menu after logging on.
- 118 -
Figure 98. Auto Attendant Edit Menu Choice Dialog Box
This feature is activated by checking the “Bypass account menu and transfer to extension”
checkbox in the Edit Menu Choice (Figure 98) and “Add Menu Choice” dialogs. Select the
extension the caller should be transferred to after login in the list box.
This feature is designed to support third-party applications that run on the TeleVantage server as
an IVR plug-in or connect to a TeleVantage station port, and that require a user to be logged in
(identified) by TeleVantage.
When “Bypass account menu and transfer to extension” is enabled:
•
The caller is re-prompted for his extension or password if an invalid value is entered, up
to the retry limit currently configured on the server.
•
The caller is prompted to change an expired or invalid password, if necessary.
- 119 -
Hold Music Controls
The control for specifying the hold music source used by an auto attendant has changed. In
TeleVantage 6.0, the hold music source is configured by selecting one of the pre-configured
choices in the list box shown in Figure 99.
Figure 99. AA Hold Music Control
In previous versions, this control used a text box in which the station number of the desired hold
music source would be typed.
See Page 63, Hold Audio Input Support for more information on configuring audio sources in
TeleVantage 6.0.
- 120 -
Transfer to a Workgroup Menu Action
TeleVantage 6.0 auto attendants include a new “Transfer to Workgroup” menu (Figure 97)
action that transfers a caller to a public workgroup. (The workgroup is not required to have an
extension.)
Figure 100. Transfer to Workgroup Menu Action in Auto Attendants
- 121 -
Voice-over-IP and IP Gateways
Uniden UIP300 Phone Support
TeleVantage now includes specific support for the Uniden IP300 IP telephone. The following
buttons and other functions on the phone are supported:
•
•
•
•
•
•
Redial Button
Transfer Button
Hold Button
Conference Button
CallerID & CallerID/Call Waiting
Visual Message Waiting Indicator
The hold button places calls on TeleVantage system hold (not local phone hold).
Figure 101. Phone Category for a User Assigned to an External Station
To configure a user’s station as a Uniden IP phone, the user must first be assigned to Station “0”
(zero) or to a statically-assigned external station number. For both cases, the properties of the IP
telephone are specified In the TeleVantage Administrator program, in the properties of a user,
under the Phone category. The category page for a user assigned to an external station is shown
in Figure 101.
To configure the user’s phone as a Uniden IP300, select “Uniden IP Phone” in the “Destination”
list box. Then select an IP address dialing service in the “Call using:” list box. Finally, specify
- 122 -
the IP address the Uniden IP phone is configured to listen on for H.323 connections in the
“Address” field.
(Note: The Administrator program will accept a host name in the “Address” field, and will use the
server’s name resolution mechanisms to resolve this to an IP address when a call is routed to the
external station. In this case, however, automatic logon through IP address matching will fail,
because the numeric IP address associated with an inbound call from the IP phone does not
match the alphanumeric host name in the Address field. Also, if “Automatically change
address to location of last login” is enabled, the server will overwrite the host name with the IP
address of the phone when the phone logs into the system.)
See External Stations on Page 75 for more information on the “Automatically change address
to location of last login” control. The “Disconnect when idle” and “Interpret ** as flash”
controls are discussed in that section.
Figure 102. Phone Category for a User Assigned to Station 0
If the user is assigned to Station 0, the Phone category page of the user’s properties appears as
shown in Figure 102. To configure the user’s station as a Uniden phone, check the “Using a
VoIP phone” checkbox and select “Uniden” in the “Phone type” list box. The “Call using” and
“Address” settings are configured in the same manner as described earlier.
See Default Flash Behavior on Page 91 for more information on the “Flash behavior while in a
call” control.
Refer to Appendix E, Using an IP Phone with TeleVantage, in Administering TeleVantage, for
more information on using Uniden IP telephones.
- 123 -
Relay PSTN Caller ID Information from H.323 Gateways
If a third-party H.323 gateway (such as a Cisco AS5300/Voice Gateway) is used to send VoIP
calls to TeleVantage, by default the recipient of the call sees the third-party gateway’s IP address
rather than the caller’s original PSTN Caller ID. To configure TeleVantage to relay the original
Caller ID information, enter either the IP address in the or product ID of the H.323 gateway in the
appropriate fields of the Server > External H.323 Gateways category page of Tools > System
Settings in the Administrator program. (See Figure 103.) A product ID is entered in the “Gateway
product ID list” text box, and an IP address in the “Gateway IP address list”. If multiple H.323
gateways are routing calls to TeleVantage, multiple product IDs or IP addresses can be specified
by separating the entries with commas or semicolons.
Figure 103. External H.323 Gateway Caller ID Controls
- 124 -
Call Center
Call Center Queue Wait time announcements in seconds
An administrator can configure the server to play expected wait time announcements to callers to
Call Center queues in either minutes or seconds. (In previous versions, only announcements in
minutes were supported and the smallest value that would be announced was “1 minute”.) The
default is announcements in minutes.
The behavior of the server is modified by changing the value of:
Artisoft\Server\PlayExpWaitTimeInSeconds
Using the TeleVantage Advanced Settings Editor, which can be found on the Tools menu of the
Administrator program. If this key is set to “1” the server plays wait time announcements in both
minutes and seconds. When it is set to “0”, the server announces wait time in minutes only.
When the value of this setting is “0”, the server always announces the next higher minute value if
the wait time is not exactly a whole minute, as shown in Table 15.
Table 15. Announcements for Various Values of Expected Wait Time
Expected Wait Time
45 seconds
2 minutes 25 seconds
2 minutes 45 seconds
Setting
Value
0
1
0
1
0
1
Announcement
"1 minute"
"45 seconds"
“3 minutes”
"2 minutes 25 seconds"
“3 minutes”
"2 minutes 45 seconds"
Agent Status Enhancements
The behavior of Call Center queues has changed relative to that found in Version 5.0.
If an agent is in the On Break personal status, the agent’s state in the Call Center queue changes
to Standby (as it did in Version 4.1 and prior versions of TeleVantage), rather than Unavailable
(as in Version 5.0).
A Call Center queue with “Closed queue if no agents are signed in” enabled closes only if all
agents are signed out or all agents are in the Unavailable state. (Since On Break is no longer
considered unavailable.)
A new statistic, “Agents On Break”, is now visible in the Queue Monitor (Figure 104). This values
indicates how many of the signed-in agents in the queue are in the “On Break” personal status.
- 125 -
Figure 104. Agents on Break Statistic in Queue Monitor
Mail Usage Column in Queues View
Figure 105. Mailbox Storage Information in the Queues View
The Queues view in TeleVantage Administrator (Figure 105) now includes information on voice
mailbox and greetings storage. Both mailbox and greeting size and usage are displayed, and
total disk usage for the queue’s voice files.
- 126 -
Overflow Call Routing Enhancements
TeleVantage 6.0 includes a number of enhancements to the overflow call routing features of Call
Center queues:
•
•
•
An administrator can bypass the overflow wait time when all current tier agents are
signed out to send calls to overflow agents faster.
You can optionally apply the wait time cumulatively to each overflow agent tier so agents
in higher tiers are only called after a caller waits longer for a lower tier to become
available.
The expected wait time algorithm now accounts for overflow agents.
Figure 106. Overflow Controls for a Call Center Queue
When the “If no agents in the current tier are signed in and available then immediately offer
calls to the next tier” checkbox (Figure 106) is checked, the queue bypasses the overflow wait
time if all primary agents are signed out. Calls are sent immediately to overflow agents. The
bypass also occurs between overflow tiers. For example, if all primary and Overflow Tier 1 agents
are signed out, calls are immediately sent to Overflow Tier 2 agents. If all primary, Tier 1, and Tier
2 agents are signed out, calls are immediately sent to Tier 3.
Leave this control unchecked to use the wait time in all cases, even when a tier is signed out. For
example, in the changeover between shifts there might be a moment when all primary agents are
signed out, but you might still want calls to wait rather than ringing overflow agent phones
Note that if a primary agent is signed in but merely unavailable (for example, on a call or on
break), the wait time is used normally. The primary agents must be all signed out for the bypass
to occur.
- 127 -
Choose “Callers should wait a fixed amount of time for any available agent“ to apply the
overflow wait time only once. If no primary agents answer during the wait time, the call is sent to
the lowest-tier ready overflow agent, regardless of what tier that agent might be in. For example,
if all Overflow Tier 1 agents are on break when the overflow wait time expires, the call is sent to
an Overflow Tier 2 agent. (This was the only behavior implemented in previous versions of
TeleVantage server.)
Choose “Callers should wait longer for agents with higher skill values” to have calls wait
longer before being sent to higher overflow tiers. With this option selected, the overflow wait time
is multiplied by the tier level when determining how long a call must wait before being sent to that
tier. For example, if the wait time is 5 minutes (300 seconds), a call must wait 5 minutes for a
primary agent to answer before being sent to Overflow Tier 1, 10 minutes before being sent to
Overflow Tier 2, 15 minutes before being sent to Overflow Tier 3, and so on.
With this feature enabled, the overflow skill value of an agent affects how long a caller must wait
before his call is offered to the agent. For example, if the overflow wait time is 5 minutes and the
agent’s skill value is set to 2, a caller must wait 10 minutes before the call is offered to that agent.
So if define three overflow tiers with skill levels of 1, 2, and 10,
then the wait times for the tiers would be 5 minutes, 10 minutes, and 50 minutes.
In previous versions of TeleVantage, expected wait time calculations ignored overflow agents. In
TeleVantage 6.0, overflow agents are included in the calculation of expected wait time.
- 128 -
Hold Music Source Selection
The control for specifying the hold music source used by a Call Center queue has changed. In
TeleVantage 6.0, the hold music source is configured by selecting one of the pre-configured
choices in the list box shown in Figure 107. For more information on configuring hold audio
sources, see Hold Audio Input Support on Page 63.
Figure 107. Hold Audio Control for a Call Center Queue
- 129 -
Call Center Reporter
In TeleVantage 6.0, Call Center Report offers nine new reports:
•
•
•
•
•
•
•
•
•
Grouped Service Level Report
Unanswered Calls During Business Hours
Call Summary Report
Outbound Call Comparison Report
Trunk Usage Report
Outbound Long Distance Summary
Outbound Calls by Phone Number
Call Transfer Report
User Call Trends Report
Also, the Agent Performance Trends report has been modified and renamed to the Agent Call
Trends Report.
Call Center Reporter Options
Several of the new reports available in TeleVantage 6.0 require some information about the
telephone network dial plan in order to sort and filter calls based on toll charges. The
Tools>Options dialog (Figure 108) in the Call Center Reporter main window provides access to
these settings.
Toll free Options
In the box labeled ”Enter toll free or local area codes/exchanges separated by commas:”, the
administrator can define the area codes and exchanges that can be dialed from this server
without added charge from the service provider. In North America, this would typically include
toll-free area codes (800, 866, 877, and 888) and the user’s local area code or codes. If the local
area code includes both local and long-distance exchanges, a list of non-toll exchanges may be
specified. A non-toll exchange is specified by appending the exchange digits to the area code.
For example, if the 354-xxxx exchange in the 617 area code is a non-toll call, enter the string
“617354” into the list.
All outbound trunk calls that:
•
•
•
Have dial strings meeting the minimum outbound number length
Are at least as long as the minimum outbound duration
Have dial strings that do not begin with any of the toll-free prefixes listed here
Are reported as long-distance (toll) calls in the reports.
In-state Options
The in-state options allow the administrator to further divide toll calls . The box titled “Enter instate area codes/exchanges separated by commas:” contains a list of area codes, exchanges,
or other dial string prefixes. Toll calls that begin with one of these dial string prefixes are
considered “in-state” and should be grouped together in reports. Currently, toll calls are only
- 130 -
divided into long-distance and in-state in the Outbound Call Comparison report. See Outbound
Call Comparison Report on Page 138.
The “Label for in-state category” field allows the administrator to specify a name for the group
of calls meeting the in-state criterion.
Figure 108. Tools > Options Dialog in Call Center Reporter
Criteria for counting calls
TeleVantage 6.0’s Call Center Reporter also allows the administrator to set criteria determining
which trunk calls shall be counted as calls in various reports, and which shall be ignored.
The “Minimum outbound number length” value determines the minimum length of the call’s dial
string required for Call Center Reporter to count the call. Any call with fewer than the specified
number of digits in its dial string is not included in the data for a particular report. The primary
purpose of this parameter is to prevent calls that did not complete because of incomplete dial
strings from being included in the reports. It also eliminates calls to special service numbers
(such as 911 or 411) and the dialing of vertical service feature codes (*69, *70) from the reports.
Calls that have durations less than the “Minimum outbound call duration” or “Minimum
inbound call duration” value also are not included in the reports. The purpose of these
- 131 -
minimums is to eliminate calls that are dialed but do not complete or are terminated before billing
occurs.
Typically, the values in the Tools>Options dialog of Call Center Reporter are only modified by an
administrator, and these fields are read-only to non-administrators by default. A user who needs
to modify these settings should either be added to the Administrators role or have his “Edit
System Settings in TeleVantage Settings Editor” permission set to “Allow”.
Grouped Service Level Report
The Grouped Service Level report (Figure 109) displays the percentage of trunk calls answered
versus the time the call rang the answering device. A call is “answered” when it is connected to a
user (not an application such as a Call Center queue, auto attendant, or IVR plug-in). The wait
time shown is the time from when the call was routed to the answering extension to the time the
call was answered by that extension.
Figure 109. Grouped Service Level Report
The report allows the user to report on all inbound trunk calls, or only those to a specified
organization, workgroup, or those appearing on a certain set of trunks. This can be done through
the Report Options dialog (Figure 110). The user specifies which trunks are included in the report
by selecting a dialing service that routes calls to that group of trunks. (If the server has a set of
inbound-only trunks that do not have an associated dialing service, create a “dummy” dialing
service for those trunks and disable the dialing service so it cannot be used for outbound calls.)
- 132 -
Figure 110. Grouped Service Level Report Options
- 133 -
Unanswered Calls During Business Hours
The Unanswered Calls During Business Hours report (Figure 111) displays the number of
unanswered calls over a selected time frame. A call is answered when it is connected to a user,
so unanswered calls are those that are abandoned after ringing unanswered, are sent to a
voicemail box, or are abandoned at an auto-attendant, Call Center queue, or other application.
Figure 111. Unanswered Calls During Business Hours Report
The vertical bars in the chart indicate the number of unanswered calls during the particular time
period, and the line indicates what percentage those unanswered calls are of the total number of
calls received during the same period.
The report allows the user to choose between all inbound trunk calls, or only those to a specified
organization, workgroup, or those appearing on a certain set of trunks. This can be done through
the Report Options dialog (Figure 112). The user specifies which trunks are included in the report
by selecting a dialing service that routes calls to that group of trunks. (If the server has a set of
inbound-only trunks that do not have an associated dialing service, create a “dummy” dialing
service for those trunks and disable the dialing service so it cannot be used for outbound calls.)
- 134 -
Figure 112. Unanswered Calls Report Options
- 135 -
Call Summary Report
The Call Summary Report (Figure 113) displays the total number of calls placed and the average
call duration per user over a specified time period.
Figure 113. Call Summary Report
The Report Options dialog (Figure 114) allows the user to specify which calls are included in the
report:
•
The report can include calls placed by all users or only the users within a specified
workgroup.
•
Of the calls of the specified group, the user can choose to report only on calls placed on
a specified set of trunks. The trunk group is specified by checking the “Only show calls
placed to” checkbox, and then selecting a particular dialing service. If the control is
unchecked, then the report includes all trunk calls placed by the specified group of users.
(If the server has a set of inbound-only trunks that do not have an associated dialing
service, create a “dummy” dialing service for those trunks and disable the dialing service
so it cannot be used for outbound calls.)
•
The “Call Type” control allows the user to further filter the calls already chosen. The
report can include either only internal calls, only external (trunk) calls, or all calls.
- 136 -
Figure 114. Call Summary Report Options
- 137 -
Outbound Call Comparison Report
The Outbound Call Comparison report (Figure 115) displays the total number of calls and total
duration of calls in each of three categories: toll-free calls, in-state calls, and other call. Toll-free
calls are those with dial strings that begin with one of the area codes or exchanges defined in
the ”Enter toll free or local area codes/exchanges separated by commas:” list in Call Center
Reporter’s Tools > Options dialog. (See Toll free Options on Page 130.) In-state calls are those
with dial strings that begin with an area code or exchange in the “Enter in-state area
codes/exchanges separated by commas:” list in the same dialog box. (See In-state Options on
Page 130.) The other category of calls includes all calls that do not meet one of the these two
criteria.
1600
6000
1400
1200
5000
4000
1000
3000
800
600
2000
400
200
1000
Total Duration
(minutes)
Number of Calls
Outbound Call Comparison - All Calls
(2/29/2004 - 3/6/2004)
0
O
th
er
ll
Fr
ee
To
In
-s
ta
te
0
Number of Calls
Total Duration (minutes)
Figure 115. Outbound Call Comparison Report
The Report Options dialog (Figure 116) allows the user to run this report for all outbound calls, or
for only those calls marked with a specified organization name.
- 138 -
Figure 116. Outbound Call Comparison Report Options
Trunk Usage Report
The Trunk Usage Report (Figure 117) displays the total talk time on a group of trunks over a
range of intervals, and the percentage of each interval during which all trunks in the group were
busy.
Figure 117. Trunk Usage Report
- 139 -
The vertical bars represent the total talk time on the group of trunks. The line on the graph
indicates the percentage of each time interval during which all the trunks in the group were busy.
The Report Option dialog (Figure 118) allows the user to specify a group of trunks by selecting an
existing dialing service in the “Dialing service” control. (If the server has a set of inbound-only
trunks that do not have an associated dialing service, create a “dummy” dialing service for those
trunks and disable the dialing service so it cannot be used for outbound calls.)
Figure 118. Trunk Usage Report Options
- 140 -
Outbound Long Distance Summary
The Outbound Long Distance Summary (Figure 119) displays the total number of outbound toll
calls and the total duration of those calls over each interval of time in a specified range. The
report includes only the calls for a single, specified organization.
Figure 119. Outbound Long Distance Summary Report
The vertical bars represent the number of long distance telephone calls that occurred during the
time interval, and the line displays the total duration of those calls.
Figure 120. Outbound Long Distance Summary Report Options
- 141 -
The Report Options dialog (Figure 120) is used to specify the organization to which the outbound
calls have been attributed. The user must specify an existing organization to run this report.
The “Cost per minute” and “Cost interval in seconds” are used to generate an estimated cost
for the long distance calls on this report. The estimate appears on the “Data” worksheet in Excel.
Outbound Calls by Phone Number
The Outbound Calls by Phone Number report (Figure 121) displays the duration and number of
calls to each of a specified list of telephone numbers or telephone number prefixes. A prefix, in
this case, may be an area code (e.g. 203), area code followed by an exchange prefix (e.g.
203234), or any other string of characters that might start a dial string. For each dial string prefix
entered, the report displays a vertical bar representing the total number of calls to number starting
with that prefix, and a point on a line indicating the total duration of those calls.
Figure 121. Outbound Calls By Phone Number Report
The report include only the calls for a particular organization, or all outbound trunk calls on the
server, as specified in the Report Options dialog (Figure 122). In the “Number prefixes” field, the
user can enter a comma-separated list of telephone numbers or digit strings. Each entry
produces an individual point and bar on the graph.
- 142 -
Figure 122. Outbound Calls By Phone Number Report Options
Call Transfer Report
The Call Transfer report (Figure 123) shows the number of calls a particular user or queue
transferred. The report displays a bar graph, with a bar for each transfer target. The height of the
bar represents the number of calls the specified user or queue transferred to that particular
transfer target.
Figure 123. Call Transfer Report
- 143 -
This report is useful in analyzing the flow of calls in the system. For example, if the report shows
that an operator is transferring a large number of calls to a particular user, it may be helpful to
add a menu choice on the main auto attendant to transfer directly to that user.
Figure 124. Call Transfer Report Options
The Report Options dialog (Figure 124) lets the user specify the transferring extension, either a
user or Call Center queue.
- 144 -
User Call Trends Report
The User Call Trends report (Figure 125) displays the number of calls and average talk time on
those calls for a user. The stacked vertical bars in the graph indicate the total number of inbound
and outbound calls the user participated in. The average talk time is displayed as two separate
lines, one for inbound call and the other for outbound calls.
Figure 125. User Call Trends Report
On the Report Options dialog (Figure 126), the user whose calls will be analyzed can be selected
from a list of existing users on the system.
Figure 126. User Call Trends Report Options
- 145 -
Agent Call Trends Report
The Agent Call Trends report (Figure 127) replaces the Agent Performance report found in
earlier versions of TeleVantage. Whereas the Agent Performance Trends report included both
the agent’s personal and Call Center queue calls, the Agent Call Trends report is generated using
only the Call Center queue calls the agent participated in. Personal calls are not included.
Figure 127. Agent Call Trends Report
The Report Options for the Agent Call Trends report are identical to those for the User Call
Trends report, and for the Agent Performance Trends report found in previous versions of
TeleVantage.
- 146 -
Maintenance and Administration
TeleVantage 6.0 includes a number of new features aimed making the system simpler to monitor,
maintain, and troubleshoot.
System Shutdown Enhancements
The Shutdown Server option on the Tools menu of the Administrator program has several added
features. In previous versions of TeleVantage, the only two options were:
•
•
“Immediately shut down the server and terminate all calls” and
“Prevent new calls in _ minutes, then shutdown until all existing calls are finished”
The TeleVantage 6.0 “Shut down TeleVantage Server” dialog (Figure 128) adds options to:
•
•
•
•
•
Schedule the termination of existing calls before a shutdown.
Stop the Dialogic drivers with TeleVantage server
Reboot the server machine after a shutdown
Initiate a Dialogic driver firmware dump after the server shutdown
Automatically restart TeleVantage server after the shutdown.
Figure 128. Tools > Shutdown Dialog in TeleVantage Administrator
- 147 -
Delayed shutdown
Check “Delay _minutes” to schedule a shutdown to occur automatically after a fixed period of
time elapses. Enter the number of minutes to delay. The clock time at which the shutdown will
occur appears to the right of the control. During the delay, users picking up a station hear the
message “The phone system is about to shut down.” Also, during the delay, the shutdown can be
canceled by returning to this dialog box. Uncheck the control to shut down the server
immediately.
Prevent new calls
Check “Prevent new incoming or outgoing calls“ to prevent the start of new external
calls during the delay period before the server is shut down. Internal (station-to-station) calls are
still permitted. Incoming trunk calls will hear a busy signal. Attempts at placing outgoing
external calls will fail to allocate a trunk, and the caller will hear “Sorry, that line is unavailable”. If
unchecked, new external calls can be placed and received.
Terminate existing calls
The next three controls in the “Shut down TeleVantage Server” dialog determine how the server
will handle active calls that exist on the server after the delay time has expired.
•
If “Immediately terminate all active calls“ is checked, after the delay, all calls on the
server are disconnected and the server shuts down.
•
If “Wait __ minutes for calls to complete” is selected, if calls are still in progress, the
server waits for the specified number of minutes before disconnecting those calls. If a
delay was specified in “Delay __minutes”, this wait time begins when the delay expires.
The shutdown continues when this wait time elapses or all calls are completed,
whichever comes first.
•
If “Indefinitely wait for calls to complete” is selected, the server shutdown is
postponed until no active calls are in progress. Note that if this option is chosen and
“Prevent new incoming or outgoing calls” is not selected, the shutdown may be
postponed for quite a long time.
Service shutdown options
The next three controls determine what services will be terminated as a result of the shutdown
process.
•
If “Stop TeleVantage Server” is selected, only the TeleVantage server (service) is shut
down. The Intel Dialogic drivers are not stopped and the server operating system
continues to run.
•
If “Stop TeleVantage Server and Intel Dialogic Drivers” is chosen, both the
TeleVantage Server service and the Intel Dialogic drivers are shut down. (Note: this
option does not stop all of the Dialogic driver-related services. For instance, the
- 148 -
CTBusBroker, DM3Config, and IPLink Media services all continue to run after the
shutdown.)
•
If Restart PC is selected, then the operating system of the server computer is rebooted.
Capture Dialogic firmware dump
Check “Capture Intel Dialogic firmware dump” to generate a firmware dump during the
shutdown. For more information on firmware dumps, see <ref>.
Restart TeleVantage server after shutdown
If the “Start TeleVantage Server” control is checked, the TeleVantage Server service is
automatically restarted after the shutdown completes. The TeleVantage Server starts the Intel
Dialogic drivers automatically if they were stopped.
Shutdown Reason
When shutting the server down through the Administrator or Device Monitor programs, a reason
for the shutdown must be entered in the “Reason for shutdown” field at the bottom of the dialog
box. This reason is recorded in both the TeleVantage Event Log in Windows Event Viewer and in
TeleVantage’s Maintenance log. (see “Viewing the TeleVantage Event Log” on Page 12-19 of
Administering TeleVantage).
Device Types and Names in the Device Monitor
The Dialogic-assigned device names for each station and trunk device installed in the system is
now displayed in the Device Monitor (Figure 129) , along with a “Device Type” value that
indicates what type of device the TeleVantage server has detected. The possible values are
listed in the table below (Table 16).
- 149 -
Table 16. Device Types and Names in Device Monitor
Device Type
ISDN PRI
Robbed-bit T1
E1 CAS
Analog
Device Name Format
Trunks
dtiBnTm
ISDN BRI
Internet
dxxxBnCm
briSnTm
IPTBnTm
DM3BnIPTm
Analog
Toshiba
External
msiBnCm
DKTBnCm
EXTm
Notes
DI/0408LSA analog trunks only
Springware analog trunks
Host-based stack
Embedded stack
Stations
MSI, HDSI, DI/0408LSA, or DI/SI station
Where n is the number assigned by the Dialogic drivers to the logical board, and m is the number
assigned to the individual device or channel.
Figure 129. Device Monitor
The Dialogic drivers divides up the resources on a physical board into logical boards. Each
logical board typically includes a fixed number of voice devices – station ports, trunk ports, voice
resources, et. al. A physical board is usually divided up into more than one logical boards. For
- 150 -
example, a D/80SC-4LS board might be assigned the logical board numbers DXXXB1 and
DXXXB2, each spanning four voice resources (dxxxB1C1-4 and dxxxB2C1-4).
Logical board numbers are assigned by the Dialogic drivers at start-up time. These logical board
numbers are assigned by device type and in the order of the physical board’s SC-bus ID. For
example, consider a system with a D/80SC-4LS at ID 1 and a D/120JCT-LS at ID 2. The
D/80SC-4LS might be assigned the numbers dxxxB1 and dxxxB2, and the D/120JCT-LS might
then be assigned dxxxB3, dxxxB4, and dxxxB5. If we add an DI/SI32 board to this system,
assigned ID 3, then the station board would be assigned the logical board number msiB1.
The Device Monitor now also indicates if the TeleVantage server detects a mismatch between the
configured device type and the detected device type. The Status column in the Trunks section of
the Device Monitor view shows the following error strings, in red:
•
•
"Device type mismatch" if the detected device and configured device are not the same.
"Device not detected” if not trunk device is detected for a configured trunk.
ISDN Red Alarm Notification via NT Events
TeleVantage 6.0 now records an Windows Event log entry (in the Application log) when the
Dialogic drivers report a blocked or unblocked event for a digital trunk board. The text of the
events are shown below:
Event Id: 153
Type: Error
Description:
Device Blocked: dtiB1.
Event Id: 154
Type: Information
Description:
Device UnBlocked: dtiB1.
Although the drivers report one event for each trunk, TeleVantage server reports only one event
per board when multiple events occur simultaneously. This prevents these event messages from
filling the Windows event log. Each channel's status is reported via the Device Monitor.
When a trunk becomes blocked, TeleVantage server periodically checks the trunk to determine if
it as become unblocked.
- 151 -
Maintenance Log Enhancements
To improve the speed at which the Maintenance Log view (Figure 130) loads, the Administrator
program now loads only the most recent 50 entries (by default) from the database. The view
includes controls to move to the next or previous 50 entries. These functions can be initiated
using the up-arrow or down-arrow (respectively) on the toolbar, or the “Previous n entries” and
“Next n entries” choices in the Maintenance Log menu.
Figure 130. Maintenance Log View in Administrator Program
The jump function allows you to navigate to entries for a particular day without paging through
multiple pages of the log. The Jump Maintenance Log dialog (Figure 131) can be displayed by
selecting the toolbar icon or the “Jump to Date” menu item on the Maintenance Log menu.
Figure 131. Jump Maintenance Log Dialog
The number of entries displayed per page can be modified in the Tools > Options dialog (Figure
132), by changing the value of the “Display _ Maintenance log entries at a time” control.
- 152 -
Figure 132. Tools > Options Dialog in Administrator Program
The Maintenance Log view also includes improved logging of administrative activities.
Whenever an item such as an auto attendant or Call Center queue is deleted from the
Administrator program, that operation is logged (Figure 133).
Figure 133. Deleted Item Maintenance Log Entry
The details of a server shutdown are also recorded in the Maintenance log (Figure 134). In
particular, the reason for a shutdown is listed in the “Details” column of the shutdown log entry.
For more information on shutting down TeleVantage 6.0, see System Shutdown Enhancements
on Page 147.
Figure 134. Server Shutdown Maintenance Log Entry
TeleVantage Server Process Dumps
TeleVantage 6.0 includes a facility (disabled by default) to create a software dump of the
TeleVantage server process (TVSERVER.EXE) when an exception occurs. This provides a more
detailed level of debugging information than was possible in earlier versions of the product.
- 153 -
To enable this feature, create the following value in the Windows Registry:
[HKEY_LOCAL_MACHINE\SOFTWARE\Artisoft\TeleVantage\Server\Settings]
"DumpCommand"="C:\Program Files\TeleVantage Server\userdump.exe"
Then whenever TVserver throws an exception the command line above will be run and
a dump of the TVserver process will be created, named "TVServern.dmp" where n is either
0 (if TVServer0.dmp does not exist) or 1 (if TVServer0.dmp does exist).
To disable process dumps, set the value of the registry key to an empty string. The registry key
can be changed while the server is running.
Problem Report Wizard Enhancements
TeleVantage 6.0 includes a number of improvements to the Problem Report Wizard. This
program now adds:
•
•
•
•
An option to include a database backup in the Problem Report Wizard package file
Automatic inclusion of any Dialogic driver firmware dump files.
The ability to run the Problem Report Wizard from a script or command file
The ability to specify system-wide default values for Problem Report Wizard entries,
either through the Administrator program or using command line options.
Include a Database Backup
The Problem Report Wizard now includes an option to automatically generate a TeleVantage
server database backup and include this backup in the problem report package (CAB file). To
use this feature, check the “Include a TeleVantage database backup in this report” checkbox
(Figure 135) from within the wizard.
- 154 -
Figure 135. Include Database Option in Problem Report Wizard
(This option is only available when running the Problem Report Wizard on the TeleVantage
server.)
Command Line Interface
The Problem Report Wizard for TeleVantage 6.0 can be run from a command line.
The command format is:
tvprwizard optionlist
Where optionlist is a list of one or more options shown in Table 17, in the form /option:value.
- 155 -
Table 17. Problem Report Wizard Command Line Options
Option
/calllogentry
/stations
/clientpackage
/includedatabase
/estimateddate
/estimatedtime
/exactdate
/exacttime
/rangestartdate
/rangestarttime
/rangeenddate
/rangeendtime
/summary
/reproducible
/details
/contactname
/contactcompany
/contactphone
/contactemail
/supportname
/supportissue
/packagepath
/packagefile
/mailpackage
/createcab
/maxevents
/cabpriority
Value
Call log entry
List of stations involved
Full path and filename of a client-side package to include
Yes - Include a database backup
No - Do not include a database backup
Estimated date of occurrence
Estimated time of occurrence
Exact date of occurrence
Exact time of occurrence
Start date of log range
Start time of log range
End date of log range
End time of log range
Summary string
Yes - Reproducible
No - Unknown
Details text
Customer name
Customer company
Customer phone number
Customer email address
Name of support contact
Support issue number
Directory for CAB file
Filename for CAB file
Should the package b emailed (not applicable when
automatically creating a CAB file)
Yes - Begin CAB creation automatically
No – Present GUI
Maximum number of event log events per event log type
Process priority for cabarc:
Normal, idle, high, realtime, below_normal, above_normal
If the /createcab parameter is not set to "yes" then the Problem Report Wizard will run normally,
with the fields pre-filled with whatever other parameters were specified. If the /createcab
parameter is set to "yes" then the Problem Report Wizard will run automatically, displaying only
the progress bar, using the data from whatever parameters were specified. The program
automatically close when the package is complete.
None of these parameters are required - if the Problem Report Wizard is run with only the
/createcab:yes option, a package is created with all the defaults. At minimum, it is
recommended the /packagepath and /packagefile parameters be specified so the location of the
resulting CAB file is certain.
- 156 -
Include Dialogic Firmware Dumps
If any Dialogic firmware dumps exist in the \TeleVantage Server\Logs directory, the Problem
Report Wizard will now collect them and include them in any server-side problem report. See
Dialogic Firmware Dump Automation on Page 67 for more information on firmware dump
automation.
Default Contact Information and Email Options
Figure 136. Problem Report Wizard Defaults in the Tools > System Settings Dialog
An administrator can now specify, through the Administrator program, the default contact
information used when generating a package t using the Problem Report Wizard (Figure 136).
The administrator can define the default value for contact name, company, telephone number,
and email address, and the destination email address to use when the Problem Report Wizard
sends a report.
Automated Collection of Server Information
Automated generation and transmission or collection of Problem Report Wizard output files is
now made feasible. With the new option of running the PRW from the command line, it is
possible to schedule the creation of problem report packages using batch programs or scripts in
conjunction with the Windows Scheduled Task feature. Also, the PRW can be run in response to
specific conditions on the server by using the Alerts functions in Windows Performance Monitor.
- 157 -
Server Log Improvements
In TeleVantage 6.0 , changes have been made to certain entries in the server logs
(TVLOGnnn.TXT files, located in the \Program Files\TeleVantage Server\Logs directory by
default) to make the logs more readable. In particular, an effort has been made to use descriptive
names instead of enumeration values when making references to:
•
•
•
•
•
•
Call rules
Routing lists
Greetings
Personal statuses
Users
Contacts
And to use descriptive names for enumerations:
•
•
•
•
Action
Transfer action
Jump action
Misc. action
More specifically, entries of the following format now appear in the logs:
"(CF) Use routing list ... (...) based on call rule ... (...)"
"(CF) Use greeting ... (...) based on call rule ... (...)"
"(CF) DND override: set to ... based on call rule ... (...)"
"(CF) Use routing list ... (...) from personal status ... (...) based on call rule ... (...)"
"(CF) Use greeting ... (...) from personal status ... (...) based on call rule ... (...)"
"(CF) Forwarding override by personal status ... (...) based on call rule ... (...)"
"(CF) DND override: set to ... by personal status ... (...) based on call rule ... (...)"
"(CF) Use active routing list ... (...) for ... (...)"
"(CF) Use active greeting ... (...) for ... (...)"
"(CF) DND is currently ... for ... (...)"
"(CF) DlgDispatchAction:... ..."
"(CF) DlgTransfer:... ..."
"(CF) DlgJump:... ..."
"(CF) DlgMisc:... ..."
Below are a few examples from actual server log runs:
[01/06/04 13:44:10.620 - 10B8 - Device -25 ] (CF) Use routing list 'Standard' (2730) based on
call rule 'External' (3169)
[01/06/04 13:21:42.261 - 790 - Device -3 ] (CF) Use greeting 'Initial Greeting' (4376) based on
call rule 'Working from Home' (2945)
[01/06/04 13:37:17.866 - C60 - Device -6
] DlgTransfer: TargetVoiceMail: User:16156 Alicia
Anderson
- 158 -
TeleVantage Event Log
TeleVantage now writes informational and error messages and warnings to the new
“TeleVantage” log in the Windows Event Viewer (Figure 137).
Figure 137. TeleVantage Log in Windows Event Viewer
The TeleVantage email notification engine scans this event log and sends email notifications to
properly configured users for all events that contain "TeleVantage" in the source string. This
includes events generated by IVR plug-ins or Client API applications, such as the SMDR service
and Conference Manager. (Note: Any custom applications written for TeleVantage 6.0 should
post notices of important events to this event log.)
In previous versions, both TeleVantage server and add-on applications used the “Application” log.
Trunk Log
The Trunk Log (Figure 138) records trunk use. It displays which users, applications, and devices
used a trunk, for how long, what to address did the trunk attempt to connect to. It also displays
any trunk signaling or the results of any call progress analysis indicating if the call completed and,
the reason. The Trunk Log is a separate view in the Administrator program and is displayed by
clicking on the Trunk Log icon in the view bar.
- 159 -
Figure 138. Trunk Log View in Administrator Program
An entry appears in the Trunk Log each time a trunk is allocated. Note that a trunk allocation is
not the same as a call. A single trunk allocation can include many calls—for example, if a user
logs in from a remote phone and places multiple calls through TeleVantage.
Each entry may include the following information (as applicable):
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Direction of the call, either inbound or outbound
Trunk
Start Time
Accepted Time (for delayed answer)
Connected Time
Remote Disconnect Time (for line drops)
Remote Disconnect Reason (for line drops)
Local Disconnect Time (for local hang ups)
Local Disconnect Reason (for local hang ups)
Access Code (for the dialing service)
Internal Name (user, et. al.)
Internal Number (extension or IP address of the near-end caller)
External Name (Contact or Caller ID name of far-end caller)
External Number (
Authorizer Name
Authorizer Number
Inbound Number (Caller ID or ANI number for inbound call)
Inbound DID (DID or DNIS number for inbound call)
Outbound Number
Outbound Dial String (number dialed less the dialing service access code)
The possible values for Remote and Local Disconnect Reason are shown in Table 18. The
associated ISDN disconnect cause code are also given, for cases where the call is routed over an
ISDN trunk.
- 160 -
Table 18. Disconnect Reasons (with ISDN Cause Codes)
Disconnect Reason
Normal clearing
No answer
Busy
Destination out of order
Operator intercept
Unassigned number
Network congestion
Call rejected
Destination incompatible
Associated ISDN Cause Code
No.16 - "Normal call clearing"
No.18 - "No user responding" or
No.19 - "No answer from user"
No.17 - "User busy"
No.27-"Destination out of order" or
No.38-"Network out of order"
No.22-"Number changed" or
No.28 - "Invalid number format address incomplete"
No.1-"Unallocated (unassigned) number"
No.34-"No circuit/channel available" or
No.42-"Switching equipment congestion"
No.21-"Call rejected"
No.88-"Incompatible destination"
An entry appears in the Trunk Log when the server hangs up or “deallocates” the trunk.
A number of additional controls have been added to the Administrator program to configure what
information appears in the Trunk Log and when that information is archived. In the Tools>System
Settings dialog (Figure 139) , under the “Call Log and Trunk Log” category, there are several
controls that determine which trunk events appear in the Trunk Log.
Figure 139. Call Log and Trunk Log Settings in the System Settings Dialog
The “Log calls” control can be used to disable all logging of calls and trunk events. If unchecked,
no entries are made in either the Call Log or the Trunk Log.
- 161 -
The “Log internal calls” control has the same function as it did in previous versions of
TeleVantage. A call to an internal extensions routed to an external stations or to an external
address through a routing list still generate a Trunk Log entry even if this control is unchecked,
though.
The “Log trunk activity on:” controls determine if events on PSTN or IP trunks or both will be
logged. By default, all trunk activity produces entries in the Trunk Log. If “Analog, T1, E1, and
BRI trunks” is unchecked, events on those types of trunks will not appear in the Trunk Log.
Similarly, if “IP trunks” is unchecked, activity on IP trunks is not logged.
Figure 140. Call Log and Trunk Log>Archive Dialog
The “Archive” subcategory page (Figure 140), the “Archive Call Log and Trunk Log daily”
replaces the “Archive Call Log daily’ control found in previous versions of TeleVantage, but
performs a similar function. If checked, the server will automatically transfer both call log and
trunk log entries that are older than the time specified by the “Archive calls older than _ days”
setting to archive files, and purge the entries from the TeleVantage database. Trunk log entries
are written to a new archive file, the Trunk Log archive, which, by default, is named
“TrunkLog.csv” . The file is located in \Program Files\TeleVantage Server\Archive directory by
default. A control to relocate this file is also provided in the Archive subcategory of Tools >
System Settings.
Also, in the Call Log view, for each call log entry there is a new item on the shortcut menu named
“Show Trunk Log entries”. (See Figure 141.)
- 162 -
Figure 141. Show Trunk Log entries... menu item in the Call Log View
When selected, the Trunk Log entries dialog box (Figure 142) appears and displays a list of all
trunk log entries associated with that particular call. For most calls (station-to-trunk) there will be
only on entry, but some call log entries may have multiple trunk log entries, such as a conference
call or external station-to-trunk call.
Figure 142. Trunk Log Entries Dialog Box
- 163 -
Identify Active Party on a Device
The Device Monitor program (Figure 143) and the Device Monitor view in the Administrator
program now provide information about what parties are using a station or trunk device.
Figure 143. Device Monitor
The “Active Party” fields shows the name and phone number or extension of the person using
this station or trunk for a call. Where available, the TeleVantage username or contact name is
used, otherwise the Caller ID name is used, if available. The possible types and format of entries
in this field are shown in Table 19.
Table 19. “Active Party” Entry Types
Type of Caller
For a user calling from a station
(including external stations)
For a user calling from an external station
For a known contact
For an unknown contact
Entry Format
Test User (x123)
Test User (6175551212 - Caller ID Name)
Known Contact (6175551212 - Caller ID Name)
Unknown (6175551212 - Caller ID Name)
The “Connected To” field displays the name and phone number or extension of the party to
which the active party is connected. For calls with more than two parties, the “& Others” appears
at the end. The possible types and format of entries in this field are shown in Table 20.
Table 20. "Connected To" Entry Types
Type of Caller
For a user
For a user with outside Caller ID
For a known contact
For an unknown contact
Entry Format
Test User (x123) - Station 2
Test User (6175551212 - Caller ID Name) – Trunk 5
Known Contact (6175551212 - Caller ID Name) - Trunk 5
Unknown (6175551212 - Caller ID Name) - Trunk 5
- 164 -
The Device Monitor's bottom pane can be used to display all the all parties participating in a call
that is occurring on a particular station or trunk device. Select the trunk or station in the Device
Monitor, and, in the bottom pane, all the parties to the call on the selected device are displayed.
For each party, the device name, the name of the party, and the party’s telephone number is
given.
For example, in the screenshot in Figure 143, Charlie Chen on Station 3 is involved in a
conference call with three other parties: Beth Brown, Edward Eaton and an unidentified caller on
Trunk 1, as seen in the bottom pane of the Device Monitor. Beth Brown is logged in at Station 1,
which is assigned by default to Alicia Anderson.
Dial Plan View
The Administrator program in TeleVantage 6.0 includes a new view called the Dial Plan view
(Figure 144). The Dial Plan view shows all the numbers on the system that can be dialed from an
internal dial tone, identified by name and type.
Figure 144. Dial Plan View in Administrator Program
- 165 -
The following types of numbers are included in the Dial Plan view:
•
•
•
•
•
Dialing service access codes
Extensions for users. auto attendants, Call Center queues, public workgroups, and IVR
plug-ins
Contact PINs
Direct-to-voice mail extensions
Special extensions, such as the emergency number, dial-by-name directory extension,
and trunk selector dialing service
For each entry:
•
•
•
•
•
The digits column lists the extension or number for that entry,
The name column is the name of the entry,
The type is a descriptive type, such as “User” or “Contact PIN”,
The owner is “System” for all entries except contact PINs (see below), and
Comments is the text from the “Comments” field of the entry.
Recall that Contact PINs are the owner’s extension with a variable-length, user-assigned identifier
appended to it. In the Dial Plan view, the owner field for a contact PIN is the name of the user
who owns the contact. The name for a contact PIN is always "< private >".
The Direct-to-voice mail entries appear if the “Allow callers to directly leave a voicemail”
control is checked. (See Dial a Voice Mailbox Directly on Page 90.) For each extension that is
able to have a mailbox, there is a dial string to call the mailbox directly. The dial string is the
extension followed by a *.
For example, Beth Brown’s extension is 102, and since she is a user and users can have
mailboxes, there is a 102* “extension” that, when dialed, takes the caller directly to that mailbox.
(Even if Beth Brown does not have a mailbox, her direct-to-voice mail extension 102* exists on
the server.)
The view has a menu bar icon and shortcut menus which allow the administrator to edit or delete
a selected entry. For example, right-clicking on a user extension in the Dial Plan and selecting
“Edit” will open the properties of the user. Selecting “Delete” from the same menu will delete the
user. Theses menu choices are disabled if the logged on user does not have permission to edit
that kind of entry. For contacts, selecting “Edit” will initiate the "Edit all client settings" for the
user that owns the contact.
There is a new user permission entitled “Access Dial Plan view” that controls access to this view.
- 166 -
TeleVantage 6.0 Upgrade Procedure
The following describes a typical procedure for upgrading an existing TeleVantage 5.0 server,
running on Windows 2000 Server, to TeleVantage 6.0. In this particular example, the starting
version number is 5.00.1640, the latest fully-supported release of TeleVantage 5.0. However, the
procedure should not vary for earlier builds of TeleVantage 5.0.
It is possible to upgrade from other versions of TeleVantage to Version 6.0. Information on
upgrading from Versions 4.1, 4.0, 3.5, and 3.0, can be found in Installing TeleVantage, Chapter 6.
The following steps are required to upgrade your TeleVantage 5.0 server to Version 6.0:
1.
2.
3.
4.
5.
6.
7.
8.
Shut down and back up TeleVantage 5.0
Shutdown Dialogic SR 5.1.1 Service Pack 1
Install Dialogic Driver Updates
Upgrade MSDE (Optional)
Upgrade TeleVantage Server
Upgrade Workstation Applications
Upgrade TeleVantage Web Services (Optional)
Enter and Activate Licenses
Installation CDs
TeleVantage 6.0 is supplied as a set of two CDs.
The Drivers CD contains the installation packages for Dialogic SR5.1.1, Dialogic SR5.1.1
Feature Pack 1, and the “Dialogic Driver Updates”, which is a collection of post-Featuer Pack 1
patches with an Artisoft installation program. Also included is the Rainbow Technologies Drivers
to support TeleVantage licensing with dongles.
The Master CD contains the installation programs for Microsoft Data Engine (MSDE),
TeleVantage Server, TeleVantage Web Services, and other adjunct TeleVantage programs.
Shut Down and Back Up TeleVantage 5.0 Server
To begin upgrading your TeleVantage 5.0 server to TeleVantage 6.0, open the Services applet in
the Windows Control Panel (Figure 145).
Figure 145. Windows Services Applet
- 167 -
Find the “TeleVantage server” service and open the properties of the service (Figure 146). Set
the service to manual start. If you have the TeleVantage Conference Manager or the SMDR
Service installed on the server, you should stop these services and set them to manual start, also.
Figure 146. TeleVantage Server Service Properties
Close the Services applet and open TeleVantage Administrator or Device Monitor. Shut down
TeleVantage server (Figure 147) using the Tools>”Shut down server” command.
Figure 147. TeleVantage Shutdown Dialog in Administrator
Backup your current TeleVantage 5.0 database and registry settings by selecting Tools>”Backup
Database” (Figure 148).
- 168 -
Figure 148. TeleVantage Administrator Tools Menu
A warning appears (Figure 149). Select “OK” to complete the backup.
Figure 149. Database Backup Warning
When the backup has completed, the dialog shown in Figure 150 is displayed. Select “OK”.
Figure 150. Database Backup Complete Dialog
Close the Administrator program.
- 169 -
Copy the following files to a safe location, either to a drive on another computer on the network,
or to some form of backup medium, such as tape or a CD-ROM.
\Program Files\TeleVantage Server\Data\Backup\tvdb.dmp
\Program Files\TeleVantage Server\Data\Backup\tvserver.reg
\Program Files\TeleVantage Server\Vfiles and its subdirectories
\Program Files\TeleVantage Server\AccountCode\AccountCode.txt
\Program Files\TeleVantage Server\Archive\CallLog.csv
You may also wish to export any public contacts defined on the server, and the contents of the
Extensions view, and save the resulting CSV files to another computer or backup medium.
These files may be useful if a catastrophic problem occurs during the upgrade process, requiring
you to rebuild the original server configuration.
Shutdown the Dialogic SR 5.1.1 SP1 Drivers
From the Windows Start Menu, select Programs>”Dialogic System Software”>”Dialogic
Configuration Manager (DCM)”. (See Figure 151.)
Figure 151. Dialogic Configuration Manager
In DCM , stop the Dialogic drivers. When the drivers have stopped, DCM displays the dialog box
shown in Figure 152. Hit the “Close” button to dismiss the dialog box.
- 170 -
Figure 152. Dialogic Service Stopped Dialog
Close DCM.
(Note: The procedure described above will usually leave the two lowest-level Dialogic services,
CTBusBroker and DM3Config, running. A good practice is to stop both of these services before
upgrading or uninstalling any Dialogic software. To stop these two services, open the Services
applet in Windows Control Panel and stop the “CT Bus Broker” service. The DM3Config service
is dependent on this service and will be also be stopped by Windows’ Service Control Manager.)
Upgrade Intel Dialogic SR 5.1.1 Drivers
Insert the TeleVantage Drivers CD into the machine’s CD drive. If the “Drivers Setup” screen
(Figure 153) does not appear, double click on “autorun.exe” in the root directory of the CD.
- 171 -
Figure 153. Driver Setup Screen
Select “Intel® Dialogic SR5.1.1 FP1 FR”. This will upgrade the existing install of Service Pack 1 to
the latest build of Feature Pack 1. The System Release 5.1.1 Feature Pack 1 Welcome window
(Figure 154) is displayed.
- 172 -
Figure 154. Dialogic FP1 Setup Dialog
(Note: Sometimes this dialog box appears behind the Driver Setup screen. If the FP1 Setup
screen does not appear, close the Driver Setup screen by choosing “Exit to Desktop” .)
Choose “Next” to begin the installation. The installation program starts by checking for installed
components. (See Figure 155.)
Figure 155. Dialogic FP1 Copying Files Dialog
A few minutes later, the following dialog box (Figure 156) appears, and the installation program
begins copying files and configuring the feature pack software.
Figure 156. Dialogic FP1 Please Wait Dialog
The installation continues until the dialog box in Figure 157 appears.
- 173 -
Figure 157. Dialogic FP1 Reboot Prompt
Select “Yes” and then “Finish” to complete the installation and reboot the computer.
When the system has rebooted, log in to Windows again.
Figure 158. Dialogic FP1 Setup Complete
- 174 -
The dialog box in Figure 158 appears. Select “Finish” to close the dialog box. The installation of
the feature pack is now complete. The next step in the upgrade procedure is the installation of
the Dialogic Driver Updates.
Install Intel Dialogic Driver Updates
After successfully completing the installation of Intel Dialogic SR 5.1.1 SP1, you must install the
Intel® Dialogic Driver Updates. Return to the Driver Setup program (Figure 159).
Figure 159. Driver Setup Screen
Select “Intel® Dialogic Driver Updates”. The dialog in Figure 160 appears .
- 175 -
Figure 160. Dialog Driver Updates Setup Start Dialog
Select “Next” to start the installation and begin copying files. While the installation is copying files
and configuring the driver updates, the dialog box shown in Figure 161 can be seen.
Figure 161. Dialogic Updates Installing Dialog
When the installation program has finished installing the updates, the dialog box in Figure 162 is
displayed.
- 176 -
Figure 162. Dialogic Updates Reboot Prompt
Choose “Yes” and click “Finish” to reboot the server.
After the operating system has reloaded, log on to Windows. The Intel® Dialogic Driver Updates
installation program will run and complete the configuration of the software package. The dialog
box in Figure 163 will appear.
- 177 -
Figure 163. Dialogic Updates Complete Dialog
Select “Finish” to end the installation program. The Dialogic Driver Updates are now installed on
the server.
Assuming you are upgrading a working TeleVantage 5.0 server, and have not added any new
Dialogic boards to the system, nor changed the of the settings of the existing boards prior or
during this upgrade procedure, then no further configuration of the Dialogic drivers is necessary.
It would be prudent to start DCM, verify your boards are properly detected and configured, and
start the Dialogic SR 5.1.1 drivers to verify they are operating properly before proceeding to the
next step in the upgrade procedure, upgrading the Microsoft Data Engine (MSDE) software.
Upgrade MSDE (Optional)
If your server is running MSDE 1.0, MSDE 2000 with a service pack earlier than Service Pack 3,
or Microsoft SQL Server 7.0 Desktop Edition, you may consider upgrading to MSDE 2000 SP3a
using “Microsoft Data Engine” install step in the Master Setup program. See <ref> for more
information on upgrading various versions of Microsoft SQL Server.
This step is complete optional, assuming your server has some working version of MSDE or
Microsoft SQL Server running on it.
Before you can run the MSDE installation program, you must exit all TeleVantage applications
running on the server. As subsequent steps in the upgrade process will also require you to
reboot a number of times, and each step requires the Device Monitor, starts automatically at
logon, to be shut down before proceeding, it is a good practice disable automatic startup of
Device Monitor at this point. First, exit the program by right-clicking on the system tray icon and
choosing “Exit Device Monitor”. (See Figure 164.)
- 178 -
Figure 164. Exiting Device Monitor
To remove Device Monitor from Startup program group, select Start>Programs>Startup, and then
right-click on “TeleVantage Device Monitor” (Figure 165). Choose “Delete” to delete the shortcut
from the Startup program group.
Figure 165. Device Monitor Shortcut in Window Startup Program Group
Remove the Driver CD from the CD driver, and insert the Master CD. If the Master Setup screen
(Figure 166) does not appear automatically, run the “autorun.exe” program on the root of the
Master CD.
- 179 -
Figure 166. Master Setup Screen
Choose “Microsoft Data Engine”.
The MSDE 2000 SP3a Setup dialog box (Figure 167) will appear:
- 180 -
Figure 167. MSDE Setup Dialog
Choose “Next” to begin the upgrade. The dialog box in Figure 168 will appear.
Figure 168. MSDE Setup Ready Dialog
Hit “OK” to proceed with the installation. A dialog box similar to that shown in Figure 169 appears.
The installation program begins copying files and configuring the database engine.
Figure 169. MSDE Please Wait Dialog
- 181 -
When the process is complete, the installer prompts you to reboot the machine by displaying the
dialog box in Figure 170.
Figure 170. MSDE Reboot Prompt
Choose “Yes” to reboot the server machine. When the operating system has restarted, log into
the console again. The dialog box in Figure 171 is displayed. Choose “Finish” to exit the
installation program.
Figure 171. MSDE Setup Finished
Upgrade TeleVantage Server
Prior to starting the installation program for TeleVantage 6.0, it is necessary to stop the
TeleVantage 5.0 Device Monitor and to remove it from the Windows Startup program group, if
you have not already done so. See Upgrade MSDE (Optional) on Page 178 for instructions.
Return to the Master Setup screen (Figure 172).
- 182 -
Figure 172. TeleVantage Master Setup Screen
On the Master Setup screen, select “TeleVantage Server”. The installation program begins, and
the welcome dialog (Figure 173) is displayed.
- 183 -
Figure 173. TeleVantage Server Setup Welcome
Choose “Next” to continue the upgrade. The warning shown in appears.
Figure 174. TeleVantage Server Setup Backup Warning
Choose “OK” to continue.
The TeleVantage server license agreement (Figure 175) is displayed. Select “Yes” to agree to
the terms of the license agreement and continue the upgrade.
- 184 -
Figure 175. TeleVantage Server Setup License Agreement
The Language Selection dialog (Figure 176) appears. The languages installed on your
TeleVantage 5.0 server are pre-selected. You may add or remove a language by checking or
clearing the checkbox next to a particular language.
Figure 176. TeleVantage Server Setup Language Selection Dialog
- 185 -
Choose “Next” after making any desired modifications. The following dialog (Figure 177) appears.
You may choose “Preserve existing” to add any new system prompts without modifying your
existing prompts, or “Backup and overwrite” to move your existing prompt to a backup directory
and install a complete set of TeleVantage 6.0 system prompts into your \Vfiles folder. The default
is “Preserve existing”. Choose the desired setting for your installation and then select “Next”.
Figure 177. TeleVantage Server Setup Voice Files Upgrade Dialog
The Windows Account Information dialog (Figure 178) is displayed next.
- 186 -
Figure 178. TeleVantage Server Setup Windows Account Info Dialog
In the “Name” field, the Windows account currently logged in is pre-selected. Either accept this
name or enter a valid Windows account for the security context you wish your TeleVantage
server and its components to run under on this server. Enter the current password for the
account in the “Password” field. Choose “Next” to continue. The SQL Server System
Administrator Password dialog (Figure 179) appears. Enter and confirm the password you would
like to assign to the SA account. Then choose “Next”.
- 187 -
Figure 179. MSDE SA Password
Figure 180. TeleVantage Server Setup Start Copying Files Dialog
The installation program displays the dialog in Figure 180. Select “Next”.
The upgrade begins with the installation program executing a number of SQL procedures to
upgrade the TeleVantage 5.0 database to TeleVantage 6.0 format (Figure 181).
- 188 -
Figure 181. TeleVantage Server Setup SQL Script Progress Dialog
When this procedures have been run, the installation program stops MSDE, and then begins
copying the TeleVantage program files from the CD to the hard drive (Figure 182).
Figure 182. TeleVantage Server Setup File Copy Progress Dialog
Eventually, the dialog in Figure 183 is displayed. Choose “Yes, I want to restart my computer
now”, and then “Finish” to restart the server and continue the installation process. Leave the CD
in the CD drive, as the installation program will restart after the operating system loads and
attempt to access the CD again.
- 189 -
Figure 183. TeleVantage Server Setup Reboot Prompt
After the system reboots, log on to the system using the same Windows account used for the first
portion of the installation. The installation program runs and continues to copy files and
configure the TeleVantage server software after you log on.
After the voice files are copied from the CD, MSDE is restarted, and the installation program
executes some final SQL scripts.
Finally, the dialog shown in Figure 184 is displayed. By default, the “Launch TeleVantage
Workstation installer” checkbox is checked. The TeleVantage Workstation Installer is used to
install, uninstall, or upgrade the Client, Administrator, TAPI Service Provider, Contact Manager
Assistant, and Recording Browser software. If this option is chosen, the Workstation Installer is
run and any of these workstation applications that are installed on the server are upgraded. If
unchecked, the TeleVantage server installation program exits without upgrading any of the
workstation applications. For this upgrade procedure, leave the box checked and select “Finish”.
The TeleVantage server software installation is complete. The next step is to upgrade the
Administrator program and any other workstation applications installed on the server, so that the
server licenses can be entered and the server can be started.
- 190 -
Figure 184. TeleVantage Server Setup Complete Dialog
Upgrade Workstation Applications
At any time after upgrading TeleVantage server, you can upgrade the workstation application
programs: the Client, Administrator, TAPI Service Provider, and Contact Manager Assistant.
(Typically, only the Client, Administrator, and, possibly, the Archived Recording Browser
programs are installed on the server.) To do so, you need to run the Workstation Installer
program, which is located in the \Netsetup share on the TeleVantage server. The executable for
the Workstation Installer is called “setup.exe”. The following assumes the Workstation Installer
program was run at the end of the TeleVantage server installation by checking the “Launch
TeleVantage Workstation installer” checkbox.
The first dialog presented by the Workstation Installer is shown in Figure 185.
- 191 -
Figure 185. TeleVantage Workstation Setup Welcome Dialog
Choose “Next” to continue. The License Agreement dialog (Figure 186) appears.
- 192 -
Figure 186. TeleVantage Workstation Setup License Agreement
Select “Yes” to accept the terms of the license agreement and then “Next” to proceed to the next
dialog.
Normally, the TeleVantage Server Information (Figure 187) dialog is displayed. If you are running
the installer on a TeleVantage server, however, the installer assumes the you will be connecting
to the local machine, and this screen is skipped. If this screen appears, enter the name of the
TeleVantage server and the station number of the telephone handset located near the server, if
any. If there is no station near the server machine, enter “0” for the station number.
- 193 -
Figure 187. TeleVantage Workstation Setup Server Info Prompt
Also, choose the user or users that will be configured to use the TeleVantage application
programs on the server. The possible choices are “all users” or “only the current user”.
Select “Next” to continue.
- 194 -
In the Setup Type dialog (Figure 189), specify what applications will be upgraded or installed on
the server. Choose “Typical” to upgrade any Version 5.0 application programs already installed
on the server. Choose “Custom” if you wish to specify which applications to upgrade, install, or
uninstall.
Figure 188. TeleVantage Workstation Setup Type Prompt
This upgrade procedure assumes only TeleVantage Administrator and Client are installed on the
server. Choose “Typical” to upgrade these two programs to Version 6.0. After selecting a setup
type, click on “Next”.
For more information on the “Custom” option, see Installing TeleVantage.
After selecting a setup type, the installation program displays the dialog shown in Figure 189.
Choose “Install” to begin the installation process.
- 195 -
Figure 189. TeleVantage Workstation Setup Ready Dialog
The installation program will begin to copying files and configuring the various program elements.
The progress bar shown in Figure 190 is displayed during this process.
Figure 190. Installing TeleVantage Workstation Applications Dialog
- 196 -
When the Workstation Installer program has finished, the dialog in Figure 191 appears.
Figure 191. TeleVantage Workstation Setup Complete Dialog
Choose “Finish” to exit the Workstation Installer.
If you have TeleVantage 5.0 Web Services installed on this server, follow the procedure in the
next section, Upgrade TeleVantage Web Services. If you are not using TeleVantage Web
Services, proceed to Enter and Activate Licenses on Page 204.
- 197 -
Upgrade TeleVantage Web Services
This section describes the steps needed to upgrade an existing installation of TeleVantage Web
Services from Version 5.0 to Version 6.0. If Web Services is running on the TeleVantage server,
exit Device Monitor by right-clicking on the Device Monitor icon in the Windows System Tray and
selecting “Exit”. Insert the TeleVantage Master CD in the server’s CD driver. At the Master
Setup screen (Figure 192), choose “TeleVantage Web Services” to begin the upgrade.
Figure 192. TeleVantage Master Setup Screen
The Welcome dialog is displayed (Figure 193). Click “Next” to continue.
- 198 -
Figure 193. Web Services Setup Welcome Dialog
At the License Agreement dialog (Figure 194), choose “Next”.
- 199 -
Figure 194. Web Services Setup License Agreement
Figure 195. Web Services Setup Server Information
- 200 -
The Server Information dialog (Figure 195) prompts you for the name of the TeleVantage server
ViewPoint Web Services should connect to. Enter or correct the information and select “Next”.
The Setup Type dialog () Figure 196 is then displayed. Choose “Typical” and then hit “Next”.
Figure 196. Web Services Setup Setup Type
- 201 -
Figure 197. Web Services Setup Ready to Install Dialog
When the dialog in Figure 197 appears, click “Install” to begin the upgrade. The “Installing the
TeleVantage Web Service dialog (Figure 198) displays the progress of the operation.
- 202 -
Figure 198. Web Service Setup Installing Dialog
When the installation program has finished copying files and configuring the program elements of
Web Services, the “Install Completed” dialog (Figure 199) is displayed. Select “Finish” to exit the
installer.
- 203 -
Figure 199. Web Services Setup Complete Dialog
The installation of TeleVantage Web Services for Version 6.0 is complete
The next step is to enter and activate the new TeleVantage 6.0 licenses and start the server.
Enter and Activate Licenses
The next step in the upgrade process is to enter and activate your TeleVantage server licenses.
Contact your distributor (or Artisoft Sales) for information on purchasing licenses and receiving
license codes. TeleVantage 6.0 license codes, as purchased, are good for 60 days, after which,
if the licenses have not been activated, certain server functions are disabled. See Installing
TeleVantage, Appendix F, Managing TeleVantage License, for more information.
The following procedure requires:
•
The TeleVantage server machine has TCP Port 80 connectivity to Artisoft’s license
activation server, activation.artisoft.com.
•
The TeleVantage 6.0 licenses are in the standard electronic format (XML).
Open and log on to the TeleVantage Administrator program. Select “System Settings” on the
Tools menu, and navigate to the “Licenses” page (Figure 200).
- 204 -
Figure 200. Licenses Page in the Administrator Program
Select “Import” and find your license file, then choose “Open”.
After importing the license file into the Administrator program, return to the Licenses page and
choose “Activate”. Fill in the information required on the Activation Information dialog (Figure
201). Select the hardware key you wish to lock your licenses to. Select “OK” to activate the
licenses. The Administrator program contacts the license activation server. The activation server
makes the appropriate changes to your licensing and returns a set of activated licenses to the
Administrator program.
- 205 -
Figure 201. Activation Information Dialog
When the activation process is complete, the dialog box in Figure 202 is displayed.
Figure 202. License Activation Complete Dialog
Choose “OK” to close the dialog box. Your licenses are now activated.
Export the activated licenses and save the resulting file in a safe place. The activated licenses
may be needed if it becomes necessary to restore or rebuild the TeleVantage server.
- 206 -