Symptom
To ensure consistency and improve compatibility across APIs, we aim to establish a unified naming convention for defining fieldId in custom or background fields referenced in Application or Candidate templates.
Following these conventions will help maintain API stability and guarantee seamless functionality.
Environment
SAP SuccessFactors Recruiting Management
Resolution
Recommended Naming Convention:
The camelCase format (either lowerCamelCase or UpperCamelCase) is the preferred naming convention for fieldId definitions.
Example:
- lowerCamelCase:
firstName UpperCamelCase:FirstName
Guidelines:
These naming conventions are strongly recommended for newly developed APIs.
Consistency and adherence to existing conventions within an API suite for a single product are critical to ensuring API stability and compatibility.
Avoid using other naming conventions such as:
lowercase(e.g.,firstname)lowercase-dashed(e.g.,first-name)lowercase_underscore(e.g.,first_name)UPPERCASE_Underscore(e.g.,FIRST_NAME)
Impact of Non-Compliance:
Using naming conventions that deviate from the recommended camelCase format (e.g., fields with underscores, hyphens, or other special characters) can lead to unexpected or erroneous results in REST API responses.
For instance: Invalid examples:
first_nameFIRST_NAMEFirst_Namefirst-name
Keywords
Naming convention, fieldId, field definition, API, Application template, Candidate templates, , KBA , LOD-SF-RCM-API , Webservices & APIs , LOD-SF-RCM-APP , Applicants and Job Applications , LOD-SF-RCM-CAN , General Candidate Issues (not Offers, not Profiles) , How To
SAP Knowledge Base Article - Public