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
- Configure an onboarding email template under a document flow message category (for example, document signature task completion).
- Add tokens that reference work permit information in the email body.
- During Personal Data Collection, enter multiple work permit records for the same user.
- 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
SAP Knowledge Base Article - Public