Add Employee Property Fields

You can add employee properties as fields in custom Candidate Hire forms, which allows you to gather additional information for the candidate when the form is submitted in Recruiting.

Before You Begin: Employee properties are configured in the HR Admin > Employee Properties feature. See Employee Property Setup.

To add an employee property to a custom Candidate Hire form:

1. Go to Workflow Administration > Form Builder and select an existing custom Candidate Hire form, or create one. See Create Custom Candidate Hire Forms.
2. In the XML tab, add the following code before the <FormBody> tag to define the UsedClass for employee properties:

3. <!-- Used Class for Employee Property -->
   <UsedClass>
   <Name>List_EmployeeProperty</Name>
   <AddNewInstanceIfEmpty>true</AddNewInstanceIfEmpty>
   </UsedClass>

3. Add the XML code for the employee property and style the field as needed. See “Setting Up Form Elements” in the XML Forms Guide.
4. The following example shows the code you might add to display the Category employee property as a drop-down list in the form:

<Label>
<Style>IVLabel</Style>
<Caption>Category</Caption>
<MarkAsRequired>true</MarkAsRequired>
<Row>60</Row>
<Column>0</Column>
<ColumnSpan>2</ColumnSpan>
</Label>
<EmployeeProperty>
<Style>IVComboBox</Style>
<Row>61</Row>
<Column>0</Column>
<PropertyXRefCode>EmployeePropertyXrefCode8</PropertyXRefCode>
<Visible>true</Visible>
<IsRequired>true</IsRequired>
<DisplayName>Category</DisplayName>
</EmployeeProperty>

5. Note: The PropertyXRefCode that you enter should be the same as the reference code of the property in HR Admin > Employee Properties.
6. The following form styles are available for employee properties with each data type:

7. Available form styles for employee properties with each data type

   Employee Properties Data Type	Form Style
   String	IVTextBox
   Pick List	IVComboBox
   Date	IVDatePicker
   Numeric	IVTextBox
   Time	IVTimeTextBox
   Boolean	IVCheckBox

4. Click Save. Dayforce adds the employee property and shows it when you open the form for candidates in Recruiting. Continuing the configuration example above, the Category field is displayed in the Candidate Hire form as follows:
5. 

When the form is processed, Dayforce shows any added employee properties in the employee’s record in People, in the Employment > Employee Properties screen. These properties are listed with the form Hire Date value as their Effective From date.