Tariscope 4.x. Administrator's guide
Chapter 3. Tariscope configuration
3.12. Adding a new telephone system
3.12.1. CDR format for 3CX Phone System
If you have selected the 3CX Phone System item in the Equipment type list (Figure 3.12.1) and you have 3CX Phone System version 14 or 15, click on the Configure button (Figure 3.12.1) and select the Advanced equipment parser settings item. The 3CX parser configuration window appears as shown in Figure 3.12.1.1.
Figure 3.12.1.1
If you have 3CX Phone System version 6-12, skip this configuration. Tariscope automatically defines CDR format for these versions.
First two check boxes are used only when Tariscope is applied to implement authorization codes in 3CX Phone System. How to implement such a feature in 3CX Phone System, find out in a special article on the Tariscope site. To use this feature the Tariscope license must include the restriction feature.
If you use authorization codes in 3CX Phone System, select the Save prefix as auth code if matching pattern check box. In the text box located on the right from this check box, type a mask for authorization codes. For example: 1###. It means that all authorization codes must contain 4 digits and the first digit in them must be started from 1. You must perform the appropriate settings in the Outbound rules page of 3CX Phone System and, type the authorization codes for subscribers on the Subscribers page.
If you want to forbid calls, where authentication codes are absent, select the Drop outgoing calls with unknown authorization code check box.
If your 3CX Phone System uses time of UTC + 0 in CDR, but you are located in another time zone, to change the time zone in call data, select the Correct time zone check box.
To monitor calls information in the real time, select the Monitor active calls check box. A prerequisite for using this feature is to install the client part of Tariscope on the same computer where 3CX Phone System works.
Tariscope provides feature to automatically create subscriber's information in the Tariscope database when the processing of information about calls is executed and if a subscriber is absent in the database. In this case, Tariscope gets subscriber's information from the 3CX Phone System database. To implement this feature, select the Automatically create subscribers from 3CX database check box.
Tariscope allows to automatically synchronize the subscriber's information such as a subscriber name, extension and email address with the 3CX Phone System database. To implement this feature, select the Automatically synchronize a subscriber name, extension and email from 3CX database check box.
If you have not selected the Automatically create subscribers from 3CX database check box, you can use the opportunity to drop all calls made from extensions that are absent in the Tariscope database. To do this, select the Drop calls from unknown extension check box.
The 3CX v14 CDR fields list specifies a list of the flields of CDR and their order. By default, the default CDR format of 3CX Phone Systems is used. If you have another CDR format, check the required fields in the list, and specify the order of the fileds.
To use the features such as the automatic creation of subscribers, data synchronization, drop the outgoing calls from telephone numbers that are unknown in Tariscope, as well as for the features listed below, it is necessary to select the Monitor active calls check box.
Except of the settings of the 3CX parser configuration window, Tariscope contains still some settings that are specific for 3CX Phone System and which provide the execution of the following features:
- Disable calls, the duration of which exceeds a predetermined value.
- Disable calls, the cost of which exceeds a predetermined value.
- Disable calls on the telephone numbers that correspond the predetermined pattern.
- Disable calls for customers who have balance less than the set value (only for the Tariscope Provider edition).
All these features are accessible for the Tariscope users who have the license with the restriction feature.
The configuration of the features are executed by setting a certain value in the main.xml file located in the folder: …/ProgramData/Tariscope.
To disconnect a call that has a duration more than a certain value, change the value of 0 on a desired value in the tags: <DropCallDurationThreshold>0</DropCallDurationThreshold>
To disconnect a call that has a cost more than a certain value, change the value of 0 on a desired value in the tags: <DropCallCostThreshold>0</DropCallCostThreshold>
The value is specified in the currency that was set as the main currency in Tariscope. The value of 0 in these tags means that Tariscope does not monitor calls on their cost.
To disconnect calls made to telephone numbers that correspond to the pattern, it should specify the pattern in the following tags: <DropCallRulesNumberPattern>*</DropCallRulesNumberPattern>.
The value of '*' means that the disconnection does not execute for this case.
If you want to forbid calls for customers who have an account balance less than a certain value, change the value of 'false' on 'true' in the tags: <LimitSubscribersByBalance>false</LimitSubscribersByBalance>.
And change the value of 0 in the tags: <BalanceThreshold>0</BalanceThreshold> on a desired value. The value of 0 means that when an account balance is equal 0, all calls will be forbidden till the balance will be more than 0.
