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:

-d,--dest          destination collection directory
-h,--help           help
-i,--id                 collection/item ID
-n,--number    sequence number to begin exporting items with
-m,--migrate   strips out any per-repository-specifics
-t,--type           type: COLLECTION or ITEM

/home/dspace/bin/dspace import

It takes the following parameters:

 -t,--test          test run - do not actually import items
 -R,--resume        resume a failed import (add only)
 -a,--add           add items to DSpace
 -c,--collection    destination collection(s) Handle or database ID
 -d,--delete        delete items listed in mapfile
 -e,--eperson       email of eperson doing importing
 -h,--help          help
 -m,--mapfile       mapfile items in mapfile
 -n,--notify        if sending submissions through the workflow, send
                    notification emails
 -p,--template      apply template
 -q,--quiet         don't display metadata
 -r,--replace       replace items in mapfile
 -s,--source        source of items (directory)
 -w,--workflow      send submission through collection's workflow
 -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/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
• http://www.dspace.org/1_6_2Documentation/ch08.html#N159FE
• http://www.dspace.org/1_5_2Documentation/ch09.html#N13795
• 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