SAP Knowledge Base Article - Public

3308656 - How to translate Instruction Text on the Custom Data Collect Step - Onboarding


  • Translation of Instruction Text on the Additional Data Collection Step
  • When the candidate switches the language during the Additional Data Collection step, the instruction text does not change language.

"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 Onboarding
  • SAP SuccessFactors Platform

Reproducing the Issue

  1. Log in as candidate
  2. Additional Onboarding Data Collection step
  3. Switch to the affected tab "Parking"
  4. You will see the text "Always, always salt the pasta water!"
  5. Now switch the candidates system language and you will see that the text stays the same.


Custom MDF Object Field's values are not included in the Language Pack


We assume in this KBA you read this article "Onboarding – Additional Onboarding Data Collection UI Configurations"and know how to add instruction text.

This KBA covers a walkaround on translation of instruction text 

  1. Navigate to Configure Object Definition > Select Object from the drop down.
  2. Search the custom MDF Object you would like to enter instruction text.
  3. Add a new custom Picklist field which will display the instruction text based on values in this Picklist.

  4. In this example we used ISOCountryList

  5. The Valid Value Source must be the Code of the Picklist you will use to pull the data.

  6. You can now add the custom field you will use for the instruction text, the Maximum Length depends on your business needs, Data type must be String.

  7. Ensure you set the visibility to Read Only as stated in the article Onboarding – Additional Onboarding Data Collection UI Configurations

  8. Save the Object.
  9. In the article the next step is to navigate to Manage Configuration UI
  10. We're going to add both those fields we configured on the custom Object by clicking Add field

  11. The properties of the instruction text field should match the article.

  12. We will additionally add our custom Picklist field

  13. Now the article states that we should add a rule in Manage UI Rules to display the instruction text.
  14. The translation would not work there so instead of add the rule there we create a Basic rule.
  15. Navigate to configure Business Rules.
  16. Create a Basic rule on the custom MDF object that has the instruction field.
  17. In this example we used the country field to determine what language should display.

  18. Save the rule.
  19. Navigate to Configure Object Definition.
  20. Find the Object with the instruction text field.
  21. On the custom Picklist field, add the rule you configured to display the text.

  22. Save and you can go ahead and test.
  23. Results.

Note: These are custom configuration which are out of scope for support. Any issues you may face with the config must be resolved by the Implementation Partner.

See Also

Onboarding – Additional Onboarding Data Collection UI Configurations


Instruction, Text, Custom, Data, Collection, CDC, Translation, SF, PLT, EC, Onboarding, Locale, Language , KBA , LOD-SF-OBX-CDC , Custom Data Collection , Problem


SAP SuccessFactors Onboarding ; SAP SuccessFactors platform 2211


Pasted image.png