Skip to main content

Bulk update employee records

Use default and custom bulk update templates to update multiple employee records at once.

I
Written by Isabelle Grey
Updated over 2 weeks ago

You can use bulk update templates to update employee records at scale. There are default templates, or you can create custom templates to update various contract elements across multiple employee records.

πŸ“ŒNote: Coordinate with your Payroll team before processing bulk updates, as changes automatically flow through to PeopleXD Payroll.

To update employee records in bulk, watch the video or follow the steps below.


Download and populate a template

You can use the two default templates to end allowances and update salaries across multiple employee records.

You can also create custom templates to update contract elements in bulk. This can include updating areas such as creating broadcast contract announcements within an employee's record.

πŸ“ŒNote: You can only update commenced or confirmed future contracts. Updates can't be made to fields specified on the Organisation Structure.

Create a custom contract template

  1. From the dashboard menu, search for and select Bulk Update Templates.

  2. Click Actions then select Create Contract Template.

  3. Search for the required fields and select the checkboxes.

  4. Click the right arrow icon to move the fields to the Selected column.

  5. Click Save, enter a name then click OK.

Download and populate a template

  1. From the dashboard menu, search for and select Bulk Update Templates.

  2. Search for the relevant template then click the three-dot menu.

  3. For guidance on populating the template, click Download Helper.

  4. Click Download Template, then open the file and populate the fields.

πŸ“ŒNote: The file type must be CSV with pipe-delimited records, and you can't update fields to a null value.


Upload and process records

After downloading and populating your template, you need to upload it. You can then use the Processing screen to fix any errors, configure settings, and apply updates to your employees' records.

Upload a template

  1. From the dashboard menu, search for and select Employee Bulk Updates.

  2. Click LOAD FILE then select the file from your device.

  3. Click OK, then review the information on the processing editor screen.

Change file visibility

Templates you upload are marked as private by default, so only you can access them. You can make a file public to allow other users with widget access to view it.

  1. From the dashboard menu, search for and select Employee Bulk Updates.

  2. Search for the relevant file then click the three-dot menu.

  3. Click Set Public, then click Yes.

Correct errors

Records with errors display the status failed on the processing editor screen. You can make updates to the records to correct highlighted issues.

  1. From the dashboard menu, search for and select Employee Bulk Updates.

  2. Next to the relevant file, click the three-dot menu then click Edit.

  3. Click the relevant record, then click Display Errors.

  4. Review the error description then update the relevant field.

  5. If prompted, click Yes to update other identical errors.

πŸ€“Tip: Where a correction has been made and cascaded to all records, you can reset all record statuses with errors using the Actions menu.

Process records

Depending on the file type, you can apply additional settings before processing the updates.

  • Bypass salary approvals: When you upload a salary amendment file, turn on the toggle to bypass the salary approval process.

  • Apply these changes to future dated amendments: When you upload an end allowance file, turn on the toggle to cascade field updates to existing future-dated amendments.

To apply additional settings and process records, follow the steps below.

  1. From the dashboard menu, search for and select Employee Bulk Updates.

  2. Next to the relevant file, click the three-dot menu then click Edit.

  3. Click Actions then click Settings.

  4. Turn on the toggles as required, then click OK.

  5. Select a record then click Process Record or click Process All Records.


User access

To access the bulk update functionality, you need to add the widgets to a PeopleXD dashboard and grant users the correct menu option access.

Add widgets to a dashboard

  1. From the dashboard menu, search for and select Site Manager.

  2. Next to Dashboard Configuration, click Open.

  3. From the drop-down menu, select the relevant dashboard.

  4. From the Dashboard Tabs section, select the relevant tab.

  5. From the Tab Widgets section, search for and turn on Bulk Update Templates and Employee Bulk Updates.

Menu options

To use the bulk update functionality, you need to add the following menu options to a menu profile:

System

Menu Option

Core Portal

  • XD Bulk Update

  • Bulk update - View/Manage Private

  • Bulk update - Unarchive

  • Bulk update - Download

  • Bulk update - Download Archived

Web Service

  • Create v2 bulkupdate contracts

  • Create v2 bulkupdate createcontracttemplate

  • Create v2 bulkupdate endallowances

  • Create v2 bulkupdate files

  • Create v2 bulkupdate salary

  • Delete v2 bulkupdate

  • Get v2 bulkupdate

  • Get v2 bulkupdate config

  • Get v2 bulkupdate files

  • Get v2 bulkupdate files download

  • Get v2 bulkupdate files errorsummary

  • Get v2 bulkupdate files fieldcount

  • Get v2 bulkupdate history

  • Update v2 bulkupdate files

  • Update v2 bulkupdate files summary

Did this answer your question?