The Dashboard provides the processing status of the latest batch. Both the Dashboard and Batches pages will show a final indicator if the batch completed successfully or with errors. Each batch has a quick link to Audit Log and if completed with errors to Error Messages.
Review all logs to verify all files processed as expected. If error messages were logged, expand the error to review the meta data captured to identify the error, correct the data in your SIS and export a new ZIP folder with a CSV file that only contains the necessary changes to correct the errors. The goal is to have the batches completed without errors.
If on your first run of either type of OneRoster integration an error occurs, try to reprocess the integration.
To reprocess a CSV integration
- On the Batches page, drag and drop your CSV ZIP file into the designated area again.
- If the CSV ZIP file is corrupt, generate a new file from your SIS and drag and drop it into the interface to process it again.
To reprocess a REST integration
- On the Batches page, click Run Update Now and select one of the following:
- Resync updates: Select the earliest date from which you want to synchronize only updates made to the data. Then click Resync.
- Resync all SIS records: Pull all the data from your SIS again, with no time constraint.
Common errors
ArgumentException Exception
- Exception Message: Invalid Request TypeName provided. No Mapping found for Type:district in Source System:27. Parameter name: TypeName
- Exception Type: System.ArgumentException
Typically occurs when the source system is missing Org Unit Type mappings in the Configuration UI and a request of that type is sent.
CourseCreationException
- Exception Message: Invalid code
- Exception Type: D2L.LP.OrgUnits.Courses.CourseCreationException
Typically occurs when the Class Request has Invalid characters in the classCode field. If classCode was not provided, then the Invalid characters are in the title field. Invalid characters: \ : * ? “ ” < > | ‘ # , % &
RoleMappingNotFoundException<![CDATA[
]]>
- Exception Message: No role mapping found for source system: OneRoster - Drag and Drop identifier: guardian
- Exception Type: D2L.IM.Platform.Exceptions.RoleMappingNotFoundException
Typically occurs when the source system is missing role mappings in the Configuration UI and a request of that type is sent.
DataNotFoundException
- Exception Message: RoleMapping not found for guardian
- Exception Type: D2L.Data.DataNotFoundException
Typically occurs when the source system is missing role mappings in the Configuration UI and a request of that type is sent.
DataNotFoundException
- Exception Message: ReplaceEnrollmentReadIMHandler.Process - IMExternalOrgUnitInfo is null.
- Exception Type: D2L.Data.DataNotFoundException
- RecordType: Enrollment
Typically occurs when either an incorrect code for the class or user is sent to the LMS.
JsonReaderException
- Exception Message: Could not convert string to DateTime: 4/30/2016T00:00:00.000Z. Path 'StartDateUtc', line 1, position 183.
- Exception Type: Newtonsoft.Json.JsonReaderException
Typically occurs when the date format of one of the Date or DateTime fields not following the correct formatting.
- Supported format: yyyy-mm-ddThh:mm:ssZ
OrgUnitMappingNotFoundException
- Exception Message: No org unit mapping found for source system: 27 identifier: SOMETHING
- Exception Type: D2L.IM.Platform.Exceptions.OrgUnitMappingNotFoundException
Typically occurs when the request has an org unit type that does not have a mapping configured in the source system. Example: Request to create a District is received by the source system has not mapped District to anything.