Main Screen

The main screen of SAM Reports 2 is divided into several parts:

1. Main menu
2. Most used commands
3. Project Chooser
4. Current screen

SAM Reports 2 Application Organization

Main Menu

Main menu lets you choose different parts of the application.

It has six sections:

1. Home Screen
2. Pivot Reports Screen
3. Detailed Reports Screen
4. Resources
5. Settings Screen
6. About

Each section has either it’s own window(Resources and About) or displays in a current screen (Home, Pivot and Detailed Reports and Settings).

Home Screen

Home screen shows the current project’s dashboard. It displays a summary of all available CDR and Queue data for that project.

SAM Reports 2 Home Screen

If current project does not contain CDR or Queue data, than just one dashboard is displayed. If it has neither CDR nor Queue data, then the home screen is empty. It is usually the case when the settings for the project have just been defined, but no data has been transferred or processed yet.

Pivot Reports Screen

When you choose the “Pivot Reports” command, then the current screen looks like this:

SAM Reports 2 Pivot Reports Screen

There are several types of reports for CDR and Queue respectively:

1. General calls reports:
   • CDR calls and Queue calls (contains the queue element)
2. Reports by elements
   1. CDR:
      1. By Channels
      2. By Trunks
      3. By Trunks and Channels
   2. Queue:
      1. By Agents
      2. By Agents Detailed
      3. By Queues and Agents
3. Report containing contacts or phone numbers
   • CDR/Queue report by phone numbers
   • CDR/Queue report by contacts

More  information about pivot reports is available on the “Pivot Reports” help page.

Detailed Reports Screen

When you run the “Detailed Reports” command then the current screen look like this:

SAM Reports 2 Detailed Reports Screen

There you can run CDR or Queue detailed reports.

More information is available on the “Detailed Reports” help page.

Resources

Resources command opens the resources window and displays them.

More information is available on the “Resources” help page.

Settings Screen

When you choose “Settings” command than the current screen look like this:

SAM Reports 2 Settings Screen

More information is available on the “Settings” help page.

Transfer Files

Log files may be:

• Single “Plain Vanilla” Asterisk log files (one Master.csv and one queue_log, no rotation)
• Split – Rotated log files (multiple rotated Master.csv and queue_log files)

Transfer copies and prepares the log files from project’s Asterisk PBX to the local computer. Parser can then process the log files to generate reports.

SFTP parameters for your project’s Asterisk PBX are defined on the Transfer area of Project Settings.

Import files

Import command lets you add log files to your Asterisk project from the local disk on your PC.

This can be useful if you have some old log files laying around, and the Asterisk PBX is no longer “alive”, but you would like to generate reports from those log files.

SAM Reports does not require “live Asterisk PBX”, this command overrides that.

Import asks you to choose a directory, and then copies  and prepares the  log files for the Parser to process.

Process Log Files

This command call the “SAM Reports 2 Parser” that generates data from the log files and adds it to the current project’s database.

Process Log Files From Beginning

This command is the same as previous, only it will empty the current project’s database, prior to processing the data.

Show Last Parse Results

Shows the parsing progress from the last time.

SAM Reports 2 - Show Last Asterisk Parsed Results

About

Opens the “About” window that shows the application version and user information.

On the “Application Data” tab you can see the application’s install directory and it’s data directory.

SAM Reports 2 Data Directory

You can check for a new version by clicking on the “Version” tab:

SAM Reports 2 Check Version

If there is a newer version available, than there will be a button on this window for updating the application.

You can download the setup file anytime regardless of the current version. It will be saved in application’s data directory.

Most Used Commands

SAM Reports 2 Most Used Commands

The commands are:

• Settings
• Import Log Files
• Transfer Log Files
• Process Log Files
• Pivot Reports
• Detailed Reports

If some command is currently unavailable then it it rendered as disabled.

Project Chooser

Project chooser shows the list of all available projects in the application:

SAM Reports 2 Project Chooser

After you have chosen a project from the chooser, you have to click on the button “Set As Current” to actually change a project.

All reports and data will be of that project only.

More information is available on the “Projects” help page.

Current Screen

The data displayed on the current screen depends on which command from the main menu or from the most used commands was chosen.

The current screen can be:

1. Home Screen
2. Pivot Reports Screen
3. Detailed Reports Screen
4. Settings Screen

It is explained in the Main Menu part of this document.