SAP Knowledge Base Article - Public

2720618 - Job Profile Builder Integration - Recruiting Management


What to expect from the Job Profile Builder integration with RCM.

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


SAP SuccessFactors Recruiting Management


General Overview:

The Recruiting – Job Profile Builder Integration populates job requisitions with pre-defined Job Profile content set up by an administrator. This pre-populating helps ensure consistency and professionalism in job requisitions. Enable the Recruiting – Job Profile Builder integration through Admin Tools.

Competencies defined for the job profile with Job Profile Builder are copied for the particular job requisition. If the competencies for a particular job profile are changed, the competencies on the requisition are not changed automatically.

To enable Job Profile Builder Integration:

  1. Navigate to Admin Tools > Manage Recruiting;
  2. To set up which sections of Job Profiles are used in requisitions, navigate to Admin Tools > Manage Job Profile Templates > select or create a template > click Next > click the gear in the desired section;
  3. Select "Show in Job Requisition" and then select your preference to “Show in internal posting”,  “Show in external posting", both or neither.


  1. (Optional Additional Configuration. May need Partner Engagement) Define the field ID “jobRole” on the Requisition XML and permission it appropriately. If defined in the XML, the new field is supported in the SFAPI, legacy data migration import, AdHoc Reports, Offer Approval, Offer Letter and job requisition tokens.
  2. (Optional Additional Configuration. May need Partner Engagement) Update the listingLayout field permissions on the Requisition XML to change user access to the Job Profile tab (omitted, read or write). When the Job Profile Builder integration is enabled, the extListingLayout and competencies field permissions become irrelevant; all job profile access is controlled by the listingLayout field permissions.


Working with the Job Profile Builder Integration:

When creating a requisition using “Browse Families and Roles,” when the recruiting user selects the appropriate family from the dropdown, the full job profile information is displayed, broken out into sections and allowing the recruiting user to browse the different roles before selecting the appropriate one.

The job description will no longer appear under “Requisition Details” but under a new “Job Profile” sub-tab. This tab is available for both Approve and Pre-Approved Requisitions. This sub-tab also includes the internal description, external description and competencies. If the job requisition detail page has been populated but the job profile tab remains blank, the job posting will be blank. You need to have data populated in the Job Profile tab if JPB has been enabled.


Users with write permissions to the listingLayout field can edit the sections of the job profile. You can edit the title and formatting of the overall section by clicking on the section heading. For library sections, you can also edit the library by clicking the section header. For text sections, edit the content by clicking directly on the section’s text. Each individual section can be limited to the internal posting, the external posting, or both. It is possible to display sections to recruiting users and not candidates.


Changes made to library sections of the job profile on the requisition do not affect the job profile library in Admin.

The recruiting user can also edit the library-based sections individually, such as Competencies or skills. When editing these sections, the corresponding library is displayed and the user can add additional items from the library. The user can also add additional sections, but the ability to edit or add sections is not configurable by user permission. It is not possible to allow only recruiters to add sections, but not hiring managers, for example.


Editing previously defined Roles on the Job Requisition:

If the jobRole field is configured and permissioned in the Requisition XML, users can click “update” to the right of the job role displayed at the top of the requisition, which will redirect them back to “Browse Families and Roles,” where they can select a new Family & Role. Selected a new Family and Role will overwrite any existing job profile customization on the requisition. The user will see a warning, asking them to confirm their selection of the Family/Role for the requisition.


To manage Job Profile Templates, navigate to Admin Tools > Job Profile > Manage Job Profile Templates. Here you can add new templates or edit existing templates. You can also configure individual templates to show/hide sections on job requisitions.

Handling Pre-Existing Requisitions:

For existing requisitions with a job description defined, the job description will move to the Job Profile tab and remain as it is, once the Job Profile Builder Integration is enabled. Existing competencies will also move to the Job Profile tab.

In order to select roles for existing requisitions, the layoutListing and jobRole fields must be enabled and permissioned. When these fields are turned on, the user can select a job role for requisitions without a role or select a new role for jobs with existing roles. These role selections will overwrite the existing job descriptions and competencies.

Data Migration and the Job Profile Builder Integration:

Importing requisitions through legacy data migration with a completed Role field and blank Job Description field causes the system to look up the job profile associated with that role and populate the Job Profile data onto the imported requisition.

To import the jobRole during data migration, use the format “Family|Role” in the field (without quotation marks, without spaces next to the pipe).

Importing requisitions with a single block of job description text in listingLayout is supported, even if the Job Profile Builder integration is enabled. The job description will appear in a single field on the Job Profile tab on the imported requisition.

Requisitions created via the Succession Org Chart will populate the appropriate job role and associated job profile for the To-Be-Hired position used to initiate the requisition.

Additional Information:

  • The following functionality is not supported:
    • SFAPI access to individual job profile sections (education, skills, competencies, etc.) on a requisition.
    • Importing content into each Job Profile section separately on a requisition during requisition data migration.
    • Creating a requisition via the SFAPI with a completed Role field and blank job description with the expectation the system will look up the job profile associated with the role and populate the Job Profile data onto the imported requisition.
    • Separate permissions for job profile template editing (layout/formatting) and job profile content.
    • Ability to define how many levels of library information the recruiting users and candidates will see in the library sections of the job profile. Only one level (the name of the library item) of information is supported on the candidate facing posting.
    • Search functionality in Browse Families and Roles.
  • When using the Job Profile Builder integration, the competencies field is not supported on the requisition. Please, include it on the job profile template to ensure it displays.
  • Job Role Tags can be used in combination with the Job Profile Builder.
  • Job Code Entity functionality can be used with the Job Profile Builder integration. The user browses Families and Roles and selects the desired job code. The Job Code Entity fields and job profile content populate onto the requisition.

Job Profile Role Based Permissions 

  1. Go to Admin Center
  2. Select the role you want to give permissions to  
  3. Select Permissions
  4. Scroll down to Administrator Permissions
  5. Manage Job Profile Builder 
  6. Save


KBA , LOD-SF-RCM , Recruiting Management , How To


SAP SuccessFactors Recruiting all versions