SUNScholar/Export and Import Artifacts

Introduction

This wiki help page assumes that you have used the three system setup procedures to install an Ubuntu server with DSpace software.

The functionality to export communities, whole collections and items using the XMLUI, only became available with DSpace versions => 1.7.0.

For older versions of DSpace please check the following procedures and instructions.

Determining Collection and Item ID's

Collection ID's are the ones that appear in the browser URL when you hover over the collection with a mouse. Check the URL for the full handle. The collection ID is shown after handle prefix, ie. If you have not registered with CNRI, the number that appears after 123456789/.

Help Info

/home/dspace/bin/dspace export

It takes the following parameters:

-i,--id            COLLECTION or ITEM ID
-t,--type          COLLECTION or ITEM
-d,--dest          Destination directory for exported artifacts
-n,--number        Sequence number to begin exporting artifacts with
-m,--migrate       Strips out any per-repository-specifics
-h,--help          Help

/home/dspace/bin/dspace import

It takes the following parameters:

 -a,--add           Add artifacts
 -d,--delete        Delete items listed in mapfile
 -r,--replace       Replace items in mapfile
 -e,--eperson       Email of eperson doing importing
 -s,--source        Source of exported items (directory)
 -c,--collection    Destination collection(s) Handle or Database ID
 -m,--mapfile       Mapfile artifacts in mapfile
 -w,--workflow      Send submission through collection's workflow
 -n,--notify        If sending submissions through the workflow, send
                    notification emails
 -p,--template      Apply template
 -t,--test          Test run - do not actually import items
 -R,--resume        Resume a failed import (add only)
 -h,--help          Help
 -q,--quiet         Don't display metadata
 -z,--zip           Name of zip file

adding items:                  ItemImport -a -e eperson -c collection -s sourcedir -m mapfile
adding items from zip file:    ItemImport -a -e eperson -c collection -s sourcedir -z filename.zip -m mapfile

replacing items:               ItemImport -r -e eperson -c collection -s sourcedir -m mapfile

deleting items:                ItemImport -d -e eperson -m mapfile

If multiple collections are specified, the first collection will be the one that owns the item.

References

• https://wiki.duraspace.org/display/DSDOC4x/Importing+and+Exporting+Items+via+Simple+Archive+Format
• https://wiki.duraspace.org/display/DSDOC3x/Importing+and+Exporting+Items+via+Simple+Archive+Format
• https://wiki.duraspace.org/display/DSDOC18/Importing+and+Exporting+Items+via+Simple+Archive+Format
• https://wiki.duraspace.org/display/DSDOC17/System+Administration#SystemAdministration-ItemImporterandExporter
• https://wiki.duraspace.org/display/GSOC/Google+Summer+of+Code+2008+Batch+Import
• http://tools.dspace.cam.ac.uk/metadatamapper
• https://github.com/checkraiser/csv2dspace

Command Line Help

Go to: http://www.ubuntu.sun.ac.za/wiki/index.php/SelfHelp for more help about the command line programs used in this procedure.

Back to Customisation