Use an Employee Property as a Token

In addition to standard Employee, Candidate, and Interview letter tokens, you can also use custom employee properties as tokens. Only properties with the Use Property as a Letter Management Tokencheckbox selected can be used as tokens. The contents of the employee property's Value field as shown in the Employment > Employee Properties screen of People for each recipient is populated into your letters. See Add Employee Properties in the HR Administration Guide.

When you distribute the letter, the employee property value for the token is populated in the letter text based on the effective date of the letter. A warning message is shown for any token that doesn't populate because the property's Value field is blank.

To set up and use an employee property as a token:

1. Go to HR Admin > Employee Properties, and click an existing employee property. Or click Add to create a new employee property. See Create Employee Properties in the HR Administration Guide.
2. Select Use Property as a Letter Management Token.
3. Complete all of the required fields for the property, then click Save.
4. Go to the Employment > Employee Properties screen of People for each of the intended letter recipients. Make sure that a value is saved in the Value field for each property that you want to use as a token.
5. Go to Letter Management > Template Designer and click an existing template.
6. Place the cursor in the area of the text editor where you want to add the employee property token.
7. Select Employee Property Tokens in the Tokens and Reusable Content drop-down list above the text editor, and select a specific token in the drop-down list next to it. The tokens are listed by the name of the employee property and its corresponding Xref code.

Six data types are supported in the property's Value field, and the values are inserted in letters in the following ways:

• Boolean: A true or false selection. In a letter, the choice populates as the words True or False.
• DateTime: A calendar date. In a letter, the date is populated according to the culture settings of the letter template.
• Numeric: A number. In a letter, the number is populated up to nine digits ranging from -99999999 to 999999999. You can use decimal values as long as the number (not including the decimal point) doesn’t have more than nine digits. Decimals can have a maximum precision of five digits.
• Picklist: A selection where users select from a drop-down list. In a letter, the selection is populated exactly as defined in the Name value of the Employee Property picklist configuration in HR Admin > Employee Properties.
• String: An alphanumeric value. In a letter, the string populates exactly as entered.
• Time: The time of the day. In a letter, the time is formatted to the culture settings of the letter template.

If the employee property's Assignable field selection is Many at a time, all of the corresponding values are populated in the letter as a comma-separated list. For example: Value 1, Value 2, Value 3, Value 4.