SAP Knowledge Base Article - Public

2961849 - EC:Same reference mapping in document template only return value for one reference


In a notification template when using two Placeholder with the same reference mapping (Subject User Name), notification display value for only one reference mapping and other is blank value


  • SAP SuccessFactors Employee Central
  • Document Generation 
  • Workflow Notifications

Reproducing the Issue

  1. Configure document template with “workflow” category 
  2. In template mapping, set two placeholder mapping type as reference and “Subject UserName” as reference
  3. Make changes to employee profile to trigger workflow
    1. Take action > Change job and comp info
    2. Any event date
    3. Select event = Data Change
    4. Select Event reason = Correction Data
    5. Change location from Sydney to Brisbane
    6. Save
    7. This will trigger workflow
    8. Make sure to change CC role to include your email address before trigger workflow
    9. Approve workflow for user SKumar from Admin center > Tool search  > Manage workflow request > request status = pending
  4. Custom notifications triggered successfully
  5. Notice one placeholder is blank where as another placeholder value with subject username is pulled correctly


  • The current implementation in Workflow supports only a 1:1 relation between a Reference ID and a placeholder. Therefore, if there is more than one placeholder mapped to the same reference, the implementation will consider only one of those placeholders. The other placeholders mapped to the same reference will get ignored.
  • As a result, when Workflow calls the Document Generation APIs, the values of those ignored placeholders are not passed along. For placeholders mapped to References, if their values are not passed to Document Generation, then by default Document Generation will resolve them as empty values.
  • This is why when you have two placeholders mapped to the same reference, the Workflow email notification will have a value for only one of those two, while the other one will appear as a blank value.


reference mapping, duplicate reference mapping, same reference mapping, document generation, custom notification, workflow notification , KBA , LOD-SF-EC-DOC , Document Generation , Problem


SAP SuccessFactors Employee Central all versions ; SAP SuccessFactors HCM Core all versions