Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This comprehensive This guide will walk you through the features and functionalities of the Das admin Importer tool, designed to streamline the process of importing and managing data for various entities. As an admin, you'll learn how to locate the importer, understand each section's the importers functionality, and ensure the quality of your imported data. Let's dive in!

...

Using the Importer

Locating the Importer

The Importer tool is your gateway to efficiently importing and managing data. To access it, follow these steps:

  1. From the Das admin left side navigation menu.

  2. 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:

...

Using the import tab

  1. Choose the content you are going to upload from from the dropdown menu.

  2. Drag and Drop drop the CSV file or select the drop zone to use use your file locator to upload.

...

Info

Missing required or unrecognized fields prompts

The Importer’s Validation Wizard notifies you of missing required fields or unrecognized columns in your CSV uploads. It guides you to

...

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 will not be included in the import them from your import.

...

edit and re-upload your CSV for successful import.

  • After uploading a CSV with unrecognized columns, a prompt warns you that there are columns that are not recognized and they will not be included in your import.

    • Additional instruction advise you that can discard your upload, fix your CSV and try again.

  • A similar prompt guides you to update your CSV if there are required columns missing.

    • When required fields are missing, the import will not upload the CSV, instead additional instructions advise you that you must update your CSV and try again.

...

  1. Upon selecting a valid CSV file, the VALIDATE button will appear

...

  1. .

  2. If there are no errors in

...

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.

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

  1. Log in to your vNext platform account.

  2. Navigate to the Admin or Management section.

  3. Locate and select the "vNext Importer" tool.

Uploading the CSV File

  1. In the vNext Importer tool, click on the "Upload CSV" button.

  2. Select the CSV file containing the course information from your local device.

  3. Click "Open" to upload the file.

Review and Edit Errors

  1. Once the CSV file is uploaded, the tool will automatically validate the data.

  2. Errors will be highlighted in real-time, allowing you to see what needs to be edited.

  3. 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:

  1. Select the Lessons entity from the dropdown menu.

  2. Upload your CSV file with lesson information.

  3. 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.

...

  1. the CSV, the button will change to PUBLISH.

  2. Click PUBLISH to finalize the import whenever the button is available.

Real-time validation and editing

When errors that are not missing required columns are present in your CSV upload the Validation Wizard allows you to update them and clear the errors in real-time. The Validate button appears when there are errors within your columns that you can correct before importing.

  1. Select the VALIDATE button to open the validation wizard.

...

Info
  • The Validation Wizard displays CSV rows with errors highlighted in red, enabling real-time adjustments.

  • Edit fields with errors in real-time and the red border and error status will disappear once entries become valid.

  • Use the Previous and Next buttons to navigate between rows with errors.

  • A dropdown menu also allows you to navigate and edit any CSV row.

...

Additional functionality

Discarding and starting over

  1. Once a CSV is uploaded, the DISCARD button will appear.

  2. Select DISCARD to remove the uploaded CSV from the drop zone.

  3. The Validate/Publish buttons will no longer be displayed.

  4. Follow the provided directions to proceed with a new CSV upload.

...

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:

  1. Navigate to the Change Log tab.

  2. Each successful import generates a new change log entry.

  3. Date, time, user email, type of download, and status are displayed.

  4. 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:

  1. After uploading a CSV, a pop-up warns if columns are unrecognized.

  2. The pop-up text provides instructions for updating and re-uploading the CSV.

  3. A similar pop-up guides you to update the CSV for missing required fields.

  4. 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.

...

  1. For inline deletion, select rows and choose Delete Selection.

  2. In the Validation Wizard, use Delete Item to delete the current row.

  3. Use the Delete All Items With Errors button to remove all rows with errors.

  4. 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:

  1. If errors are present, the PUBLISH button is not visible.

  2. The VALIDATE button appears instead for error-checking.

  3. When errors are absent, the PUBLISH button becomes visible.

  4. 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:

  1. Use the Bucket tab for the validation process.

  2. 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:

  1. Upload your CSV for the desired entity.

  2. The VALIDATE button displays if errors are present.

  3. select VALIDATE to initiate the validation modal.

Selecting an Entity

This option allows you to select the entity type for importing.

How to Use:

  1. Choose the entity type from the available options.

Conclusion

...

  1. of all rows in a second prompt.

...