Report of FaceSense Logon Statistics

Introduction

The purpose of the "Facesense Logon Statistics" report template is to allow the administrator to create reports that show statistics based on all user logon that used Facesense authentication.

The report can be found by navigating to "Administration | Reports", then scrolling down to the report "Facesense Logon Statistics";

Creating a report using the "Facesense Logon Statistics" template

To create a report based on FaceSense logon activity details you will need to use the context menu option "Create" for the report template "Facesense Logon Statistics" (highlighted template above).

• Click here for more information on how on report creation

  To create a report, navigate to "Administration | Reports", then select the tab "Templates";

  

  Left click on the context menu of the report template you will base the report on, then select "Create Report";

  

  A new window titled "Report - New" will now open that can now be used to create the required report;

  

  
  

  
  

  
  

  
  

  
  

  Name:

  Enter a name that will identify this report.  Whilst any name may be used that describes the purpose of the report it is suggested that somewhere in either the report name or the report description you include a reference to the name of the report template that this report is based upon. 

  Description: (Optional)

  This optional field can be used to describe what the report does, and this is also the natural place to refer to the report template that this report is based on.

  
  

  Query Statement

  If no conditions are specified, then the report will list details for all tokens in the token repository.

  It is possible to filter which details are listed in the report by using the condition builder tool (the tool is accessed by clicking on the icon);

  

  We would use the condition builder to specify what details are to included in the report by providing the condition details that match our filter requirements.

  In the above example we will be searching for tokens in the specified domain of the product type "SafeID/Event-Based".

  When the conditions have been provided we submit them using the button.

  
  

  
  

  Schedule Enabled

  This field will determine if the report schedule is enabled (if enabled the task will execute at the scheduled time).

  Schedule:

  This field is used to specify when the report is scheduled to execute using a tool that is launched using the icon;

  

  
  

  Repeat Count:

  Specifies how many times the report should be rerun after the report has been executed.

  
  

  Once this report has been saved, the newly created report may later be edited by clicking on the "Reports" tab and using the "Edit" context menu options;

  

  

Using the "Condition Builder" tool to filter reported records

If no conditions are specified, then the report will list details all FaceSense login statistics, but additional conditions can be added that filter which records are included in the report.

Condition filters are added using the "Condition Builder" tool that is used to construct the Query Statement and is employed using the icon.

Filters may be applied based on any of the following fields;

• Click here for more information on using the Query Statement Tool

  It is possible to filter which details are listed in the report by using the condition builder tool (the tool is accessed by clicking on the icon).

  After the icon is pressed a new window titled "Condition Builder" will open;

  

  The report template would normally produce a report that provides details for all records that are produced by the query that the report is based on, but these records can be restricted by supplying optional conditions in the condition builder.

  The condition builder allows us to specify additional conditions that further restrict what records are included in the report.

  As an example, if we wanted to restrict the records added to our report for a specific product and domain we could add the following conditions;

  

  The above example was created with the "All Tokens" report template (searching for tokens in the specified domain of the product type "SafeID/Event-Based"), but each template will offer different options.

  Conditions are added to this list using the button, and it is possible to use the logic operators ("and" and "or") to specify if all the conditions are required, or if some are optional.

  When all the required conditions have been added we submit the conditions using the button, and once applied the condition builder will close, and the "Query Statement" parameter will be updated;

  

Report Scheduling

Whilst the report can be run manually from the management console, it is possible you might want to schedule the report to run a specific times automatically.

This can be achieved by use the report scheduling option;

• Click here for more information on Report Scheduling

  Reports can be scheduled for automatic execution by selecting the "Schedule Enable" option then clicking on the icon;

  

  When the is pressed a window will open titled "Schedule" that can be used to specify the when the report is scheduled to run; 

  

  
  

  As an example, we can schedule the report to run at 1am every weekday using the following settings;

  

  After clicking on the schedule details will be converted into text form and added against the report parameter "Schedule"; 

  

Configuring Report Output 

The default layout and contents of the report can be customised using the button.

The purpose of the configuration feature is to specify which of the available field are to be listed in the report columns.

In the following table the items listed as included are listed in the report columns, whilst the optional items are not included in the report;

• Click here for more information on Report Configuration

  Unable to render {include} The included page could not be found.

  
  

Running and Exporting the Report

The newly created report will now be listed in the "Reports" tab (listed under the name that you gave your report, and should be at the end of the list).

• Click here for more information on running reports

  To run your reports, first select the tab "Reports";

  

  Then click on the context menu of the report you want to run, then select "Run";

  

  The status of the running report can be inspected by selecting the "Results" tab;

  

  Initially the status will be set to "RUNNING" (as shown in the example above), but will eventually change to "COMPLETED (you can update the page status by clicking on the "" icon).

  Once the report has completed you may export the results by left clicking on the context menu of your report then selecting "Export";

  

  A new windows titled "Report - Output" will now open that allows you to specify the report format;

  

  For this test we will leave the default "PDF" format selected and click on  to produce our report.

  The report will now be created in our download folder, and is ready for inspection.

  
  

Example Report

In the following example report we will create a report that will list all FaceSense statistics for users are members of the domain "spt.deepnetid.com".

We start by naming our report and providing a suitable description, then we click on the  icon in order to build our query statement;.

A new window now opens titled "Condition Builder";

For this report we want to search for all users within the domain "spt.deepnetid.com" so we add the following filter;

We don't need any additional conditions so we click  to build the condition, and the Query Statement parameter is updated;

After the report has been saved and run, we will find the FaceSense statistics for all users that are members of the specified domain.