blackboard / BBDN-LTI-Tool-Provider-Node

A node.js LTI Tool Provider for testing LTI launches, Caliper, and Outcomes.
73 stars 40 forks source link

Added custom claim in order to get MSFT Cloud Document integration #136

Closed pablolizardo-blackboard closed 2 years ago

pablolizardo-blackboard commented 2 years ago

This PR intents to add a custom variable to test the CourseGroup.id which was requested by the MSFT team for the integrations of One Drive Collaborative Documents.

This excerpt from LTI Spec Group is from the IMS Global Team : https://github.com/IMSGlobal/lti-spec-groups/blob/master/docs/groups-spec.md#group-substitution-variables

Group Substitution Variables

Course groups and course memberships may have a many to many relationship. This means that a member can belong to multiple groups within a course. When performing an LTI launch, a tool may request a LaunchGroup variable to accept any specific course group that might be associated to the launch.

**CourseGroup.id**

This variable will be substituted with the ID of any one context group asociated with the launch, or an empty string if there is no group associated with the launch. This is intended for tools that offer group activities and need to know which group the launch is intended for. The existence of this variable and any value it holds will not mean the launch user is part of the provided context group. For example, an instructor may launch a group activity of a course group where they not a member. Any id value provided by the platform must be of a group in the context course and must never be an id of a group outside the course context.