Recall Prilog Service
Extension integration based on CDRs
Installation & Setup Guide
Software version 1.0
2
TABLE OF CONTENTS
1.
Introduction ... 3
2.
Prerequisites ... 3
3.
Installation ... 4
4.
Configuration ... 5
4.1
Basic configuration ...
5
4.2.1
CDR capture ...
5
4.2
Advanced configuration ...
6
4.2.1
Trunk matching table ...
6
5.
Testing ... 7
3
1. Introduction
When the extension number is not available in the recorded media, typically on trunk lines, this information can be retrieved from the pbx CDRs if it is available.
This document is intended to help understand the principles, installation and configuration of the Prilog Service allowing the Recall to retrieve and display some additional information from the Call Details Records (such as the internal number of the called or calling) when this information can’t be obtained in the recorder due to technological reasons.
As mentioned previously, when the extension number is not available in the recorded media, this information can be retrieved from the pbx CDRs if available.
The system gets the CDRs from the pbx and uses the CDR information to assign the extension number to the recordings.
Examples of CDRs from different pbx brands:
Date Time Ext Trk Number Duration
20/05/10 10:08 247 04 987654321 00:00'27 20/05/10 10:08 444 03 654321987 0'01 00:00'00 Ext Trk Date Time Duration Number
A1203 --> L02 16/11/11 08:24 00:01:02 0 ST 600433012 A1301 --> L01 16/11/11 08:48 00:00:00 0 ST 645817859 Time Date Trk Duration Ext Number
30 IVIN 09:54 10/06 014 00:00:50 235 987578073 0:05 31 IVIN 09:53 10/06 005 00:01:47 270 987578073 0:32
Both CDR and recordings share parameters as Call Type (Incoming, Outgoing), Dialed number, Date and Time, Trunk Number, Duration, etc.
Prilog service compares all values between both CDR and recording and when they match, the extension number appearing in the CDR is assigned to the recording.
Different services installed are responsible for CDR capture, processing and data matching.
Service Funtion
Jusan CallXpressCollect CDR capture
Jusan CallXpressProcess CDR processing
Jusan Prilog Data matching
2. Prerequisites
- Recall Software already installed and operational.
- .Net Framework 4 extended (it will be installed automaticaly if needed). - CDRs from pbx available on the computer via RS232, TCP server, etc.
4
For Recall ISDN/Analog :
- Enable the ‘Recintegra’ option in the Recall Server Setup.
3. Installation
Note: (Only for Recall ISDN, Recall Analog or Recall SIP)
The installation of the “Jusan PRI Database Logger” Service (Prilog) is needed for products as Recall ISDN, Recall Analog or Recall SIP when the Extension integration is to be done; otherwise, do not install it.
Note: (Only for Recall E1)
The standard installation or Recall E1 already installs the “Jusan PRI Database Logger” Service. If it was already installed and the option “PBX integration” was not enabled and you need to integrate the Extension Number now, please uninstall current “Prilog” from Control Pannel-Programs and install it again activating this time the option “PBX integration”.
To install the Prilog Service, launch the installation wizard (Bin\Setup.exe) and select Language-Install Software-Recall E1-Recall E1 Logger.
Alternatively you can move to the folder ”RecallSoftware\Recall E1\PRI Database Logger” and
run Setup.exe
When prompted about the option ‘PBX integration’, be sure to check the option ‘PBX integration’ ONLY when you intend to integrate the Extension Number in the recording using the pbx CDRs; otherwise, leave the option un-checked.
Follow the different installation windows.
5
4. Configuration
For PBXs where the channel number is not shown in the CDR, just go through the basic configuration described in point “4.1 CDR capture”.
ONLY for PBXs where the channel number is shown, after going through the basic configuration also proceed with the advanced configuration as described in point “0
4.1 Basic configuration
4.2.1 CDR capture
The configuration of the CallXpress Setup will define the type of connection with the pbx (RS232, TCP, etc.) and the processing of the CDR (PBX format).
To enter into the CallXpress Setup, enter with default user and password (user: admin / Password: admin).
Select the “Site 1” and the configuration window will be opened. In the first section, select the right PBX format for the pbx CDRs.
If you don’t have the PBX format Driver, please contact our Technical Support at [email protected]
In the second section called Type of Protocol, select the type of connection with the pbx (TCP server, TCP Client, RS232, etc.) and its related parameters (IP Address, TCP Port, Baudrate, etc.).
After setting all parameters have been setup, select OK. The services will be restarted to make the changes effective.
6
4.2 Advanced configuration
Advanced configuration can ONLY be used when the Trunk Number is shown in the PBX CDR. Otherwise, go only through basic configuration.
The usage of Trunk Number from PBX CDR in the matching helps to avoid assigning a wrong extension number assignation mainly when the pbx traffic is high and some calls from the same number to the same destination are made at times very close to each other.
To enable the Trunk Matching, open the Prilog.ini file and set the parameter “TrunkMatch=1”
4.2.1 Trunk matching table
To use the Trunk matching, in addition to enable it by changing the parameter “TrunkMatch=1”, you have also to setup for each Device Channel Number, the corresponding Trunk ID as it appears in the CDR.
To do this, you can be aware in advance of what kind of cabling you made between recording devices and pbx trunk; otherwise, make some tests calls in different trunks and build the table according to the Trunk ID info you get in the CDR.
Open the Prilog.ini file with Notepad or similar plain text editor and setup the Trunk ID shown in the CDR to the relevant Device Channel Number:
Example:
Ext Trk Date Time Duration Number A1203 --> L01 16/11/11 08:24 00:00:15 0 ST 654321987 A1301 --> L02 16/11/11 08:26 00:00:20 0 ST 654321987
Ext Trk Date Time Duration Number A1203 --> L03 16/11/11 08:28 00:00:15 0 ST 654321987 A1301 --> L04 16/11/11 08:30 00:00:20 0 ST 654321987 [Device_BBRI0886] Channel_0886A = L03 Channel_0886B = L04 [Device_BBRI0887] Channel_0887A = L01 Channel_0887B = L02
As can be seen on the above example, the Device Channel Number “0886A” is assumed to be connected to the PBX Trunk Number “L03” as it appears in the CDR.
Depending on the recording device (Analog, ISDN, E1, etc.), the Device and Channel identification may be different. Here are some examples for different recording devices:
Pbx CDRs
7
[Device_B1]Channel_B1 Channel 1 of the E1 “B”
Channel_B2 Channel 2 of the E1 “B”
Channel_B3 Channel 3 of the E1 “B”
The different Channels (B1, B2, etc.) belong to the different channels in the E1 recorder.
Example for ISDN recorder:
[Device_BBRI0886]
Channel_0886A Channel A of the unit with MAC Address ending in …08-86
Channel_0886B Channel B of the unit with MAC Address ending in …08-86
[Device_BBRI0887]
Channel_0887A Channel A of the unit with MAC Address ending in …08-87
Channel_0887B Channel B of the unit with MAC Address ending in …08-87
The 4 digits identification belongs to the last 4 digits of the unit MAC Address. You can find the unit MAC Address in the label at the unit bottom.
After the table has been completed, it is necessary to restart (Stop/Start) the Prilog service (Control Pannel-Administration Tools-Services)
5. Testing
Open the Recording Manager software, make some test calls, wait for 2 or 3 minutes and then refresh the call list to check if the extension number is shown.
The extension number is assigned in post-process mode; this means that when the call ends, the recording doesn’t have the extension number yet. When the CDR is received and processed (capture and processing services run every minute), then the extension number will be assigned. It is recommended to enable the “Auto-Refresh” mode of the Recording Manager to help in the fields refresh to shown changes in the extension number after the post-process has taken place.
6. Backup
In case of a system reinstallation due to a computer crash, it is recommended to keep a copy of the following files:
Cdr Format Driver xxxx. LF3 file