Brightspace Integration

Last updated: November 17, 2026

Summary

Connect Brightspace (the Learning Management System of D2L) with Eduframe and learn how the integration behaves. During the implementation of Eduframe and/or Brightspace, the Drieam consultant supports you with setting up this integration, but there are also parts that you can set up yourself.

Set up connection Eduframe and Brightspace

If you want to set up the connection between Eduframe and Brightspace, you can find the information in πŸ“„ Setting up Eduframe and Brightspace Connection.

Note: Setting up the connection is not possible without Drieam involvement and is incorporated in the implementation process.

As part of the connection between Eduframe and Brightspace, you can set up Single Sign-On (SSO) by setting up CAS as the primary login method in Brightspace. This means that the credentials created for Eduframe are also used for logging in to Brightspace. Read more about this in πŸ“„ Setting up Eduframe and Brightspace Connection.

Brightspace settings in Eduframe

After setting up the Eduframe–Brightspace connection, you manage the integration in the Brightspace plugin.

  1. Log in as Admin in Eduframe.

  2. Go to Settings > Plugins > Brightspace.

  3. Click Go to Brightspace and then Sign in with Eduframe.

Brightspace plugin in Eduframe

The home page shows the steps to set up the integration. A step with a checkmark is done. When something needs your attention, a warning shows under the step.

Set up steps of the Brightspace integration

Brightspace organizes its courses in departments. In Department links, you link each Eduframe department to a Brightspace department. Eduframe places the Course Templates of an Eduframe department in the Brightspace department it is linked to.

  • Choose a Brightspace department next to the Eduframe department and click Link.

  • You can link several Eduframe departments to the same Brightspace department. An Eduframe department is linked to one Brightspace department.

  • Eduframe does not create departments in Brightspace. Create the department in Brightspace first.

  • The Course templates column shows how many Course Templates of the department are already in Brightspace.

Link Eduframe departments to Brightspace departments

A Course Edition can only be published to Brightspace when the department of its Course Template is linked.

Change a department link

Choose another Brightspace department for a linked department and click Save. Eduframe moves all Course Templates of that department to the new Brightspace department. The course offerings move along with their course template.

Unlink a department

Click Unlink and confirm. See What happens when you unlink a department or move a Course Template? below for what this means for your Course Templates and Course Editions.

Roles

In Role links, you choose which Brightspace role Participants get, and you link the Eduframe Teacher Roles to Brightspace roles. A warning at the top of the page shows when Participants or Teachers are not in Brightspace because a role is missing.

Set Brightspace roles in Eduframe

Participant Roles

The Participant role is the Brightspace role every Participant gets in the course offering, for example Student or Learner. Without a Participant role, Eduframe does not enroll Participants in Brightspace.

  • Set: choose a role and click Save. Eduframe enrolls the Participants that were skipped before.

  • Change: choose another role and click Save. Eduframe moves the Participants that are already in Brightspace to the new role.

  • Remove: choose Not set and click Save. Nobody is removed from Brightspace, but new Participants are no longer enrolled.

Teacher Roles

In Eduframe you can create Teacher Roles. Read more in πŸ“„ Teacher Roles. Each Eduframe Teacher Role can be linked to a Brightspace role. Eduframe only enrolls Teachers whose Teacher Role is linked. This also applies to the default Eduframe role Teacher.

  • Link: choose a role next to the Eduframe Teacher Role and click Link. Eduframe enrolls the Teachers with that role in all published Course Editions.

  • Change: choose another role and click Save. Eduframe moves the Teachers with that role to the new role.

  • Unlink: click Unlink. Eduframe unenrolls the Teachers with that role, unless they have another linked role on the same Course Edition.

Note: A Teacher can be planned on a Course Edition several times, for example in different roles. Eduframe then uses one role: a role on the Course Edition comes before a role on a Meeting, and a role on a Meeting comes before a role on a subevent.

Integration log

In Integration log, you find everything the integration did, such as publishing Course Editions and enrolling Participants. Every line shows whether it succeeded, failed or was skipped, and why. Click the date of a line to see the details.

Integration log of the Brightspace integration

Publish a Course Edition to Brightspace

