2.1.3. Set parameters of TAPI and Server.

Here you can set the necessary parameters for TAPI-interface and the server to do this, open "Settings / TAPI & Server".

Here you can set proper parameters for TAPI- interface and Server:

• Reinitialize TAPI, if KX_STATUS is lost - establishes a critical number of times after which the TAPI server will be re-initialized.
• Interval between KX_STATUS in seconds - time interval in the seconds with which happen events KX_STATUS. KX_STATUS can be admit if it doesn’t appear after a while writing in this parameter +5 seconds.
• Restart telephony servicen if has not received KX_RETRIEVE during - time after that will be launched over the phone in the absence of KX_RETRIEVE.
• To establish{install} ACD attributes at start of service - if this option at start of a server ACD-attributes will be automatically established or be dumped{installed or be dumped;established or be reset;installed} is included.
• To establish{install} ACD attributes at start of service - If this option at start of a server ACD-attributes will be automatically established or be dumped{installed or be dumped;established or be reset;installed} is included.
• To reinstall ACD attributes after KX_RETRIEVE - if during work the TSP-driver will suddenly send message KX_REINIT, and after it{him} KX_RETRIEVE after that the server will automatically repeatedly establish{install} or will dump{reset} ACD-attributes.
• Delay for Transfer, millisecond - important pause between commands that sends for PBX is important for lucky execute function Transfer. Insufficient meaning of this pause result to answer for incoming call instead of transfer the ring on Transfer at that on system telephone will turn on speakerphone. Inordinate meaning of this pause result to unwanted delay for transfer calls. For each type of PBX this parameter fit by experiment. For example for KX-TD1232 enough 100 microseconds and for KX-TDA100 sometimes 200 microseconds is little.
• Delay for Drop, millisecond - important pause between off-hooh and on-hook. It needs for right responding and successful calling party release by your CO line or GSM gate. In real for this pause add meaning "Delay for Transfer" needed for right give work up all commands by your PBX.
• Call date and time given from: - states where the call is recorded with a computer or PBX system.
• Enable ACD-mode control for group redirections - During initialization of the TAPI-interface after reception data on groups of distribution of calls for each of them - "ACD mode" and "Waiting time CTI", functions necessary for work redirection incoming calls directly two attributes will be set or unset from these groups. If in tables "DID/DDI Extended" and "DIL_11 Extended" in a field "EXT Supervisor" numbers of groups of distribution of calls are entered, attribute "ACD mode" for these groups will be set and by means of attribute "Waiting time CTI" will be set duration time in which PBX will wait redirection for a call a server. If for this time the call has not redirected a server, PBX will direct it on internal number under the own program.
  
  It is necessary to remember that after set of these attributes by means of Blitz KXTD TAPI Server, they will function is not dependent on that, the server works or not, that will lead to delays of incoming calls in case of if the server for any reason will not work.
• IP-Address - IP-address getting from list through which TAPI-server will work.
• Port - number of TCP-port on which TAPI-server will work
• Prefix to access on outside line - one or some numbers for enter on CO lines. Use in two cases :
  • Sent it for clients for example Blitz CallerID Display in answer for demand of prefix;
  • In result of import tables database in table Speed Dial KX-TDA.csv, added this prefix for number CallerID;
• To allow to open EXT, not entering into groups - allows client appendices to open lines of internal phones which are not included in one of groups of distribution of calls and to work with them.
• Logged intercom calls - when this option, the database will be maintained calls between internal users.
• Way to audio records of calls - a global way to folders in which audiofiles with records of calls contain.
• Enable log - the server can log their errors it is necessary for them to find and fix. You can also specify a log file name is stored.

2.1.6 Select Columns

If necessary, you can turn off the display table columns that you do not need it. At the same time accelerating the process of finding information on the screen, as well as the manufacture of their sample from the database, which in some cases provides an additional gain speed.

2.1.7 Automatic import of data into tables

You have a possibility use automatic import data from files CSV or DBF in database tables in specified days and time.

• Turn on - choice database tables for which will be turn on automatic import dates;
• Table - the name of database tables;
• Prefix - prefix from which must be beginning the names of files CSV and DBF;
• Format - choice of file format from which will be generate import of dates CSV or DBF;
• The paht for DBF or CSV - the way for catalog in which will be generate search files CSV and DBF with proper prefixes;

By import data check existence analog notices in tables database:

• In table DID/DDI Extended - through number DID;
• In table DIL 1:1&snbp;Extended - through number CO;
• In table CallerID distribution - through number Caller ID;
• In table Users - through number EXT;

