This article explains how district administrators view and interpret ClassLink sync reports.
Access Sync Reports
1. Navigate to Manage in your district administrator account.
2. Select the Sync Reports tab.
3. On the Sync Reports page, you can view the upload history, status, and sync reports for the last 30 days. You can adjust the date filter to see all sync reports within a specific timeframe.
- Sync Status: There are 3 possible sync statuses:
- Completed: The sync completed with no errors detected. No sync report is generated for syncs with this status.
- Completed with Errors: The sync completed with errors detected. Access the sync report to review the errors.
- Failed: The sync did not complete.
- Completion Date: The date and time the sync finished processing.
- Sync Reports: If any sync reports are available, you can access them here. Click the report link to download it.
Interpret Sync Reports
There are four types of sync report files you can download and review.
- users_sync_report.csv: Indicates there was an error updating or creating a user
- classes_sync_report.csv: Indicates there was an error updating or creating a class
- orgs_sync_report.csv: Indicates there was an error updating or creating a school
- enrollments_sync_report.csv: Indicates there was an error assigning a user to a class
Each sync report contains the following columns:
| SourcedId | Field | Status | Error Message |
|---|---|---|---|
| The ID assigned to the user, class, or school in the district's student information system (SIS) | The field that triggered the error |
Failure: The object was not created and must be fixed and re-synced. |
A description of the error. This description tells you what needs to be fixed in order to successfully process the data. |
Common Sync Report Errors
Here are a few examples of common sync report errors and how to resolve them.
users_sync_report.csv
| SourcedId | Field | Status | Error Message |
|---|---|---|---|
| 1234 | Failure | email is required for users with “teacher” or “administrator” roles |
Possible solution: The user was not created. Update the user's record in your rostering data source to include their email address. The user should be created after the next nightly sync.
classes_sync_report.csv
| SourcedId | Field | Status | Error Message |
|---|---|---|---|
| 1234 | subject | Failure | primary teacher is required |
Possible solution: No teacher was listed in the data so the class did not populate in Great Minds. Check your source data to ensure the class has an assigned teacher.
orgs_sync_report.csv
| SourcedId | Field | Status | Error Message |
|---|---|---|---|
| 1234 |
school |
Failure | school is not onboarded in Great Minds, school and all associated records will not be synced |
Possible solution: The school has not yet been rostered in Great Minds. Contact your Digital Implement Specialist for assistance.
enrollments_sync_report.csv
| SourcedId | Field | Status | Error Message |
|---|---|---|---|
| 1234 | userSourcedId | Failure | userSourcedId not found in our system |
Possible solution: A user with an invalid SourcedId was included in the enrollments file. This user was not enrolled in their assigned class(es) as a result. Verify the user has the correct ID assigned to them in your SIS.
How to Resolve Errors
All errors listed in the sync report should be corrected in your rostering data source (SIS). Once the record has been updated in your SIS, it will successfully process during the next nightly sync.