ipoffice testing

TAPILine

TAPILine is a utility used to troubleshoot integration issues on systems that interface with the PBX using the TAPI protocol (e.g., Avaya IP Office and Panasonic KX-TDA). It connects to the PBX using the same hooks as the voice mail system, allowing you to visually monitor all integration data sent from the PBX. Using TAPILine you can monitor any station that is connected to the PBX.

TAPILine is entirely independent of the 7.00 service; neither requires the other to be running in order to operate correctly.

When TAPILine is initially started, it displays only a blank window. Before it can display any integration data, you must first establish a connection to the PBX. Select File from the main menu as shown in the figure below. Then select either Open Avaya IPOffice or Open Panasonic KX-TDA, depending on which PBX your system is connected to.

You can also right-click within the main window to display a context menu from which you can select either of the PBX options previously listed. TAPILine uses the right-click context menu for controlling most features.

After you select the PBX with which to connect, the application will attempt to load the TAPI driver for the selected PBX. It will then display a message box with one of the following messages:

MessageMeaning
Successfully connected to PBXTAPI driver was successfully configured and was able to connect to the PBX.
Unable to initialize TAPITAPI is not installed, or cannot be initialized under Windows.
Unable to load TAPI extensionsTAPI driver was not able to connect to the PBX and retrieve the list of extensions. Check the TAPI driver configuration for your PBX.

Once you have connected to the PBX, right-click anywhere on the grid and select Open device(s). This will open the Select Extension dialog, shown below, which allows you to select the extensions or devices you wish to monitor. Note that how extensions and devices are listed in the dialog will differ depending on the PBX type.

The example below shows a system that is connected to an Avaya IPOffice PBX.

For best results, choose to monitor all the VMS extensions and one or more extensions that you are using for testing. Select the devices to monitor and click OK. You can re-open this dialog at any time by right-clicking anywhere on the grid where no data is being displayed.

Each device (or extension) will appear in the grid as a separate row of data, as shown in the Monitoring Devices section below.

The Panasonic is very slow at enumerating the list of extensions and devices on the PBX, which causes the ports to start slowly. However, once the connection is established, you will see no slowdown in performance.

Extensions on the Avaya IPOffice can be configured to be hidden from the directory; any such hidden extensions cannot be monitored, nor will they integrate.

Once you have opened one or more devices, the grid window will change to display a table with several columns, as shown in the figure below. Each row in the table represents a single extension or device.

The following data items are displayed (when relevant; depending on the call type, some information may not be present):

ColumnDescription
NameDevice name given by the PBX.
ExtensionThis is the extension the switch told us it was or we interpreted it as. Panasonic does not provide the extension number, so we decode the name instead.
StateDevice state: Idle, Offering, Accepted, DialTone, Dialing, RingBack, Busy, Connected, Held, Conferenced and Disconnected.
Call TypeType of call received: Direct, FwdBusy, FwdNoAnswer, FwdUncond, Transfer and Unknown.
OriginWhere the call originated (not always accurate, especially on the Panasonic): Inbound, Outbound, Internal, External and Unknown.
Caller IDThe calling party's number.
Caller NameThe calling device's name.
Called IDThe called party's number.
Called NameThe called device's name.
Redirecting IDThe number of the device that redirected the call to this device.
Redirecting NameThe name of device that redirected the call.
DisplayTelephone display text, if available. Not always accurate.
TrunkTrunk number (if known).
Call IDUnique call number provided by the switch.
Outgoing BlockedWhether the device is blocked from making calls (IPOffice only).
Last TAPI MessageLast TAPI message sent from the PBX.

Right-clicking on a device will display a context menu providing several actions that can be performed on the device:

ActionDescription
CloseRemoves the device from the list of monitored devices.
Set MWITurns the device's message waiting indicate on. (IPOffice only).
Clear MWITurns the device's message waiting indicator off. (IPOffice only).
BlockBlock the device from making outgoing calls. (IPOffice only).
Un-BlockUnblock the device from making outgoing calls. (IPOffice only).
  • Last modified: 2023/01/07 11:45
  • by 127.0.0.1