If such notice isn't in database it is added in it.

If such notice is in database other fields of notice will just regenerate.

If imported table CSV or DBF in given notation have another empty fields then given notation delete from database.

Section Data and time of updating of the tables allow to import data and time automatic tables renew in database. You could set renewal that will have a period once at month/week/day, every hour and every minute.

Required format of tables DBF and CSV:

DBF:

DID/DDI Extended

The name of the column	The type of data	The length of the field
DID	Character	15
EXT_SVISOR	Character	5
EXT_IRNA	Character	20
METHOD	Numeric	1

• DID (Dialed ID) - number dialed by called subscriber;
• EXT_SVISOR (EXT Supervisor DID) - EXT number on which getting incoming external calls according to PBX program;
• EXT_IRNA (EXT IRNA DID) - EXT number, the user's name on which must be transfer incoming calls or number "1" in case command "Call drop". In case if in this field will be wrought the user's name Blitz_KXTDServTAPI will do search user with such name in table "Users" and in table database in proper column will add his ID-number;
• METHOD - method transfer calls: 1 or 0. 0 - Redirect, 1 - Transfer;

DIL 1:1 Extended

The name of the column	The type of data	The length of the field
CO	Numeric	3
EXT_SVISOR	Character	5
EXT_IRNA	Character	20
METHOD	Numeric	1

• CO - number CO-port of PBX ;
• EXT_SVISOR (EXT Supervisor CO) - EXT number on which getting incoming external calls according to PBX program;
• EXT_IRNA (EXT IRNA CO) - EXT number, the user's name on which must be transfer incoming calls or number "1" in case command "Call drop". In case if in this field will be wrought the user's name Blitz_KXTDServTAPI will do search user with such name in table "Users" and in table database in proper column will add his ID-number
• METHOD - method transfer calls: 0 or 1. 0 - Redirect, 1 - Transfer;

CallerID distribution

The name of the column	The type of data	The length of the field
CALLERID	Character	15
EXT1	Character	20
EXT2	Character	20
EXT3	Character	20
NAME	Character	20
NAME_MID	Character	20
NAME_LAST	Character	20
POST	Character	50
DEPARTAM	Character	50
ICQ	Character	12
EMAIL	Character	20
NOTE	Character	254

• CALLERID - Caller ID number ;
• EXT1, EXT2, EXT3 – EXT numbers, the user's name on which must be transfer incoming calls, number "1" in case command "Call drop" or number "8" in case command "Don't processing of call". In case if in this field will be wrought the user's name Blitz_KXTDServTAPI will do search user with such name in table 'Users' and in table database in proper column will add his ID-number;
• NAME - the client name;
• NAME_MID - middle name of client;
• NAME_LAST - last name of client;
• POST - post address of client;
• DEPARTAM - post which take the client;
• ICQ - number ICQ client;
• EMAIL - e-mail of client;
• NOTE - notice (about 254 symbols);

Users

The name of the column	The type of data	The length of the field
EXT	Character	5
NAME	Character	20
ADDRESS	Character	22
GROUP	Character	15

