SAP Knowledge Base Article - Public

2314757 - How to set up Configuration UI Rules

Symptom

How to set up Configuration UI Rules.

"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 HCM Suite
  • Metadata Framework (MDF)
  • SAP SuccessFactors - Employee Central

Resolution

  • One Config UI Screen can have multiple UI rules
  • There are few Events where these config UI rules can be linked (onInitUI Rules, onInsertUI Rules, onChangeUI Rules)
  • One Event can have multiple UI Rules associated with it
  • When any of these event occurs all rules associated with it are executed one by one in the order they are configured
  • Each UI rule is identified by its unique name

Below screenshots show how to add, edit and delete Config UI Rules for the Screen.

  1. Go to Manage Cinfiguration UI and select an existing UI or create a new one.
  2. In Manage Config UI when you hover over Title bar of the screen, the following Tool bar is displayed.



  3. Click on Manage UI Rules to add a new rule or see the existing rules for this UI



  4. Click on "Add Rule" to create a new UI rule or in an existing rule to edit it.



  5. Click on "Edit Properties" then you will be able to add the existing rules in the desired event.



  6. To add the rule in any onChange event, hover over the desired UI field and click on the pencil icon.
  7. Add the onChange rule in the "onChange UI Rules" field

 Important Notes

  • UI rules will be only effective in PP3 portlets. They will only take effect in Manage Data and Workflow if you add the UI in the MDF custom object in Configure Object Definitions > Default Screen
  • UI Rules should not be used to modify or set field data, but instead set UI parameters like "visibility". Business Rules should instead be used when changing or setting field data.
  • OnInit Rules will always override RBP as they have a higher priority and will take precedence over RBP and Field Level Overrides.
  • OnInit Rules Trigger at run time once the screen initializes, so as soon as the UI loads the rule will trigger. Meaning, that once the UI loads RBP will be overridden by the rule.
  • UI rule to set the field to be required or not will not work if the field is already set to be required in the Configure Object Definitions and/or UI set up. If you want to control the requirement of the field, please set it to "not required" from object and UI level and then control the required or not in the UI. 

Keywords

Manage Configuration UI, UI Rules, default screen, Business Rules, Config UI, custom object, ECT-171844INC1495892, INC1495892 , KBA , LOD-SF-MDF-UI , UI Config, Layout & Rules , LOD-SF-EC-MDF , MDF & EC2MDF Migration , LOD-SF-MDF-RUL , Custom Oject based Business Rules , How To

Product

SAP SuccessFactors Employee Central all versions