SAP Knowledge Base Article - Public

2231234 - Tokens in notifications used in the Recruiting Management Module - Recruiting Management

Symptom

Tokens are placeholders used in e-mail notification templates to reference field data. There are standard (non-customizable tokens) and custom tokens which can be then used in Recruiting E-Mail templates and Offer Letters.

 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 Recruiting Management

Resolution

Tokens used in the notifications set up in Admin Tools > E-Mail Notification Templates

The notifications set up in Admin Tools > E-Mail Notification Templates are usually shared by multiple modules. Notifications supported in the Recruiting Module:

  • Document Routing Notification
  • Document Due Notification
  • Document Late Notification
  • External Candidate Forgot Password Notification
  • New Recruiting Operator Notification
  • Recruiting Interviewer Notification
  • Recruiting Even Interviewer Notification
  • Recruiting Agency
  • Recruiting Imminent Candidate Purge Notification
  • Share candidate search

EmailNotificationTemplateSettings.png

Notes:

  • Because most of the system notification templates are shared with other modules, the tokens are usually not module specific. If not other specified, only general tokens (e.g. [[DOC TITLE]], [[DOC ACCESS URL]]) are supported. You can find the list of tokens in this Knowledge Base Article: 2087503 - Customizing Email Notifications Default Template Text.
  • The tokens in Admin Center > E-Mail Notification Templates are not customizable.

Tokens used in notifications set up in Admin Tools > Manage Recruiting E-Mail Templates

Notifications set up in Admin Center > Manage Recruiting E-Mail Templates are used in:

  • Automatically sent e-mail notifications when changing the status of the applicant (if a template is set up in Admin Center > Edit Application Status Configuration)
  • Ad-hoc e-mails to applicant from the Application page (when using the E-Mail/Contact Candidate button)
  • Recruiting E-Mail Triggers

If you go to Admin Center > Manage Recruiting E-Mail Templates, you can click on the "Show Tokens" button to see the full list of supported tokens in Recruiting E-Mail Templates:

2.jpg

3.jpg

The list will show all standard and custom tokens available for the instance.

The list of available tokens is also accessible from the text editor, when configuring an e-mail template - selecting the token will insert it into the e-mail body text:

4.jpg

5.jpg

 

 If the token is spelled correctly (and supported) it will be highlighted in the body e-mail text:

6.jpg

The tokens will render the data information in the notification referenced in the token if the referenced field is filled.  If the data is not available for the specific application, the placeholder will render blank.

Please consider following use case:

  1. Fill a field on the application:
    ApplicationFieldFilled.png
  2. Click on "Contact" button and insert the custom token assigned to this field:
    ContactCandidateToken.png
  3. Click Next and see that the token will resolve:
    TokenResolved.png
  4. Go back to Application and remove field data:
    ApplicationFieldBlank.png
  5. Following Steps 2-3 again and see that the token does NOT resolve:
    TokenNotResolved.png

 

Special Tokens used only in Recruiting E-Mail Triggers

Recruiting email triggers manage emails that can be sent out at various points in the recruiting process. Therefore they may support some tokens supported only for this specific action e.g. in the E-Mail trigger "Invite Candidate to Apply" following tokens are supported: [[RECRUITING_APPLICANT_NAME]], [[INVITE_REFERRER]], [[INVITE_JOB_POSTING_DATE]] & [[INVITE_LINK]]. In other recruiting notifications, these tokens are not supported and will not resolve. You can find the information about additional supported tokens in the "Tips" in Admin Tools > Recruiting E-Mail Triggers for each e-mail trigger:

RecruitingEmailTriggers.png

Some tokens may be required for the notification set up as an e-mail trigger e.g. the Requisition Posted Recruiting Email Trigger requires an e-mail template including tokens: [[BEGIN_REPEAT]] and [[END_REPEAT]]. Please refer to the Knowledge Base Article 2144747 and 2122640 for further information.

Tokens used in Offer Letter Templates

The e-mail templates used for the Offer Letters are being set up in Admin Tools > Manage Offer Letter Templates. They may also include tokens from the last offer version and the list of the available tokens in Offer Letters is accessible in the text editor:

13.jpg

How to set up custom tokens for Recruiting E-Mail Templates and Offer Letter Templates

Custom tokens can be only created from the back-end of the system. Please contact Cloud Product Support and provide a reference to a field on job requisition, application, candidate profile or offer detail and a Support Engineer will add a custom token to your instance based on your configuration.

See Also

2644637 - Behavior of [[DOC_TITLE]] token for Language English_US - Recruiting Management

2162125 - Job Title Token [[JOB_REQ_TITLE]] - Recruiting Management

Keywords

Recruiting, Email, Tokens, RCM, notification, trigger , KBA , LOD-SF-RCM-EML , Recruiting Emails and Notifications , How To

Product

SAP SuccessFactors Recruiting all versions