Eduframe does not send a Course Edition to Brightspace automatically. You publish each Course Edition yourself.

  1. Go to Courses > Course editions.

  2. Open the Course Edition.

  3. Click the Brightspace tab.

  4. Optionally, fill in the Dates in Brightspace.

  5. Click Publish.

Publish a course edition to Brightspace

When you publish a Course Edition, Eduframe:

  • Creates the course template in the linked Brightspace department, if it does not exist yet.

  • Creates the course offering under the course template.

  • Enrolls the Participants and Teachers of the Course Edition.

  • Adds the Meetings of the Course Edition to the calendar of the course offering.

  • Stores the link to the course offering in the External content URL field of the Course Edition.

Link to the course offering on the course edition in Eduframe

Participants open the course offering with the Go to Course button in the Participant Portal.

Note: Eduframe creates the course offering inactive, so Participants do not see it yet. Make the course offering active in Brightspace when it is ready for the Participants.

After publishing, the Brightspace tab shows that the Course Edition is published, with a link to open it in Brightspace. Below that, you find what the integration did for this Course Edition.

Course edition published to Brightspace

Note:

  • You cannot publish a Course Edition when the department of its Course Template is not linked. The tab then shows: Department is not linked to a Brightspace department, so the course edition cannot be published. Link the department and click Publish again.

  • When no Participant role is set or no Teacher Role is linked, the course offering is still created. The Participants or Teachers are added as soon as you set the role.

Dates in Brightspace

By default, the course offering gets the start and end date of the Course Edition. Fill in a date under Dates in Brightspace to give the course offering another start or end date in Brightspace, for example to give Participants access a week before the start. Click Save dates.

  • Leave a date empty to use the date from Eduframe.

  • When you filled in a date, a change of that date in Eduframe no longer changes it in Brightspace.

  • A flexible Course Edition has no start and end date in Brightspace. Fill in the dates here if you want the course offering to have dates.

  • Brightspace gets each date as 00:00 at the start of that day, in the time zone of your Eduframe environment. The course offering therefore ends at the start of its end date. Fill in an end date one day later if Participants need access on the last day.

Unpublish a Course Edition

Click Unpublish and confirm. Eduframe then:

  • Archives the course offering in Brightspace. A Brightspace administrator can restore it.

  • Stops keeping the course offering in sync with the Course Edition.

  • Removes the link to the course offering from the Course Edition.

  • Removes the history of grade exports of the course offering.

When you publish the Course Edition again, Eduframe creates a new course offering.

Sync information from Eduframe to Brightspace

What information will sync from Eduframe to Brightspace?

Definitions in Eduframe differ from definitions in Brightspace. See details in the table below.

Eduframe

Brightspace

Department

Department

* Linked in Department links, not created by Eduframe

Course Template

Course template

* Created in the linked department

* Name is the name of the Course Template

* Code is the code of the Course Template

Course Edition

Course offering

* Created when you publish the Course Edition

* Name is the Course Template name followed by the Course Edition name (start date - variant - location)

* Code is the code of the Course Template

* Start and end date (none for a flexible Course Edition)

* Created inactive

Meetings

Calendar events in the course offering

Contacts (Participants and Teachers)

Users

* Only created for Contacts with an Enrollment in a published Course Edition

* Username and Org Defined ID are the Principal ID

* First, middle and last name

* No email address and no password

Enrollments (Participants)

Enrollments with the Participant role

Teachers on Course Edition, Meetings and subevents

Enrollments with the linked Brightspace role

Not everything is synchronized from Eduframe to Brightspace. Programs, Blocks, categories, subevents, course descriptions and email addresses are not synchronized. Eduframe does not use semesters and sections in Brightspace.

What happens after changes in Eduframe to Brightspace?

Eduframe

Brightspace

Condition

Direct

Overnight

Course

Create new Course Edition

Nothing happens in Brightspace until you publish the Course Edition.

Publish Course Edition

New course offering in Brightspace, created inactive.

* Name is the Course Template name followed by the Course Edition start date - variant - location, for example "Opleiding Makelaar-taxateur β€” 28/01/2028 - Dag - Online".

* Code is the code of the Course Template.

* New course template in the linked Brightspace department, if this is the first published Course Edition of the Course Template.

* Participants, Teachers and Meetings of the Course Edition are added.

