SAP Knowledge Base Article - Public

2610536 - SuccessFactors Recruiting Business Rules: Raise Message


  • 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.


SAP SuccessFactors Recruiting Management

Reproducing the Issue

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

  1. Go to Admin Center > Manage Data
  2. Click 'Create New' dropdown > select Message Definition
  3. 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

  1. 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
  2. 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.
  3. Choose Basic Rule.
  4. 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.
  5. Add any IF and THEN conditions as required, and save the rule.
  6. 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 is to inform them that an issue has been found based on the configuration of the rule.

IMPORTANT: As of 1H 2022, 'Raise Message' is supported only onChange trigger. 'Raise Message' for onSave trigger is not supported. Additionally, Business Rules on the Candidate Profile (introduced in b1902) supports OnSave Rule Triggers which does not support 'Raise Message' functionality.

Two enhancement requests have been raised for this issue: 276625 and 278565 

See Also

KB article 2515173 - The Rules Engine in SuccessFactors Recruiting


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


SAP SuccessFactors Recruiting all versions