Skip to main content

Using Report Builder to create a Universal Import file

Great for quickly bulk-updating people in one go!

D
Written by Dave Branscombe

You’ve arrived here because you want a quick way to update lots of people in one go, like updating your new starters, movers and leavers all in one swift action.

For a quick reminder on how to get the best from Report Builder, revisit this guide and then come back here for the specific steps to follow.

Ready to get cracking? Let’s go …

Our goal is to create a csv file with the right headers, in the right order and with the right information. First, you should familiarise yourself with this guide: Importing lots of people quickly with a CSV file – it’s non-negotiable, so you have to get it right!

Open Report Builder and create a new report called “Export active people in Universal Import format” and press Create Report:

Now start picking the right columns in the right order, starting with the User section and Username field. Here is the full list of fields to pick and remember to pick these in the following order and remember to switch to the Location section to pick the Location Name and then switch back to the User section for everything else:

Username

This is what a person will log in to the learning platform with. It is unique to every person in the learning platform. We may interface with another HRIS platform, which will automatically (or silently) log them into the learning platform, but they will still have this unique identifier that exists in both your HRIS platform and the learning platform.

Type Description

This describes what type of dashboard a person has and therefore what tools they have access to e.g. Report Builder!

First Name

A person’s given first name as defined by the HRIS platform or entered manually.

Last Name

A person’s given surname as defined by the HRIS platform or entered manually.

Email Address

Useful to request a login reset and for receiving email digests.

Location Name

This is the actual name of the location where a person works.

Date of Birth

This is useful if you need to assign content for somebody who's over a certain age for legal reasons, e.g. 18.

Language

The learning platform is translated into multiple languages. If we know what language they prefer then we can present the learning platform in that language.

Job Code

As defined within your HRIS platform, a code that defines a job that someone does e.g. “MGR” (a manager). This is aligned with the Job Description and provides a mechanism where we can assign a learning profile so that we give people a list of courses applicable to the job that they do

Job Description

As defined within your HRIS platform, a description or label that describes a job that someone does e.g. “Manager” This is aligned with a Job Code.

Joining Date

This is the date that they joined the business.

Leaving Date

This is the date that they left the business, and it's an important field when automating your new starters, movers and leavers because when we receive a leaving date, we will automatically mark that person as inactive (Account Active=0).

Temp Exclude

This means is they've been excluded from reporting for whatever reason. It could be long-term sick, maternity/paternity leave, or something unspecified.

We’ve now done everything we can in Report Builder, and you’ll end up with something like this, so Export your report:

You could email this to someone else if you need to, if you’re completing this whole exercise then just export the file to your computer:

Download your csv file from the View Exports option:

You now need to switch to your “spreadsheet editor of choice”; we’ll be using Microsoft Excel to insert some missing columns, but use whatever you’re comfortable with. The process is the same.

The first thing you’ll notice is that the headers are what Report Builder exports and this is absolutely fine! However, there are some missing columns which we need to sort out next because the user import function must have the right columns in the right order.

To help, a top tip is to paste the column headings from a previous import file so you can quickly line up the new columns accurately.

Insert a new column after the “email” column by “shifting the existing data across", this will create a blank set of password data (which is just what we need):

Repeat this to create a new blank column at column I (Country):

We’re almost there! Insert two new columns to align the “tmp exclude” column correctly:

And, finally, you just need to delete the data from column B (trust me, it’ll make your import run smoothly):

Just a quick check to see that the ‘before’ and ‘after’ columns align is all that’s needed before you delete the superfluous column headers on row 2:

At this point, you can now change whatever data you’d like to in the file.

You could:

  • delete the rows for people you don’t need to update;

  • move people into different locations in the business by changing the Org1 data;

  • update their job code and job type.

  • insert new rows with data for your new starters

The CSV file is already in the right format so go ahead and save it!

That’s it, you're now ready to import this file and update everyone in one go.

Did this answer your question?