Add/Update competence completion for a user
Resource URL
URL: competenceUser/updateCompletion
Parameters
string username | Username |
string password | Password |
int userId | Unique identifier of the user |
string userExternalId | Unique external identifier of the user. Either userId or userExternalId must be filled. |
int competenceId optional | Unique identifier of the competence |
int competenceExternalId optional | Unique external identifier of the competence. Either competenceId or competenceExternalId must be filled. |
Date completionDate optional | Updated completion date. If completionDate==null, any existing completion will be deleted. |
Date validUntilDate optional | Updated "valid until" date. Will not be used if completionDate==null. Note: validUntilDate must be set for competences with expiry. This method will not use Trainingportal's defined refresher interval for setting validUntilDate |
int level | Sets the level if the competence is a level competence. |
Return value
completionDate | yyyy-MM-dd - the date when competence was completed. Empty value indicates, that the competence is not yet completed |
validUntilDate | yyyy-MM-dd - if a competence has validity period this indicates the time it expires |
status | Status of the competence.
|
requirementReferenceId | Identifier of the requirement (if requirement exists) |
level | Will return the level if the competence is a level competence. |
Example request
URL | https://www.trainingportal.no/mintra/rest/competenceUser/updateCompletion |
POST DATA | userId=123456&competenceId=123&username=username&password=secret&completionDate=2011-05-10 |
{
"level": null,
"completionDate": "2011-05-10",
"status": "COMPLETED",
"validUntilDate": null,
"requirementReferenceId":"3d2d24f0-1e24-4bd6-a82f-9602e6d2cf49"
}