Content
Overview
The CSV upload option allows customers to ensure that their information is up to date. This includes:
- Creating accounts for new employees.
- Updating the accounts of existing employees (i.e. manager change, title change, etc.).
- Deactivating the accounts of employees who are no longer with an organization.
Note: There is another manual user management option (i.e. individual updates) and several automated user management options (i.e. HRIS, BambooHR, TriNet Zenefits, and UKG Pro integrations).
Parent-child Departments
A parent-child department structure (aka nested department structure) is an organizational hierarchy where departments are nested within larger ones, forming a tiered system. If your organization has this structure, please define it by using the template below. If not, continue to the next section.
In the name field (aka name column header), enter the parent department followed by related child departments. In the parent field, enter the parent department where applicable.
In the screenshot below, “Human Resources” is the parent department. It is shown at the top of the name field followed by related child departments, and in the parent field, to the right of each child department.
Note: When using the template, do not rename the fields. Also, save the completed parent-child department data file as “Comma Separated Values” (.csv). Otherwise, it cannot be processed.
The completed parent-child department data file must be uploaded manually. It cannot be sent through the HRIS integration.
- Access the CSV upload page.
- Go to the Admin module.
- Select the User Management tab.
- Select Departments (under the Department and users header).
- Select the CSV upload tab.
- Drag and drop the completed parent-child department data file or click choose a file.
- Wait a few moments for the completed parent-child department data file to be processed and validated.
- Click Save.
User Data Templates & Explainers
Below are our user data templates and explainers. Please read the explainer thoroughly before using the related template.
Default
For organizations that need to send user data to Betterworks:
Custom
For organizations that need to create custom user data fields before sending user data to Betterworks, see this Support article.
Advanced Analytics
For organizations that use Advanced Analytics and need to send user data to Betterworks.
- User Data Template (Default & Advanced Analytics)
- User Data Template Explainer (Default & Advanced Analytics)
Note: When using the template, do not rename the fields. Also, save the completed user data file as “Comma Separated Values” (.csv). Otherwise, the file cannot be processed.
Common Errors
If there are any errors found in the file sent to the Betterworks SFTP server, the Technical Contact will receive an automated notification by email. The notification will contain a downloadable error file and direct them to our error resource.
FAQs
How are name changes reflected in Betterworks?
If an employee's name changes, it should be updated in their Betterworks user profile. For organizations that are not using one of our user management integrations (i.e. HRIS, BamooHR, TriNet Zenefits, or UKG Pro), a Super Admin can update the employee's name manually through an individual update or CSV upload.
For organizations that are using one of our user management integrations, someone from the organization with the necessary permissions will need to update the employee's name in their HRIS. The name change will then be sent to Betterworks as part of the next data sync.
Name changes apply to most areas of the Betterworks application. However, some areas that display static data (i.e. the text in a past conversation response) will still contain the employee's previous name.