...
| Widget Connector | |
|---|---|
|
...
|
...
|
...
|
...
|
| Widget Connector | |||||
|---|---|---|---|---|---|
|
...
|
...
|
| Inhalt | ||
|---|---|---|
|
Preface
This documentation is valid as of the iQueue pro/iPro UC-Analytics version 13.1.1. and the STARFACE 7.0.2.1
...
Go to the item module library where the already installed modules are listed. If the module STARFACE_CDRConnector_v114 is not available here, it must be imported. To do this, select the item import module and choose the corresponding "sfm" file under install module via upload (in this case, it is the file "STARFACE_CDRConnector_v114.sfm" - the file name may differ). Press next to import the module.
...
Create configuration Aurenz CDR Connector
The previous process only imports the module, but does not yet create a configuration. To create a configuration, please click new configuration under module configuration and select "STARFACE_CDRConnector_vxxx". By clicking create, a new configuration for this module is created.
...
Here, some adjustments are necessary:
Under general a name must be given, (e.g.: "Aurenz-CDR-Connector") then press apply.
In addition, a password must be assigned for communication. To do this, set an appropriate password in configuration under password protection and press apply.
The parameters name and password are required when configuring the data source in UC-Analytics and they must match!
...
| Tipp |
|---|
Procedure for setting the passwordSpecifying the password requires a special procedure in STARFACE, as otherwise it will not be correctly adopted:
|
Starting with module version 185, additional parameters have been added. These have the following meaning:
Erstdatenbenzu nicht älter als: The date from which the data is to be imported is specified here. This is only taken into account for the first query. A query can otherwise take a long time, especially if a system has been running for a long time and a lot of data has been collected. This parameter can be used to limit this.
Datensammlung ("Gruppen Login/Logouts Sammeln" and "Telefoniestatusänderungen von Benutzern Sammeln"): These two parameters are used for "debugging" and are intended to help analyze performance problems. If these parameters are "deactivated", the corresponding data is no longer collected and is therefore missing from the analysis. This means that this can only be deactivated temporarily.
...
Setup a data source instance to connect to the STARFACE
To retrieve CDRs from the STARFACE a so called data source instance has to be created. The data sources are managed by the UC-Analytics program module called data collector. You can access the data collector through the tray icon in the windows task bar:
Double click on the 
icon and the data collector application opens. Login with the "superuser" account. If you haven't installed the iQueue pro/iPro UC-Analytics yet, you can also configure a data source instance during the installation prozess which is described in the next sections.
...
When choosing the data source, select the manufacturer STARFACE and then as model STARFACE module.
...
Define data source name and the outbreak location
It is important to set the correct location of the pbx outbreak if you want to use the accounting features. Based on the location of the outbreak and the call destination the call costs will be calculated.
...
Configuration settings for the STARFACE module
...
The parameters have the following meaning:
IP address of the STARFACE: This is the IP address (or DNS) of the STARFACE.
Port number: The module port to be used must be entered here (normally port 80 for HTTP and port 443 for HTTPS).
Secured connection (SSL): If HTTPS is to be used, this must be activated (and the port adjusted accordingly).
Login ID: The "login ID" of a user in STARFACE. With this user the login into the STARFACE module will be performed.
Login Password: The corresponding password to the "Login ID".
Module configuration name: This is the name of the "configuration" that was created in STARFACE like described before.
Module configuration password: This is the password of the "configuration" that was set in module configuration like described before.
Limit for query (number of data): This can be used to define how many CDRs are retrieved per query.
Poll-Intervall (Sekunden): In diesem Intervall werden bei einer Standverbindung neue CDR von der STARFACE abgefragt. (Hinweis: Diese Punkt sollte nicht zu klein gewählt werden, da sonst die Datenbank der STARFACE zu sehr beansprucht wird).
Poll interval (seconds): In this interval, new CDRs are queried during a permanent data connection. (Note: Don't set this point too low, or else the STARFACE database could be overloaded).
Please check if the connection based on that parameters can be establish through clicking the "Connection test" button. See also the section "Testing the installation" further below.
...
You can setup some additional settings after a data source once was created. Please open the data collector module and then the Overview window:
...
Then select the data source instance you want to configure and double click in it. Open the configuration, if needed pause the connection.
...
Now the data source configuration window opens and you can check and change all the setting available. 
...
Tab Scan Directory
By default, the path is already "correctly" set and no further configurations are necessary here.
...
This tab is used to define the location ofthe breakout of the telephone system as well as which network carrier is used to calculate the price of the individual phone calls.
Please consider
The settings for the used network carrier are made in the UC-Analytics administrator under File / Set up programme / Network carrier. Further descriptions can be found in the UC-Analytics admin manual.
The settings in the Access tab have no relevance for STARFACE.
Tab Time period
Use this tab to define on which days of the week/ times of the day the data from STARFACE shall be processed.
...
Example: Extension Johnson = 115 / Fax Number for Johnson = 98115
Note: This This feature is not supported by all PBXs!
...
Example of a successful connection
...
Example of an incorrect connection
...
Error message: ...The registered auth token converter did not convert the client transport token ....
...
In this example, the "module configuration name" is incorrect!
Error message: ...No processor found for the identifier ...
...
Data collection
Start the UC-Analytics data collector and open the data source overview window through the menu item "Data source → Overview". Highlight your telephone system and select the menu item "Data source → Data record monitor". Make some test calls via STARFACE. If the data source is not set to "permanent connection", press the menu button "connect now" in the menu bar, so that the data will be processed. You can check the transfer using the two monitor windows. The overview monitor window shows the transfer of the data and the data set monitor window shows its interpretation of each data record itself.
...
The data set monitor should be closed after the tests are completed.
...