Breadcrumbs

Blackboard Integration Guide

Introduction

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

HelioCampus - Blackboard Setup

This guide outlines the requirements for integrating HelioCampus Assessment and Credentialing with Blackboard. A Blackboard 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 Blackboard Course IDs in the ExternalLmsId field.

Before starting this guide, request your Blackboard Application ID from your HelioCampus integration technician, as it is required for completion.

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 Blackboard.

  • 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., blackboard.institution.edu or institution.blackboard.com).

    • If your Blackboard instance has a vanity URL (e.g., blackboard.institution.edu) that most users use to access Blackboard, 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 Blackboard course.

Start LTI 1.3 Configuration (Blackboard LTI 1.3 Integration)

3. HelioCampus API Integration

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

Start API Integration (Blackboard API Integration)

😀

Congratulations you have completed the integration between Blackboard and HelioCampus Assessment and Credentialing! There are some optional configurations you can add to your integration below:

Optional Blackboard LTI 1.3 Integration Modifications

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 Blackboard .

  • Modify the landing page for the tool.

  • And more

Start Customizing LTI 1.3 Tools (Blackboard 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.

Blackboard ExternalLMSID → Blackboard Course ID

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 ID from your LMS. This ID is mapped to our ExternalLMSID field, which uniquely identifies each section. When you refresh assignments, our platform queries the LMS using this Course ID to retrieve assignment data.

If LMS assignments aren’t updating or syncing correctly, verify that the Course ID (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 ID (this appears on the Course/Co-Curricular Activity Settings page in the HelioCampus A&C Platform).

  3. Compare the Course ID 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 ID Mapping

Course

ExternalLMSID

CHEM 510 A

CHEM510_A_S2024

MATH 202 B

MATH202_B_F2023

MATH 302 A

MATH302_A_F2023

If you need further assistance, please reach out to your LMS administrator or support@heliocampus.com.

For further assistance, contact the HelioCampus A&C team.