Higher Logic

Setup Credentials

Type Description
Community URL For example: https://bluesky.connectedcommunity.org
IAM Key Please contact the Higher Logic team to obtain your IAM Key.
Password Please contact the Higher Logic team to obtain your password.
Return URL Users are taken here when signing in from Path. For example: https://bluesky.connectedcommunity.org/HigherLogic/Security/Login.aspx?ReturnURL=https%3a%2f%2fbluesky.connectedcommunity.org%2fbluesky-redirect

Integration Points

Single Sign On (SSO)

Browsing Higher Logic (embedded learning content)

This is a seamless transition into learning from directly within the community. Users are automatically logged in to Path (behind the scenes) and shown learning content without ever leaving Higher Logic.

Setup instructions

Step 1. Build a SSO redirect link in Higher Logic navigation.

  • In Higher Logic, setup a “Page” with the following:
    • Include in site nav (unchecked)
    • Navigation Title: Blue Sky Redirect
    • Page Code Name: bluesky-redirect
    • URL Name: bluesky-redirect
  • Add Content to the page created with the following configuration:
    • Name: BlueSkyRedirect
    • Content is available to: everyone
    • Type of content: User Control
    • User Control Class or Path: hlCommon:PartnerRedirect
    • User Control Parameters: Domain=”https://www.pathlms.com/YOUR-SITE/courses/” AutoRedirect=”True” UseRemoteProductIdInUrlPath=”True”
      • The Domain paramater should be the course you have embedded. If redirecting to something other than Courses in Path, please contact Blue Sky for additional configuration support.

Step 2. Create a Library Entry in your Higher Logic Course Catalog for each Path course you want to embed.

  • Entry Type: Webinar
  • Link to Webinar: enter the SSO redirect URL created in step 1, and append ?RemoteProductID=COURSEID. Where COURSEID is the course ID value from the corresponding Path site (visible in the URL when visiting the course in Path). For example: “https://bluesky.connectedcommunity.org/bluesky-redirect?RemoteProductID=4566”

Browsing Higher Logic (external learning content)

When Path is used standalone, users can be ‘linked into’ specific Path content from Higher Logic.

Setup instructions

Follow the embedded learning instructions above, but skip step 2 (creating the Library Entries). You can instead share the SSO redirect links in a few ways, such as:

  • Adding them to the main Higher Logic navigation
  • Linking to them from a Higher Logic blog or discussion
  • Copy/pasting them into external communications (email, twitter, etc)

Browsing Path

When Path is used standalone, users can click ‘Sign In’ in the top right corner to use Higher Logic as a traditional SSO provider.

Setup instructions

Path should not be set to headless (embed) mode, and there should be a properly configured Return URL.

Configuring the Return URL

For the Return URL to work properly, it must be configured as a SSO redirect link in Higher Logic (it can’t just be a direct link to Path). Follow Step 1 in the embedded learning instructions above, and use that as your Return URL.


Activity Writeback

Overview

When setting up an account in Path, there are three pre-built writebacks for Higher Logic: Course Registration, Course Completed, Certificate Issued.

We send the following information back for each writeback:

Course Registration

  • LegacyContactKey (Path User Email/Username/UID - defined in provider settings)
  • LegacyActivityKey (Path Course ID)
  • Course Name
  • Registration Date (Course start date)
  • Course Type (currently set to Course)

Course Completed

  • LegacyContactKey (Path User Email/Username/UID - defined in provider settings)
  • LegacyActivityKey (Path Course ID)
  • Course Name
  • Completion Date (date when all course elements were completed - may or may not coincide with certificate issued date, depending on course setup)
  • Course Type (currently set to Course)

Certificate Issued

  • LegacyContactKey (Path User Email/Username/UID - defined in provider settings)
  • LegacyActivityKey (Path Course ID)
  • Certificate Name
  • Course Name
  • Issued Date
  • Type (currently set to Certificate)

Setup

In Path

On Account Edit Page, click the button to add a Higher Logic Writeback. You can add as many writebacks as needed. There are currently three writebacks available as outlined above.

For each writeback, define how the user in Path should be mapped to the LegacyContactKey in Higher Logic, by either Email Address, Username, UID (most common), or Path User ID. Also add the appropriate Higher Logic Credentials/Endpoints.

In Higher Logic
  • Go to Admin > Tools > External Activity Types and create create three different types:

  • Certificate Issued
    • Name: Certificate Issued
    • Plural Name: Certificates Issued
    • Legacy Key: bse_cert_issued
    • Show in Summary: Yes
    • Include in Activity Sync: Yes
    • Active: Yes
    • Additional Display Data Configuration:
      • Name: Certificate Name / Data Type: Text 1
      • Name: Course Name / Data Type: Text 3
      • Name: Issued Date / Data Type: Date 1
      • Name: Type / Data Type: Text 2
  • Course Completed
    • Name: Certificate Issued
    • Plural Name: Certificates Issued
    • Legacy Key: bse_course_completed
    • Show in Summary: Yes
    • Include in Activity Sync: Yes
    • Active: Yes
    • Additional Display Data Configuration:
      • Name: Course Name / Data Type: Text 1
      • Name: Completion Date / Data Type: Date 1
      • Name: Type / Data Type: Text 2
  • Course Registration
    • Name: Certificate Issued
    • Plural Name: Certificates Issued
    • Legacy Key: bse_course_start
    • Show in Summary: Yes
    • Include in Activity Sync: Yes
    • Active: Yes
    • Additional Display Data Configuration:
      • Name: Course Name / Data Type: Text 1
      • Name: Registration Date / Data Type: Date 1
      • Name: Type / Data Type: Text 2

Visibility

End users can see their writeback activity by visiting their Higher Logic Profile Page and clicking on My Contributions > Summary. Each writeback type will be listed as a separate activity type. When clicked on, you will see a listing of all the activity data and the corresponding data points as outlined above.