ClearCompany Learning: Debug Reports

Follow

The Learning Debug Reports provide SuperAdmins with tools to validate data integrity within the learning platform. Debug Reports help identify potential issues such as duplicate records, failed imports, broken SCORM/xAPI content, or user assignment exclusions. By offering detailed insights into system activities and configurations, Debug Reports are essential for maintaining a healthy and accurate learning environment.

In this article:
Debug Reports Overview
Types of Reports
Debug Reports Navigation
Debug Reports Available
Debug Reports Considerations
F.A.Q.

Debug Reports Overview

Debug Reports offer visibility into the backend processing of data within the learning platform. They allow SuperAdmins to:

  • Review group and user file uploads.

  • Confirm successful file imports or identify failed ones.

  • Monitor SCORM/xAPI interactions and recent user activity.

  • Troubleshoot mail logs, assignment exclusions, and content visibility.


Types of Reports

When users click Review Report next to the report they would like to analyze, the reports will be generated in two ways:

CSV File Clicking View Report will download a raw data file.
Dashboard

Clicking Run Report will open an interactive dashboard with additional filtering and export options.


Debug Report Rights

Debug Reports are only accessible to top-level SuperAdmins and are particularly useful for diagnosing system errors or confirming correct data flow.

  • Some reports are limited to 30 or 365 days of historical data.
  • SCORM or xAPI packages must be authored to properly display data.

Debug Reports Navigation

  1. From the administration dashboard, click Reports, then click Debug Reports.Debug Report Option.png
  2. Below are the Debug Reports available.Debug Reports.png

Debug Reports Available

Bulk Import Files - Dashboard

The Bulk Import Files report displays uploaded or attempted bulk import files.

Use Case:

Helps verify which files were processed successfully or failed, aiding troubleshooting.

Data Fields

Filename Import Type
Last Modified Import Status

Completion CSV to FTP - Requires Configuration

Completion CSV to FTP report will display a list of the learning platform completions files sent to an external FTP server. For information, refer to:  ClearCompany Learning: Completion and Assignments CSV to sFTP.

Use Case:
Provides a backup of learning completion records for external system syncing.

Data Fields

User ID

First Name Email Completed On
User Name Last Name Phone Record Id
Title Primary Group Id Primary Group Code Score
Primary Group Name Object Id Object Title Active User Auxiliary Fields

Assignment CSV to FTP - Requires Configuration

Assignment CSV to FTP report will display a list of the learning platform assignment files sent to an external FTP server. For information, refer to: ClearCompany Learning: Completion and Assignments CSV to sFTP.

Use Case:
Enables syncing LMS assignment records with external systems.

Data Fields

Assigned TS

Email Object Name Username
Batch ID First Name Object Type Name User ID
Batch Name Last Name Primary Group ID Active User Auxiliary Fields
Batch Name Object Id Status  

Recent SCORM Activity - CSV

The Recent SCORM Activity report displays recent SCORM object activity for a specific user or object.

Use Case:
Audit SCORM engagement and performance.

Data Fields
Object ID Object Name User ID
Username First Name Last Name
Completion Status Success Status Total Time Tracked
Score Known Score Last Update
Start DT Suspended Act  

SCORM Interaction - CSV

The SCORM Interaction report displays a detailed report of learner interactions within SCORM packages.

Use Case:
Review specific SCORM quiz questions, responses, and outcomes.

Data Fields
Interaction Index Last Name Description Weighting
Record ID Object ID Type Interaction Seconds Spent
User ID Object Name Correct Response Timestamp_UTC
Username Attempt Count Learner Response  
First Name Interaction ID Result  

xAPI Statements - CSV

The xAPI Statements report displays Experience API (xAPI) statements sent from compatible courses.

Use Case:
Track learner activity for xAPI-enabled courses.

Data Fields

Data Fields
Object ID User ID
Name Statement
Timestamp  

Objects With No Access - CSV

The Objects With No Access report displays a list of learning objects that are inaccessible to any users or groups.

Use Case:

