SAP Knowledge Base Article - Public

3763936 - Onboarding email notifications do not display multiple work permit records - Onboarding

Symptom

  • An onboarding email notification intended to include multiple work permit entries shows only one record.
  • Multiple work permit records are present in the user profile (work permit info), but only a single record appears in the email body.
  • Custom tokens for work permit data resolve to a single record only (for example: [[workpermitcountry]], [[permitdocument-type]], [[permitissue-date]], [[permitexpiration-date]]).
  • No error message is displayed or logged.

Environment

SAP SuccessFactors Onboarding

Reproducing the Issue

  1. Configure an onboarding email template under a document flow message category (for example, document signature task completion).
  2. Add tokens that reference work permit information in the email body.
  3. During Personal Data Collection, enter multiple work permit records for the same user.
  4. Trigger the notification and observe that only one work permit record is rendered in the email.

Cause

  • The onboarding email notification token framework does not support iteration over multiple records.
  • When tokens are used with direct mapping to base objects such as Work Permit Info, they resolve to a single record only (for example, system-selected record based on internal logic such as latest or effective entry).
  • Repeating the same token multiple times in the email template does not result in retrieval of different records.

Resolution

This is an expected system behavior.

Currently, it is not possible to dynamically display multiple records within an onboarding email notification using direct token mapping, as email tokens do not support handling multiple instances of an object.

Additional Information:

  • Repeating the same token multiple times in the email template results in the same single record being displayed.
  • Email tokens are non-iterable and do not support multiple record resolution.
  • If multiple records need to be handled differently, alternative configurations such as rule-based mapping may be considered based on business requirements.

Keywords

onboarding, email notification, work permit, multiple records, token, non-iterable, iterable, personal data collection, email template, document signature, document flow, single record, token resolution, custom token, business rule , KBA , LOD-SF-OBX-EML , Notifications , Problem

Product

SAP SuccessFactors Onboarding 2511