Overview
This article explores the capabilities and functionality of the import Learning Data option for Events. With this, you can create Events, as well as update them and the learning records for them.
Import Data Button
As an Admin, navigate to Admin > Learning > Events. Here you will see the Import data icon:
Clicking it will bring up the following menu:
Create new events
Update existing events
Create new event assignments
Update existing event assignments
How do I Create New Events with the importer?
To create Events with an import, go to Admin > Learning > Events. Here, select the option Create new events and download the template:
Here, you will find 4 different columns. Selecting any of the header names will show you a tooltip for each different column. The columns are named:
Event Title *
This data is required to fill in
Event Description
Please only use plain text
Add Topics
If you wish to add more than one Topic, simply separate topics by comma
Add to Learning Plans
To add the Event to an existing Learning Plan, add the Learning Plan ID
The only required section is the Event Title, everything else is optional.
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 Event 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 Events to the specific Learning plans. This process is also the same for Events via Admin > Learning > Events > 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 Event was created.
Keep in mind that Event creation will always create just the Event shell, not any Sessions. You must manually create Sessions in the platform.
How do I Update Existing Events with the importer?
To update Existing Events, follow the same steps to the importer as you can see above, then select Update existing events.
This will bring up a similar menu and option to download a template as the previous section. Download the template by clicking here in the menu. Once downloaded, open it, and you will see the following:
Here, you will see four very similar columns to the Event creation process.
Event ID*
Required field
To locate Event ID go to Admin > Learning > Event > 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 Event 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 Event Name, Status, Topics added, and the Learning Plans that the Event 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 it's complete, it will appear at the top with the number of Events successfully updated.
How do I Create New Event Assignments?
Creating new Event assignments is a fairly straightforward process. First, navigate to Admin > Learning > Events > Import data.
Once here, click + Create event 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 3 columns:
Event ID*
This data is required to fill in
To locate the Events ID go to Admin > Learning > Events > Download
User *
This data is required to fill in
This field accepts either the User Email or the Account ID
Add to Session *
This data is required to fill in
To locate Session ID go to Reports > Events select the Event in question, go to the Sessions tab and click to download the report
Event ID, User, and Add to Session are all 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 Event assignments for already existing Events in your platform. Updating/adding Event assignments will not automatically create an Event in the platform, meaning this is a 2-step process if you are updating/adding Event assignments for a new Event. Additionally, Events can be created with an import, but Sessions cannot.
To create an Event, follow the steps in the first section of this article, or review this article to create them manually: Events Overview
How do I Update existing Event Assignments?
First, you must navigate to Admin > Learning > Events > Import data.
Here, click Update existing event 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 the following columns:
User *
This data is required to fill in
This field accepts either the User Email or the Account ID
Event ID *
This data is required to fill in
Session ID
To locate Session ID go to Reports > Events select the Event in question, go to the Sessions tab and click to download the report
Session Status
Signed Up, Attended, Unattended or Cancelled
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.
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 Course 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.
Important! Remember that if you attempt to update records that do not exist, it will still go through, but no changes will be reflected in the platform. Make sure you have assignments to update by assigning the Learning 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!