SAP Knowledge Base Article - Public

2342466 - STUD-FIRST and STUD-LAST tags are not pulling user name in Contact/Supervisor/Instructor Learning Notifications in the LMS

Symptom

  • The syntax tags STUD-FIRST and STUD-LAST are not pulling student name in Contact, Supervisor and Instructor Notifications
  • User Name tags from Notification Editor are not resolving values in Notifications sent to Instructors, Supervisors & Contacts

Environment

  • SAP SuccessFactors
  • Learning Management System (LMS)

Reproducing the Issue

  1. Using the out of box SystemEnrollmentNotification or a Customized Registration notification
  2. The user's name is rendered using the <&STUD-FIRST> and <&STUD-LAST> syntax tags in the notification
  3. For the Notification Editor, this would be the User First Name and User Last Name tags
  4. The Notification for the Learning Item or Scheduled Offering that is sent to Supervisors, Contacts and Instructors does not pull value for these syntax tags
  5. Instead of showing the User Name as expected, STUD-FIRST and STUD-LAST are shown instead

Example of what is received (from out of box notification):

These learner(s) received the following message:
Thomas, Carly  -  TROW


Dear STUD-FIRST STUD-LAST,
Your registration is confirmed for this learning activity.
  1. Learning Activity: TROW Scheduled Offering Test
  2. Start: Oct/17/2016 08:00 AM America/New York
  3. End: Oct/17/2016 04:00 PM America/New York
  4. Instructor: Thomas, C F

Cause

  • This is expected behavior because the notification sent to Instructors, Supervisors & Contacts includes multiple Users that have been enrolled/registered into a learning item or scheduled offering
  • A single value is not expected and therefore does not resolve the single Syntax Tags in the notification

Important to Note:

  • The same template is used for Users as for Supervisors/Instructors/Contacts, though the top part of the message is not included in what is sent to Users
  • There are conditional labels and tags which will have values when mail is sent to Supervisors/Instructors/Contacts:
    • The email notification starts with following line
      • "The following Learner(s) received this message.
      • TROW - Thomas, Carly "
    • This corresponds to following labelID and tags in the Notification template:
      • notification.Enrollment.MessageText1
      • notification.Enrollment.MessageText2
      • <&ROLLUP_STUD_ID> - <&ROLLUP_STUD_NAME>
    • Or in the Notification Editor:
      • [Start Loop]The following Learner(s) received this message. [Rollup Message][End Loop]
      • [Start Loop][List of User IDs] - [List of User Names][Rollup Message][End Loop]

Resolution

  • Since the same Notification Template is being used for both Users and non-Users, the recommendation is to use the default out of box notification method that lists the Users at the top of the message, and then includes the body of the message sent to the Users
  • When customizing notifications, be sure the following conditional labels & tags are used for User ID and/or User Name:
    • <&ROLLUP_STUD_ID> <&ROLLUP_STUD_NAME>
    • The roll-up tags ensure Instructors, Supervisors & Contacts are getting the detail they need
  • User tags like <&STUD_FIRST>,<&STUD_NAME>,<&STUD_LAST> are not meant to be used for contacts, supervisor, instructor
    • However, if you wish to have a personalized greeting sent to the Student, you can include them in the Notification
    • If they are included, the Supervisor/Instructor/Contact will receive the message as noted above in the "Reproducing the Issue" section where it will show "Dear STUD-FIRST STUD-LAST"
  • Please review the default SystemEnrollmentNotification Notification Template for the recommended notification syntax (just in case, this detail is also included below)*:
    • System Admin > Configuration > Notification Templates > SystemEnrollmentNotification

 

Important Note:

  • This impacts other Notification Templates as well, not just the SystemEnrollmentNotification template.  Any notification that would include multiple Students would need to use the Rollup syntax tags to properly resolve the Student Name(s).

 

* Out of Box SystemEnrollmentNotification body:

  • <LOOP>
    • <label key="notification.Enrollment.MessageText1"/><&ROLLUP_MESG>
  • </LOOP>
  • <LOOP>
    • <label key="notification.Enrollment.MessageText2" arg0="<&ROLLUP_STUD_ID>" arg1="<&ROLLUP_STUD_NAME>"/>
  • </LOOP>
  • <label key="notification.Enrollment.MessageText3"/>
  • <&SCHD-CPNT>
  • <&SCHD-DESC>
  • <&SCHD-DESC-EDITABLE>
  • <label key="notification.Enrollment.MessageText4"/>
  • <&SEG-GRID>
  • <label key="notification.Enrollment.MessageText5"/>
  • <&SEG-FACILITY>
  • <LOOP>
    • <label key="notification.Enrollment.MessageText6" arg0="<&APPROVAL_OR_DENIAL_REASON>"/>
  • </LOOP>

 

From Notification Editor:

NotificationEditor.png

Keywords

SuccessFactors SF Success Factors Learning Management System LMS STUD-FIRST,  STUD-LAST , Supervisor, Instructor, registration notification LRN-14624 template syntax tag resolve display appear show render variable value data name user student stud editor launch pull scheduled offering learning item other contact enroll enrollment system, lrn-13742 , KBA , LOD-SF-LMS , SuccessFactors Learning , Problem

Product

SAP SuccessFactors Learning 1608