For customers of our ADP Workforce Now® (US and Canada) and Workforce Now Next Gen® integrations.
In addition to the default data fields imported from ADP Workforce Now®, you can import custom field data for people and positions. You can then utilize your custom field data in reports, when applying org chart visualization tools, and more.
For each ADP custom field you want to import, you must first create an identical custom field in Built:
Only Company Admins and HR Admins can create custom fields. Only Company Admins, HR Admins, and HR Managers can initiate an import. Learn more about managing user roles and permissions.
Click your company name at the top of the main navigation, then click Company Settings.
Click the Fields tab.
Click the + Add Field button in the upper-right corner to create a new custom field.
While all Built customers can add custom people fields, only customers of our Position Management module can add custom asset or position fields. Employment custom field data imported from ADP must correspond to a position custom field in Built. Likewise,a personal custom field in ADP can only map to a person custom field in Built. Custom asset data cannot be imported from ADP Workforce Now.
Enter the name of the custom field you want to add. The display name for the ADP custom field and the Built custom field must match exactly. Ensure that all characters are identical and there are no extra spaces before or after the name.
You may enter an optional description for the new custom field.
Click the Field Type dropdown to select Short Text, Numeric, or Currency. The field type set in ADP must map to a corresponding field type in Built. While some ADP field types correspond to an equivalent field type in Built (Money Field in ADP; Currency in Built), other ADP field types must be stored in Built as Short Text. Refer to the table below to choose the appropriate field type:
Here’s an example of how you might select a field type when importing a custom field from ADP:
Your organization has a number employment custom field in ADP called "Security Level" and a text personal custom field in ADP called "Food Allergies." In Built, you would create a position custom field called "Security Level" and set the field type to Numeric, then create a people custom field called "Food Allergies" and set the field type to Short Text.
Select the appropriate settings for the new custom field, and click Save. Your custom field data will be updated during all future imports. Learn more about utilizing custom fields.
Notes about imported custom fields:
If a person has multiple positions in Built, imported position custom field data will be applied to all of their positions.
If custom field data is deleted in ADP after it’s been imported via the Built Connector for ADP Workforce Now®, the data will remain until you clear the data manually or delete the custom field in Built.
Customers utilizing the ADP Workforce Now® US bidirectional API can also send changes to ADP for the following ADP custom field types: Coded Menu, Date field, Droplist, Number Field, Percent Field, Phone Number, Text Field, and Yes/No Buttons. Changes to custom fields in Built that are mapped to Money Field and Multi-Select Menu custom fields in ADP are not currently supported.
Please contact our Customer Success Team for additional assistance.