SAP Knowledge Base Article - Public

3587790 - API error 'jobReqLocale/jobDescription is required' when creating a Job Requisition with Job Profile - Recruiting Management

Symptom

  • Error 'jobReqLocale/jobDescription is required' or 'jobReqLocale/externalJobDescription is required' occurs when creating a Job Requisition through Integration Center or OData API.
  • It is required to map the job description fields manually while the Job Profile should be automatically pulled from the Job Code or Role.

Environment

SAP SuccessFactors Recruiting Management

Reproducing the Issue

  1. Try to create job requisitions using Integration Center.
  2. Map the job code to automatically pull the job profile.
  3. Error 'jobReqLocale/jobDescription is required' or 'jobReqLocale/externalJobDescription is required' occurs.

Cause

Cause 1: The system is trying to populate the job description fields before the Job Code / Role.

The order in which fields are populated cannot be controlled. Adding or removing fields from the API request may also affect this process.

If the Job Code / Role is not populated first, the Job Profile (job description) will be blank.

Cause 2: Configuration issues with the Job Profile. Possible causes are:

  • "Show in Job Requisition" is not enabled for any Job Profile Template sections.
  • Incorrect Role-Job Code mapping.
  • The Job Profile is inactive.
  • No Job Profile is associated with the Job Code / Role.

Resolution

This article focuses on the correct configuration of the job profile and mainly addresses the first cause. Here are two workarounds:

  • a. Assign dummy values to "jobReqLocale/jobDescription" and "jobReqLocale/externalJobDescription" in the API request.
  • b. Make the two fields "listingLayout" (Internal Job Description) and "extListingLayout" (External Job Description) as non-required in the job requisition template.

After creation, the Job Profile will be pulled from the Job Code or Role, so it will not show empty or dummy values.

Please note that these workarounds are not applicable if there are configuration issues with the Job Profile. For configuration issues, please review the KBAs in the See Also section.

See Also

Keywords

RCM, JPB, INC, Job Requisition, Job Profile, jobReqLocale, jobDescription, externalJobDescription, API, OData, Integration Center, Required, Mandatory , KBA , LOD-SF-RCM-INT , Integration Center & Intelligent Services , LOD-SF-RCM-API , Webservices & APIs , LOD-SF-RCM-JOB , Job Postings & Requisitions , Problem

Product

SAP SuccessFactors Recruiting all versions