Replace Strings for Intelligent Agents

What is "replace strings" in D2L Intelligent Agents email?

"Replacing strings" refers to the process of swapping one set of characters in a text with another. Imagine you're editing a document and you decide to change all instances of "cat" to "dog." That's exactly what replacing strings is about, but it happens within computer programs or software. This can be done for many reasons, like fixing errors, updating information, or customizing messages to make them more relevant or personal. It's a basic yet powerful tool in programming and data processing, helping to ensure that the information being handled by software, such as intelligent agents, is accurate, up-to-date, and tailored to the user's needs or preferences.

What are some possible "strings" that I can replace in an email for Intelligent Agents?

 

Replace String

Description

Where does it go?

{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

Email body

{OrgUnitCode}

The code for the Org Unit

Email body

{OrgUnitName}

The name of the Org Unit

Email body

{OrgUnitStartDate}

The start date specified for the Org Unit

Email body

{OrgUnitEndDate}

The end date specified for the Org Unit

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

 

How do I replace the words with strings?

First, determine why you need to replace strings in your email. Replace strings are specially formatted codes that can be entered into automated emails; they replace the need to enter information that might change from student-to-student. For example, to send a personalized message to each student in a class of 60, use the replace string {InitiatingUserFirstName}, and the names of the students will be filled in automatically.

Below is an example of an email using Replace Strings:

email image
 

 

Are there other uses for Replace Strings?

In D2L, you can use Replace Strings in several course areas:

  • Course Homepage Widgets 
  • Announcements 
  • Course descriptions (for modules, content items, etc.) 
  • Intelligent agent templates 
  • Mail Templates 
  • Grades when adding bulk feedback