SAP Knowledge Base Article - Public

2084836 - Rating Sources - Performance Ratings Not Updating on Compensation Form or Reflecting the Correct PM Rating - Compensation


  • This article discusses issues with Performance Ratings not updating. This includes HBA and non HBA configurations.
  • What is completed-only="true"?

  • Why do some people show N/A as the performance rating on the compensation form?

  • How do I make the compensation plan show the rating for a completed performance form?
  • What is comp-rating-source?
  • What is checkRatingSourceAcrossTemplates?


  • Compensation


  • The following options are all important when considering what form rating will be used in the compensation form, and whether those ratings will update while in progress or not, and whether your performance form needs to be completed for it to be used as the rating in the compensations plans.
  • The compensation plan has to be saved in order for the form to be updated when viewing via the Detailed Document Search Report. Please note though that the form with the manager will always refresh
  • Performance form must be launched prior to launching the Compensation form at all times.


  • On a compensation template there is an option to use only completed compensation forms. Check your configuration to see if this is enabled. This option should be used only if:

1. All performance forms are completed at the time of launching the compensation plan.

2. or you do not need any ratings for incomplete forms to update on the compensation plan once they are completed. People that have incomplete performance forms will show N/A. Note: Merit guidelines will not work if based on the performance rating and the rating is N/A.

  • If you need in-progress performance scores to be reflected on the compensation plan as they are updated or are completed, then you must set the comp-rating-source as completed-only="false". This way your compensation plan can link to in-progress performance forms and update as they change. 
    When compensation plans are created the system automatically looks for the most current performance form for each user and creates a physical linkage between the comp plan and the PM form. When completed-only="true" is set on the template and if the pm form is NOT completed then no linkage will occur, so that the individuals rating will forever remain as N/A.
  • When using completed-only="true" if you do need to have the users rating change from N/A to the completed rating, then once the performance form is completed, use the "remove member from plan" option and then add the member back so that the linkage to the completed PM form can be established and the rating displayed. This can only be done while the compensation plan is still in-progess.
  • Changing your configuration may require a change request if you need SuccessFactors Engineers to make this change for you. Please open a case with Customer Success. Changes will only apply to new compensation plans and not existing plans. To update live plans please use the steps outlined above to remove and add members back to comp plans.

When using HBA

  • User’s Performance ratings were changed on the Performance form but the compensation form is showing the old rating.
  •  Please note HBA doesn't support automatic refreshing of Performance rating from PM forms. Only opening compensation form supports this.
    Best practice is to complete the PM forms before launching the compensation forms.
    But if this is not feasible there are two ways to sync the Performance ratings on the compensation forms:
    1) Open the compensation forms and click save.
    2) To perform Mass Update of Compensation Form.


  • Most clients will only define one performance form as the rating source. So for the current year, you will have one compensation plan and one performance plan template that you want to use as the performance rating. Some clients though may have multiple performance forms, and would like the compensation plan to check multiple performance forms to determine which is used as the rating.

    There are 2 basic options:

1. Use the comp-rating-source from the first template defined in form-id. example:

      <comp-rating-source useFor="all" form-id="1" is-default="true" completed-only="false" use-calculated-rating="true" import-from-assignment="false">
      <comp-rating-source useFor="all" form-id="5" is-default="true" completed-only="false" use-calculated-rating="true" import-from-assignment="false">

  • In this example, if a performance form for a user exists based on form-id="1", then use the rating as found in this PM form. If though no PM form exists then check for one based on form-id="5". If you have defined more than two rating sources then it continues down the list until a form is found. If no performance form is found, then for this person they will remain unrated. Even should you now create a PM form the compensation plan will not update to use this rating, as the PM form must exist before your comp form is created to be used as a rating source.

2. Use the newest/most recent form's rating: So check all form templates, form-id="1" + form-id="5"  and then use the rating from the newest form. In the above example, even though form-id="1" is the first form defined in your list, if form-id="5" is a newer form, then use the rating from form-id="5".

  • To enable this functionality you need to use comp-rating-source in combination with checkRatingSourceAcrossTemplates.


  • When you configure your compensation plan to use checkRatingSourceAcrossTemplates, the following logic is applied.
    true = get the latest comp plan rating source form instance across all of the rating source templates defined.
    false = use the latest comp plan rating source form instance from the first rating source template found.
  • Note: Please note that if you have PM forms with embedded comp section, and if multiple PM forms are tied to the same compensation form template, make sure -
    1. The ids are accurate in all templates.
    2. checkRatingSourceAcrossTemplates is set to true.
  • Not doing so can result in incorrect form linkages. Errors resulting in incorrect form linkages cannot be corrected once the forms have been launched under any circumstance. Your only option will be to delete existing comp forms, correct tempaltes or launch needed PM forms, and then relaunch your compensation plan to pick up the expected data.

Flag for Reloadable Field Update only on Mass Update to Improve Performance

  • The enhancement CMP-17337 introduced a new feature under Compensation Home > Plan Setup > Advanced Settings, "Only reload user data on mass update". 
  • When this feature is enabled, it's meant to stop reloadable fields from automatically updating after saving the worksheet
  • This feature also impacts PM ratings, so if you want ratings to automatically update when saving the worksheet or updating the PM form directly, please disable this checkbox


KBA , sf compensation rating sources , LOD-SF-CMP-FRM , Forms & Templates , How To


SAP SuccessFactors HCM Core all versions