D2L Intelligent Agents - Dynamic Agent Email with Replacement Strings

Learn what replacement strings are, how they are used in Intelligent Agents, and review the list of Intelligent Agent replacement strings.

What are replacement strings?

Replacement strings are special symbols or tokens that D2L looks for when preparing text to display or email. Replacement strings can be identified by text wrapped in curly braces ("{" and "}"). A replacement string {OrgUnitName} in D2L is converted by D2L to show the name of a course.

Using replacement string in an agent

Intelligent Agents can use replacement strings to personalize email messages. For example, instead of writing an Intelligent Agent body that is generic, the opening of a message might have "Dear {InitiatingUserFirstName}". The student that triggers an agent would see their first name in their email rather than "{InitiatingUserFirstName}".

Valid replacement strings

While many areas of D2L use replacement strings, Intelligent Agents has unique strings that will only work in the Intelligent Agents tool.

List of Replacement Strings
Replace String Description For Use In
{InitiatingUser} The user who performs the action that meets the agent’s criteria Email address field
{InitiatingUserAuditors} The auditors for the user who performs the action that meets the agent’s criteria Email address field
{OrgName} The name of the organization ("UW-Milwaukee") Email body
{OrgUnitCode} The code for the Org Unit (typically the code listed in My Courses and Course Offering Information) Email body
{OrgUnitName} The name of the Org Unit (typically the name of a course in Course Offering Information) Email body
{OrgUnitId} The org unit ID required to make quicklinks works Email subject line and email body
{InitiatingUserFirstName} The first name of the initiating user Email body
{InitiatingUserLastName} The last name of the initiating user Email body
{InitiatingUserUserName} The username of the initiating user Email body
{InitiatingUserOrgDefinedId} The Org Defined ID of the initiating user Email body
{LastCourseAccessDate} The date the initiating user last accessed the course Email subject line and email body
{LastLoginDate} The date the initiating user last logged in Email subject line and email body
{LoginPath} The address of the login path for the site Email body



Keywords:d2l d2l@uwm learn@uw learnuw luw brightspace intelligent agent agents email progress student notification notify email body text string replacement variable code   Doc ID:76050
Owner:David D.Group:UW-Milwaukee Center for Excellence in Teaching and Learning
Created:2017-08-24 14:10 CSTUpdated:2017-08-24 14:32 CST
Sites:UW-Milwaukee Center for Excellence in Teaching and Learning
Feedback:  0   0