Tabs3 Device Interface (TBDevice)
Avaya Data Format

Overview

The Tabs3 Device Interface (TBDevice) software (Avaya Format) is used to convert telephone expense transactions from Avaya’s Call Data to be compatible with the Merge Tabs3 Remote Data program. The Avaya system saves data to a file called SMDR.csv, which contains ASCII comma delimited data. The SMDR.csv file contains a record of incoming and outgoing phone calls. Outgoing calls are further classified as internal or external calls. The Avaya Tabs3 Device Interface (TBDevice) format only converts outgoing external calls. All other calls are skipped.

The Tabs3 Device Interface (TBDevice) program must reside in the same directory as the Tabs3 programs in order to work properly.

Installation

The Tabs3 Device Interface (TBDevice) program must be installed to the directory on your hard disk where the Tabs3 program resides. The Tabs3 program directory can be found in Tabs3 by selecting Help | About Tabs3.

  1. Insert the enclosed CD-ROM into your CD-ROM drive.
  2. A CD Browser program will automatically start. 

    Note:  If the CD-ROM Autorun feature is disabled, click the Start button, and then click Run... Click the Browse button and navigate to the CD-ROM drive. Double-click the LAUNCH.EXE file. Click OK.
  3. Follow the on-screen instructions to install the selected systems.

Configuring the Data Collection Device Type

Before you can convert any data from a data collection device, Tabs3 Device Interface (TBDevice) must be configured to handle the necessary format. The main purpose of the configuration is to specify a default tcode and rate.

  1. From the Tabs3 & PracticeMaster folder, double-click the Data Collection Device Conversion icon to start the Tabs3 Device Interface (TBDevice) software.
  2. If the Logon dialog box is displayed, enter your User ID and Password and click OK.
  3. From the File menu, select the Configure option.
  4. The Configuration window will be displayed. Click the drop-down arrow next to the Device field and select Avaya.
  5. In the File field, type the name of the file containing the data from the collection device (i.e., SMDR.csv).
  6. Select the Default check box if you want to make the Avaya device the default in the Conversion program.
  7. Click the drop-down arrow next to the Tcode field to select the transaction code number that you use for phone calls.
  8. In the Rate field, specify the rate you want to use to calculate the amount for transactions.
  9. Click the More Config button.
  10. In the Descriptions section, select the Use Tcode Descriptions check box if you want the tcode description to be used in the cost transaction’s description field. Clear this check box if you want a blank transaction description instead. Select the Upper Case Text check box if the Use Tcode Descriptions check box is selected and you want to use all upper case letters in the cost transaction description.
  11. Click OK.
  12. Click the Save button.
  13. Close the Configuration window.

Converting the Avaya Data

Use the following procedure for the conversion:

  1. Copy the file containing the data from the collection device (i.e., SMDR.csv) to the Tabs3 directory.
  2. If the Tabs3 Device Interface (TBDevice) program is already started, skip to step 4. From the Tabs3 & PracticeMaster folder, double-click the Data Collection Device Conversion icon to start the Tabs3 Device Interface (TBDevice) program.
  3. If the Logon dialog box is displayed, enter your User ID and Password and click OK.
  4. From the File menu, select the Convert option.
  5. The Conversion window will be displayed. If the Avaya device is not displayed in the Device field, click the drop-down arrow next to the Device field to select the Avaya format.
  6. Verify that the file name to be converted is displayed in the File field.
  7. Click the Convert button. The program will look for the file name specified in the Configuration window. If the file is found to contain data, the program will read transactions from the file and increment the Processed count for every transaction that is read. All transactions that are successfully converted will increment the Added count and will be written to the Tabs3 Remote data files (RMT*.*).

    Note: A TBDEVICE.LOG file is created and will contain any records that were not converted. If no errors were encountered during the conversion, then the TBDEVICE.LOG file will include a start and finish time.

    Note: If you are using a full user system, the data file containing the logged phone calls will automatically be deleted when the conversion is complete to avoid double posting of the data. However, when using a trial system, the data file is not deleted.
  8. When the process is complete, the data files will have been created allowing you to merge the information into Tabs3 using the Merge Tabs3 Remote Data program. To merge the files, start Tabs3. From the Integration Task Folder, select Merge Tabs3 Remote Data. This program will merge the remote data files created by the Tabs3 Device Interface (TBDevice) program (RMT*.*) with your main Tabs3 data files. The Tabs3 Help includes complete details regarding the Merge Tabs3 Remote Data program.

