Contribute to the DSpace Development Fund
The newly established DSpace Development Fund supports the development of new features prioritized by DSpace Governance. For a list of planned features see the fund wiki page.
Community and Collection Structure Importer
This Command-Line tool gives you the ability to import a community and collection structure directory from a source XML file.
Usage
Command used: |
|
Java class: |
|
Argument: short and long (if available) forms: | Description of the argument |
-f | Source xml file. The presence of this argument engages import mode. |
-o | Output xml file. Required. A copy of the input augmented with the Handles assigned to each new Community or Collection. |
-e | Email of DSpace Administrator. Required. |
XML Import Format
The administrator need to build the source xml document in the following format:
<import_structure> <community> <name>Community Name</name> <description>Descriptive text</description> <intro>Introductory text</intro> <copyright>Special copyright notice</copyright> <sidebar>Sidebar text</sidebar> <community> <name>Sub Community Name</name> <community> ...[ad infinitum]... </community> </community> <collection> <name>Collection Name</name> <description>Descriptive text</description> <intro>Introductory text</intro> <copyright>Special copyright notice</copyright> <sidebar>Sidebar text</sidebar> <license>Special licence</license> <provenance>Provenance information</provenance> </collection> </community> </import_structure>
The resulting output document will be as follows:
<import_structure> <community identifier="123456789/1"> <name>Community Name</name> <description>Descriptive text</description> <intro>Introductory text</intro> <copyright>Special copyright notice</copyright> <sidebar>Sidebar text</sidebar> <community identifier="123456789/2"> <name>Sub Community Name</name> <community identifier="123456789/3"> ...[ad infinitum]... </community> </community> <collection identifier="123456789/4"> <name>Collection Name</name> <description>Descriptive text</description> <intro>Introductory text</intro> <copyright>Special copyright notice</copyright> <sidebar>Sidebar text</sidebar> <license>Special licence</license> <provenance>Provenance information</provenance> </collection> </community> </import_structure>
This command-line tool gives you the ability to import a community and collection structure directly from a source XML file. It is executed as follows:
[dspace]/bin/dspace structure-builder -f /path/to/source.xml -o path/to/output.xml -e admin@user.com
This will examine the contents of source.xml, import the structure into DSpace while logged in as the supplied administrator, and then output the same structure to the output file, but including the handle for each imported community and collection as an attribute.
Community and Collection Structure Exporter
This command-line tool writes the current Community and Collection structure into an XML document in the format which is read by the importer. See above for format details.
Usage
[dspace]/bin/dspace structure-builder [-h] [-?] -x -e <eperson> -o <output>
Argument: short and long (if available) forms: |
|
---|---|
-x, --export | Export the current structure as XML. The presence of this argument engages export mode. |
-e, --eperson email or netid | User who is manipulating the repository's structure. Required. This user's rights determine access to communities and collections. |
-o, --output file path | The exported structure is written here. Required. |
-h or -? | Help |