3. Using of the Program "Blitz TAPI SMDR"

3.1 Run the program.

This shortcut has appeared in your desktop after installation.

3.2 Setting of the program.

Program Blitz TAPI SMDR during the work uses some database. That is why the program will ask you to point where the table of modification of number Caller ID layouts when you start this program at first time, for example if it has installed for other CTI application of series Blitz.

Also you should point the format of database of calls and location of the file of this database.

You can do all it at once press the button "yes", and also you can do it later. Then the initialization of TAPI-interface begins.

3.2.1 To set TAPI-interface.

This window allows to set TAPI-client, to set automatic observation over status of TAPI interface and its automatic restoring in case of the cessation of its work.

Control and restoration TAPI.

• Option "TAPI reinit, if KX_STATUS is lost" Х "times" - allows to switch on/off mechanism of the control and automatic restoring of TAPI-interface based on KX_STATUS message. Parameter X define the quantity of KX_STATUS message which were missed one after another and after then TAPI will be reinitialize.
• Parameter "Interval for "KX_STATUS",sec." - define time space in seconds through what we must get KX_STATUS message.
• Option "Restart a telephony if has not received KX_RETRIEVE during" Y "minutes" - order to restart service Telephone and to reinitialize TAPI if TSP-driver don't send KX_RETRIEVE event during Y minutes after KX_REINIT event was received.
• Option "Connect MS-TAPI client before the initialization" - defines whether will be the connection of TAPI-client to TAPI server, before the automatic initialization TAPI in case of cessation of TAPI initialization. If TAPI interface with PBX are installed on this computer, this option doesn't need to be switched on.
• Parameter "The name of file log" - the name of file, where all errors and events will be recorded in an operating time of the program. There is the file log in program installation folder if path to the file log is not pointed. The filename extension *.log will be added to the filename of the file log.

Connect / Disconnect to TAPI-servers.

These settings are used, if computer on which Blitz TAPI SMDR installed receives the information means standard Microsoft Windows "TAPI-client" with TAPI server on computer network.

• In the field "Command line" the result command line is reflected, which automatically start on execution by pressing the button "Connect".
• Option "Callbacks" sets the option of command line of settings TAPI-client. It is intended for case, if TAPI client have to contact with TAPI-server through overload net, or through the poor quality net.
• To input new, delete or change the names of TAPI-server, you need to press the button "The list of servers" - in this case other dialog window will open, which permits to do this.
• Button "Connect" runs the command settings of TAPI-client.
• The button "Client disable" makes relation back - disconnected from all TAPI-servers.

The list of servers

This list consists from 2 columns:

