Reports
Reports are the results of a scan across one or more files that is initiated from the Reports page.
In this chapter
1.From the navigation panel on the left, click REPORTS. The Active Reports page opens.
The Active Reports page lists both in-progress and completed scans with a high-level overview of the scans. For scans that are in-progress, this overview provides information about the current progress. For completed scans, this overview provides information about the result of the scan. The scan reports are retained in the system with links to download the associated report for scans that were completed.
Common scan management actions like creating, canceling or deleting a scan are available from this page.
This page also provides links to interactive scan details for each file for a selected scan report.
·To customize the number of items displayed on the page, click the Items per page drop down below the list and choose the number of items you wish to display. If there are more scan reports than the list can display, you can use the navigation links below the list to browse through more scan reports.
·Enter a word in the Filter field above the list to filter the set of scan reports by the word entered.
The columns in the list are as follows:
a.Submitted Date - date and time when the scan was submitted.
b.Folder Path - the UNC location of the root folder that contains one or files or folders to be analyzed.
c.Profile - Name of the profile used in the scan.
d.Status - indicates the state of the scan. Valid values are In Progress, Canceling, Canceled and Completed.
e.Report - link to download the report. If the report status indicated In Progress or Canceled, the link does not appear because the report does not exist.
f.Expiration Time - the date and time until when the report will be active. This date and time depend on the retention period that you selected when the scan was created.
Report Overview
a.Status - indicates the state of the scan. Valid values are In Progress, Canceling, Canceled and Completed.
b.Files Submitted - the number of files that could be analyzed and have been submitted for analysis by the system. When the Status indicates In Progress, this value will be incremented every time a file is submitted for analysis. When the Status indicates Completed, this value will indicate the total number of files that were submitted for analysis.
c.Pending - the number of files waiting to be scanned. This parameter is displayed when Status is In Progress, otherwise it is hidden.
d.Analyzed - indicates the subset of the Files Submitted that were successfully analyzed. When the Status indicates In Progress, this value will be incremented every time a file is successfully analyzed. When the Status indicates Completed, this value will indicate the total number of files that were successfully analyzed.
e.Unsuccessful - indicates the subset of the Files Submitted that could not be analyzed. When the Status indicates In Progress, this value will be incremented every time a file could not be analyzed. When the Status indicates Completed, this value will indicate the total number of files that could not be analyzed.
f.Skipped - the number of files that could not be submitted and were not processed any further. There could be several reasons why files are skipped. For example, files may be skipped because there was a problem reading the contents of the file or due to low disk space on the server, or the file upload service was unavailable.
|
|
NOTE: The information presented can be used to verify the scan in the following ways: a.Submitted + Skipped should be equal to the number of items (files and folders) on the target share unless the scan service was denied accessing in one or more sub-folders due to permissions set on those sub-folders. b.Analyzed + Unsuccessful + Pending (if the scan is in progress) should be equal to the File Submitted count. |
2.Click the Download link of a report to export the details in a CSV file or click Details to view the information about the scan.
1.From the navigation panel on the left, click REPORTS. The Active Reports page opens.
2.Click New Report. The New Report page opens. This page presents the information that is necessary to create the scan necessary for the report.
3.Step 1: Enter the folder path
a.Enter the UNC path to the root folder that contains the documents or sub-folders with documents that must be scanned.
b.Select the option Exclude specified folders from the path to exclude sub-folders from the path specified.
c.Click Next.
4.Step 2: Specify the folders to exclude.
This step is available when the option Exclude specified folders from the path is selected.
a.Enter the UNC path of the sub-folder that you want to exclude from the scan.
b.Click 
c.To remove a sub-folder from the list of excluded folders, select one or more sub-folders in the list and click 
5.Step 3: Select the profile to use for this scan
a.Click the drop down to select from a list of standard or custom profiles that will be used for the scan.
b.Click Next.
6.Step 4: Specify options
a.Select a retention period which is the number of days that the report will be retained.
b.Click Next.
7.Step 5: Ready to scan
a.Click Scan Now to begin the scan.
|
|
NOTE: You can review or revise your settings by clicking the edit icon |
for any of the previous steps.8.The Active Reports page that opens will display the status of the scan.
1.From the navigation panel on the left, click REPORTS. The Active Reports page opens.
2.Select a report where the status indicates In Progress. You cannot cancel a report with any other status.
3.Click Cancel Scan 
4.Click Yes to confirm or No to prevent the cancellation. If you click Yes, the status will briefly change to Canceling and then to Canceled.
1.From the navigation panel on the left, click REPORTS. The Active Reports page opens.
2.Select a report where the status indicates Canceled or Completed. You cannot delete a report with any other status.
3.Click Delete Scan 
5.Click Yes to confirm or No to prevent the deletion. If you click Yes, the report will be deleted.
Report Details
In this topic:
1.From the navigation panel on the left, click REPORTS. The Active Reports page opens.
2.Select a report and click Details to view the information about the scan. The Report Details - All page opens.
-or-
Select a report and click the link in the Files Submitted parameter in the Report Overview information box. The Report Details - All page opens.
-or-
Select a report and click the link in the Pending parameter (available only when Status is In Progress) in the Report Overview information box. The Report Details - Pending page opens.
-or-
Select a report and click the link in the Analyzed parameter in the Report Overview information box. The Report Details - Successful page opens.
The information displayed on this page is described below:
Report Summary
a.Submitted - date and time when the scan was submitted.
b.Folder Path - the UNC location of the root folder that contains one or files or folders to be analyzed.
c.Profile - name of the profile used in the scan
d.Submitted By - identity of the user who submitted this report in the format domain\username
e.Completed - date and time when the scan was completed.
f.Duration - the time taken to complete the scan.
Report Overview
a.Status - indicates the state of the job. Valid values are In Progress, Canceling, Canceled and Completed.
b.Files Submitted - the number of files that could be analyzed and have been submitted for analysis by the system. When the Status indicates In Progress, this value will be incremented every time a file is submitted for analysis. When the Status indicates Completed, this value will indicate the total number of files that were submitted for analysis.
c.Pending - the number of files waiting to be scanned. This parameter is displayed when Status is In Progress, otherwise it is hidden.
d.Analyzed - indicates the subset of the Files Submitted that were successfully analyzed. When the Status indicates In Progress, this value will be incremented every time a file is successfully analyzed. When the Status indicates Completed, this value will indicate the total number of files that were successfully analyzed.
·Warning - indicates the subset of the Files Submitted that have defects but allows a successful scan.
e.Unsuccessful - indicates the subset of the Files Submitted that could not be analyzed. When the Status indicates In Progress, this value will be incremented every time a file could not be analyzed. When the Status indicates Completed, this value will indicate the total number of files that could not be analyzed.
f.Skipped - the number of files that could not be submitted and were not processed any further.
Report List
a.Parent File Path - the UNC path of the file that has been submitted for analysis.
b.File Name - name of the file that has been submitted for analysis.
c.Status - the result of the analysis. Valid values are Successful and Unsuccessful.
d.Terms Detected - a semi-colon delimited list of the terms detected.
e.File Id - The globally unique identifier (GUID) of the file submitted for a scan. Click to 
f.Submitted On - The date and time when the file was submitted for a scan. Click to
Click 
To customize the number of items displayed on the page, click the Items per page drop down below the list and choose the number of items you wish to display. If there are more report detail records than the list can display, you can use the navigation links below the list to browse through more search terms.
|
|
NOTE: A maximum of 10,000 detail records can be viewed across all pages. If the number of files in the scan exceed 10,000 you can download the full or filtered list as a CSV file and use Excel or a similar desktop tool to view the results. |
Enter a word in the Filter field above the list in either the Report Details - All or Report Details - Successful view, to filter the set of report detail records by the word entered.
1.Click Download. The Download Report Details dialog opens.
2.Choose an export format from the following options: Default or Migration. The Migration export format is designed specifically for use with Quest Content Matrix or Quest Secure Copy.
3.Expand the Filter section to download a subset of the scan results if needed. Then enter the information as described below:
a.Parent File Path - enter the UNC path to the folder that contains the files to download. All sub-folders in the specified folder will be part of the filter criteria.
b.File Name - enter a file name to download.
c.Status - Choose from one of the following status values: Any, Error, Successful or Warning. For example, if you choose Error as the status, then the scan results where the status indicates an Error will be included in the filter criteria.
d.Search Term - Select the search term from the drop down list that appears that you want to include in the filter. For example, if you enter Government Identification Number as the search term, then the scan results where the Government Identification Number was detected will be included in the filter criteria. You can also include a custom search term manually. For example, Medical ID could be custom search term. Custom search terms may be listed in the search terms list if they are part of a current profile. Custom search terms will not be listed if you removed the term from a profile and you must enter it manually.
4.Click Download to export the scan results to a CSV file with the specified export Format. Click Reset to clear the filter or click Close to confirm the cancellation and exit the dialog.
Journals
Journal are log entries from report scans that indicate files that were skipped during a scan, warnings, and unsuccessful scan attempts
In this topic:
1.From the navigation panel on the left, click REPORTS. The Active Reports page opens.
2.Select a report and click Details to open the Report Details - All page.. Then click Journals to open the Report Journals - All page
-or-
Select a report and use the Report Overview information box to view various Report Journals as described below:
Click the link in the Warnings parameter. The Report Journals - Warnings page opens.
-or-
Click the link in the Unsuccessful parameter. The Report Journals - Unsuccessful page opens.
-or-
Click the link in the Skipped parameter. The Report Journals - Skipped page opens.
To customize the number of items displayed on the page, click the Items per page drop down below the list and choose the number of items you wish to display. If there are more report journal items than the list can display, you can use the navigation links below the list to browse through more search terms.
|
|
NOTE: A maximum of 10,000 journal items can be viewed across all pages. If the number of files in the scan exceed 10,000 you can download the full or filtered list as a CSV file and use Excel or a similar desktop tool to view the results. |
Enter a word in the Filter field above the list in either the Report Journal - All, Report Journal - Warnings, Report Journal - Unsuccessful, or Report Journal - Skipped page to filter the set of report journal items by the word entered.
1.Click Download from the any Report Journals page The Download Journals dialog opens.
2.Select a status from the Include records with the selected status value drop down. The options are: All, Error, Skipped and Warning.
3.Click Download to export the scan results to a CSV file. Click Reset to set the Include records with the selected status value to All, or click Close to confirm the cancellation and exit the dialog.
Configuration
This section describes the components and properties that control the functionality of SCM. The following topics are described in this section: