Symptom
- How to setup a Rule that will propagate changes based on selection of data in other fields.
- Example: ee would like to make the Location field propagate the Timezone when the Location field is changed in the Job Information portlet.
- How to create a propagation rule for Employee Central using the MDF Rules Engine.
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 HCM Suite
Resolution
- Using propagation rules, it is possible to set a field to a default value during the hire process.
- In the following example, we would like to configure a rule that when the Location field is changed, this change sets the Timezone field in Job Information portlet.
There are a few steps to follow to configure this propagation via Rules:
Create a Rule:
- Navigate to Admin Center > Configure Business Rules and click Create New Rule.
- Select Employee Central Core and one of the scenarios from the list, like "Trigger onChange Rules for HRIS Elements" if you are planning to use the rule onChange, or "Trigger onSave Rules for HRIS Elements" for the rule to be assigned onSave.
- Set "Base Object" (in this Example: Job Information Model).
- Click Create.
Then we can proceed with creating the rule.
- Check "Always True" since we want this propagation to happen every time the field Location is changed.
- In the Then expression, select Set -> Job Information Model.Time zone.Value -> To Be Equal To -> Job Information Model.Location.Value.Time zone
- Click Save
See Reference:
Once the Rule has been created this rule needs to be added to the Employee Central configuration and given a trigger.
First you need to decide which trigger(s) to use :
| Event Name | Details |
| onSave | When clicking save, the system will trigger the rule |
| onChange | When changing the fields value, the rule will trigger |
| onInit | Only applies to New Hire wizard process, if you would like this rule to trigger here. Rule scenario on this case should be "Trigger onInit Rules for Hire/Rehire". |
In our case, we would like this rule to trigger when the Location field is changed.
Add Rule to Employee Central Configuration using "Manage Business Configuration":
- Admin Center -> Manage Business Configuration.
- Select the object "jobInfo" on the left.
- Find the field Location and select Details.
- At the bottom of the object, find the "Trigger Rules" section.
- Add your Rule and the Event Name.
- Click Save.
NOTE: When creating a Propagation Rule, the source field and the destination field MUST be of the same type. For example, if the field in the Location object were a "Date" field, then the destination field in Job Info would also need to be a "Date" field, otherwise the Rules Engine will not allow you to map the values. The same can be said if it is a Numeric String or even Picklist field.
See Also
Keywords
Propagation, Propagate, Auto-fill, Object, Foundation, MDF, employee central, field type, data type, rule, sync, string, translatable , KBA , LOD-SF-EC-JOB-RUL , Job Info Business Rules , LOD-SF-EC , Employee Central , How To
SAP Knowledge Base Article - Public