Skip to content

Latest commit

 

History

History
39 lines (28 loc) · 2.79 KB

README.md

File metadata and controls

39 lines (28 loc) · 2.79 KB

islandora_multi_importer

DCMNY admin documentation

[Multi-Importer Admin Instructions for DCMNY Administrators] (https://docs.google.com/document/d/18oB6sX-8s6sIScgUf7RbkFFlJ52Y9k_f9FcsaWvDJ7s/edit?usp=sharing)

[Sample CSV (configured for multi-importer ingest)] (https://drive.google.com/file/d/0BzuVASmQStk8dWJ6UGt6bmphcGs/view?usp=sharing)

[DCMNY Metadata Spreadsheet (for use with multi-importer ingest)] (https://docs.google.com/spreadsheets/d/1fL9oO_x35tUx3wKSZ4a848ravc4Oh1Wjk5ykU3H1Ti8/edit?usp=sharing)

Installation

  • Ensure that composer is installed in your enviornment: composer version.
  • Clone the module into the modules folder: git clone https://github.com/mnylc/islandora_multi_importer
  • Install the module's dependency using the composer composer install
  • Ensure that you have all the module's drupal dependencies (ex Field Group)
  • Enable the module

Twig

[Sample Twig Templates (for use with multi-importer ingest)] (https://github.com/mnylc/dcmny/tree/master/twig)

[Twig Documentation] (http://twig.sensiolabs.org/documentation)

Why Use Multi-importer

  • UI driven integrated workflow for ingest and update
  • Metadata Cleanup: Export your MODS metadata as CSV via Solr, clean up, then update the MODS datastream of the objects by recreating the MODS datastream using Twig
  • To ingest different content types at the same time including hierarchies, like collections inside collections with compounds and books, etc
  • To avoid having to follow strict naming conventions and folder structure dictated by many Islandora batch ingest processes
  • Selectively choose which derivatives you want to create and upload
  • To avoid the OpenRefine/XSLT approach to creating MODS from CSVs
  • To take advantage of the Twig Templating system for creating MODS from CSVs
  • To preview the MODS output easily
  • Supports integration with Google Spreadsheets, Zip/Local/Amazon storage and Complex storage needs via hooks.
  • Added Jasny Pcre Extension. Twig templates can now support regular expressions. Be mindful of needing doubly escaped backslashes in situations that require regex with backslashes.

Updating existing Objects

  • To enable this functionality without any warnings you need to use https://github.com/mnylc/islandora_batch/tree/7.x-ISLANDORA-2046 instead of main Islandora Batch release. We are working on making those changes into the main release.
  • Objects (PIDs) present in other Batch Sets won't be able to be updated because Islandora Batch only allows a single PID to exist in its DB. We are working on fixing that inside 7.x-ISLANDORA-2046. For now, please delete old batch sets if you plan on updating existing Objects that were ingested using Islandora Batch.