Introduction
As a Superadmin, you may be in charge of managing the skills of your people. This means assigning skills of your users and keeping them updated, understanding their upskilling needs, and looking for content aimed at helping them in reaching their goals while keeping them motivated.
If your company uses an external Talent Management platform or Human Resources Information System (HRIS), then you can avoid the manual configuration of skills, since the selection of skills and their mapping takes place within this platform.
Integrating Docebo with external Talent Management Platforms or HRISs
On your platform it is possible to manage the skills of your users in two ways, either by letting your users set their own skills within Docebo or integrating with the external Talent Management platform or Human Resources Information System where the skills mapping is carried out. By choosing the latter mode you can import the skills mapping already done in the external system in Docebo via APIs since the skills selection and the definition of their level are carried out by an external HRIS. Learn more about how to reach the API browser.
Impact of Integrating with External Talent Management Platforms or HRISs
When integrating an external system the following functions will no longer be available:
- The guided selection of skills and their self-evaluation.
- The My Skills section will no longer be visible in the users’ My Profile area.
- Admins will no longer be able to reset user skills.
- Managers will no longer be able to suggest skill level updates, however, they will be able to suggest content related to them.
- The platform’s Artificial Intelligence will no longer perform skills suggestions.
- Users will no longer be able to self-evaluate their skills in the Skills Dashboard.
- Superadmins can perform self-evaluations of skills on behalf of users from the external Talent Management platform via APIs.
New User Experience
When integrating an external system, users will be able to manage their skills in their external Talent Management platform or HRIS and get suggested content (e.g. assets and courses) within their My Skills channel and from their Skills Dashboard.
Enabling External Talent Management Platforms or HRISs
It is possible to integrate external talent management platforms or HRIS via APIs, as described in the following table:
|
API Description |
API Verb |
API Url |
Payload Example |
|
Enable external platforms |
PUT |
/manage/v1/setting |
{ "skills_third_party": "on" } |
|
Disable external platforms |
PUT |
/manage/v1/setting |
{ "skills_third_party": "off" } |
|
Query the status of external platforms |
GET |
/manage/v1/setting?settings=skills_third_party |
|
|
Get a user’s skills |
GET |
/skill/v1/profile/{user_id} |
|
|
Add skills and update skills level |
PUT |
/skill/v1/profile/{user_id} |
skills": [ { "code": "esco_skill_ead58f22-0af5-467c-ac1e-b750e4e1ac6a", "name": "Business Plan Development", "expertise": 2, "is_custom": false, "is_suggested": false }, { "code": "esco_skill_ead58f22-0af5-467c-ac1e-b750e4e1ac6a", "name": "Business Plan Development", "expertise": 2, "is_custom": false, "is_suggested": false } ] |
|
Get the list of all skills |
GET |
/skill/v1/skills/catalog |
|
|
Get skills containing the word “project” |
GET |
/skill/v1/skills/catalog?search_text=Project |
|
|
Query Workforce to get the list of categories |
GET |
/skill/v1/workforce/categories |
|
|
Query Workforce to get the list of job roles |
GET |
/skill/v1/workforce/occupations |
/skill/v1/workforce/occupations?search_text=Project&categories[]=1 |
|
Query Workforce to get the list of skills by job roles or category |
GET |
/skill/v1/workforce/skills |
/skill/v1/workforce/skills?categories[]=1232&occupations[]=2 |
Please note! Make sure that the values is_custom and is_suggested are parameters used by Docebo in order to track which are the skills recommended by the Artificial Intelligence.
Accessing Content for a Selected Skill and User
When using external integrated systems, you can effortlessly access all available content for a specific skill that the chosen user hasn't completed yet. Simply include the skill's unique ID as a URL parameter like this: /skill/my-skills/available-training?skill=skill_id. To find the skill's unique ID, open the Skills Management page in the Admin-Menu, go to the Platform Catalog tab, and find the skill you want in the table, using filters or the search bar if necessary. The unique ID can be found in the ID column.