Triggering ProofSpace Interaction via Canvas "On course completed" event
- Olesya Kershaw
Steps | Instruction | Screenshots |
|---|---|---|
 | !Registration(onboarding) of Canvas student with ProofSpace App is required! This type of interaction (initiated "by event") cannot issue credentials to unregistered learners. Therefore, students must first register with ProofSpace through another interaction, such as "Onboard.” You can find information on how to set up "Onboarding" with Canvas here. |
|
Create a trigger subscription | If you haven’t create the trigger subscription yet, create one.
|
|
Update your trigger subscription | If you have already created the subscription, add “Course,“ then “Course completed“ and “Course progress“ triggers to it. To do so, click "Admin" and then "Data Services."
On the new page, select your subscription’s name and check the corresponding checkboxes for “Course“, then “Course completed“ and “Course progress.“ | 
|
Create new trigger subscription | To create the trigger subscription, click "Admin" and then click "Data Services.
| |
| On the new page, click “+ Add.“ Name the new trigger. In the delivery method, select HTTPS. Add https://platform.proofspace.id/lti/web-hook/trigger to the “URL“ field. For the moment, we support only event “course completed” and “Learning outcome“ We are working on expanding the number of events for the interaction triggers. On the new page, scroll down if needed, and tick “Course“ and “course completed“ checkboxes. Click “Save and Exit.“ | |
Setup on PS Service side: |
|
|
Instal extension extension | On your ProofSpace dashboard, click “Extensions,“ and then “Install Extension.“
On the Pop-up window, click “Public extensions,“ and select “Canvas Course Complete Trigger” extension. Click “Install.“ |
|
Create a Credential Definition | On your ProofSpace dashboard, click the “Schemas“ tab. On the “Schemas“ page, select “Public schemas.“ Find “Canvas Course Certificate“ schema, schema ID : Vv7PzSvCSYRaR67Wikyg5M:2:Canvas Course Certificate:1.0. (You can search by name or by ID). Click “Create.“ | |
| On the new page, tick the checkbox “Service-attested.“ Click “Create.“ | |
Add Interaction | On your ProofSpace dashboard, add a new interaction. Click the “Interactions“ tab. On the “interactions“ tab, click “Add Interaction.“ Name the interaction and add an icon. Set “Incoming push from service“ as an initiation media type. Click “Select” on the “Issued credentials” section. Select the credential definition you created on the previous step (the credential definition created based on “Canvas Course Certificate“ schema). Click “OK.“ Add messages to your user in the “Notification Flow“ section (Optional). Click “Done.“ You can find more information about how to create an interaction on the https://proofspace.atlassian.net/wiki/spaces/KBOV/pages/2032271394 . |
|
Add the Canvas extension to the interaction | Before the next step, prepare:
|
|
| Click the “Edit“ icon next to the interaction’s name you just created. Scroll down. On the “Extension Setup“ section, click “Select.”
Click “Add“ next to “Extension to issue Course Certificate Credential by course complete event.“
On the new pop-up window, fill-in all the fields with prepared data. In the last three fields, enter Student Name, Course ID, Course Name respectively. If you want this credential be issued only once, tick the “runOnce“ checkbox. Click “Submit.“ Now click “Done“ to save this interaction. |
|