Running a Grade Passback sync from Canvas to Aeries Gradebook fails, displaying a generic server error page instead of a descriptive error message.
The error page shows a hash value, fArnoKysooCNEXpvpB7aDg==, and references the OneRosterv1p1 controller.
Cause
The sync fails when Canvas passes back grades for a course containing linked, or grouped, gradebooks. An unhandled exception occurs in the Aeries OneRosterv1p1 endpoint while processing the request. Aeries attempts to render a diagnostic Error view to display the underlying exception, but that view does not exist within the OneRosterv1p1 module. As a result, the generic An unexpected error has occurred page displays in place of a specific error message.
The hash value displayed on the error page maps to the ERR table and can be used to confirm the missing-view exception:
- fArnoKysooCNEXpvpB7aDg==: example hash value shown on the error page; replace with the actual hash value from the affected environment
ERR table
SELECT * FROM ERR WHERE HS = 'fArnoKysooCNEXpvpB7aDg=='
Resulting message:
The view 'Error' or its master was not found or no view engine supports the searched locations. Locations searched: ~/Views/OneRosterv1p1/Error.aspx, ~/Views/OneRosterv1p1/Error.ascx, ~/Views/Shared/Error.aspx, ~/Views/Shared/Error.ascx, ~/Views/OneRosterv1p1/Error.cshtml, ~/Views/OneRosterv1p1/Error.vbhtml, ~/Views/Shared/Error.cshtml, ~/Views/Shared/Error.vbhtml
Resolution
1. Confirm the affected course uses linked, or grouped, gradebooks
- Reference the How to Tell if Gradebooks are Linked documentation to identify linked gradebook groupings for the affected teacher and course
2. Unlink the affected gradebooks
- Follow the How to Unlink Linked/Grouped Gradebooks documentation to remove the gradebook grouping
3. Re-run the Grade Passback sync
- Run the sync for the affected course period and confirm the error no longer occurs