SAP Knowledge Base Article - Public

3291183 - Reset the Password for External Candidates via OData API / Integration Center - Recruiting Management

Symptom

Set the password for external candidates using OData API / Integration Center.

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

Note: it is impossible to retrieve the current password of a candidate via OData API.

Grant the following Role-based permission to the API user:

  • Recruiting Permissions > OData API Candidate Update

Sample OData API request:

Operation: POST

URL: https://<api-server>/odata/v2/upsert?$format=json

JSON Body:

{
"__metadata":{
"type":"SFOData.CandidateLight",
"uri":"CandidateLight(enter candidateId here)"
},
"password":"Enter password here"
}

Using Integration Center:

1. Create a CSV UTF-8 import file including "Candidate ID" and "Password" (the column header can be any free text).

  • Candidate ID
  • Password

Host the file into SFTP folder in the case of batch update.

Note: If the number of candidates is less than or equal to 10, there is no need to host the file to SFTP as it is possible to process the records using the import test mode in the integration.

2. Create an input integration to import the data.

  1. Go to Integration Center > My Integrations.
  2. Click Create and select Scheduled CSV Input Integration.
  3. Search for "CandidateLight" and select it.
  4. Click Select button.
  5. Go to Configure Fields tab. Click Upload Sample CSV to upload a sample file for mapping the data to fields.
    (You can upload the same import file but only the first 10 records will be picked in the sample data view.)
  6. Click the link icon to switch to Field Mapping View.
  7. Map the CSV columns to the data fields accordingly.
  8. Click the triangle icon to switch to File Import Test View.
  9. Click Run Preview Records to update the sample data. Check if the data can be updated successfully.
  10. Go to Source Settings tab. Set File Server, File Name and Folder Settings of the import file.
  11. Save and run the integration.

See Also

SAP SuccessFactors API Reference Guide (OData V2) - CandidateLight

Keywords

RCM, Candidate Profile, Career Site, Password, OData API, update password, reset password, change password , KBA , LOD-SF-RCM-API , Webservices & APIs , LOD-SF-RCM-CAN , General Candidate Issues (not Offers, not Profiles) , LOD-SF-RCM , Recruiting Management , How To

Product

SAP SuccessFactors Recruiting all versions