Note: You can change the phone call transaction code, default rate and the detail description options used by the Avaya format by selecting File | Configure.

Input Field Positions

Field #

Field Name

Converted?

Description

1

Call start

Yes

Date and time of call in "YYYY/MM/DD HH:MM:SS" format.

2

Call duration

Yes

Duration of the call in "HH:MM:SS" format.

3

Ring duration

No

Duration in seconds of the ring time of the call.

4

Caller

No

The callers’ number.

5

Direction

Yes

The direction of the call – I for Inbound, O for outbound.

6

Called_number

No

The number called.

7

Dialed_number

No

Identical to the called number for internal and outbound calls.

8

Account

Yes

The last account code attached to the call.

9

Is_Internal

Yes

0 or 1, denoting whether both parties on the call are internal (1) or external (0).

10

Call ID

No

The Call ID is a 10 digit number assigned by the IP Office SMDR.

11

Continuation

No

1 if there is a further record for this call, 0 otherwise.

12

Party1Device

No

The device number for the first party on the call.

13

Party1Name

No

The user name or line number for the first party.

14

Party2Device

No

The device number for the second party on the call.

15

Party2Name

No

The user name or line number for the second party.

16

Hold_Time

No

Duration in seconds of the hold time of the call.

17

Park_Time

No

Duration in seconds of the park time of the call.

Notes

Sample Data File

The following is an example of an Avaya SMDR.csv file. Please note that lines that were too long to fit on the page were wrapped to the next line and indented in this example so the text can be seen on the printed copy. Actual transactions in a real data file will appear as one continuous line.

"Call start","Call duration","Ring duration","Caller","Direction","Called_number","Dialled_number","Account", "Is_Internal", "Call ID", "Continuation", "Party1Device", "Party1Name", "Party2Device", "Party2Name", "Hold_Time", "Park_Time"

2009/10/06 14:37:40,00:05:07,0,8964,O,8963,8963,10000,1,1000000000,0,E8964,Erin,E8963,Vicki,5,0
2009/10/07 14:37:27,00:10:19,2,95403547075,I,200,200,10100,0,1000000001,1,E8964,Erin,T9001,ANALOG Channel 1.1,4,7
2009/10/08 14:37:27,00:15:18,5,95403547075,I,200,200,10200,0,1000000001,0,V9502,VM Channel 2,T9001,ANALOG Channel 1.1,0,0
2009/10/09 14:39:37,00:20:24,0,8964,O,7,7,20001,0,1000000002,0,E8964,Erin,T9041,ANALOG Channel 2.1,0,0

Startup Options

Command line options can be used when starting Tabs3 Device Interface (TBDevice) to bypass the User ID prompt and automatically execute the Convert programs thereby eliminating user interaction. These startup options can be quite useful when implemented as part of a batch file.

The following are examples of the available startup options:

Bypass the User ID prompt C:\Program Files\Tabs3\TBDEVICE.EXE ALICE

Convert C:\Program Files\Tabs3\TBDEVICE.EXE /CONVERT Avaya

Note: The normal "sign in" routine is used when Tabs3 Device Interface (TBDevice) is started with the "/CONVERT" option. If you have not specified a User ID on the command line, you will be required to enter the User ID. If password security has been defined, you will also be required to enter the password before the Convert program will proceed.

The Tabs3 Device Interface (TBDevice) Help includes complete details regarding Startup Options.

20090115