SAP Knowledge Base Article - Public

2989965 - Learning API user/learningHistory/v1/learninghistorys Returning Null for certificateLink Parameter - LMS

Symptom

When getting learning history using below learning API call, the parameter certificateLink is returning null even when the criteria includeDeepLink is set to true.

GET /learning/odatav4/public/user/learningHistory/v1/learninghistorys?$filter=criteria/maxNumberToRetrieve eq 10 and criteria/includeDeepLink eq true

Environment

SAP SuccessFactors Learning

Reproducing the Issue

  1. Generate a learning OAuth token in LMS
  2. Encode to base64 format
  3. Open your API client application
  4. Generate access token through below API:
    • POST /learning/oauth-api/rest/v1/token
  5. Run below API call:
    • GET /learning/odatav4/public/user/learningHistory/v1/learninghistorys?$filter=criteria/maxNumberToRetrieve eq 10 and criteria/includeDeepLink eq true

Note: Please refer to help guide Obtaining an OAuth Token for more information on the replication steps.

Cause

The Reports permission Run User Certificate of Completion History Record Report is missing in the user's role that is needed by the learning API call to display the data of the parameter certificateLink.

Resolution

  1. Navigate to System Administration > Security > Role Management
  2. Search and edit the user role
  3. Add the below Reports permission:
    • Run User Certificate of Completion History Record Report

Keywords

learning, API call, API, OData, microservice, microservices, user/learningHistory/v1/learninghistorys, user/learningHistory/v1/metadata, learning history, history, certificateLink, learninghistorys, null, blank, certificateLink returning null, certificateLink returning blank , KBA , LOD-SF-LMS-ODA , Web Services OData , Problem

Product

SAP SuccessFactors Learning 2005