The department of the Course Template is linked to a Brightspace department

βœ…

Change name of the Course Template

In Brightspace, the name of the course template and of all its course offerings changes.

Course Edition is published

βœ…

Change code of the Course Template

In Brightspace, the code of the course template and of all its course offerings changes.

Course Edition is published

βœ…

Change start date, end date, Location or variant

In Brightspace, the course offering name and its start and end date change.

After saving the Course Edition

A date filled in under Dates in Brightspace is not changed

βœ…

Move Course Template to another department

The course template and its course offerings move to the Brightspace department linked to the new department.

New department is linked. If it is not linked, see What happens when you unlink a department or move a Course Template?

βœ…

Cancel or delete Course Edition

The course offering stays in Brightspace. Unpublish the Course Edition first to archive the course offering.

Unpublish Course Edition

The course offering is archived in Brightspace and no longer kept in sync.

βœ…

Create new Meeting

New calendar event is added to the course offering.

After saving a Meeting.

Draft Meetings are not synchronized

βœ…

Change Meeting

Change calendar event in the course offering.

After saving a Meeting

βœ…

Delete Meeting

Calendar event is removed from the course offering.

βœ…

Change name of a Meeting Location

Location of all calendar events with this Location changes.

βœ…

Participants (students)

Participant has a confirmed Enrollment

Participant is enrolled in the course offering with the Participant role.

* A Brightspace user is created when the Participant does not have one yet.

Course Edition is published

Participant role is set (see Role links)

βœ…

Access to the course offering

Enrollment confirmed, active or ended

Course offering is active in Brightspace

Brightspace start and end date of the course offering

βœ…

Enrollment of Participant is canceled

Participant is unenrolled from the course offering and no longer sees it in Brightspace.

Enrollment gets status Canceled in Eduframe

βœ…

Enrollment of Participant is removed

Participant is unenrolled from the course offering and no longer sees it in Brightspace.

Enrollment gets removed from Eduframe

βœ…

Enrollment in a flexible Course Edition starts or ends

Participant is enrolled in the course offering while today is between the start and end date of the Enrollment, and unenrolled outside of it.

Flexible Course Edition

βœ…

Changes to Participant data: name or Principal ID

First name, middle name, last name, username and Org Defined ID of the Brightspace user change.

Contact is not managed externally

βœ…

Delete Participant

The Brightspace user is deleted about one hour later, with all its enrollments, also in courses that were not published from Eduframe.

Contact managed externally: the Brightspace user stays, only the enrollments in course offerings published from Eduframe are removed.

βœ…

Merge Contacts

The Brightspace user of the merged Contact is merged into the Brightspace user of the remaining Contact.

Both Contacts have a Brightspace user

βœ…

Teachers

Add Teacher at Course Edition level in role

Access to the course offering in the linked Brightspace role.

Eduframe Teacher Role must be linked to a Brightspace role (see Role links)

βœ…

Plan Teacher at Meeting or subevent level

Access to the course offering in the linked Brightspace role.

Eduframe Teacher Role must be linked to a Brightspace role (see Role links)

βœ…

Delete Teacher at Course Edition, Meeting or subevent level

No access to the course offering.

Teacher is not planned on the Course Edition in another way

βœ…

Change role of Teacher

Role in the course offering changes.

New role is linked

βœ…

Change Teacher to inactive

Nothing changes in Brightspace. Remove the Teacher from the Course Edition to remove their access.

Notes:

  • Changes are sent to Brightspace in the background, usually within a few seconds. You can follow them in the Integration log.

  • When you change the name or dates of a course offering in Brightspace, Eduframe overwrites them after the next change in Eduframe. Other settings of the course offering, such as active and description, are not changed by Eduframe.

  • When you change a Brightspace user, Eduframe overwrites the name, username and Org Defined ID after the next change of the name or Principal ID in Eduframe. This does not happen for Contacts managed externally.

  • Subevents do not synchronize to Brightspace, only Meetings do.

When the department of a Course Template is not linked to a Brightspace department, Eduframe no longer sends changes of that Course Template and its Course Editions to Brightspace. This happens when you:

  • Unlink the department in Department links.

  • Move the Course Template to a department that is not linked.

