This article explains how district administrators view and interpret Clever sync reports.
Accessing Sync Reports
1. Navigate to Manage in your district administrator account.
2. Select the Sync Reports icon or 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.
Interpreting Sync Reports
There are three 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 section
- schools_sync_report.csv: Indicates there was an error updating or creating a school
Each sync report contains the following columns:
| Clever ID | sis_id | field | status | message |
|---|---|---|---|---|
| The Clever-assigned alphanumeric ID of the user, class, or school | The ID assigned to the user, class, or school in the district's student information system (SIS) | The field that triggered the error |
Failure: This means 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
| Clever ID | sis_id | field | status | message |
|---|---|---|---|---|
| 1234 | 5678 | 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
| Clever ID | sis_id | field | status | message |
| 1234 | 5678 | teacher | 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.
school_sync_report.csv
| Clever ID | sis_id | field | status | message |
|---|---|---|---|---|
| 1234 | 5678 |
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.
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.
For assistance with data sharing rules in Clever, see this article and/or contact Clever support.