Import/Export

The Import/Export feature allows users to export SD Elements Library content to the format of their choosing. Refer to the help documentation in the Help tab from the Library > Import/Export page for a list of supported content types to import and export. Use this for bulk actions on Library items by exporting SD Elements content as files, modifying them, and then reimporting them. In addition, a full library can be downloaded as an export-only ZIP file.

Note
 You cannot delete library content items through a library import. You can create new items and change existing items when appropriate, but you can never delete existing items.

File format

Supported formats for the import/export feature are:

  • xlsx (Excel) (Recommended when opening in Microsoft Excel. Note that Excel automatically truncates large files upon import.)

  • csv (Comma Separated Values format)

  • json (JavaScript Object Notation format)

  • yaml (Yet Another Markup Language format)

The full library export-only format is available as:

  • ZIP (Compressed file format)

Download full library in export-only format

Export the SD Elements content library for backup or to help with tracking changes. Follow the steps below to trigger an export:

Prerequisites:

  • The user has the permission Global role→Customization→Customize content.

Steps:

  1. Click Library→Tasks.

  2. Select the Export [file download] icon.

    library export diffable format.png

  3. Click Download.

The downloaded ZIP file contains low-level details about content (amendments, how-to’s, problems, survey, and tasks) including match conditions.

Export template/file structure

Use a content template as a basis for importing content to the system. To retrieve the template, follow the steps below:

Prerequisites:

  • The user has the permission Global role→Customization→Customize content.

Steps:

  1. Click Library→Import/Export.

  2. Select the Export tab.

  3. Under Templates, select the Empty option.

  4. Select a File Type.

  5. Click Export.

The template defines the headers you require, as illustrated below:

image

Export all content

Export the SD Elements content library for offline reading, making a backup, or modifying and reimporting it. Follow the steps below to trigger an export:

Prerequisites:

  • The user has the permission Global role→Customization→Customize content.

Steps:

  1. Click Library→Import/Export.

  2. Select the Export tab.

  3. Under Templates, select the All Data option.

  4. Select a File Type.

  5. Click Export.

Export specific content

Only export the content of Tasks, Problems, or Glossary items.

Prerequisites:

  • The user has the permission Global role→Customization→Customize content.

Steps:

  1. Click on one of the following:

    • Library→Tasks to export Tasks.

    • Library→Problems to export Problems.

    • Library→Glossary to export Glossary items.

  2. Select the Export tab.

  3. Under Templates, select the All Data option.

  4. Select a File Type.

  5. Click Export.

The library content you select is then exported in the format of your choosing.

Export specific content template

Use a content template as a basis for importing specific content to the system. Supported types are Tasks, Problems, and Glossary items. To retrieve a template, follow the steps below:

Prerequisites:

  • The user has the permission Global role→Customization→Customize content.

Steps:

  1. Click on one of the following:

    • Library→Tasks.

    • Library→Problems.

    • Library→Glossary.

  2. Select the Export tab.

  3. Under Templates, select the All Data option.

  4. Select a File Type.

  5. Click Export.

The file template content you select is then exported in the format of your choosing.

Import content

Submit bulk changes to the content library using the import function. Up to 5 files are supported in a single import.

Prerequisites:

  • The user has the permission Global role→Customization→Customize content.

Steps:

  1. Click on Library→Import/Export.

  2. Select the Import tab.

    image

  3. Click Choose File and select the .xlsx or .csv file containing your changes. If you have up to 5 files, click on Choose File and select each one.

  4. Click Import.

  5. Review the changes detected by the system.

    • New content will be displayed in green, and any old content (that will be overwritten) is displayed in red.

    • Only new or updated rows will be displayed.

      image

  6. Apply the changes by clicking Accept. Otherwise, click Cancel to abandon the import.

Warning
 Review the changes carefully. You cannot reverse an import once you apply it.

Troubleshooting

An error will be displayed if you import an unsupported file. For example:

image
Solution:

  1. Make any required changes to the file.

  2. Click Close.

  3. Restart the import process with the updated file.

results matching ""

    No results matching ""