Versions Compared

Old Version 5

changes.mady.by.user Tim Donohue

Saved on

compared with

New Version Current

changes.mady.by.user Robin Taylor

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Removed an incorrect slash from an example

Batch Metadata Editing

Table of Contents
minLevel2
outlinetrue
stylenone

Batch Metadata Editing Tool

DSpace provides a batch metadata editing tool. The batch editing tool is able to produce a comma delimited file in the CVS CSV format. The batch editing tool facilitates the user to perform the following:

...

The following table summarizes the basics.

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="9cfa63eb-0eaf-4103-9a6c-d73c8ce8b373"><ac:plain-text-body><![CDATA[

Command used:

[dspace]/bin/dspace metadata-export]]></ac:plain-text-body></ac:structured-macro>

Java class:

org.dspace.app.bulkedit.MetadataExport

Arguments short and (long) forms):

Description

-f or --file

Required. The filename of the resulting CSV.

-i or --id

The Item, Collection, or Community handle or Database ID to export. If not specified, all items will be exported.

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="66fa40ee-f6d8-4684-afd6-e095b1b34a53"><ac:plain-text-body><![CDATA[-a or --all

Include all the metadata fields that are not normally changed (e.g. provenance) or those fields you configured in the [dspace]/config/modules/bulkedit.cfg to be ignored on export.

]]></ac:plain-text-body></ac:structured-macro>-h or --help

Display the help page.

...

In the above example we have requested that a collection, assigned handle '1989.1/24' export the entire collection to the file 'col_14.cvscsv' found in the '/batch_export' directory.

...

The following table summarizes the basics.

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="0fb8aef3-20e3-4c06-a6d4-fb9dc1a35072"><ac:plain-text-body><![CDATA[

Command used:

[dspace]/bin/dspace metadata-import]]></ac:plain-text-body></ac:structured-macro>

Java class:

org.dspace.app.bulkedit.MetadataImport

Arguments short and (long) forms:

Description

-f or --file

Required. The filename of the CSV file to load.

-s or --silent

Silent mode. The import function does not prompt you to make sure you wish to make the changes.

-e or --email

The email address of the user. This is only required when adding new items.

-w or --workflow

When adding new items, the program will queue the items up to use the Collection Workflow processes.

-n or --notify

when adding new items using a workflow, send notification emails.

-t or --template

When adding new items, use the Collection template, if it exists.

-h or --help

Display the brief help page.

...

Code Block
[dspace]/bin/dspace/ metadata-import -f /dImport/new_file.csv -e joe@user.com -w -n -t

...

The csv files that this tool can import and export abide by the RFC4180 CSV formathttp://www.ietf. org/rfc/rfc4180.txt. This means that new lines, and embedded commas can be included by wrapping elements in double quotes. Double quotes can be included by using two double quotes. The code does all this for you, and any good csv editor such as Excel or OpenOffice will comply with this convention.

...

If you want to store multiple values for a given metadata element, they can be separated with the double-pipe '||' (or another character that you defined in your _modules/bulkedit.cfg _ file. For example:

Code Block
Horses||Dogs||Cats

...

  1. 'expunge' This permanently deletes an item.  Use with care!  This action must be enabled by setting 'allowexpunge = true' in modules/bulkedit.cfg
  2. 'withdraw' This withdraws an item from the archive, but does not delete it.
  3. 'reinstate' This reinstates an item that has previously been withdrawn.

...