SAP Knowledge Base Article - Public

2610536 - SuccessFactors Recruiting Business Rules: Raise Message

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

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.

Resolution

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.

Raise1.png

**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

Raise3.png

**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: As of 1H 2022, 'Raise Message' is supported only through the onChange Rule Trigger. 'Raise Message' for onSave trigger is currently not supported. Additionally, please be aware that Raise Messages created through onChange Rule Triggers for the Candidate Profile, will not execute on External Careers Sites where Mobile Apply is enabled.

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

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

Product

SAP SuccessFactors Recruiting all versions