{"id":47630892,"url":"https://github.com/harvard-library/aspace-import-excel","last_synced_at":"2026-04-01T23:28:35.309Z","repository":{"id":74988199,"uuid":"79478632","full_name":"harvard-library/aspace-import-excel","owner":"harvard-library","description":"Import resources, archival objects, etc. into ArchivesSpace using Excel spreadsheet files","archived":false,"fork":false,"pushed_at":"2020-06-25T15:44:12.000Z","size":2435,"stargazers_count":42,"open_issues_count":12,"forks_count":10,"subscribers_count":26,"default_branch":"main","last_synced_at":"2024-06-11T17:30:14.691Z","etag":null,"topics":["archivesspace","bulk-upload","spreadsheet"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/harvard-library.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-01-19T17:44:34.000Z","updated_at":"2024-03-28T19:21:45.000Z","dependencies_parsed_at":null,"dependency_job_id":"dd3ef53b-bf76-4c1c-befb-e6699fcc56d0","html_url":"https://github.com/harvard-library/aspace-import-excel","commit_stats":null,"previous_names":[],"tags_count":55,"template":false,"template_full_name":null,"purl":"pkg:github/harvard-library/aspace-import-excel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harvard-library%2Faspace-import-excel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harvard-library%2Faspace-import-excel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harvard-library%2Faspace-import-excel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harvard-library%2Faspace-import-excel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/harvard-library","download_url":"https://codeload.github.com/harvard-library/aspace-import-excel/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harvard-library%2Faspace-import-excel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31292927,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["archivesspace","bulk-upload","spreadsheet"],"created_at":"2026-04-01T23:28:34.676Z","updated_at":"2026-04-01T23:28:35.298Z","avatar_url":"https://github.com/harvard-library.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# aspace-import-excel\r\nAn [ArchivesSpace ](http://archivesspace.org/) [plugin](https://github.com/archivesspace/tech-docs/blob/master/customization/plugins.md) to support the bulk uploading via Excel SpreadSheet of Archival Objects and (optionally) their associated Creator Agents, Top Containers, Subjects, Digital Objects etc.\r\n\r\nAlso supports the import 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.\r\n\r\n## Current Version\r\n\r\n  For versions of ArchivesSpace **before** v2.2.2:  [v1.7.8](https://github.com/harvard-library/aspace-import-excel/releases/tag/v1.7.8)\r\n\r\n   **NOTE**: v1.7.8 does *not* support the creation of Digital Objects to be associated with already-created Archival Objects.\r\n\r\n  For ArchivesSpace **v2.2.2 and higher**:  [v3.0.2](https://github.com/harvard-library/aspace-import-excel/releases/tag/v3.0.3)\r\n\r\n## Development\r\n\r\nThis plugin supports interactive selection of an archival object (or resource) as the starting point of the bulk upload.\r\n\r\nVersion 3.0 incorporates new functionality for uploading archival objects (described in the [user documentation](user_documentation/archival_objects_instructions.md)), which supports the use of an [expansion](templates/extended_aspace_import_excel_template.xlsx) to the [original](templates/aspace_import_excel_template.xlsx) Excel template.  Version 3.0 is, however, backward compatible, so that users whose workflow is satisfied with the original template can continue to use it.\r\n\r\n### Bulk upload/creation of Archival Objects\r\n\r\nThe Excel templates will be found in the templates/ folder as\r\n *  *New in V3.0*: [**extended_aspace_import_excel_template**](templates/extended_aspace_import_excel_template.xlsx)\r\n\r\n * [**aspace_import_excel_template.xlsx**](templates/aspace_import_excel_template.xlsx).\r\n\r\nThe 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 assignment of locations to top-level containers) would take place interactively.\r\n\r\nSee the [user documentation](user_documentation/USER_DOCUMENTATION.md) for more information.\r\n\r\n### Bulk upload/creation of Digital Objects associated with already-created Archival Objects\r\n\r\n**This functionality is turned on by default** See the \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e instructions for turning it off.\r\n\r\nThe Excel template will be found in the templates/ folder as [**aspace_import_excel_DO_template.xlsx**](templates/aspace_import_excel_DO_template.xlsx).\r\n\r\nAs 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:\r\n  + File with an *Xlink Actuate Attribute* of **onLoad** and an *Xlink Show Attribute* of **embed**\r\n  + File with an Xlink Actuate Attribute of **onRequest** and an *Xlink Show Attribute* of **new**\r\n\r\nSee the [user documentation](user_documentation/USER_DOCUMENTATION.md) for more information.\r\n\r\n\r\n\r\n## \u003ca name=\"install\"\u003eInstallation\u003c/a\u003e\r\n\r\nThis is a regular  [ArchivesSpace Plug-in](https://github.com/archivesspace/tech-docs/blob/master/customization/plugins.md).\r\n\r\nTo install this plug-in:\r\n1.  Either clone this plugin, or download the latest version:\r\n    - Clone the plug-in from this [GitHub repository](https://github.com/harvard-library/aspace-import-excel) into the ArchivesSpace **/plugins/** directory.\r\n    - Download the zipfile of the  appropriate version: see [Current Versions](#current_versions) for links to the appropriate release download. Unzip the download into the **/plugins/** directory.  You will probably need to rename the top folder/directory to **aspace-import-excel**.\r\n\r\n2. (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\r\n```bash\r\n    AppConfig[:hide_do_load] = false\r\n```\r\nto\r\n```bash\r\n    AppConfig[:hide_do_load] = true\r\n```\r\n3. **IF** you are running, on Windows, a version of ArchivesSpace that is *lower* than version **2.6.0**:\r\n\r\n     There was a problem with Bundler versioning.\r\n\r\nCopy\r\n```\r\narchivesspace\\aspace-import-excel\\extras\\modified_initialize-plugin.bat\r\n```\r\nto\r\n```\r\narchivesspace\\scripts\r\n```\r\n\r\n  **UPDATE**: You no longer need to use this modified .bat script **if** you are running ArchivesSpace 2.6.0 or higher.\r\n\r\n\r\n4. Run the initializer script:\r\n   * for Linux, that's\r\n   ```bash\r\n   scripts/initialize-plugin.sh aspace-import-excel\r\n   ```\r\n   * for Windows, running an ArchivesSpace version **lower than 2.6.0** ,that's\r\n   ```\r\n   scripts\\modified_initialize-plugin.bat aspace-import-excel\r\n   ```\r\n   Otherwise, for Windows running ArchivesSpace version **2.6.0** and higher:\r\n   ```\r\n   scripts\\initialize-plugin.bat aspace-import-excel\r\n   ```\r\n\r\n\r\n5. In the **common/config/config.rb** file, add 'aspace-import-excel' to the `AppConfig[:plugins]` array.\r\n6. Stop and restart ArchivesSpace\r\n\r\n### Why we don't include a Gemfile.lock in this repository\r\n\r\nWe have found that when we include a `Gemfile.lock` file in our plugin, some sites have found that, after initializing the plugin and trying to restart ArchivesSpace, they get errors like this:\r\n```bash\r\n[!] There was an error parsing Gemfile: You cannot specify the same gem twice with different version requirements.\r\nYou specified: rubyzip (~\u003e 1.2.2) and rubyzip (= 1.0.0). Bundler cannot continue.\r\n```\r\n\r\nThis problem does not seem to occur when the `Gemfile.lock` is created through the initialization instead.\r\n\r\n\r\n\r\n## User Documentation\r\n\r\nUser documentation is [available](user_documentation/USER_DOCUMENTATION.md)\r\n\r\n## Contributors\r\n\r\n* Bobbi Fox: [@bobbi-SMR](https://github.com/bobbi-SMR) (maintainer)\r\n* Robin Wendler: [@rwendler](https://github.com/rwendler)\r\n* Julie Wetherill: [@juliewetherill](https://github.com/juliewetherill)\r\n* Adrienne Pruitt: [@adriennepruitt2](https://github.com/adriennepruitt2)\r\n* Dave Mayo: [@pobocks](https://github.com/pobocks)\r\n* h/t to Chintan Desai: [@cdesai-qi](https://github.com/cdesai-qi) for catching inconsistencies\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharvard-library%2Faspace-import-excel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fharvard-library%2Faspace-import-excel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharvard-library%2Faspace-import-excel/lists"}