Back

Manage Blocks in BPI (Overview)

Integrating Blue content in a Learning Management System (LMS) with Blue Portal Integrator (BPI) is done through the creation of BPI blocks. Blocks allow users to access portions of Blue through their existing platforms, bringing the power of Blue into an already familiar tool.

These are the available BPI Blocks:

  • Feedback Block - a connection with the data in a datasource. Used for instructors and supervisors to view response rates and scores updated on a daily basis.
  • Launcher Block - a small block that can be expanded into a larger block. Links to the other four types of blocks. A Launcher Block allows you to reduce the number of blocks that will be added to the LMS by creating links to BPI blocks.
  • Report Block - a list of Blue reports. Used for instructors and supervisors (e.g. deans and department chairs) to view reports.
  • Task Block - a list of pending and completed Blue tasks. Used for raters to fill out evaluations, and instructors personalizing their questions.
  • Subject Block - subject specific information. Used for instructors and supervisors to opt-in or opt-out subjects and instructors from the evaluation process.
  • Pathway Task Block - a list of Fillout tasks (Blackboard Learn only).

Build a Block

  1. Navigate to BPI - Blocks.
  2. Select Add block.
  3. Choose a platform.
  4. Choose a module.
  5. Select Next.
  6. Configure the block specific options.
  7. Select Save.

Platform blocks in BPI

NOTE

Task Blocks and Report Blocks have the ability to display notifications and alerts. A small red number will appear in the upper right corner indicating the number of new alerts or notifications present.

Preview a Block

View how a block will look in the selected platform by following these steps:

NOTE

Blackboard Learn Native blocks cannot be previewed. This includes the Task Block, Pathway Task Block, Report Block, and the Launcher Block.

  1. Navigate to BPI - Blocks.
  2. Select Preview to open BPI - Blocks - Preview.

BPI blocks preview

  1. Select the type of block to preview.
  2. Block ID - Choose the block to preview.
  3. User ID - Include a Blue username to view that users block information (optional for Feedback Block).
  4. Access type - For Report Blocks and Task Blocks set the Access type (Post is required for LTI Tools).
  5. Select View block to open a new window with a live preview of the selected block based on the chosen settings.

Preview settings

Feedback block preview

Export a Block

In order for a BPI block to appear within a platform, it will need to be exported from BPI.

Export a block from BPI:

  1. Navigate to BPI - Blocks.
  2. Select Export beside the relevant block.
  3. Save the file.

Now the block needs to be added to the appropriate platform.

When you export a block, a file is created that contains configuration information for the block, relevant code, URLs, security keys, etc.

Contents of an Exported Block

PlatformFile Contents
Blackboard LearnA ZIP file that contains configuration information about the building block, JSP (Java) server code for all the displays, grade blocking, etc.
CanvasA text file with instructions and customized code.
MoodleA text file with instructions, customized code, and assorted keys.
BrightspaceA text file with instructions and customized code.
SakaiA text file with instructions, customized code, and assorted keys.
SharePointA text file with a link and instructions.
WebAppA text file with a link and instructions.
NOTE

The Blackboard Learn Community Engagement License is required to install building blocks for Blackboard Learn. If you do not have the license, an LTI tool must be created instead.

When you export a WebApp Block, BPI generates a text file that contains a URL that will load the WebApp. This URL needs to be adapted to include user credentials and other necessary parameters to view the appropriate Blue data. Additional code may also be needed to properly integrate the WebApp with your system.


Copyright © 2025

Explorance Inc. All rights reserved.