This comprehensive guide will walk This guide walks you through the features and functionalities of the Das admin Importer tool, which is designed to streamline the process of importing and managing data for various entitiescontent types. As an admin, you'll learn how where to locate the importer, understand each section's its functionality, and ensure the quality of your imported data. Let's dive in!
Where to Locate the Importer
The Importer tool is your gateway to efficiently importing and managing data. To access it, follow these steps:
| Table of Contents | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Locating the Importer
v2 Site admin
From the Site admin’s left-side navigation menu, locate and select the Import section.
...
v1 Das admin
From the Das admin's left-side navigation menu
...
, locate and select the Import/Export section.
...
Importing
The importer lets you import content with real-time validation, ensuring that errors can be identified and corrected inline, eliminating the need to manage your CSV outside the importer tool.
How to Use:
...
Select the content entity from the dropdown menu.
...
Using the Import tab
Once on the Import Content page, use the drop-down under Choose a Data Bucket to select the type of content you want to upload.
Drag and drop the CSV file or select the drop zone to use your file locator to upload as a CSV file.
If the CSV file is missing any required Column Headers, the importer will prompt you to fix the file you are trying to import and try again.
If the importer doesn't recognize any non-required column headers in your CSV file, it will prompt you that the unrecognized headers
...
| Info |
|---|
Missing required or unrecognized fields promptsThe Importer’s Validation Wizard notifies you of missing required fields or unrecognized columns in your CSV uploads and guides you through editing and re-uploading your CSV for a successful import.
|
...
Courses
Importing Courses using vNext Importer
This guide will walk you through the steps to import courses using the vNext Importer tool. This tool provides real-time validation, allowing you to identify and correct errors inline, making the course importing process efficient and streamlined. As an admin, you can manage course details without manipulating your CSV file outside of the tool.
Prerequisites:
Access to the vNext Importer tool
CSV file containing course information
Accessing the vNext Importer
Log in to your vNext platform account.
Navigate to the Admin or Management section.
Locate and select the "vNext Importer" tool.
Uploading the CSV File
In the vNext Importer tool, click on the "Upload CSV" button.
Select the CSV file containing the course information from your local device.
Click "Open" to upload the file.
Review and Edit Errors
Once the CSV file is uploaded, the tool will automatically validate the data.
Errors will be highlighted in real-time, allowing you to see what needs to be edited.
Edit errors inline by clicking on the relevant cell and making the necessary changes.
Lessons
The Lessons importer offers real-time validation for importing lesson information. Errors can be viewed and edited inline, simplifying the data management process.
Lesson Importer Features
Real-time validation: Receive immediate feedback on errors for inline editing.
Inline editing: Edit errors directly within the importer tool.
CSV template reference: Utilize the JUNO Learning Importer Template Master: Learning 2022.
Large file support: Handle sizable CSV files containing multiple courses and lessons.
Change log storage: Retrieve updated CSV for future reference.
Ascending order import: Lessons are imported in the order listed on the CSV.
How to Use:
Select the Lessons entity from the dropdown menu.
Upload your CSV file with lesson information.
Follow the same steps as the Courses importer for real-time validation and editing.
Discarding and Starting Over
Das admin Importer: Discard + Drop Zone Language
Description: This feature allows you to clear a CSV from the drop zone, enabling you to discard validation or start over.
How to Use:
...
If a CSV is uploaded, the Discard button will appear.
...
|
...
Once you have selected a valid CSV file, the VALIDATE button will appear if there are no errors in the import.
...
Select VALIDATE to open the validation modal.
...
Each page displays a row of the CSV with highlighted errors.
...
Make edits directly in the modal. Valid entries remove the error border.
...
Use the Next and Back buttons to navigate through rows with errors.
...
Once all errors are corrected, the PUBLISH button becomes visible.
|
...
If there are no errors in your uploaded CSV, the PUBLISH button will appear.
Select PUBLISH to finalize the import whenever the button is available.
...
Real-time validation and editing
When errors occur that are not missing required columns in your CSV upload, the Validation Wizard allows you to update them and clear the errors in real time, and a Validate button appears.
Select the VALIDATE button to open the validation wizard.
...
| Info |
|---|
|
...
Additional functionality
Discarding and starting over
Once a CSV is uploaded, the DISCARD button will appear.
Select DISCARD to remove the uploaded CSV from the drop zone.
The Validate/Publish buttons will no longer be displayed.
Follow the provided directions to proceed with a new CSV upload.
Importing and Exporting Change Logs
Das admin Importer: Import Change Log
Description: The Import Change Log provides a record of your imports, allowing you to reference changes made during inline validation.
How to Use:
Navigate to the Change Log tab.
Each successful import generates a new change log entry.
Date, time, user email, type of download, and status are displayed.
Select entries and use the download button to retrieve updated CSVs.
Real-Time Validation and Editing
Validation Wizard: Missing Required or Unrecognized Fields
Description: The Validation Wizard notifies you of missing required fields or unrecognized columns in your CSV uploads. It guides you to edit and re-upload your CSV for successful import.
How to Use:
After uploading a CSV, a pop-up warns if columns are unrecognized.
The pop-up text provides instructions for updating and re-uploading the CSV.
A similar pop-up guides you to update the CSV for missing required fields.
Follow the instructions to ensure a successful import.
Deleting Rows
Deleting a Row [Inline or in Validation Wizard]
Description: You can delete rows from your imported CSV directly within the tool.
How to Use:
...
Deleting Rows
For inline deletion, select rows and choose Delete Selection.
In the Validation Wizard, use Delete Item to delete the current row.
Use the Delete All Items With Errors button to remove all rows with errors.
Confirm the deletion in the prompted pop-up.
Importing to Production
Das admin Importer: Production Import Behavior
This feature lets you import data to production and receive confirmation.
How to Use:
If errors are present, the PUBLISH button is not visible.
The VALIDATE button appears instead for error-checking.
When errors are absent, the PUBLISH button becomes visible.
select PUBLISH to initiate the import and receive a confirmation pop-up.
Additional Functionality
Import/Export Bucket Tab
This tab allows you to navigate between the validation and change log sections, keeping import and change log actions separate.
How to Use:
Use the Bucket tab for the validation process.
Use the Change Log tab to access change log documentation.
Import/Export Initiate Validation
Description: This feature provides real-time error validation for your CSV before importing.
How to Use:
Upload your CSV for the desired entity.
The VALIDATE button displays if errors are present.
select VALIDATE to initiate the validation modal.
Selecting an Entity
This option allows you to select the entity type for importing.
How to Use:
Choose the entity type from the available options.
Conclusion
...
of all rows in a second prompt.
...