cgspace-java-helpers/README.md

49 lines
2.0 KiB
Markdown
Raw Normal View History

2020-08-03 13:32:31 +02:00
# DSpace Curation Tasks [![Build Status](https://travis-ci.org/alanorth/dspace-curation-tasks.svg?branch=master)](https://travis-ci.org/alanorth/dspace-curation-tasks)
2020-07-31 20:40:15 +02:00
Metadata curation tasks used on the [CGSpace](https://cgspace.cgiar.org) institutional repository:
2020-08-02 22:20:29 +02:00
- **CountryCodeTagger**: add ISO 3166-1 Alpha2 country codes to items based on their existing country metadata
2020-07-31 20:40:15 +02:00
Tested on DSpace 5.8. Read more about the [DSpace curation system](https://wiki.lyrasis.org/display/DSDOC5x/Curation+System).
## Build and Install
To build the standalone jar:
```
$ mvn package
```
Copy the resulting jar to the DSpace `lib` directory:
```
$ cp target/dspace-curation-tasks-1.0-SNAPSHOT.jar ~/dspace/lib/dspace-curation-tasks-1.0-SNAPSHOT.jar
```
## Invocation
Once the jar is installed and you have added appropriate configuration in `~/dspace/config/modules`:
```
$ ~/dspace/bin/dspace curate -t countrycodetagger -i 10568/3 -r - -l 500 -s object
```
_Note_: it is very important to set the cache limit (`-l`) and the database transaction scope to something sensible (`object`) if you're curating a community or collection with more than a few hundred items.
2020-07-31 20:40:15 +02:00
## Notes
This project was initially created according to the [Maven Getting Started Guide](https://maven.apache.org/guides/getting-started/):
```console
2020-08-02 22:52:12 +02:00
$ mvn -B archetype:generate -DgroupId=io.github.ilri.cgspace -DartifactId=dspace-curation-tasks -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4
2020-07-31 20:40:15 +02:00
```
## Todo
2020-08-01 20:56:36 +02:00
- Make sure this doesn't work on items in the workflow
- Port to DSpace 6
- Remember to bump Gson version!
2020-08-02 14:53:37 +02:00
- Check for existence of metadata field before trying to add metadata
- Add tests
2020-07-31 20:40:15 +02:00
## License
This work is licensed under the [GPLv3](https://www.gnu.org/licenses/gpl-3.0.en.html).
This repository contains data from the [Debian iso-codes project](https://salsa.debian.org/iso-codes-team/iso-codes) project, which is licensed under the [GNU Lesser General Public License v2.1](https://salsa.debian.org/iso-codes-team/iso-codes/-/blob/main/COPYING).