SAP Knowledge Base Article - Public

2560623 - Triggering Alerts & Notifications Specifically for Custom MDF Objects


This KB article explains how to trigger alerts and notifications for custom MDF objects

Note: KB article 2532558 is different. This KB article is specifically for custom MDF objects.

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 HXM Suite
  • Metadata Framework (MDF)


  1. In Admin Tools > Company Settings > Configure Object Definitions, search for AlertMessage
  2. Change the Maximum Length of alertDescription as 4000

Note: This is to increase the length of Alert description as configured in Step 3 below


  1. Create an Alert Message. Go to Manage Data > Create new > select the object AlertMessage. You can customize the description of the alert as per your requirement


  1. Create a Workflow. If you want the user to receive an Alert as well as an email notification, then add the approver in the CC Role


  1. For the MDF object, on which you want to trigger the alert, create a business rule selecting the right base object (refer to the sample screenshot below)


Note: Previously, you could create MDF object-based rules of any purpose and execute the Trigger MDF Alert Event() function but post b2005 release, Trigger MDF Alert Event() function will be executed only if the rule purpose type is Alert. If you have existing rules with different purposes, they continue to operate as usual; however, you can't edit these rules. If you need to modify these rules create a new rule with purpose as Alert.

  1. Set up this rule on the PostSave rules section on the Object level. - Save the object definition.
  2. Now create data for this custom MDF object to trigger alerts. (Or update the already created data for a user)


  1. You can now see the alerts in the To Do tile of the user:



  • If alerts are not triggering, please remove the if condition and try checking again without any if condition. If the alerts are triggered then, it means the condition you have configured in the rule is not satisfied and hence the alerts are not triggered. Try configuring a rule trace and then check the execution logs to troubleshoot before reporting support Incident. See KB article 2257064 - Business Rule Execution Log FAQ - EC & RCM
  • If you do not trigger future dated alerts, you will not require and job to be scheduled, the system will create and send these alerts automatically on save event.
  • If you trigger alerts for a future date you will require the "EC Alerts and Notifications" job to be scheduled and running in the instance. This job will send out any future dated alerts, once their effective date is reached.
  • For objects which have a Parent/Child Association the Business Rule should be configured with the Parent Base Object and also triggered on the Parent Object.
  • If the self/EM/EMM is the first step approver and the initiator is same as the approver,  then the first step is skipped and hence alert is not received in the Take Action tile in home page.
  • For triggering multiple alerts on an MDF object, check the KBA mentioned below.
  • The MDF alerts and notifications will only work in case you have Employee Central enabled. If you don't have EC, the take action tile won't be available for you and the notifications job will not run.
  • When you edit the record of the custom MDF object that triggered the MDF alert, the alert is automatically updated. However, if you insert a new record, it is expected that the system will only add a new alert and will not modify the alert triggered by the previous record.

See Also

  • KB article 2895379 - Multiple MDF Alerts are not being triggered - Custom MDF
  • KB article 2532558 - EC Alerts: Configuring Alerts for MDF Objects
  • KB article 2257064 - Business Rule Execution Log FAQ - EC & RCM


sf, success factors, MDF, Alert messages on MDF, Object definition, Workflows, Business Rule, MDF-32338, multiple alerts , KBA , LOD-SF-MDF-WFL , Custom Object based Workflows , LOD-SF-MDF-RUL , Custom Oject based Business Rules , How To


SAP SuccessFactors HXM Suite all versions