• The column "Server" sets Net-BIOS or domain name of TAPI-server.
• The column "Use" set, whether TAPI-client should be connected to this TAPI-server. If the icon "Cross" is depicted (haven't chosen), that this TAPI-server will be lacking in the list of TAPI-server in the dialing window "To set TAPI-interface" and connection won't be made to it. To change the status "to select/not to select" You need to click twice on the icon by the mouse.

3.2.2 Initialization of TAPI-interface.

During start the program initialization of TAPI-interface is made automatically and during which all found out TAPI-lines view.

But if any of TAPI-lines have not found out, you would see the interactive prompt to eliminate error with TAPI-interface.

After you have eliminated error you have an opportunity to run the initialization of the TAPI-interface without running the program.

3.3 Main settings.

3.3.1 To set Database.

You need to point out the format of Database calls in Database settings, where the information about will be logged.
You can select WinTariff 1.72, WinTariff 2.х, Text file, File CSV (Excel) for Blitz TAPI SMDR and in addition Microsoft Access, MySQL, MS-SQL, Firebird for Blitz TAPI SMDR PRO .

Then depending on selected format of DB calls you need to point out or path to files of calls, or address of SQL server, database name, login and password. In case you selected the format of file of calls Wintariff, DBF format of table is used or its name must be Calls.dbf and it is necessary from capital letter and path to it must be the same as in module of processing Wintariff 1.7x or Wintariff 2.x (you can also point it in tab "Folders").

3.3.2 To set SMDR.

These settings define the type of calls, which will be logged in the database. If calls will be logged in the text file, you can select the format of data and time.

To log the calls:

• Incoming outside calls - whether the incoming calls will be displayed and logged.

Outgoing calls:

• Intercom calls - if calls from EXT to EXT number will be displayed and logged.
• Local calls - if local calls will be displayed and logged.
• Long-distance calls - if long-distance calls will be displayed and logged.
  Field "Prefix" sets prefix for output on long-distance line.
• International calls - if international calls will be displayed and logged.
  Field "Prefix" sets prefix for output on international line.
• Calls not shorter (than second) - minimal duration of a call (after the subscriber has answered the call), at which the calls will be logged in database. If in this field the value is equal to "0", all calls with any duration will be logged.
• Not answered calls - whether not answered calls will be logged in database.
• Option "Meter pulse" / "Cost" - if you select format WinTariff 2.x, this option defines what will be logged in the file of calls.

3.3.3 Modification of number Caller ID.

These settings are used to cast numbers Caller ID, which are received at incoming calls from different CO from different operators to the one legible type. While setting the modification of number Caller ID you will see next window:

• Parameters of the Caller ID number - these are the parameters of the number, which are given by the operator.
• First digits - these are the digits from which the Caller ID number begins, which need to be modified.
• The number of digits - the number of figures in number Caller ID, which need to be modified.
• Parameters of modification - these are the necessary modifications of the number Caller ID.
• Delete digits - the numbers of digits moved away in the beginning of the number Caller ID at modification if all the parameters of number Caller ID have concurred.
• Add number - this is the prefix, which is added in the beginning of the number Caller ID, residuary after removal.
• Path to DB - The name of file of the table of modification and path to it (Also you can point out it in the tab "Folder").
• Switch on modification - This option allows to switch on/off the modification of number Caller ID at incoming calls.

3.3.4 COS.

This window displayed the status of COS service table for each external number, it allows to permit or to forbid management COS service and change the name of EXT line for other programs, for example WinTariff.

File with description of interface of interaction the other software with Blitz TAPI SMDR PRO about changing the COS and the name of EXT line of PBX Panasonic KX-TD, KX-TDA you can download on this page.

• EXT - the number of extension line.
• Name EXT - the name of extension line.
• COS - the current number of COS service, which is established at the present moment in PBX for this line.
• Use - permits or forbids other software to establish number COS service for this line. If pictogram tick or cross are painted in grey colour, it means that external line is out of service or it's absent and it's impossible to change the number of COS service.
• COS 1, COS 2, COS 3 ... - number of COS service, which other software selects for this line.
• PBX - type of PBX, to which possesses this line.
• Status - it is status of the external line. Line can have three statuses:
  • INS - line is in service, it can be controlled;
  • OUTS - line is out of service. For example, if system telephone set is disconnected;
  • None - line is absent. The possible reasons of this can lie in changing line's identifier, in disconnection of cable between PBX and computer, in exchanging the card of external numbers in PBX, etc.
• Parameter Time of COS changing, sec. - maximal time which is necessary in order that PBX executes changing of COS number for one external line.
• Parameter Interval of COS table's reading, sec. - in this interval of time testing of all external lines and reading information about for what external line it is necessary to change the number of COS service are executing.
• Parameter Amount of COS columns - amount of COS columns in COS.dbf table. It's possible to define from 3 to 96 of columns. Before modification of COS.dbf t's necessary to close all applications that can use it, for example, WinTariff.
• Button "Browse" - allows to point the path of a file COS.dbf

3.3.5 Folders.

This window allows to establish the arrangement of files and tables of calls, modification Caller ID, and table COS.dbf only for ver. Blitz TAPI SMDR PRO.

• "Table of calls" - allows to establish the path of the file of calls.
• "Table of CallerID modification" - path of the file of table modification Caller ID
• "Table COS.dbf" - path of the file of COS.dbf (for ver.Blitz TAPI SMDR PRO).

3.4 Work with program.

The work with program consists in observation over calls.

The description of table columns:

• Date - the date when the call was made.
• Time - the time when the call was made. For incoming calls - this is the time when the telephone began to ring. For outgoing calls - this is the time when subscriber raises the phone to dial the number.
• EXT - the number of extension telephone line.
• CO - the number of port to which urban telephone line is connected or gateway GSM, through which the call was made.
• Dial number - at outgoing call this is the telephone number, which the subscriber has dialed, including special symbols as "pause", transition in a tone dialing, etc., at incoming calls - the number of subscriber Caller ID who is making call. The format of Caller ID is determined by PBX, which sends the number, and by table of modification Caller ID. If the number Caller ID is not determined at incoming call, the number is not displayed. Also at incoming calls before the number of Caller ID the insertion "<Incoming>" is added, which means that this is incoming call.
• Duration - shows the duration of conversation. At incoming and outgoing extension calls, the duration of conversation is estimated from the moment when subscriber has answered on the call. The moment of the beginning of the conversation at outgoing outside calls is determined exactly, if the call is made on external line ISDN, E1, T1, but if you have analog line, operator should switch on the option of Reverse Circuit and on CO port of PBX this option should be switched on too.
• Ring - shows the ring duration before answering a call in Minutes/Seconds. The moment of the beginning of the conversation at outgoing outside calls is determined exactly, if the call is made on external line ISDN, E1, T1, but if you have analog line, operator should switch on the option of Reverse Circuit and on CO port of PBX this option should be switched on too.
• Account - account-code, which was used by subscriber at making call.
• CD - shows other call information with following codes:
  • NA - not answered call (NOT ANSWER)
  • TR - call was transferred (TRANSFER)
  • RT - call returned after transfer (RETURN)
  • FW - call was forwarded (FORWARD)
  • PK - call was picked up (PICK UP)
  • D0...D8 - call through DISA
• Charge - the amount of Meter pulse for call (if it is given by the operator and CO port of PBX is set and completed appropriate option cards).
• Cost - shows the call charge which is given by the PBX (depends on PBX settings).

There is the status bar in the bottom of the window. The information about time of start the program, type of PBX, version software of PBX (firmware) and information about errors in work of the program are displayed in this status bar. In case if it was impossible to log the call in the database, in this status bar the reason of this failure is displayed.

3.4.1 Sample of calls.

For calls sample in different criteria in menu "Tools"choose item "Sample of calls".

On bookmark "Date and time" you can choose initial and finite date of calls , interval in time of day during the time calls comes, duration fo calls and time on which were answered. Chose of interval , time of a day now work only for databases such as DBF, Firebird,text file and CSV.

On bookmark "Numbers" you can chose calls from list of internal phone calls , CO ports of PBX , numbers Caller ID or from localization of calls - intercom, local, long distance, international.

On bookmark "Parameters" you can chose categories as for direction- Incoming and outgoing, for Call Status- transfer, forward,pickup, returned, reply DISA, not answered, and for account codes list.

On bookmark "Presets" you can save settings of call access and using them later.