Tariscope 4.6. Administrator's guide
Chapter 4 Tariscope configuration
After the installation and the initial start, Tariscope automatically starts Tariscope assistant if you installed it with the empty Tariscope database.
4.1 Tariscope assistant
The Tariscope assistant provides a basic configuration of the system, facilitating and accelerating this process.
The wizard allows to configure:
- Country and area codes.
- Telecommunications node name (company name).
- VAT percent.
- Main currency.
- Currency profile and a service for automatic update of currency rates.
- Telecommunications equipment type.
- Advanced settings of telecommunications equipment.
- Long distance dialing and international dialing prefixes.
- The data source through which the data will be collected (a serial port, TCP server/client, FTP server/client, etc.), and its parameters.
- Service provider, through which telephone system is connected to the telephone network (PSTN).
- Access code to PSTN.
- The internal numbering plan.
- Prefixes.
- Import of subscribers' (customers') parameters.
- Parameters of the database backup, archiving and optimizing.
After completing the initial configuration, the Tariscope administrator can change these settings at any time or configure the new parameters that are not available in the wizard.
Start
The page of the Tariscope assistant wizard is automatically opened after the initial startup of Tariscope (Figure 4.1.1). The Tariscope administrator can omit any of the steps of the wizard and continue the configuration of these parameters at any later time or opt out of this configuration.
Figure 4.1.1
The first page of wizard is an information one. After acquaintance with contents of the first page, click Start.
Configuration steps
Initial Tariscope configuration
The first step allows you to configure the main Tariscope parameters (Figure 4.1.2).
Figure 4.1.2
In the Company name box, enter your company name.
In the Country code box, enter your country code instead of "+".
In the VAT percent box, you can type percent of VAT, which can be used when you create reports on the cost of calls.
In the Set Main Currency list, select the currency name, which will be the main in the Tariscope.
If you use Tariscope Provider, you can assign an account number yourself or Tariscope will assign the account number automatically. In order to Tariscope will assign account numbers automatically, turn on the Account Id assigned automatically switch.
Tariscope can automatically execute some tasks. You should use Tariscope Tasks for this purpose. Turn on the Enable Tariscope Tasks switch, in order to activate this service. The Initial Tariscope configuration page contains four tasks that Tariscope Tasks can perform.
To automatically create the Tariscope database backup, turn on the Create database backup switch. In the Period list, select the desired period of the backup creation. In the Path box, enter a path to save the backup.
If you will use call rates, which are set in the different currencies, and you want to recalculate the call cost into the main currency, turn on the Update the currency rate switch. And in the list, you should select the desired profile to get the currency rates. Currently profiles are available for Ukraine, Russia, Georgia and Kazakhstan:
- UA-NBU. Currency rates in relation to the UAH according to the National Bank of Ukraine.
- UA-PIB. Currency rates in relation to the UAH according to the Prominvestbank of Ukraine.
- GE-NBG. Currency rates in relation to the GEL according to the National Bank of Georgia.
- RU-CBR. Currency rates in relation to the RUB according to the Central Bank of Russian Federation.
- KZ-NB. Currency rates in relation to the KZT according to the National Bank of Kazakhstan.
If the required profile is not in the list, skip this setting. You can execute it later in another configuration page.
If you do not need to store calls information for more than 1 year to reduce the size of the database, you can delete old calls automatically. Turn on the Clear up old calls every month older than 1 year switch.
If you want to automatically optimize the parameters of the Tariscope database each month, turn on the Monthly database optimization switch.
Click Next.
Step 1. Communication nodes
This page of configuration wizard to create a new telecommunication node (Figure 4.1.3).
Figure 4.1.3
Click Create. The New node window appears as shown in Figure 4.1.4.
Figure 4.1.4
In the Node name box, enter a node name and click Save. If you want, you can create some communication nodes.
Select the table row with the node for which you will add a list of telephone systems.
Click Next.
Step 2. Create an equipment and configure the minimum required parameters
The page of the second configuration step is shown in Figure 4.1.5.
Figure 4.1.5
In the Name box, enter a telephone system name. For example: CUCM or 3CX, or another.
In the Long distance prefix box, enter the prefix. For most of the countries it is 0.
In the International code box, enter the code. For most of the countries it is 0.
In the Country code list, the country name is displayed that you selected on the Initial Tariscope configuration page. If you wish, you can change the country name.
In the Area code box, enter the area code where your telephone system is located.
Click Next.
Step 3. Set the equipment type and configure CDR data source
A choice of the telephone system type affects on the correctness of processing call information. When the choice is wrong, the processing of call information will not be executed, or it will be executed with mistakes.
The choice of the desired type of telephone system is executed in the Equipment list (Figure 4.1.6).
Figure 4.1.6
Select the desired type of telephone system. It is possible to specify additional parameters for some telephone systems. In this case, the Advanced settings button appears on right from the Equipment list (Figure 4.1.6). If the button has appeared, click on it. The Advanced settings window appears. It is specific one for each type of telephone system. The example of the window for Cisco Unified Communications Manager is show in Figure 4.1.7.
Figure 4.1.7
If necessary, select the desired parameters in this configuration window.
If you do not know exactly the type of your telephone system, Tariscope can determine it himself in most cases.
Leave the Auto value in the Equipment list (Figure 4.1.6). In this case Tariscope will try automatically to determine the type of telephone system when it will process CDR. But for a number of PBXs (Alcatel OmniPCX Office, Aura, S8800, S8700, S8500, S8400, S8300, Definity) due to the fact that they have a custom CDR format it cannot be used the automatic recognition.
If you want that Tariscope will automatically receive CDR data, you should create Tariscope Observer service. It is a Windows service that collects CDR data and save them in the Tariscope database.
Turn on the Create observer switch.
In the Data source list, select a data source that will be used to collect CDR data. For example, it can be FTP or SFTP server for Cisco Unified Communications Manager.
To define which data source is used in your telephone system, see the documentation on your telephone system. Improper selection or improper configuration of source parameters will not allow receiving information from the telephone system.
Click on the Advanced settings button located on the right from the Data source list. The Data source configuration window appears. The window is specific to each data source. The example of the window for FTP server is shown in Figure 4.1.8.
Figure 4.1.8
You can find a detailed description of all parameters for each type of data source in the Tariscope documentation or articles of the site.
As a result of the data source choice and assignment of its parameters, the profile will be created. At the same time the appropriate Windows service will be started. After the setup wizard finishes, install and launch the Tariscope Observer service.
Click Next.
Step 4. Choose a telecom provider to rate calls
An example of this page is shown in Figure 4.1.9. The page contains a list of telecom providers. Also, you can create a new provider or import the provider from the Tariscope site.
Figure 4.1.9
Click on the Providers for import button. You will get the list of providers. Select the desired provider from the list.
If you have not found the required provider. You can create it.
To do this, click on the Create now button. The New provider window appears as shown in Figure 4.1.10.
Figure 4.1.10
In the Name box, enter the provider name.
In the Description box, you can enter a description for the provider.
Click Save. The provider name will be displayed in the provider table on the Available provider configuration page.
Select the desired provider.
If in your telephone system the access code is used to access to the provider, enter the access code in the Access code box.
Click Next.
Step 5. Configure the numbering plan
The Numbering plan page allows you to set an internal numbering plan (Figure 4.1.11).
Figure 4.1.11
This setting can be useful when you must manually enter the large number of extensions in the Tariscope database, as well as you have telephone systems in which the definition of extension is difficult without a numbering plan. These are such telephone systems:
- Asterisk,
- Cisco IOS VoIP (CallManager Express - CME),
- Cisco Unified Communications Manager (CUCM),
- Microsoft IAS,
- Elcom.
If the Default range (100-9999) switch turns on, this means that extensions will be from 100 to 9999. If you have extensions with other telephone numbers, you should turn off the switch and click Add. The window appears as shown in Figure 4.1.12.
Figure 4.1.12
In the Name box, type the name of a numbering plan.
In the Type list, select the Phone Numbers item.
In the From box, type a telephone number from which the numbering range is started.
In the To box, type a telephone number which the numbering range is ended. Click Save.
If necessary, repeat the procedure.
After the input, click Next.
Step 6. Create the prefixes
The Prefixes configuration page (Figure 4.1.13) is used to change a prefix in dialed numbers for outgoing calls or telephone numbers of calling party for incoming calls.
Figure 4.1.13
If you do not use prefixes, click Next.
To specify a prefix, click Add. The window appears as shown in Figure 4.1.14.
Figure 4.1.14
In the Name box, type a rule name to change prefixes. This is an information field.
If you want that a telephone number after application of the prefix rule will be saved, click on the Save changed number.
If you wish to use this rule to group of prefixes, which have different digits in the same position, turn on the Prefix code is mask switch. In this case, in the Replace to box, you should type the underscore character ("_") in the required position.
In the Prefix box, type a prefix, which you want to change on another code.
When the rule should be applied only to a certain length of telephone number, turn on the Number length switch and specify its length.
In the Replace to box, type a value of the prefix, which should replace the beginning of the telephone number.
If you wish to rate calls that contain this prefix using specific rates, select a telecom provider name from the Provider list, which provides such rates.
The prefixes can be set to dialed numbers or the telephone numbers of calling party from which incoming calls were made. Depending on which type of phone numbers you want to use a prefix, in the Call direction list, select: Outgoing or Incoming.
The From and To boxes allow you to specify a valid period of the prefix rule.
Click Save.
Repeat these actions to add the next prefix rule.
Click Next.
Step 7. Select an option to add subscribers
The Subscribers page (Figure 4.1.15) allows you to select an option to add subscribers' data into the Tariscope database.
Figure 4.1.15
Tariscope supports several different options of the customer (subscriber) data entry. In the wizard, you can enter the data only in automatic modes:
- Import from file. The subscriber data are imported from files of the following formats: Microsoft Excel, Excel 2007, Access, Access 2007, CSV, TabText, dBase.
- Import from Active Directory. The subscriber data are imported from Microsoft Active Directory or LDAP catalog.
- Automatically create subscribers. The subscriber data are created during the time of processing of CDR data. A subscriber will have a name that is the same as his phone number with 'a' prefix.
Select the desired option and import the subscriber data.
If you wish to input the subscriber data into the Tariscope database later, select the I will add subscribers later option.
Click Next.
The Equipment creation wizard will finish its work. If you will need to add another communication node or telephone system, you can launch the wizard from the Tariscope menu.
Tariscope 4.5.x. Administrator's guide
Chapter 4 Tariscope configuration
4.13. Tariscope Observer
4.13.18 Remote Tariscope Observers
Sometimes Tariscope users have a need to receive call data (CDR, SMDR) from a remote telephone system. Usually there is no problem if such a telephone system can use Internet protocols such as TCP, FTP, SSH and others. But what to do if the telephone system has only a serial port? In this case, we suggest using the remote Tariscope Observers, which are installed on a computer located next to the telephone system.
To install remote Observers, you need a computer with the operating system Windows 10, 8.1, 8, Windows Server 2019, 2016. On such a computer, you must run the Tariscope installation package, as described in section 1.1. At the component selection stage (Figure 1.1.4), select the value Tariscope applications or updates only. In the Tariscope Components window, select only the Observer server item, as shown in Figure 4.13.18.1. You should not select any other components.
Figure 4.13.18.1
On the computer where the remote Observer server is installed, if the firewall is used, it is necessary to create outgoing rules for port 8001 (this is the Tariscope server port), 1433, 1434 (Microsoft SQL Server ports). You also need to create an incoming rule for the IP port on which the Observer server will run. This IP port is set in the subsequent configuration.
On the Windows system of the remote computer, click on the Start button. Select the Tariscope folder and select the Observer server item. The Server Control Panel window appears, an example of which is shown in Figure 4.12.18.2.
Figure 4.13.18.2
The window displays the Windows user settings with which the Tariscope Observer services will be started. If you would like to run Observer with the current users' rights, click Yes. If you want to run Observer with rights of another Windows user, click on the No button and specify the username and password. The window of the Server Control Panel will be as shown in Figure 4.13.18.3.
Figure 4.13.18.3
Select the Settings item in the menu, the window will be as shown in Figure 4.13.18.4.
Figure 4.13.18.4
Click the Update connection button. The SQL Server Connection window appears. An example of the window is shown in Figure 4.13.18.5.
Figure 4.13.18.5
In the Server name or IP box, enter the IP address (name) of the computer on which the SQL server with the Tariscope database was installed.
If your SQL server has the name other than the default, then in the SQL Server Name box, enter this name.
In the Authentication Type list, select SQL Server Authentication. In the Username, specify the username with which the connection to the SQL server will be performed, and in the Password position, specify the password. This user must have permissions to work with the Tariscope database.
Click the Check connection button. If the parameters are entered correctly, then in the Connection status position will be displayed: connected. Otherwise, check the entered parameters and repeat the connection check.
Click the Done button.
In the Server section (Figure 4.13.18.4), specify the parameters of the TCP server through which the Observer server will communicate with Tariscope.
In the Port box, specify IP port.
In the Login and Password, specify the appropriate parameters. They will be used by the Tariscope system to connect to this server. These fields may be empty.
Click on the Start button. When the server service starts normally, in the Status position the value 'running' will be displayed.
Return to the main Tariscope application. Select in the menu Data Collection/Observer → Observers management. The Data Collection/Observer page is displayed. An example of the page is shown in Figure 4.13.18.6.
Figure 4.13.18.6
On the toolbar, click on the Remote observers icon. The Servers page appears. An example of the page is shown in Figure 4.13.18.7.
Figure 4.13.18.7
On this page, you need to set the server parameters of the remote Observer. On the toolbar, click on the '+' icon (Add). The Server window appears (Figure 4.13.18.8).
Figure 4.13.18.8
In the Name box, enter an arbitrary server name.
In the Host box, specify the IP address of the computer on which the Observer server was installed.
In the Port box, specify the IP port that you specified on the Observer server (Figure 4.13.18.4).
In the User name and Password boxes, specify the username and password specified in the Observer server (Figure 4.13.18.4).
If necessary, in the Description box, you can leave some comments.
Click on the Save button. The Servers page displays a string with the parameters of the entered server. Figure 4.13.18.9 shows an example of this page with two remote Observer servers.
Figure 4.13.18.9
Select the line with the desired server and click on the toolbar on the List of observers icon. The page displays a list of remote Observer services. If no Observer services have been added to the server of the remote Observer, the service table will be empty. Figure 4.13.18.10 shows an example with two Observer services already added on the remote server.
Figure 4.13.18.10
You can configure remote Observer, start and stop them on this page using the toolbar icons. At the same time, you can go to the Data Collection/ Observer page (Figure 4.13.18.6), where you can perform the same actions.
The Observer server contains a log file. To access it, click on the menu item Service log. This log is also available from the Tariscope application. To do this, select the required remote server (Figure 4.13.18.10) and click on the Download log icon on the toolbar.
Tariscope 4.5.x. Administrator's guide
Chapter 4 Tariscope configuration
4.14 Notifications and mailing
To execute the notifications and mailing settings, you should know an email address, from which Tariscope will execute mailing, and its parameters such as password, SMTP server name, IP port, and authentication. If you do not know these settings, contact to your technician or email provider.
To configure notifications and mailing settings, in the Tariscope menu, select Additional options → Notifications and mailing. The Notifications and mailing page appears as shown in Figure 1.
Figure 1
In the SMTP Server box, enter the SMTP server name. For example, if you have the email address in Gmail, you should enter: smpt.gmail.com
In the Port box, enter IP port of SMTP server. Enter the value of 587 for Gmail.
If your SMTP server requires an authentication, switch on the Authentication switch box.
In the User box, enter your email address.
In the Password box, enter your password.
If your SMTP server uses the Transport Layer Security protocol, switch on the Use TLS switch box.
In the Sender section, in the Email address box, type an email address from which sending will be executed.
In the On behalf of box, type a name which will be used to sending.
In the Message section, in the Default address box, type an email address on which will be sent notifications by default. For example, it may be the email address of the Tariscope administrator.
In the Subject box, type a subject of message. By default, it is used: Tariscope.
In the Message template box, type a message text that will be displayed at the beginning of the message body. For example, it may be the following: "Notification on the events in Tariscope" or another.
To keep settings, click on Save button.
To check settings, click on the Send test mail button. If you correctly set parameters, you will get the message that is shown in Figure 2.
Figure 2
Otherwise, you will get the message about an error. In that case, click on the Open service log button. The Service log page is opened. Analyze the log and fix the errors in the settings.
Tariscope 4.5.x. Administrator's guide
Chapter 4 Tariscope configuration
4.20 Dashboard configuration
Tariscope 4.5 contains a dashboard that allows you to monitor current information about calls, services, subscribers, and others. Now the Tariscope dashboard includes 22 widget types that allows you to create hundreds different widgets. You can choose any combination of the widgets for your dashboard.
The dashboard is the first page that appears after you log in. An example of the page is shown in Figure 4.20.1.
Figure 4.20.1
The default dashboard contains only one widget. This is Information about Tariscope that displays the valid date, support date, Tariscope version, and version that is available on the Tariscope site. You cannot change or delete this widget.
You can open the dashboard at any moment if you click on the Dashboard item of the menu.
To do any actions with the dashboard, click on the sign of three dots after the Tariscope dashboard title. The menu appears that contains the following items:
- Add widget. Allows you to add a new widget to the dashboard.
- Settings. Allows you to configure the dashboard settings.
- Widget access. Allows you to set access to widgets for users.
- Refresh all widgets. Allows to refresh the widgets.
- Go full screen. Allows you to expand the dashboard on the full screen.
4.20.1 Adding a widget
Open the menu as it is described above and click on the Add widget item. The page will be as shown in Figure 4.20.2.
Figure 4.20.2
Open the Available widgets list. It contains the following items:
- 3CX – active calls. The widget is relevant only for 3CX users. It displays the number of current active calls and number of maximum available simultaneous calls according to 3CX license.
- Abnormal subscribers. The widget displays statistics on subscribers whose services are abnormal according to the Tariscope Payment Forecast service. If you do not use this service, it makes no sense to use the widget.
- Balance statistics. This widget can be applied by telecom service provides who use the Tariscope Provider edition. It displays the beginning balance for the current month, sum of charged services on the current day, sum of payments from customers for the current month, and current day balance.
- Call statistics. It is a graph of call traffic. The Tariscope administrator can configure a graph period, traffic type (from a communication node, PBX, department, or subscriber), call direction (all directions, incoming, outgoing, internal, or transit). It is possible to simultaneously display data on two elements of the same type.
- Current date and time. Displays the current date and time.
- Current version of Tariscope. Displays the latest version number of Tariscope, which is available on the Tariscope site, and version number of Tariscope that you use.
- Database information. It displays the server name, database size, log file size, and Tariscope database version.
- Database size. If you use Microsoft SQL Server Express edition, it has a restriction on the database size. In this case the widget is useful to control the database size. It displays the percentage of available database volume.
- Latest news article. Displays an announce of the latest article on the Tariscope site.
- License usage. The widget displays the percentage of the Tariscope license usage.
- Missed call statistics. The widget displays statistics on the missed calls.
- Notes. The widget allows you to create notes that will be displayed on the dashboard.
- Observers status. The widget displays statuses of the Tariscope Observer services.
- Request to database. The widget allows you to create a query to the Tariscope database to get any data and display them in the widget using HTML tags.
- Resource usage. The widget displays a usage of the server resources by Tariscope.
- Tariscope task status. Displays a task list of Tariscope Tasks for today and yesterday. The list contains a task name, time when task must be executed, and execution status.
In the Available widgets list, select the desired widget. It appears in the box below as it is shown in Figure 20.3.
Figure 20.3
Select the widget and drag and drop it on the dashboard. The page will be as shown in Figure 20.4.
Figure 20.4
To save these changes on the dashboard, click on the click here link. To cancel the changes, click on the cancel changes link. To close widgets selection, click on the Close button.
Let us consider widget types in more detail.
3CX active calls
The widget is intended to 3CX users who wish to monitor information about active calls. There are two views of the widget: the detailed view and simplified one. The examples of these views are shown in Figure 20.5 and 20.6.
Figure 20.5
Figure 20.6
The widget shows a number of the current active calls in 3CX Phone System and number of maximum calls that can be made.
Before you will configure the widget, you should configure Tariscope to monitor active calls.
To set up settings of the widget, double click on it and in the appeared menu, select the Configuration item. The Widget configuration window appears as shown in Figure 20.7.
Figure 20.7
In the Equipment ID text box, enter an identifier (ID) of the 3CX Phone System in the Tariscope system. You can find it on the Equipment page. To go to this page, select in the menu: Communication nodes → your node → Equipment → Equipment management.
In the Widget type list, select the desired type of the widget. There are two options:
- Detailed.
- Simplified.
Click on the Save button to keep settings.
Balance statistics
The widget can be applied by telecom service providers. It allows you to monitor the value of services provided and money that customers paid for these services in the current month.
An example of the Balance statistics widget is shown in Figure 20.8.
Figure 20.8
Call statistics
The widget allows you to monitor calls traffic intensity. An example of the widget after adding it on dashboard is shown in Figure 20.9.
Figure 20.9
You should specify the widget settings. Before doing this, determine for which object you want to calculate the traffic: a specific communication node, PBX, group of subscribers, or subscriber. Find ID of the required object in Tariscope.
To specify the widget settings, double click on the widget, the menu appears as shown in Figure 20.10.
Figure 20.10
Select the Configuration item. The Widget configuration window appears as shown in Figure 20.11.
Figure 20.11
In the Period list, select the desired period. There are the following options:
- Last hour.
- Last 6 hours.
- Last 12 hours.
- Today.
- Yesterday.
- This week.
- Last week.
In the Statistics for list, select an item for which you wish to get the statistics. There are the following options:
- Node.
- Equipment.
- Group.
- Subscriber.
Depend on what object you selected in the Statistics for list, the title of the next box can be changed. For instance, if you have selected 'Subscriber', the next box title will be 'Subscriber ID', and so on.
Enter an identifier (ID) of the selected object in this box.
The Statistics on all directions switch allows you to select a call direction. By default, the switch is on. This means that the widget will contain data on incoming, outgoing, internal, and transit calls. If you want to monitor only the specific call direction, turn off the switch and in the Call direction list, select the required call direction.
The Compare switch allows you to display traffic of one or two objects. By default, the switch is off. This means only traffic of one object will be display. To display traffics of two objects, turn on the switch. The ID of object appears, where you should specify an identifier (ID) of the object.
To show the date on the widget, turn on the Show the date switch. By default, it is off.
If you wish to show the legend, turn on the Show legend for chat switch.
You can use a special color to display the chat. To specify the color of the main chat, enter the color code in the Main line color text box. If you use two chat in the widget, to specify the color of the second chat, enter the color code in the Color for comparable line text box.
To save settings, click on the Save button.
Current date and time
The widget displays the current date, time or date and time. An example of the widget is shown in Figure 20.12.
Figure 20.12
To configure the widget settings, double-click on the widget and in the appeared menu, select the Configuration item. The Widget configuration window appears as shown in Figure 20.13.
Figure 20.13
In the Display mode list, select the desired item. The list contains the following items:
- Time.
- Date.
- Date and time.
In the Time format list, select the desired time format:
- 12 hours.
- 24 hours.
Click the Save button to keep the widget settings.
Current version of Tariscope
This widget displays the latest version number of Tariscope, which is available on the Tariscope site, and version number of Tariscope that you use. An example of the widget when the used Tariscope version is equal to the version on the Tariscope site is shown in Figure 20.14.
Figure 20.14
Database information
The widget displays the server name, database size, log file size, and Tariscope database version. An example of the widget is shown in Figure 20.15.
Figure 20.15
Database size
The widget is relevant if you use Microsoft SQL Server Express edition, that has a restriction on the database size. The widget is useful to control the database size. It displays the percentage of available database volume if you use Microsoft SQL Server Express edition. For other Microsoft SQL Server editions it writes that there are no limits on the database size as it is shown in Figure 20.16.
Figure 20.16
If you use other Microsoft SQL Server editions than Express edition and want to control the database size, use the Database Information widget.
Latest news article
The widget displays an announce of the latest article on the Tariscope site. An example of the widget is shown in Figure 20.17.
Figure 20.17
Click on the ‘more’ link to go to the article.
License usage
The widget displays the percentage of the Tariscope license usage. As you know there are two Tariscope editions: Tariscope Enterprise and Tariscope Provider. The Tariscope Enterprise license specify the number of subscribers that Tariscope processes. The Tariscope Provider license specify the number of extensions, IP addresses or subscriber without extensions and IP addresses that Tariscope processes. The License usage widget displays the maximum value on the license and value that you used. An example of the widget is shown in Figure 20.18.
Figure 20.18
Missed calls statistics
The widget displays statistics on the missed calls. An example of the widget when there is no data on the missed calls is shown in Figure 20.19.
Figure 20.19
You can configure the widget. To do this, double-click on the widget. In the appeared menu, select the Configuration item. The Widget configuration windows appears as shown in Figure 20.20.
Figure 20.20
In the Period list select the desired period. There are the following options:
- Last hour.
- Last 6 hours.
- Last 12 hours.
- Today.
- Yesterday.
- This week.
- Previous week.
In the Statistics for list, select an object for which you want to create the widget. As an object you can select:
- Node. This means you will get the statistics for the desired communication node.
- Equipment. This means you will get the statistics for the desired telephone system.
- Group. This means you will get the statistics for the desired group of subscribers.
- Subscriber. This means you will get the statistics for the selected subscriber.
To specify the desired object, enter its ID in the Object ID box. The word of ‘Object’ will be changed on Node, Equipment, Group, or Subscriber depending on previous choice.
If you need, you can select a call direction. By default, the widget displays information for all call directions. To choose the specific direction, turn off the Statistics on all directions switch and in the Call direction list, select the desired direction. There are the following options:
- Incoming.
- Outgoing.
- Internal.
- Transit.
- Unknown.
You can select the data display mode. To do this, in the Display mode list, select the required option from the following options:
- Pie chart. The mode displays the chart that contains answered and missed calls. An example on the char is shown in Figure 20.21.
- Text mode. The mode displays text information about answered and missed calls. An example on the char is shown in Figure 20.22.
- Only answered. The widget displays information only about the answered calls. An example on the char is shown in Figure 20.23.
- Only missed. The widget displays information only about the missed calls. An example on the char is shown in Figure 20.24.
Figure 20.21
Figure 20.22
Figure 20.23
Figure 20.24
Missed calls are considered to be those that have an unanswered feature in Tariscope. If you want to consider the missed calls that have zero duration, turn on the Calls with zero duration are counted as missed switch.
By default, the widget displays data as a percentage. To display the data as a value, turn off the Show percentage switch.
Click on the Save button to save settings.
Figure 20.25 shows the use of the Missed calls statistics widget for different departments.
Figure 20.25
Notes
The widget allows you to display some notes. For example, you can create a list of tasks that you should do in Tariscope. An example of the widget is shown in Figure 20.26.
Figure 20.26
To create notes, double-click on the widget. In the appeared menu, select the Configuration item. The Widget configuration window appears. The window allows you to enter your notes using HTML. An example of the windows is shown in Figure 20.27.
Figure 20.27
After you entered your notes, click on the Save button to keep text.
Observers status
The widget allows you to monitor the statuses of the Tariscope Observers services. It displays a name of Observer, status of the service (Not installed, Running, Stopped), and the time when the Observer processed the latest call. An example of the widget is shown in Figure 20.28.
Figure 20.28
The widget has two settings. Double-click on the widget and in the appeared menu, select the Configuration item. The window appears as shown in Figure 20.29.
Figure 20.29
The value in the Warning threshold (min) box allows you to specify the time period that if there are no new calls during the period you will get the warning. A warning sign is a red exclamation mark before the Observer name.
The Time format list provides the choice of time format: 24 hours or 12 hours.
Click on the Save button to keep the settings.
Request to database
The widget allows you to create a query to the Tariscope database to get any data and display them in the widget using HTML tags.
If you have selected the widget, it appears as shown in Figure 20.30.
Figure 20.30
At first, you should decide what information from the Tariscope database you want to display. Then you should define how to get these data. There is a document "Tariscope 4.x. Database scheme" that contains the descriptions of all Tariscope tables and views. Find tables or views that contain the required data and create the SQL query. You can check out the correctness of the query using Tariscope. To do this, in the menu, select Additional options → SQL queries, enter and execute the query.
If you get the required result, enter the query in the widget. To do this, double-click on the widget and select the Configuration item. The Widget configuration window appears as shown in Figure 20.31.
Figure 20.31
Enter the query in the SQL query to database box. In the Response format box, enter information that will display in the widget. You can use HTML to display data. For example, you can enter the following string to display the result of query contained calls cost for current date:
Total calls cost: {0},
where {0} is a result of the query.
Click on the Save button to keep the settings.
The widget allows you to create hundreds of different widgets.
Resource usage
The widget displays a usage of the server resources by Tariscope. An example of the widget is shown in Figure 20.32.
Figure 20.32
Blue color shows the resource usage by other applications. Yellow color shows the resource usage by Tariscope applications. It is possible to show only the resource usage by Tariscope applications. To do this, double-click on the widget. In the appeared menu, select the Configuration item. The Widget configuration window appears as shown in Figure 20.33.
Figure 20.33
The window contains only the Advanced mode switch, which is enabled by default. Turn off the switch to show only the resource usage by Tariscope applications.
Tariscope Task status
The widget displays a task list of Tariscope Tasks for today and yesterday. The list contains a task name, time when task must be executed, and execution status. Tariscope Task is a Windows service that executes different tasks by schedule. Therefore, the widget is relevant if you use Tariscope Tasks. An example of the widget is shown in Figure 20.34.
Figure 20.34
Dashboard settings
The Tariscope dashboard has some settings. To configure the dashboard, click on the sign of three dots after the Tariscope dashboard title. In the appeared menu, select the Settings item. The window appears that is shown in Figure 20.35.
Figure 20.35
The Auto refresh widgets switch enables or disables automatic refresh of widgets content. By default, the switch is off. Most widgets contain data that are changed over time, therefore, to see actual data, turn on the switch and specify the period of data change in the Interval box.
The Enable widget reordering switch allows you to enable or disable the widget rearrangement.
The Auto sorting widgets switch allows or disallows you to leave an empty space on the dashboard.
If you want to have more space for the dashboard, turn on the Close left menu switch.
Click on the Save button, to keep the settings.
Widget access
When you create a Tariscope user, you can give access rights to the dashboard for the user. The configuration of widget access allows to restrict number of widgets that users can see. Click on the sign of three dots after the Tariscope dashboard title. In the appeared menu, select the Widget access item. The window appears as shown in Figure 20.36.
Figure 20.36
By default, all widgets disable. Enable the widgets that can be visible for users.
Refresh all widgets
If you want to refresh all widgets, click on the sign of three dots after the Tariscope dashboard title and in the appeared menu, select the Refresh all widgets item.
Go full screen
If you wish to extend the dashboard to full screen, click on the sign of three dots after the Tariscope dashboard title and in the appeared menu, select the Go full screen item.
Specific actions for a widget
There some specific actions that you apply to each widget. Double-click on the desired widget. The menu appears as shown in Figure 20.37.
Figure 20.37
The Back item of the menu allows you to close the menu.
If you want to pin the widget position, select the Pin item. If you want to unpin the widget from the specific position, select the Pin item again.
If you need to refresh the widget content, select the Refresh item.
A widget can have a different size. To change the widget size, select the Resize item and in the appeared window, select the desired size of the widget.
If you want to rename the widget, select the Rename item of the menu.
Some widgets have settings. To change these settings, select the Configuration item of the menu.
If you want to understand the widget purpose, select the About widget item.
To remove the widget from the dashboard, select the Remove item.
Previous page Next page
Tariscope 4.5.x. Administrator's guide
Upgrading from previous versions of Tariscope to Tariscope 4.5
To migrate to Tariscope 4.5 from previous versions, you should perform a series of actions.
- Create a full backup of the Tariscope database.
- Remember in what form the data is presented in the settings of the service provider. For example, 0038057, where 00 is an international access code, 380 is a country code of Ukraine, 57 is an area code of the Kharkiv region. This information will be used on the 10, 11 steps of upgrading. Pay attention to the presence or absence of the '+' sign before the codes, the presence or absence of exit codes for long-distance and international calls.
- If you perform the upgrade from Tariscope 3.4 - 4.0, you must to archive or remove all unnecessary calls from the Tariscope database.
- Install Tariscope 4.5. During installation, in the Components selection window, select Tariscope applications only or update.
- In Windows, click on the Start button. Select the Tariscope folder. Select the Tariscope Start program.
- The Tariscope Start window appears as shown in Figure 1.
Figure 1 - The system of telephone codes and parameters of telecom operators was completely redesigned in Tariscope 4.5. To import data from a previous version of Tariscope, select in the program menu Tools → Migrate the codes. The Migrate telephone codes window appears as shown in Figure 2.
Figure 2 - If you click on the Help button, the window appears that contains a series of actions which you should do.
- In the Migrate telephone codes window (Figure 2), click on the 'connect' link. The SQL Server Connection window appears as shown in Figure 3.
In this window, enter the desired parameters and click Check connection. If you specified the connection parameters correctly, the Connection status displays the 'connected' value and the Done button will be accessible. Click Done.
Figure 3
Otherwise, you will receive the message about a connection error. In the latter case, adjust the connection settings. - In the Migrate telephone codes window (Figure 2), in the Common parameters section specify:
- Long distance code (usually it is 0).
- International code (usually it is 0).
- Country code.
- Region code (it is an area code of your region).
In the Select the format of your codes section, the country and area code options appear.
Figure 4 - Select those options that you used in the previous version of Tariscope (see the step 2).
- Click Start. The country and area codes will be migrated to the new code structure.
- If you had views for calls and services in the desktop version of Tariscope that you would like to transfer to Tariscope 4.5, decide for which user of Tariscope 4.5 you want to migrate the views. If such a user is not already in the system, then you need to run Tariscope 4.5 and create the required user. We recommend that you migrate for the system administrator (webadmin) who was created during installation and then, if necessary, give other users of the system access to the necessary views.
- To migrate views, in the Tariscope Start window (Figure 1), select Tools → Migrate the views. The Migrate views window appears, an example of which is shown in Figure 5.
Figure 5 - In the list of users, select the username for which views will be available.
- In the list of views of the desktop version, select the views that you want to transfer to Tariscope 4.5. Click Migrate. The views will be available in Tariscope 4.5.
Previous page Next page
