SAP Knowledge Base Article - Public

2712134 - Retrieving and Updating Job Requisition Posting information using Odata - RCM

Symptom

Within the SF system release 2018Q4 it is possible to retrieve and manipulate job requisition posting information. The system also validates if the user credentials running the API operation also has the necessary permissions to read and edit the postings.

This article provides a brief explanation of how to use this new functionality.

"Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental."  

Environment

SAP SuccessFactors Recruiting Management

Resolution

If the user has view/write permission to the job requisition posting, it is possible to run the following query to read the information related to a job requisition:

API Server URL/odata/v2/JobRequisition(23644)?$format=json&$expand=jobReqPostings/jobReqPostingPermissionsNav

The information returned will have the same data visible thru the UI and some extra information related to permissions and type of the posting. In this past relese, a flag called isPostingUpdatable was also introduced. If this information, the user will be able to know if they are able to update the information related to an expecific posting within a job requisition:

posting 1.jpg

When running upsert operations, the user can set a posting for a specific board, e.g. external posting, internal posting, etc. If the user has the necessary permissions, the operation will return a successful message, otherwise, it will indicate the call fails due to missing permissions.

Example: API Server URL/odata/v2/upsert

{
"__metadata": {
"uri": "JobRequisition(23644L)",
"type": "SFOData.JobRequisition"
},
"jobReqPostings": [
{
"boardId": "internal",
"jobReqId": "23644",
"postStartDate": "/Date(1540209107000)/"
}
]}

Result when the user has the necessary permission

posting 2.jpg

Result when the user does not have the necessary permission

posting 3.jpg

The permission error message may vary if the user does not have permission to edit the whole job posting content or does not have permission to specific boards.

Keywords

RCM-50621, RCM-51709,RCM-51710, job posting, updating, Odata, Insufficient, row-level, permission, field, level , KBA , LOD-SF-RCM-JOB , Job Postings & Requisitions , LOD-SF-RCM-API , Webservices & APIs , Problem

Product

SAP SuccessFactors Recruiting all versions