0.01
Low commit activity in last 3 years
A long-lived project that still receives updates
Pulls ContentDM metadata and object links into a CSV. Then allows you to upload that CSV into Hyrax for automatic ingest. The CSV intermediate step is to allow for data refining or upload to another system.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

~> 5.0
 Project Readme

CdmMigrator

This migrator is designed to export individual ContentDM collections to a CSV for refining. It then allows batch importing into Hyku/Hyrax via a CSV upload.

Installation

Add this line to your application's Gemfile:

gem 'cdm_migrator'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install cdm_migrator

Finally, run:

$ rails g cdm_migrator:install
$ rails db:migrate

to insert the yml and add a link to your Hyrax dashboard

Usage

  1. Add your ContentDM url and api port to the cdm_migrator.yml file.
  2. Configure the CSV Checker with the appropriate fields, paths, or multi-value separator (in cdm_migrator.yml).
  3. Navigate to the cdm_migrator/collection url to select your contentdm collection and what type of work you want to export it to and click "choose mappings".
  4. Map the ContentDM fields to your Hyrax work and file fields* and click "generate CSV".
  5. Refine the CSV as you see fit. Optional: go to cdm_migrator/csv_checker and upload it to validate metadata fields and/or file paths.
  6. Navigate to the cdm_migrator/upload url; choose your multi-value separator (default is |) and upload your CSV file.
  7. Done.

* cdm_migrator uses the generated Hyrax forms (ex. Hyrax::Forms::GenericWorkForm) in your host application to obtain it's terms for mapping. If you have added terms to your FileSet model extend the Hyrax::Forms::FileSetEditForm with Hyrax::FileSetForm in your host application so that the changes will be detected by the migrator. You can also add a list of fields in the yml file, under "default fields".

License

The gem is available as open source under the terms of the MIT License.