Difference between revisions of "SUNScholar/Export and Import Artifacts"

From Libopedia
Jump to navigation Jump to search
Line 31: Line 31:
 
It takes the following parameters:
 
It takes the following parameters:
 
<pre>
 
<pre>
−
-s,--source              source collection directory/folder
+
-t,--test          test run - do not actually import items
−
-c,--collection       destination collection handle
+
-R,--resume        resume a failed import (add only)
−
-e,--eperson           email of authorised person
+
-a,--add          add items to DSpace
−
-m,--mapfile           collection/item map file name
+
-c,--collection   destination collection(s) Handle or database ID
−
-a,--add                  add items
+
-d,--delete        delete items listed in mapfile
−
-d,--delete              delete items listed in mapfile
+
-e,--eperson       email of eperson doing importing
−
-r,--replace             replace items listed in mapfile  
+
-h,--help          help
−
-w,--workflow       send submission through collection's workflow
+
-m,--mapfile       mapfile items in mapfile
−
-p,--template        apply template
+
-n,--notify        if sending submissions through the workflow, send
−
-t,--test                    test run - do not actually import items
+
                    notification emails
−
-R,--resume            resume a failed import (add only)
+
-p,--template      apply template
−
-h,--help                  help
+
-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.
 
</pre>
 
</pre>
  

Revision as of 09:40, 9 May 2013

Template:SUNScholar

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

Step 1. Export on the old server

Step 2. Import on the new server

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

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
Retrieved from "http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Export_and_Import_Artifacts&oldid=18713"