Docebo is an Learning Management System (LMS) that provides course management, and other features. Many customers use Docebo to manage their courses and have asked about integrating Docebo with our systems. With the newest version of Webhooks and Integrations, we are happy to announce that ScopeAR Worklink can easily integrate with Docebo.
| Table of Contents | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
...
There are many use cases and ways for Docebo and ScopeAR Worklink to work together but this document will focus on one case in particular:
“As a Docebo user, I want to be able to launch a graded quiz on Worklink from my Docebo course training list and when I have completed and passed my quiz, I want Docebo to display that I have completed the training.”
Step One: Turn on extra data for xAPI/Tin Can
xAPI / Tin Can is a feature within Docebo that will add extra parameters to launch external content from Docebo. To use the Worklink integration, you will need to enable extra parameter data to be added to the external URLs that are used to launch training courses. The integration will use these extra parameters to connect the Worklink scenarios to the courses, training materials, and users within Docebo.
To turn on this feature in Docebo, log into your Docebo dashboard as an admin, and go to the Admin Menu by clicking on the gear icon on in the top right corner:
...
Next, scroll down the page to the Settings section and click on Advanced Settings link:
...
Lastly, scroll down the page and make sure the XAPI/TinCan checkbox is checked:
...
Now that the additional data for XAPI/TinCan is turned on, we need to whitelist the external URL for Worklink.
Step Two: Add
...
Worklink to E-Learning Whitelist
Now, we need to add ScopeAR’s Worklink’s getworklink service to Docebo’s xAPI external content whitelist.
What is the getworklink service? This service allows for easy sharing of ScopeAR Worklink scenarios with a getworlink URL. Each scenario within ScopeAR Worklink has a shortened getworklink URL. The WorkLink App will launch when the shortened getworklink URL is opened with a browser.
...
In order for the integration to be secure, a public and private key need needs to be generated. There are various means to create one. For the sake of this tutorial, we will use the https://cryptotools.net/rsagen
...
Copy the Private key and save it to a text file called private_key.pem:
...
Create a unique client ID for the API Credentials:. This can be any string you want it to be. Just make note of this string as you will need it again later.
...
Upload the public key (public_key.pem file) that was created in the earlier step:
...
This is where the magic happens. We will create the integration between Docebo and ScopeAR. We do this by creating an Integration object which is more or less a collection of Webhooks that will send data from ScopeAR to Docebo.
...
Lastly, copy and paste the private key (from the private_key.pem file) into the JWT Private Key field:
...
Fill in the required fields and then create the course:
...
At this point, we have create created a new Course. Now let’s add some training materials.
...
Next, just save the training material. It should pop-up on the training material course list:
...
...
Step Eight: Change the Training Material Settings
Select the menu button to the right side of the training material and select the Settings option. This will open a settings dialog for the training material.
...
Change the Launch Mode to “Play in New Window” and save your changes
Congratulations! You just created a training course that integrates with ScopeAR’s Worklink!
Step
...
Nine: Test
Now it’s time to test. This is rather straightforward: just launch the training course and complete the training in the Worklink App. If you finished all the trainings within the course, the webhooks should automatically update Docebo and state that you completed the course and the trainings:
...
...
When you click Start Learning, this will launch a webpage from which you can either launch the Worklink app or you can scan the QR code on the page to launch the quiz material in the Worklink app on another device. Either way, once the scenario has been run and any quiz material completed with a passing grade, then the quiz in Docebo will be automatically marked as complete.
To find the score of the training session, go to User Stats
...
Scroll all the way to the bottom and you’ll see this. Score is the farthest right value
...