Setup a Damstra Learning stems integration

This article documents how to set up a Damstra Learning to Stems integration.

1. Log into Stems using your username and password

2. Hover over the Admin tab on the right then click on Settings.

3. Expand the Stems API menu item on the left then click on API Clients. 

4. Click on 'Add New Client...'.
Name: Velpic
Type: Website
Leave Allowed Origins blank.
Click Save. 

We use the Website type because of the extra security available by using the client secret property which is created for this type. 

5. Note the 'Client ID' field, then click on 'Show' under the 'Secret' heading.

6. Note the client secret value.

7. Next contact Damstra Learning using the Intercom bubble on the bottom right of the screen and send them the following information from the previous steps: 

• Email (not a username)
• Password
• Client Id
• Client Secret

The Damstra Learning team will then set up the Stems integration for your account. 

While you wait for the team to complete the integration you can prepare your Damstra Learning users for the integration.

8. Log into your Damstra Learning account.

9. We need to add a custom field to store each users' Stems id. To do this navigate to Admin > Custom Fields > Users then click Add Field

10. Fill out the form with the following details:
Name: Stems Id
Field Id: stemsid (should be filled out for you)
Click Save

11. You can now use the Stems Id field on your Damstra Learning users to associate them with their Stems system number.

12. You can follow this article to import users from Stems.

Integrated Training Content

You will need Confirmation from the Damstra Learning team that the setup has been complete before you can proceed with these steps.

1. In the Stems app and click on 'Course Register' under the 'Training' tab. 

2. You should be able to view all the courses in your Stems account from this view.

 
3. Next, schedule a lesson to a user with a Stems id.

5. After you have scheduled the user to the lesson, wait 30 seconds then go back to the courses page in Stems, and you should see the new lesson which was created in Stems as a new course.

6. Next, click on 'Role Profiles', which is found under the 'Human Resources' tab.

7. Select a role that your user/s (in this example 'Michael Glass') is assigned to.

8. Click on the 'Training Required' tab, then click the 'Edit Mode' button.

9. Add the new course 'KFC' to the list of required training for the role. Then click the 'Save' button.

10. Next, click on 'Training Matrix', which is found under the 'Training' tab.

11. Select the role/s and then click 'Generate Matrix'.

12. You should see the generated training matrix at the bottom of the screen. Notice that the course KFC is now showing as 'Required', as expected.

13. Now complete the lesson the was previously scheduled for your user.

14. In this case I am just manually completing the lesson. You can of course watch the lesson from the 'Learn' tab to complete it as well.

15. Now click on 'Employee Register' under the 'Human Resources tab.

16. Now click on the user which was scheduled for the lesson, in this case 'Michael Glass'.

17. Click on the 'Training' tab and you should now see a new training record assigned to the user indicating that the course has been completed by this user.