Audit and clean up unused or misconfigured content.

Data Fields
Object Name Object ID
Object Type Name Object Status
Creation TS User Access
Group Access Assigned

Mail Sent Log - CSV

The Mail Sent Log report tracks messages sent from the system (e.g., assignments, reminders).

Use Case:
Troubleshoot undelivered or misrouted emails.

Data Fields
From Email To Email
Subject CC Emails
BCC Emails Sent On

User Assignment Exclusions - CSV

The User Assignment Exclusions report displays a list of users who were manually excluded from assignment batches.

Use Case:

Validate intentional exclusions or identify configuration errors.

Data Fields
First Name Batch Name
Last Name Batch ID
Username Assigned Group
Email Assigned On

Objects Debug - CSV

The Object Debug report will display access configurations and relationships for all learning objects.

Use Case:

Troubleshoot access visibility and inheritance issues.

Data Sections Data Fields

User Access

  • Object Name
  • Object ID
  • Object Status
  • Username
  • User ID
  • First Name
  • Last Name
  • Email
  • Status
Group Access
  • Object Name
  • Object ID
  • Object Status
  • Group Name
  • Group ID
  • Group Status
Parent Object
  • Object Name
  • Object ID
  • Object Status
  • Object Type Name
  • Parent Object Name
  • Parent Object ID
  • Parent Object Status
  • Step Sort No
  • Step Status
Equivalent Objects
  • Object Name
  • Object ID
  • Object Status
  • Equivalency Name
  • Equivalency Description
  • Equivalency Status
  • Creation TS
  • Equivalent Object Name
  • Equivalent Object ID
  • Equivalent Object Status

Assignments Debug - CSV

The Assignment Debug report displays a breakdown down all assignment configurations and related data.

Use Case:

Comprehensive troubleshooting of assignments by user, group, object, and grouping.

Data Section Data Fields
Users
  • Batch name
  • Batch Id
  • Batch Status
  • Username
  • User Id
  • First Name
  • Last Name
  • Email
  • Status
  • Excluded
Groups
  • Batch name
  • Batch Id
  • Group Name
  • Group Id
  • Group Status
Groupings
  • Batch name
  • Batch Id
  • Batch Status
  • Grouping Name
  • Grouping Id
  • Grouping Status
Objects
  • Batch name
  • Batch Id
  • Batch Status
  • Object Name
  • Object Id
  • Object Status

Email Suppression List - CSV

Email Suppression List displays users whose emails are suppressed due to bounces or spam complaints.

Use Case:

Review and reinstate users with blocked email addresses if needed.

Data Fields
User ID First Name
Last Name Email
User Status Reason
Last Updated TS  

Debug Reports Considerations

  • Ensure that all SCORM or xAPI content is authored to return data (e.g., quiz responses, completion status). Improperly configured content will result in blank or partial reports.
  • Be aware of time restrictions. Data for some reports is not stored indefinitely (e.g., 30 or 365 days). Clients should regularly download and archive key reports.
  • For CSV-to-FTP reports, the correct configuration of FTP credentials and enabling relevant settings is critical.
  • If report data is missing or files fail:
    • Review import logs
    • Confirm data formats
    • Check content authoring settings
  • Large reports may take time to generate and download. Use filters to narrow the scope if needed.

F.A.Q.

What types of issues can the “Objects With No Access” report help identify?

The Object with No Access report helps identify content that is not assigned to any users or groups, which can highlight configuration errors, unused content, or gaps in training assignments.

How can the “Assignments Debug” report assist with troubleshooting?

The Assignments Debug report allows SuperAdmins to cross-reference assigned users, groups, and learning objects. It’s useful for investigating missing assignments, validating exclusion rules, and ensuring group-based assignments are working correctly.

Can Debug Reports help verify if FTP file transfers were successful?

Yes. The “Completion CSV to FTP” and “Assignment CSV to FTP” reports confirm which files were generated and sent by the LMS. They act as a log of successful exports and can be used to compare with your external system to ensure syncing is working.

0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.