• EXT - EXT number of user;
• NAME - the name of user;
• ADDRESS - address in your local network of user`s computer in need through ":" number of TCP-port of user application getting information about incoming calls;
• GROUP - the name of group which user is member; Blitz_KXTDServTAPI will do search of group with such name in table "Group of users" and if such group will be find in database for given user add it ID-number;

CSV:
The files CSV must be contain in first line the name of columns. Their names must be simple with which are in tables DBF. In files CSV could be empty lines however can not be that file is beginning from empty line.

2.1.8 Auto exports tables

Automatic export permits to export data from tables and outgoing calls to CSV files or DBF raised in the days and times.

• Enable - select database tables, which will be included automatically import data;
• Table - the name of database tables;
• Filename - the template file names CSV, and DBF. Entries "% D" and "% T" means that the position of the file name will be replaced by, respectively, the date and time of the first call in this file;
• Format - choose your file format, which will be the export of data, CSV or DBF;
• Path to DBF and CSV files - path to the directory, which will appear exported CSV files and DBF;

The section "Date and time of updating the tables" allows you to set the date and time of auto exports tables incoming and outgoing calls. You can export every month, every week, every day, every hour and every minute. Accordingly, each file will be kept information about calls in the last month, week, day, hour or minute.

• Delay for export, min - The time from 0 to 30 minutes, which exports tables should miss. This need it for ongoing calls that have not yet completed, did manage to finish and they got it in this exported file, rather than the next. For example, a client called, they talked with one manager, he was transferred to the second manager, traveling the incoming call is not yet complete, but already the time of export tables, and here it is very important to travel the entire route of the call came in an exported file, rather than two different.

Format of the exported DBF tables and CSV:

DBF:

Inbox

The name of the column	The type of data	The length of the field
CALLERID	Character	15
DID	Character	15
CO	Numeric	4
EXT	Numeric	4
CALLDATE	DateTime	---
REPLYTIME	DateTime	---
DURATION	Character	8
CD	Character	6

• CALLERID - A phone number to call the client;
• DID - Your external telephone number on which to call the customer;
• CO - Number of CO-port PBX system through which the call was received;
• EXT - Internal subscriber number, who received an incoming call;
• CALLDATE - Date and time of call;
• REPLYTIME - Date and time of answering a call;
• DURATION - Call duration;
• CD - The type of call;

Outgoing

The name of the column	The type of data	The length of the field
CALLEDID	Character	15
DIALTILE	Character	40
CO	Numeric	4
EXT	Numeric	4
CALLDATE	DateTime	---
REPLYTIME	DateTime	---
DURATION	Character	8
CD	Character	6

• CALLEDID - Number, which called internal subscriber;
• DIALTILE - Additional digits dialed after the numbers (after the symbol "*");
• CO - Number of CO-port, through which called internal subscriber;
• EXT - Internal subscriber number;
• CALLDATE - Date and time of call;
• REPLYTIME - Date and time of answering a call (on the external analog lines may be approximate value);
• DURATION - The duration of the call (for external analog lines may be approximate value);
• CD - The type of call;

CSV:
The CSV file contains the first line of the column headers, the second row is empty, and starting from the third row are the data.

2.1.9. Installation and dump ACD of attributes

That the server could redirect entering calls and to beat off them directly on ACD-groups, it is necessary on PBX for these groups to establish{install} ACD-attributes "ACD Mode" and "CTI Wait", without it{this} the server cannot operate these calls. The attribute "ACD Mode" includes an opportunity of management of calls on group, and "CTI Wait" sets time in seconds in which current the call will be late on group, and PBX will expect from a server of any actions. If in current of this time of any actions has not followed, PBX will process this call to a usual mode.

Blitz KXTD TAPI Server defines{determines}, what groups should establish{install} ACD-attributes and what to dump{reset}, under tables DID/DDI Extended and DIL11 Extended, for this purpose it is necessary to include an option "To include management of an ACD-mode for redirect calls from group". To those groups which are specified in fields "EXT Supervisor DID" and "EXT Supervisor CO", ACD-attributes will be established{installed}, and to other groups are dumped{reset}. If the option "will Include management of an ACD-mode for redirect calls from group" is switched off, the server will dump{reset} ACD-attributes to all groups without exception.

The parameter "the Waiting time redirect" sets value of attribute "CTI Wait".

The parameter "the Maximum quantity of attempts of reading of the information on groups and records of ACD-attributes" sets a limit of quantity{amount} of attempts of reading of the information on ACD-groups and records of ACD-attributes after which the server will stop attempts. In case of if attempts of reading of the information on ACD-groups were made, the server will make compelled{forced} reinit TAPI.

For start of installation or dump of ACD-attributes, press the button "Record of attributes". Those groups by which ACD-attributes will be established{installed}, will be noted by a sign "+" and with which will be dumped{reset} - by a sign "-".

The set condition of ACD-attributes is kept and at stopped Blitz KXTD TAPI Server, therefore at the stopped server entering calls will be late on groups that can lead to losses of calls. It is necessary to remember it{this} and for avoidance of such situation before stopping a server it is necessary to dump{reset} all ACD-attributes, having switched off an option "Management of an ACD-mode..." and having pressed the button "Record of attributes".

In case of not stable work of the TSP-driver, service "Telephony" or at loss of communication{connection} with PBX, the TSP-driver sends the message "KX_REINIT", and after restoration of communication{connection} with PBX, the message "KX_RETRIEVE". It is necessary to remember that after these two messages all ACD-attributes for all groups appear are dumped{reset} by the TSP-driver, therefore for restoration of working capacity of the mechanism redirect or a release of entering calls, it is necessary repeatedly make record of ACD-attributes. Blitz KXTD TAPI Server can and repeat independently record of ACD-attributes, for this purpose it is necessary to include in parameters of adjustment{option} TAPI an option "To reinstall ACD attributes after KX_RETRIEVE".