Symptom
- A Raise Message provides the feature for a user to raise a warning message based on a certain rule condition.
- To create a rule that raises an error message, you first have to create a MessageDefinition MDF object.
- A typical use case for creating such rules is to validate the user's entries.
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 Recruiting Management
Resolution
Example Scenario:
You'd like to create a rule that when a user changes a currency when the Base Salary and Bonus have already been specified in a job requisition, a warning message should be shown.
Create a MessageDefinition Object in the Admin Center
- Go to Admin Center > Manage Data
- Click 'Create New' dropdown > select Message Definition
- Provide the following details:
- Text - this will contain the actual text to be displayed in the Raise Message popup window
- externalCode - external code for the message definition object
- externalName - external name for the message definition object
- status - status of the object. Set to "Active" if you want to use immediately after creation.
**The above configuration is based on the Example Scenario.
Create the Rule
- Log in as an admin user with the necessary authorization, and choose Configure Business Rules.
- If you can’t see the Configure Business Rules link, it probably means you don’t have authorization
- Choose Create New Rule
- A screen appears on which you’re asked to select a scenario.
- The options available here depend on the settings you’ve made in Provisioning
- Note: Recruiting only supports Basic Rule.
- Choose Basic Rule.
- Enter all the necessary information such as the rule name, specify whether you want to use a Job Requisition Template or Offer Approval Template as the base object, and choose Continue.
- Add any IF and THEN conditions as required, and save the rule.
- The rule is created. If you subsequently need to make any changes to the rule, you can do so by choosing Take Action > Make Correction
**Above rule is based on the Example Scenario
Note: When the rule is triggered and if the user accepts the message it will still allow the Job Requisition to be saved. The rule will not stop the user from saving it, it is just to inform them that an issue has been found based on the configuration of the rule. The same applies to Job Applications, the users will be able to save the Application after accepting the message raised by the rule.
IMPORTANT:
- 'Raise Message' is supported only through the onChange Rule Trigger. 'Raise Message' for onSave trigger is currently not supported.
- Additionally, please be aware that businesss rules will not execute on External Careers Sites if the Mobile Apply feature is enabled (Manage Recruiting Sites > Enable Mobile Apply) or on Recruiting Marketing (RMK) career sites.
Two enhancement ideas have been raised for this feature. Please vote for them if this is something you wish to see considered for inclusion in a future release:
See Also
KB article 2515173 - The Rules Engine in SuccessFactors Recruiting
Keywords
sf, success factors, RCM, raising, Candidate Profile, business, rule, raise, message, onSave, error , KBA , LOD-SF-RCM-RUL , Recruiting Rule Issues with MDF Platform , How To