Assumptions and Limitations

Assumptions

D2L can work with any SIS that supports OneRoster 1.1 REST and is certified with IMS Global or working towards their certification.

REST Process

  • Scheduled runs run from the previous run date of the data extract to the start date of the current data extract. If this is the first run, it acts like a sync operation and runs with no start date to the date range.
  • There is an option to trigger a run manually from the previous run date, from a specific date or for all records in the system
  • Call Order: The order that the various endpoints or consuming the various files are called in.
    • Academic Sessions

    • Orgs

    • Schools
    • Courses

    • Classes

    • Users

    • Enrollments

  • The order that data is sent back to Skyward
    • Categories (requested on demand from the Brightspace gradebook)
    • Lineitems (sent on demand or nightly based on grade export settings)
    • Results (sent on demand or nightly based on grade export permissions)

Grade Export

For a grade to be exported, the course must have been created through OneRoster SIS integration and the OneRoster IPSIS source system must have Grades Export enabled. The course may only be mapped to one active source system with grades. Grades must belong to Grade Categories that are retrieved from the SIS and the grade must have an Academic Session selected.

Academic Sessions

The Academic Session (Terms) dropdown menu is visible when creating a new grade item. The menu is populated by finding all org units created by the same SIS as the course where the SIS mapping is for Academic Session. The academic session must be a parent to the course offering.

Categories

Categories are required for the integration. Categories created by Skyward have the Export to SIS option selected. This category is used to link grade items so that Brightspace Learning Environment knows which grade items should and should not be sent.

How the grade sync works

Grade categories are synced from Skyward on demand in the Brightspace gradebook. To sync grades, navigate to Manage Grades> More Actions> Sync Categories from SIS. Grade categories from the SIS do not map to manually created categories. If a category needs to be deleted, it must be deleted in Skyward and then resync’d in the Brightspace gradebook.

Grade items (line items) are synced if they meet any of the following conditions:

  • Line item has never been sent
  • Line item has been updated since it was last sent (This includes name, academic session, points, delete, restore from delete)
  • Line item failed to be sent during the last export
  • An assignment and due date are sent with the lineitem. Below is the logic Brightspace uses when sending dates:

    • Lineitem (Grade) Assign Date is determined as follows:
      • Use Activity Start Date if it exists, if not
      • Use Activity Due Date if it exists, if not
      • Use Activity End Date if it exists, if not
      • Use Academic Session End Date
    • Lineitem (Grade) Due Date is determined as follows:
      • Use Activity Due Date if it exists, if not
      • Use Activity End Date if it exists, if not
      • Use Academic Session End Date

Note: The line item sourced id that gets sent is class-specific and is generated like this: {lineItemSourcedId}_{classSourcedId}

Grades (results) are synced if they meet any of the following conditions:

  • Result has never been sent
  • Result has been updated since it was last sent
  • Result failed to be sent during the last export
  • Parent line item has been modified since the last export

Note: The line item sourced id that gets sent is class-specific and is generated like this: {lineItemSourcedId}_{classSourcedId}

Grades (results) are synced if they meet any of the following conditions:

  • Result has never been sent
  • Result has been updated since it was last sent
  • Result failed to be sent during the last export
  • Parent line item has been modified since the last export

Limitations

  • Records with a status of tobedeleted are only deleted if the child is deleted
  • Enrollments using the User’s Org property cannot be unenrolled via the OneRoster integration at this time.
  • Unsupported characters: there are several characters that are not supported in the Brightspace Org Unit Code. These characters are replaced with an underscore (_). Unsupported Characters: \ : * ? “ ” < > | ‘ # , % &
  • Truncations: The max length for the Org Unit Code in Brightspace is 50 characters. If it exceeds this length, it is truncated in the UI.
  • OneRoster allows multiple ScoreStatus: Brightspace Learning Environment only sends fully graded or exempt