Overview
Settings window is used to configure SAM Reports.
There you can:
- Set common options (available to all projects)
- Create and delete projects
- Access Log Files Viewer
- View Last Parse Results
- Manage and view Project Rules:
- Manage each project’s settings:
- Perform Maintenance Operations:
Settings Window
There are four main areas:
- common options
- project actions and options
- project list
- display area
SAM Reports 2 Settings - Main Window
Project Settings
There are five main areas of project settings:
SAM Reports 2 - Settings - Asterisk Project Settings
On the image above you see the five main parts tabs that appear on the bottom of each project window. Below I will describe each one.
But first, let’s take a look at a video describing adding a new project and processing data:
Asterisk Project Settings
On this page you enter the information related to connecting to your Asterisk server.
SAM Reports 2 - Asterisk Project Settings
Single Log Files Settings
If you use single log files, that are placed in default location, then you don’t need to edit anything on this page. Same goes if your Asterisk installation rotates log files. Then you would go to the “Multiple Log Files” page.
SAM Reports 2 - Settings - Asterisk Single Log Files
Multiple Log Files Settings
Multiple Log Files let you define the rules that explain to SAM Reports 2 how your sliced Asterisk log files get rotated. That is necessary for the Transfer or Import to work properly. This is only needed if you don’t have a single log files configuration on your Asterisk PBX.
SAM Reports 2 - Asterisk Rotated Log Files Settings
Transfer Settings
Here you can define the SFTP connection settings for your project’s Asterisk machine.
- SAM Reports 2 Asterisk Transfer Settings
Manager Settings
Those settings let you define local codes and prefixes. PBX prefix is important so that phone numbers may be identified correctly.
SAM Reports 2 Asterisk Prefix Settings
Project Rules
Project rules commands let you see the raw log files of the current project (only in Enterprise Edition), also set the rules for processing log files, and view last parsed results.
SAM Reports 2 Asterisk Project Rules
Log Files Viewer
Log Files Viewer is an application that comes only in the Enterprise Edition of SAM Reports 2. It let’s you view and inspect your project’s raw log files, as created by the Asterisk PBX.
The purpose of Log Files Viewer is to construct ignore rules and agent rules for your project, which is only possible if you can examine the raw log files.
SAM Reports 2 Log Files Viewer
Agent Rules
If an agent’s extension is contained within it’s name, than you can define the rules explaining how that extension can be recognized and extracted.
SAM Reports 2 Asterisk Agents Parsing Rules
Ignore Rules
Ignore rules let you ignore some lines from CDR and queue log files. You may have such needs if your CDR log file has many unnecessary log lines, not to crowd your report with redundant data. Or maybe there are some privacy issues involved.
SAM Reports 2 - Ignore Rules for Parsing Asterisk Log Files
Last Parse Results
This command shows you a window with animated report displaying the project’s last parsing flow. You can see more information here.
Common Settings
Common settings inform you about SAM Reports2 application installation directory and the data directory.
You can also change the skin with common settings
SAM Reports 2 Settings - Common
.