What stays the same:

  • The course template and course offerings stay in Brightspace, in the Brightspace department they were in.

  • Participants and Teachers keep their access to the course offerings.

  • Changes to the name or Principal ID of Contacts and deleted Contacts are still sent to Brightspace.

  • Grades can still be exported from Brightspace to Eduframe.

  • You can still unpublish the Course Editions.

What is no longer sent to Brightspace:

  • Changes to the names and dates of the course template and course offerings.

  • New, changed and deleted Meetings.

  • New, canceled and removed Enrollments.

  • Teachers that are added, removed or get another role.

  • A change of the Participant role.

  • Dates in Brightspace you save in the meantime. They are stored and sent when the department is linked again.

A Course Edition of such a Course Template that is not published yet cannot be published. The Brightspace tab of a published Course Edition shows: Department is not linked to a Brightspace department, so changes to this course edition are not sent to Brightspace.

Link the department again

When you link the department again, or move the Course Template back to a linked department, Eduframe moves the course template to the linked Brightspace department and brings every published Course Edition up to date: names, dates, Meetings, Enrollments and Teachers are sent as they are in Eduframe at that moment.

Note: Course Editions that could not be published while the department was not linked are not published automatically. Open the Brightspace tab of the Course Edition and click Publish.

Export grades from Brightspace to Eduframe

The final grades of Participants can be exported from a Brightspace course offering to Eduframe once the Eduframe tool is added to Brightspace (see πŸ“„ Setting up Eduframe and Brightspace Connection). An instructor or administrator does this in Brightspace:

  1. Open the course offering in Brightspace.

  2. Open the Eduframe tool in the navigation bar of the course offering.

  3. Click Export grades.

Eduframe then copies the final grade of every Participant to their Enrollment in Eduframe: the grade as the Participant sees it in Brightspace, and a score from 0 to 100. The table below the button shows every export, with how many grades were exported, unchanged, skipped or failed.

Notes:

  • Only released final grades are exported. A Participant without a released final grade is skipped, so an export never removes a grade in Eduframe.

  • An existing grade in Eduframe is overwritten when it differs from the grade in Brightspace.

  • Only Participants that Eduframe enrolled in the course offering are exported.

  • Comments and the graduation state in Eduframe are not changed.

  • The Eduframe tool has to be added to Brightspace first. See πŸ“„ Setting up Eduframe and Brightspace Connection.

How can you merge duplicate users in Brightspace?

Before the Eduframe (and Brightspace) implementation, you might already have users in Brightspace. When Eduframe enrolls a Contact for the first time, it first looks for a Brightspace user whose Org Defined ID is the Principal ID of the Contact. When that user exists, Eduframe uses it instead of creating a new user.

Note: Turn on Manage externally for Contacts whose Brightspace user is managed by another system, such as your central identity management system. Otherwise Eduframe overwrites their username and, when the Contact is deleted in Eduframe, deletes the Brightspace user with all its enrollments, also in courses that were not published from Eduframe.

Note: When you merge Contacts in Eduframe, Eduframe also merges their Brightspace users. Brightspace moves the enrollments and awards to the remaining user. Grades, quiz attempts and other progress of the removed user are lost.

Which identifier does Eduframe use for users in Brightspace?

Eduframe identifies every Contact in Brightspace by its Principal ID: the Principal ID is the username and the Org Defined ID of the Brightspace user. Find out more in πŸ“„ Principal ID.

What happens in Brightspace when I change a Principal ID?

Eduframe changes the username and the Org Defined ID of the Brightspace user, usually within a few seconds. It stays the same Brightspace user, so its enrollments and progress stay.

When Manage externally is enabled for a Contact, Eduframe creates the Brightspace user when the Contact is enrolled for the first time, but no longer updates it. When such a Contact is deleted, Eduframe keeps the Brightspace user and only removes its enrollments in the course offerings published from Eduframe.

Frequently Asked Questions

Why do Participants not see the course in Brightspace?

Eduframe creates the course offering inactive. Make the course offering active in Brightspace when it is ready for the Participants.

Can Eduframe create sections or semesters in Brightspace?

No. Eduframe does not use sections and semesters in Brightspace. You can add them in Brightspace yourself.

For more frequently asked questions, see πŸ“„ FAQs Brightspace-Eduframe Integration.