SAP Knowledge Base Article - Public

2257064 - Employee Central - Business Rule Execution Log


  • Is there a way to trace a Business Rule?
  • How to check if a Business Rule has executed properly
  • How to check the rule execution steps when any rule is executed

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 Employee Central


  • Creating a Rule Trace is a great way to troubleshoot Business Rules to analyze errors
  • Each time a specific rule is triggered, a log is created to show how the system validates and possibly sets that rule
  • To create a Rule Trace, do the following:
    1. Go to Admin Centre > Business Rule Execution Log > Create New > Rule Trace
    2. Provide a Code and a Name

This can be any naming schema as long as you are able to recognize it afterwards to retrieve the log trace after execution

    1. Start date will use the same time as the Server Time

Note: It is best practice to get a time stamp from the system to ensure you are selecting the proper dates

      1. Click on your name menu at the top of the page
      2. Click on show version information 
      3. This will tell you the date of the server
      4. If you do not select the proper date the log returns empty results
    1. At the bottom left, choose the rule in question:

rule log.JPG

Note: The USER Field will represent the user which executes the transaction (Note: this is the user you proxy and not the login user)

      • This will either be the login user or if you are proxied as another user to trigger the transaction, put the proxy user instead
      • This can be any system user that is active including an Admin, Manager, or other employee

    1. There are two ways to execute the Rule Trace:

      • If you only put a user the system will gather all the associated rules with the transaction
      • If you input a rule at the bottom in the, Rules to be Logged section, the system will only retrieve the singular rule
    1. Perform the transaction which is believed to trigger the rules
    2. Click on download and view the steps performed by the rule in the Comma Separate Value (CSV) file

Note: If you see the downloaded CSV file is empty, then the rule has not triggered for the transaction. If a rule fails for any reason, this information will also be available inside the Rule Trace CSV file

See Also

Creating Business Rule Execution Logs


SF, success factors, EC, rule isn't working, logging, empty, missing, rule trace, business rule execution log, execution log, log, trace, file, export, track, FAQ , KBA , LOD-SF-EC-JOB-RUL , Job Info Business Rules , LOD-SF-MDF-RUL , Custom Oject based Business Rules , LOD-SF-EC-ADM , Admin Tools (EC Core only) , LOD-SF-EC-CMP-RUL , Business Rules , LOD-SF-RCM-RUL , Recruiting Rule Issues with MDF Platform , How To


SAP SuccessFactors Employee Central all versions ; SAP SuccessFactors HXM Suite all versions