Skills management

Opigno Enterprise provides a Skills feature for tracking learners’ knowledge levels, identifying skill gaps, and recommending personalized training. To get the list of all skills available for the current API user, getAllSkills should be used.

Parameter	Type	Description	Default
`after`	`Cursor`	Returns results that come after the specified cursor. Should be used together with `first` parameter. Cannot be used if `before` is set.	—
`before`	`Cursor`	Returns results that come before the specified cursor. Should be used together with `last` parameter. Cannot be used if `after` is set.	—
`first`	`Integer`	Returns up to the first N elements from the list. Required if `after` parameter is set. Cannot be used together with `last`.	—
`last`	`Integer`	Returns up to the first N elements from the list. Required if `before` parameter is set. Cannot be used together with `first`.	—
`reverse`	`Boolean`	Allows to reverse the order of the query results list (default order is by a skill taxonomy term title, ascending).	`false`
`title`	`String`	Optional filter by a skill taxonomy term title. Works with `CONTAINS` operator.	—

The query returns a paginated list of TaxonomyTerm objects. Here is an example of the query execution:

query getAllSkills {
  getAllSkills(first: 3) {
    edges {
      node {
        id
        name
        weight
      }
    }
    totalItems
  }
}

{
  "data": {
    "getAllSkills": {
      "edges": [
        {
          "node": {
            "id": "4",
            "name": "Communication"
            "weight": 2
          }
        },
        {
          "node": {
            "id": "1",
            "name": "Creativity",
            "weight": 1
          }
        },
        {
          "node": {
            "id": "3",
            "name": "Management"
            "weight": 3
          }
        }
      ],
      "totalItems": 15
    }
  }
}

Manage learner’s target skills

Target skills can be defined for user contexts by users with ADMINISTRATOR scope. To assign a target skill to a learner, assignTargetSkill mutation should be executed; to remove a skill from the list of target ones for the user context, removeTargetSkill mutation should be used. Both mutations accept two required arguments:

Argument	Type	Description
`skillId`	`ID`	ID of the skill taxonomy term that should be assigned (or removed) as a target one to the given user context.
`userContextUuid`	`ID`	UUID of the user context to assign (or remove) the target skill.

Here is an example of the mutation execution:

mutation assignTargetSkill {
  assignTargetSkill(skillId: 2, userContextUuid: "a1b2c3d4-e5f6-7890-abcd-ef1234567890") {
    errors
    response
  }
}

{
  "data": {
    "errors": {
      "errors": [],
      "response": true
    }
  }
}

If the mutation executed without any errors, a boolean value will be returned as a response, indicating the success status. To remove a skill from the list of target ones for the user context, removeTargetSkill mutation should be executed. Skills are basically taxonomy terms, they can be created using UI in the backoffice or with Opigno Enterprise API:

Taxonomy terms API

Check how to create, update or delete taxonomy terms using API.

Pagination

Learn how to efficiently navigate through large sets of items using cursor-based pagination.

Getting started

Integration & Concepts

Use cases

Hierarchy Management

Zapier Integration

Mobile application

Skills management

Manage learner’s target skills

Taxonomy terms API

Pagination

​Manage learner’s target skills

​Related Features

Taxonomy terms API

Pagination

Manage learner’s target skills

Related Features