Redirecting after SSO

Owned by Steve Ross
Last updated: Apr 27, 2021 by Seth Petry-Johnson
3 min read

LearningBuilder supports bringing the user to a specific page during login. This is useful if an external system wishes to automatically direct the user to a page within LearningBuilder based on a link from their site.  

Warning: Although LearningBuilder™ will support redirecting to other pages not listed here, it is not recommended, as those links may break in a future release.  Please only use the links listed here, or provide the basic link of https://[YourSite].learningbuilder.com.

Link

Parameters

Description

/LearningPlanLaunch/ PractitionerSearch?taskGroupId={id}

/LearningPlanLaunch/ PractitionerSearch?taskGroupId={id}?criteria.keyword={keyword}?showResults=true

{id} = The ID (ITEM_ID) of the task group on which to launch the search.  This must be looked up through the database. 

{keyword} is a search term to pre-filter (only support on Full Page Branded Search)

Takes the user to the active Learning Plan that has the Task Group ID specified in the {id} and opens an activity search for that task group.  

  • If the task group is configured for Full Page Branded search, the user will see the search page.  (New in Release 7.32.1) The user can also be sent directly to the search results filtered by a keyword such as 'xxxx' by adding the following to the link:

    • ?criteria.keyword=xxxx?showResults=true

  • If the task group is configured for Popup search, the user will see the learning plan page with the activity search popup open. (Note: Prior to release 7.29, the user will see the learning plan list page with the activity search popup open.)

  • If the task group is configured for no activity search, the user will see the learning plan page and an instance of the configured activity added to the learning plan page.  If the user can act on the first step of that activity's workflow, the workflow step will also be opened. (Note: Prior to release 7.29, the user will see the learning plan list page with the activity search popup open.)

  • If the user does not have a learning plan instance for the Task Group ID specified and the user would otherwise be able to begin the learning plan and the learning plan is configured to begin automatically, this link will also automatically begin the learning plan.

  • The user lands on their Learning Plan List Page the user has:

    • more than one active learning plan instance for the Task Group Id specified  (i.e. not Practitioner Complete) or 

    • no active learning plan instances for the Task Group Id and has more than one Practitioner Complete learning plan or 

    • they cannot begin a learning plan automatically, then the user lands on their Learning Plan List Page.

/LearningPlanLaunch/view?lpid={id}

{id} = The ID of the learning plan definition on which to land.  This must be looked up through the database. 

Takes the user to the active Learning Plan that has the Learning Plan ID in the {id}.  

  • If the user does not have a learning plan instance for the Learning Plan ID specified and the user would otherwise be able to begin the learning plan and the learning plan is configured to begin automatically, this link will also automatically begin the learning plan.

  • The user lands on their Learning Plan List Page if the user has:

    • more than one learning plan instance for the Task Group Id specified that is active (i.e. not Practitioner Complete) or 

    • no active learning plan instances for the Task Group Id and has more than one Practitioner Complete learning plan or 

    • they cannot begin a learning plan automatically