Overview
This article explores the various features of the "Import Learning" button. We'll guide you through the process of updating, creating, and importing learning data into your platform.
Import Data Button
As an Admin, first navigate to Admin > Learning > Courses. Here you will see the Import data icon:
Clicking it will bring up this menu with four options:
Create new courses
Update existing courses
Create new course assignments
Update existing course assignments
We will cover each of these options in the sections below.
How do I Create New Courses with the importer?
As you can see, the Create new courses option allows you to import a pre-defined list of Courses which will create new Courses on the platform. Clicking the "+ Create courses" button will bring you to this page:
Here, you will see the option to download and upload a template Excel file. Download the file by clicking here in the menu. This will download the template Excel file with some examples. Once you download and open it, it should look like this:
Here, you can see that there are 5 different columns. Selecting any of the header names will show you a tooltip for each different column. There are columns for:
Course Title *
This data is required to fill in
Course Description
Please only use plain text
Course Type
Standard or SCORM
Course Type is not required, but note that it cannot be changed changed in the future. If not provided, the Course will automatically be imported as a Standard Course Type
Add Topics
If you wish to add more than one Topic, simply separate topics by comma
Add to Learning Plans
To add the Course to an existing Learning Plan, add the Learning Plan ID
We recommend reading the Template Guide before populating the template.
Please do NOT change the predefined template be deleting any columns or rows including row 1: NewLearningRecords_template (when uploading new records) or UpdateLearningRecords_template (when updating records) as this will cause the import to not function.
Adding Topics is a fairly easy process! Simply type each topic as it appears in the platform, then separate it by a comma if you intend to add more than one. You can also add the newly created Course to Learning Plans automatically. It is a similar process, but instead of listing by name, you will need to provide the Learning Plan ID instead.
In order to get the Learning Plan ID's, you can download the Overview report in Admin > Learning > Learning Plans > Download button
Once you download it, open the file and you will see the ID for each of the Learning Plans.
You can use this in tandem with the Importer template to add the newly created Courses to the specific Learning plans. This process is also the same for Courses via Admin > Learning > Courses > Download.
Once you have provided the necessary information, you can save the file and import it by dragging and dropping it, or uploading it directly with the hyperlink in the menu.
Once you upload it, should it be successful, you will be presented with the following menu:
Ensure all of the information is correct, then click Confirm. Once you click Confirm, you will see it load at the top and confirm that the Courses were created.
Keep in mind that the bulk Course creation will only create the shell of the Course. You must manually add content, upload the SCORM file (if applicable), and customize it however you need (Add skills, duration, certifications, cover image, etc.)
How do I Update Existing Courses with the importer?
To update Existing Courses, follow the same steps to the importer as you can see above, then select Update existing courses.
This will bring up a similar menu and option to download a template as the other steps. Download the template by clicking here in the menu. Once you download the template, open it. You will be presented with the following:
Here, you will see four very similar columns to the Course creation process.
Course ID *
This data is required to fill in
To locate the Course ID go to Admin > Learning > Courses > Download
Course Status
Active or Archive
Add Topics
If you wish to add more than one Topic, simply separate topics by comma
Add to Learning Plans
To add the Course to an existing Learning Plan, add the Learning Plan ID
Once you provide the necessary information on the form, save it and upload it to the importer.
Here, you will see the Course Name, Status, Topics added, and the Learning Plans that the Course may have been added to. Once you confirm that the changes being made are correct, click Confirm.
You will see an element load, then once its complete, it will appear at the top with the number of Courses successfully updated.
How do I create New Course Assignments?
Creating new Course assignments is a fairly straightforward process. First, navigate to Admin > Learning > Courses > Import data. Once here, click + Create course assignments.
This will again present you with a window showing an option to download the template and an option to upload it. Once you download and open the file, you will see this:
Here you can see 4 columns:
User *
This data is required to fill in
This field accepts either the User Email or the Account ID
Course ID *
This data is required to fill in
To locate the Course ID go to Admin > Learning > Courses > Download
Required
True or False
Deadline
This data must follow the date format "YYYY-MM-DD"
User and Course ID are required fields, without them, you cannot determine who and what you are editing. Once you have updated the document to fit your needs, save and upload it. Confirm the changes are correct, then click Confirm. You will see the same message as the examples above.
Please note that you will only be able to create Course assignments for already existing Courses in your platform. Updating/adding Course assignments will not automatically create a Course in the platform, meaning this is a 2-step process if you are updating/adding Course assignments for a new Course.
To create a Course, follow the steps in the first section of this article, or review this article to create them manually: How to Create, Edit, and Assign Courses
How do I update existing learning records/course assignments?
First, you must navigate to Admin > Learning > Courses > Import records
Here, click Update existing course assignments. You will be presented again with the option to download a template. Download and open the template, you should see the following screen:
Here you will see there are a few more columns than the previous examples:
User Email *
This data is required to fill in
Course ID *
This data is required to fill in
Course Status
Not started, In Progress or Completed
Completion Date
This data must follow the date format "YYYY-MM-DD"
Required
True or False
Deadline
This data must follow the date format "YYYY-MM-DD"
Time Spent
This data must be provided in seconds
Once you have amended the file to fit your needs, you can save it and upload it back to the platform. Once you do so, you will see the following:
Here, you can see the different fields that you have mapped data to. Once you verify that the changes are correct, select Confirm. You then see another confirmation at the top once you finalize the import.
Updating Courses with a Certificate Renewal:
When updating assignments of a User for a renewable Course Certification, the Completion date must be within the range set in the Certificate setting and thus, the Certificate must be valid. If it is outside the range of the interval set in the settings, the Certificate will not be issued.
Historical Completions:
It is important to note that the importer will only be able to issue one Certificate per Course Completion. โIf multiple Completion dates of a User for a Course is given, then the importer will take the latest date while the rest are treated as duplicates. This is because the importer works in a pair functionality update - 1 User with 1 Course Completion.
Why is my learning import not working?
The import feature is sensitive to typos and mistakes. The system will pick up any errors and reject the file when you upload it. We will use an example of an error while trying to update current assignments. Here, in the image below, you can see red text indicating errors:
If any of the fields are missing information, have the wrong information or the information provided does not exist on the platform, it will clearly define what is wrong. In the example above, you can see that the user email does not exist on the platform, and the completion date provided is not valid. In order to rectify this, you must go back into the excel file and update the data accordingly.
Remember that if you attempt to update records that do not exist, it will still go through and update, but no changes will be reflected in the platform. Make sure you have assignments to update by assigning the learning material first and then applying your changes after.
Common Import Blockers
If you are getting invalid responses, or if the file is not being taken in by the system, there is more than likely something wrong with the file. The first thing to check is the responses you are getting from the importer itself.
Here, you can see that the file is invalid as the file provided has mistakes inside of it, and the users to be updated do not exist on the platform. If the file is giving you an error stating that the file type is incorrect, please keep in mind that the file must be in a specific format of .xlsx or CSV format. If the file is saved into a different file type, you may see the following error:
In any case, if you repeatedly run into errors and invalid responses and cannot successfully debug it yourself, please feel free to reach out to our Support Team or your CSM/AM.
In case of any questions or concerns, please feel free to reach out to our support team via the eloomi Support Hub!