SAP Knowledge Base Article - Public

2361536 - How to add a custom field for selecting users in a portlet

Symptom

You want to add a custom field in a portlet, such as Personal Information or Job Information.
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 Employee Central
  • SAP SuccessFactors HXM Suite

Resolution

  1. Navigate to Admin Center -> Manage Business Configuration
  2. Select the portlet to which the custom field should be added
  3. Select an unused custom string from the drop down and provide a valid label and enable the filed
    NF.JPG
  4. Click on Details link on the right hand side of the row
  5. Select Employee for Type of Reference Object and Edit for Visibility field
    Det.JPG
  6. Click on Done followed by Save
  7. Provide permissions for this field.
  8. Test the field in UI.
    TU.JPG

Please Note:

  • This custom field will show only active users in the instance.
  • You will need to add a Personal Information record for the employee being saved in this custom field i.e adding First and Last name. The system will then be able to pick up the Personal Information record and insert it into this field.
  • You can apply target permissions to these fields also: 2513637 - Employee Central: Role-Based Permissions: Restrict "Worker" type fields to display only users that are in the Permissioned Users Target Population - 1708
  • If you want to show the Job Title below the employee name when searching you will need to configure the standard field "Job Title" in the instance. For that you can add it via Admin Center->Manage Business Configuration->jobInfo->Enable stardard field "Job Title" or you can edit the Data Model adding the following text.  

standard-element id="title" max-length="255" required="false" matrix-filter="false">
<label>Current Job Title</label>
</standard-element>

  • You will also need to update the users permissions so them are able to see this field. For that you can follow the steps:
    • Admin center->Manage Permission Roles
    • Select the user Role and click in "Permission"
    • Select "Effective Dated Entities" 
    • Mark the option "View Current" for jobInfo_job-title
    • Click Done and click Save Changes
  • After that the Job Title should be visible under the employee name when searching any worker type fields.

 

Keywords

BCUI, MANAGE_BUSINESS_CONFIGURATION, user, employee, worker, user field, people field, inactive, job title, worker type field, add field, custom field , KBA , LOD-SF-EC-BCI , Manage Business Configuration (BCUI) & Data Models (XML) , LOD-SF-EC-JOB , Job Information , LOD-SF-EP-UI , People Profile UI (PP3 UI) , How To

Product

SAP SuccessFactors Employee Central all versions ; SAP SuccessFactors HCM Suite all versions