SAP Knowledge Base Article - Public

2257064 - Employee Central - Business Rule Execution Log

Symptom

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

Environment

SAP SuccessFactors Employee Central

Reproducing the Issue

Cause

Resolution

  • 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 and select the End Date as one day ahead

      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. Select the Login User

Note: The Login 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
      • For Provisioning jobs, the "Login User" must be the Job Owner of the Job
      • In case the user has no First and Last Name maintained within Personal Information, it will not be displayed when searching the "Login User"
    1. On the Rules to be Logged section, there are two ways to execute the Rule Trace:

      • If "Rules to be Logged" is empty the system will gather all the associated rules with the transaction
      • If you input a rule at the Rules to be Logged section, the system will only retrieve the logs for the selected rule

    1. Select the trace mode Complete or Short (What is Short Trace mode? Check this Short Rule Trace | SAP Help Portal).
    2. Perform the transaction which is believed to trigger the rules.
    3. 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

Keywords

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, PLT business rules , 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

Product

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