Integration Setup Guide
Vocareum provides the ability to integrate Vocareum content to Skilljar courses. This article is a step-by-step guide on how to take advantage of this feature.
1. Enabling Skilljar on a Vocareum Course
Go to the desired Vocareum course you wish to integrate with Skilljar. Go to the course settings and enable the 'Skilljar' option.
Once the 'Skilljar' setting is enabled, enter your Skilljar API key along with the Skilljar Course ID that'll be using the Vocareum course's content.
Skilljar API Key: Within the Skilljar Dashboard, using an admin account, go to 'Organization Settings' => 'API Credentials' then 'Create a Key'. Copy the created key into the 'Skilljar API Key' Field within the Vocareum Course Settings.
[The same API key generated from following the Skilljar Webhook Setup Guide can be used here.]
Skilljar Course ID: Within the Skilljar Dashboard, Go to 'Course Management' => 'Courses', then select the Skilljar course you'd like to bind to the Vocareum Course. Now, look at the URL and copy the portion of the URL with the red box as shown below.
Once a Skilljar API key and Course ID are entered, save the Course Settings. The course is now ready to be used with a Skilljar Assignment.
NOTE: When the Course Settings is saved with a Skilljar API key and Course ID present, Vocareum's Skilljar Webhook Handler URL is automatically added to the provided API Key's list of webhooks. See Skilljar Webhook Setup Guide for more details.
2. Integrating Vocareum Lab/Assignment Content into Skilljar Lessons
Go to the desired Vocareum lab/assignment that you wish to integrate into a Skilljar Lesson then, go into the parts Settings. Under the 'Misc. Options' section, enter the Skilljar Lesson ID of the Skilljar Lesson you'd like to have the selected part's content integrated into.
Skilljar Lesson ID: Within the Skilljar Dashboard, go to 'Course Management' => 'Courses', then select the Skilljar course that contains the Skilljar lesson you wish to have the selected part's content integrated into. Now, look at the URL and copy the portion of the URL with the red box as shown below.
Once the Skilljar Lesson ID is entered, save the Parts Settings.
A Skilljar Code can now be generated which could be copied (from Vocareum) and pasted (onto a Skilljar lesson content source code). The Skilljar Code Generator can be found under the 'Misc. Options' section of the parts settings (as seen in the above image). Clicking 'Generate' will display options that pertain to the type of code to generate as shown in the image below.
Presentation Type: How the Vocareum content will show up within the Skilljar lesson.
iframe: The code generated will have the Vocareum content show up as an iframe within the lesson content.
window: The code generated will have the Vocareum content show up in a new window/tab after clicking 'Launch Lab'.
Preview Mode: Allow 'Preview Mode' to be used within Skilljar. This generates an SSO link that expires after 5 minutes from the point of generation.
Clicking 'Generate Skilljar Code' will generate code that could be copied then pasted onto the Skilljar Lesson Content Source Code.
Once the generated code is pasted onto the Skilljar lesson content source code, Vocareum content has now successfully been integrated onto Skilljar.