D2L Brightspace Integration Guide

Introduction

Welcome to the HelioCampus - D2L Brightspace Integration Guide. This document provides an overview of the D2L Brightspace integration process with HelioCampus Assessment and Credentialing.

HelioCampus - D2L Brightspace Setup

This guide outlines the requirements for integrating HelioCampus Assessment and Credentialing with D2L Brightspace. A D2L Brightspace Administrator, working alongside a HelioCampus integration technician, can complete the setup.

Data Feed Requirements

To ensure proper data flow, the Course Section file in the data feed sent to HelioCampus must include the Course Offering Code in the ExternalLmsId field.

Steps to Complete the Integration

1. HelioCampus Assessment and Credentialing LMS Information Form

Please complete the HelioCampus Assessment and Credentialing LMS Information Form to provide the necessary details for LMS integration.

Start HelioCampus Assessment and Credentialing LMS Information Form

Required Fields:

• Institution Name: Select your institution from the list.

• LMS: Choose D2L.

• LMS Contact Name: Enter your full name.

• LMS Contact Email: Provide your email address.

• LMS Server URL: Enter your LMS URL without https:// or trailing slashes (e.g., d2l.institution.edu or institution.brightspace.com).

  • If your D2L Brightspace instance has a vanity URL (e.g., d2l.institution.edu) that most users use to access D2L Brightspace, be sure to use that URL.

Keep the form open, as you will be filling it out while completing the steps below. Look for the HelioCampus Assessment and Credentialing LMS Information Form in the upcoming instructions.

2. HelioCampus LTI Tool

The HelioCampus LTI Tool enables students and instructors to access a HelioCampus Assessment and Credentialing course section within a D2L Brightspace course.

Start LTI 1.3 Configuration (D2L Brightspace LTI 1.3 Integration)

3. HelioCampus API Integration

The next step involves setting up the HelioCampus API integration to allow data synchronization between D2L Brightspace and HelioCampus Assessment and Credentialing.

Start API Integration (D2L Brightspace API Integration)

4. HelioCampus API Authorization

Start API Authorization (D2L Brightspace API Authorization)

Optional D2L Brightspace LTI 1.3 Integration Modifications

Additional LTI 1.3 Tools

If needed, you can create additional LTI 1.3 connectors for different purposes, such as one directing users to the Assignments page and another to the Survey page.

Start Additional LTI 1.3 Tools (D2L Brightspace Additional LTI 1.3 Integration)

Customizing LTI 1.3 Tools

If needed, you can customize the LTI 1.3 tools. A customized configuration allows you to:

• Control who can see the LTI 1.3 tool in D2L Brightspace.

• Modify the landing page for the tool.

• And more

Start Customizing LTI 1.3 Tools (D2L Brightspace Customizing LTI 1.3)

LMS Integration Troubleshooting

If you are having issues after HelioCampus informs you that the integration is complete within HelioCampus Assessment and Credentialing, the following will assist you in resolving common LMS-HelioCampus integration issues. For additional support, contact support@heliocampus.com.

D2L ExternalLMSID → Course Offering Code

Issue: HelioCampus Section Not Accessible in LMS or Assignments Not Syncing

HelioCampus receives course section data from your institution’s data files, including the Course Offering Code from your LMS. This code is mapped to our ExternalLMSID field, which uniquely identifies each section. When you refresh assignments, our platform queries the LMS using this Course Offering Code to retrieve assignment data.

If assignments aren’t updating or syncing correctly, verify that the Course Offering Code (mapped to ExternalLMSID) for the affected sections matches the expected value. A mismatch prevents the integration from linking the LMS and the HelioCampus A&C Platform.

Next Steps

1. Log into your LMS and navigate to the affected course sections.

2. Locate the Course Offering Code (found on the Course/Co-Curricular Activity Settings page in the HelioCampus A&C Platform).

3. Compare the Course Offering Code in LMS with the ExternalLMSID in HelioCampus.

4. If the values don’t match, check with your institution’s LMS administrator. If necessary, we may need to discuss how the data files were set up.

Examples of Course Offering Code Mapping

Issue: "Invalid Access Token" Error When Refreshing Assignments

If you receive an "Invalid Access Token" error when attempting to refresh LMS assignments in the HelioCampus A&C Platform, it means the access token has expired and must be reauthorized. Authorization tokens ensure security and appropriate API permissions.

Resolution

1. Notify the HelioCampus A&C team to request token deletion.

2. Reauthorize the LMS service account by following the steps in our documentation:
   D2L Brightspace Integration | Authorize the Service Account from HelioCampus on D2L
   (This action should be completed by the LMS Administrator or an Institutional Administrator with access to the LMS system account.)

Alternative Token Reauthorization Method

Our team can bypass the LTI step to recreate the token; however, adding the service account to the Keycloak realm is essential. A manual user login to the HelioCampus system is required to complete reauthorization.

For more details on this method, please contact the HelioCampus A&C team.