Compose Workflow Messages

Workflows use Message Center to notify employees involved in the business process. You can control the subject and body of the messages Dayforce sends during the workflow process by configuring settings in the Decision, Notification, and End objects in the workflow.

In the subject and body of messages, you can use tokens to automatically insert values such as employee name. You add the tokens where you want the values to be in the message, and Dayforce replaces the token with the associated information when the message is sent. For the message body, you can also control text formatting such as font.

The job assignment and location tokens insert only an ID number into the message. You can add a look-up function to retrieve job assignment and location names. See Populate Job Assignment and Location in Messages.

To insert employee property values into workflow messages, you must use the GetEmployeePropertyWithCulture() function. See Populate Employee Properties in Messages.

Dayforce masks the output of the following tokens with asterisks by default to protect personal information:

Workflow tokens with default masking

Token Name	Personal Information	Masking Details
<<SocialSecurityNumber>>	Employee's national ID number (SSN, SIN)	The entire number is masked.
<<List_EmployeeDependentBeneficiary.Item.SocialSecurityNumber>>	Dependent's national ID number (SSN, SIN)	The entire number is masked.
<<List_EmployeeDirectDeposit.Item.AccountNumber>>	Bank account number	The entire number is masked.
<<BirthDate>>	Employee's date of birth	The month is displayed, but the year and day are masked.
<<List_EmployeeDependentBeneficiary.Item.BirthDate>>	Dependent's date of birth	The month is displayed, but the year and day are masked.

If you want to turn off the default masking and show the entire token value in messages, select the unmask variant of the token in the Create Expression dialog box. The format of an unmasked token expression is Unmask(<<token>>).

To compose a message:

1. In Workflow Administration > Workflow Designer, click Create Expression next to the Message Subject or Message Body properties of the appropriate workflow object. Dayforce shows the message editor.
2. Note: Text controls are shown only when editing the message body.
2. Place the cursor in the area of the text editor where you want to add the token.
3. Select a token from the sidebar to insert it into the text editor. You can enter all or part of a token name in the search field and press Enter to filter the list.
4. Enter additional text as needed.
5. For example, select the FormName field from the WorkflowState section, and Dayforce shows the name of the form associated with the workflow.
6. For more information on the field token values that can be used in messages, see the Workflow Tokens Guide.
7. When you select a token, Dayforce inserts it to the text editor, surrounded by double pointed-brackets.
5. Enter any additional text contained in the message. In the example above, the employee is notified by name, with a message that their form has been submitted.
6. In the Create Expression dialog box that is opened from the Message Body field, you can click the link icon to add a link to the text editor. You can also double-click an existing hyperlink in the text editor to open the link’s properties and update the link as needed.
7. Note: The link icon isn’t shown in the Create Expression dialog box opened from the Message Subject or Expression fields of node properties, because links aren’t used in these fields.
7. Click OK.
8. When Dayforce sends the message, the selected tokens are replaced with the associated employee information.