Smithsonian/aspace-import-excel

Name: aspace-import-excel

Owner: Smithsonian Institution

Description: Import resources, archival objects, etc. into ArchivesSpace using Excel spreadsheet files

Forked from: harvard-library/aspace-import-excel

Created: 2018-03-05 21:39:22.0

Updated: 2018-03-05 21:39:24.0

Pushed: 2018-03-09 02:16:01.0

Homepage:

Size: 2134

Language: JavaScript

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

aspace-import-excel

An ArchivesSpace plugin to support the bulk uploading via Excel SpreadSheet of Archival Objects and (optionally) their associated Creator Agents, Top Containers, Subjects, Digital Objects etc.

Also supports the inport of spreadsheets that will allow for the creation of Digital Objects to be associated with already-created Archival Objects for Version 2.2.2 and higher of ArchiveSpace.

Current Version

For versions of ArchivesSpace before v2.2.2: v1.7.8 Note: This version does not support the creation of Digital Objects to be associated with already-created Archival Objects.

For ArchivesSpace v2.2.2 and higher: v2.1.5

Development

The initial version supports interactive selection of an archival object (or resource) as the starting point of the bulk upload.

Bulk upload/creation of Archival Objects

The Excel template will be found in the templates/ folder as aspace_import_excel_template.xlsx.

The intention is not to completely reproduce a Finding Aid as presented in an EAD XML, or to allow for every permutation of Archival Object creation within ArchivesSpace. We are aiming for the “80% rule”; that is, at least 80% of the work that would be done interactively can be replaced by an excel spreadsheet; additional refinements to individual archival objects (such as addition of agents-as-subjects, assignment of locations to top-level containers, etc.) would take place interactively.

See the user documentation for more information.

Bulk upload/creation of Digital Objects associated with already-created Archival Objects

This functionality is turned on by default See the Installation instructions for turning it off.

The Excel template will be found in the templates/ folder as aspace_import_excel_DO_template.xlsx.

As with the original development, we are not completely reproducing all the functionality of ArchivesSpace: only one Digital Object, which can have either or both of one:

See the user documentation for more information.

Installation

This is a regular ArchivesSpace Plug-in.

To install this plug-in:

  1. Download or clone the plug-in from this GitHub repository into the ArchivesSpace /plugin/ directory.

  2. (Optional) To turn off the functionality for creating Digital Objects associated with already-created Archival objects, you must edit /plugin/aspace-import-excel/frontend/plugin_init.rb. Change the line

    onfig[:hide_do_load] = false
    

    to

    onfig[:hide_do_load] = true
    
  3. Run the scripts/initialize-plugin script

  4. for Linux, that's scripts/initialize-plugin.sh aspace-import-excel

  5. for Windows, that's scripts/initialize-plugin.bat aspace-import-excel

  6. In the common/config/config.rb file, add 'aspace-import-excel' to the AppConfig[:plugins] array.

  7. Stop and restart ArchivesSpace

User Documentation

User documentation is available

Contributors

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.