Skip to content

Latest commit

 

History

History
291 lines (241 loc) · 54.8 KB

README.md

File metadata and controls

291 lines (241 loc) · 54.8 KB

Awesome ArchivesSpace

ArchivesSpace is an open source, web application for managing archives information. The application is designed to support core functions in archives administration such as accessioning; description and arrangement of processed materials including analog, hybrid, and born-digital content; management of authorities (agents and subjects) and rights; and reference service. The application supports collection management and functions as a metadata authoring tool.

What is this list?

Awesome ArchivesSpace is an awesome list. It points to resources (code, blog posts, anything with a URL, really) regarding ArchivesSpace created by the community that are dispersed around the web. Resources are loosely categorized by broad topic.

The intended audience for the list is those who have decided to adopt or have already implemented ASpace, both ASpace members and non-members, and need some help on where to go next in a specific area.

This list is not intended to be an exhaustive roadmap to ArchivesSpace implementation, but more as a "resource guide". Inclusion on the list is not an endorsement of any kind.

Table of Contents

Contributing to the list

Please help us continue to collect and add relevant sources to Awesome ArchivesSpace. See the Contributing Guidelines for information on how to update this page.

Awesome ArchivesSpace was initially populated with three categories of resources: Migrations, Plug-ins, and Integrations. Through that work, additional categories of interest were identified: Implementation, Scripts, and Trainings and Documentation. We encourage the ArchivesSpace community to add links to these categories as well as welcome new category suggestions.

Not seeing what you need?

Here are some other helpful links:

Ownership and credits

The ArchivesSpace community has ownership over Awesome ArchivesSpace. TAC Vice Chair has responsibility for the ongoing maintenance of the list which includes: responding to all pull requests, monitoring the ASpace user group listserv for new content and adding it to the list, taking care of any administrative issues, and initiating an in-depth review of the list by TAC as needed with a minimum recommendation of every two years. Please reach out to the TAC Vice Chair if you have any further questions or suggestions that cannot be handled via a pull request or issue.

Awesome ArchivesSpace was initially populated by the Awesome ArchivesSpace Ad Hoc Working Group, under the aegis of the Technical Advisory Council, in 2018. The working group was comprised of: Justin Dalton, Christina Luers, Anne Marie Lyons, and Maggie Hughes.

Migrations

The links below relate to ArchivesSpace migration projects. Resources are loosely grouped by the systems or tools organizations were coming from when migrating to ArchiveSpace. Some links may appear in multiple categories.

Any legacy database

Links that can be useful for any legacy database:

Archivists' Toolkit

Archon

Re:Discovery

  • Yale University ArchivesSpace Migration:
  • Migration Scripts (University of Denver): Migration scripts from Re:Discovery to ArchivesSpace.

EAD or Homegrown database

If you are migrating from EAD or a Home Grown database, you may find these links useful:

Plug-ins

The links below relate to ArchivesSpace plug-in projects. Resources are loosely grouped by whether the plug-in involves importing or exporting data, searching, administration, authentication, and additional front-end and back-end functionality. Some links may appear in multiple categories.

Import/Export Data

  • Plugins and Scripts from UNLV (University of Nevada, Las Vegas Libraries): Includes plugins to use custom PDFs for different repositories, customization of the default MARCXML export, spawn a number of accession records at once into resource records, and an overlay function that that allows for more granular record merging.
  • Harvard ASpace Excel Import plugin (Harvard Library): Supports the bulk uploading via Excel Spreadsheet of Archival Objects and (optionally) their associated Creator Agents, Top Containers, Subjects, Digital Objects, etc.
  • Import Agent Records with LCNAF Import Plug-in (ArchivesSpace): Information from the ArchivesSpace membership documentation about creating agent records using the Library of Congress Name Authority File plugin.
  • ArchivesSpace @ NYU: Local Development (New York University): Provides information and access to locally-developed plugins, including an EAD export customization plugin, a plugin for location management (pre-ArchivesSpace v.1.5.0), a MARC record export plugin, and a digitization work order plugin and digital object creation tool.
  • MOMA EAD Importer (Brian Hoffman): Custom ArchivesSpace EAD Importer for MOMA EADs. Theses customizations are specific to version 1.0.9 of ArchivesSpace and may not work with later versions.
  • Yale EAD Exporter Plugin Example (Developer house at code4lib 2015): It shows how to tweak the EAD converter. In this example, Yale wanted to add container barcode_1 to the EAD container @label attribute with the convention of "LABEL BARCOD" (e.g., "text 1234").
  • OCLC Import (Hudson Molonglo): Search OCLC records and choose which ones to import into ArchivesSpace as Accession records.
  • Custom MARC Exporter (Lora Woodford): Sample custom MARC exporter demonstrated at the 2018 Code4Lib pre-conference workshop. Enables customizations to MARC exporter for country codes, descriptive cataloging forms, cataloging sources, dates, and locations.

Search

  • NCSU Search Title Boost (NCSU Libraries): Boosts exact matches on title field - improves precision of search queries from linked record fields (linked agents, subjects, etc.). Note that this functionality can now be implemented by customizing the Solr parameters via the ArchivesSpace config file.
  • Search Identifier plugins:
    • Search Identifier (Duke University Libraries): Adds the identifier column to search and advanced search results pages for a number of different records.
    • Search Identifier (LYRASIS): Adds an identifier column to search and advanced search results pages in the staff interface.
    • ArchivesSpace Advanced Search Extension (Hudson Molonglo): This is an ArchivesSpace plugin to extend the advanced search to index and allow searching on a series of record fields as specified by Yale University.

Administration

Authentication

Additional Back-end Functionality

  • NCSU Delete Button Context Plugin (NCSU Libraries): Changes the label on the 'Delete' button in the record toolbar to indicate the type of record being deleted.
  • Payments Module (Hudson Molonglo): Payments subrecord for accession records.
  • Alma/ArchivesSpace Integrations Plugin (University of Denver): Based on the resource record provided by the user, this integration will perform API calls to check for a BIB with the Resource's MMS ID, check for holdings associated with the BIB identified by that MMS ID, and add new holdings. If no MMS ID is present, a new BIB will be created. Additionally, users can sync changes to a Resource in ArchivesSpace. Built on the Top Container functionality.
  • Generating Accession identifiers:
    • Custom Accession Identifiers (Brian Hoffman): Creating custom accession identifiers. Users with "Manage Repository" permissions will see a new menu item in the Repository settings menu (click the gear icon to the right of the selected repository). Use the "Department Codes" setting to add and remove codes for your Repository. Department codes will appear in a dropdown for the second part of the Accession identifier. The first and third sections of the identifier will be system-generated upon saving the record. The fourth section will be removed.
    • Custom Accession Identifiers (University of Virginia, forked from Yale/Hudson Molonglo plugin): This is a modification of the original generate-accession-identifiers plugin with two significant differences.
    • Next Resource Identifier plugin (University of Denver Libraries): ArchivesSpace plugin to determine the next collection number in a sequence.
  • University of Denver's local ArchivesSpace plugins (University of Denver Libraries): Includes branding; extending the resource_tree content model to display the component IDs in the third column, for easier tree navigation for our archivists; extending the public search result summary to provide additional metadata about Resources, Archival Objects, and Digital Objects; adding rows to the component toolbar for Archival Objects to allow for MODS export and linking to digital objects.
  • Timewalk plug-in (Alex Duryee): An automated date parser plugin for ArchivesSpace.
  • ArchivesSpace Assets Reroute Plugin (Mark Triggs, Hudson Molonglo): This is a plugin to reroute the Rails asset pipeline in the ASpace frontend and public UI to use plugin assets. It's specifically designed to allow plugin assets to be served by Tomcat7.
  • Container Management (Hudson Molonglo): ArchivesSpace plugin to add a new container type to ArchivesSpace. This plugin is compatible with ArchivesSpace v1.1.x.
  • Yale ArchivesSpace ILS Integration (Hudson Molonglo): ArchivesSpace plugin to add support for integrating Yale's ILS.
  • Yale Accessions plugin (Brian Hoffman): Creates custom accession identifiers for Yale.
  • Yale MARC XML (Hudson Molonglo): Additional MARC XML for accession mappings for Yale.
  • Default text for notes (Hudson Molonglo): ArchivesSpace plugin to specify default text for selected fields. This plugin was developed for the National Library of Australia.
  • Yale Materials Types (Hudson Molonglo): When this plugin is installed, you will see a new Material Types subrecord form in the Accessions form. After adding a Material Types subrecord to an Accession, you can check the material types that apply to the Accession. You can set default Material Types by clicking 'My Repository Preferences'; in the user dropdown menu. Checked Material Type preferences will be checked by default when a new Material Types record is created.
  • ASpace Yale Container Operations (Hudson Molonglo): Plugin for bulk container operations.
  • Item linker (Denver University Libraries): This ArchivesSpace plugin allows a user to create a Digital Object record directly from an Archival Object (i.e. for digital surrogates of a physical object), and automatically link that Digital Object to the item upon its creation. If a Digital Object is already linked to the item record, the user can push updates from the item to its Digital Object.
  • Archival Object_MODS (Denver University Libraries): This plugin allows users to download MODS representations of Archival Objects in ArchivesSpace. On the backend, there is an API call allowing the direct download of a MODS representation of any Archival Object as well as the metadata for that MODS representation, similar to the MODS export for Digital Object records.
  • Autogenerate DOIDs (Lora Woodford): This plugin auto-generates an identifier for Digital Objects created in staff mode (frontend).
  • Manager User Defined Fields (Ohio State University): This ArchivesSpace plugin hides any user defined fields that are default or not used for the specific type of item being created/edited.
  • PBSpace (Jason Corum, WGBH Media Library and Archives): This plugin adds new properties and object relationships in the application so that PBCore structure, elements, and attributes can be better represented in ArchivesSpace. PBCore is a data model for the description of audiovisual content.
  • css stylesheet (Yale University): for the staff interface.
  • Donor Details Plugin (Bentley Historical Library): Blog post that discusses the Bentley's Donor Details plugin. Includes links to the plugin code.
  • Accession Identifier Generator (UNC Chapel Hill Libraries): Creates controlled value list for accession identifier component 1 and auto-generates accession identifier component 2.
  • Publish Partial Trees (University of Cambridge): Allows publication and unpublication of parts of record trees. When active, a "Publish All" and "Unpublish All" button will appear in the resource and archival object toolbars for users with appropriate permissions, and will affect the open record as well as all descendant records.
  • Check URLs Custom Report (University of Georgia Libraries): A custom report to capture URLs in notes and digital object file versions and check them for bad requests (404, 500, etc.). Redirected links check the destination URL for errors.

Additional Front-end Functionality

  • Implementing the ArchivesSpace PUI: A Before Action Review (Yale University): Blog post that explains the purposes of this Before Action Review (BAR): identify what would be accomplished, what would change, and what would indicate success by moving to the ArchivesSpace public user interface.
  • Fixes title tag rendering bug in ArchivesSpace v1.5.4 (Tim DiLauro/Johns Hopkins University): This plugin remedies the worst of the ArchivesSpace v1.5.4 Public User Interface (PUI) <title> tag rendering bugs, which resulted in missing title text in fields and component tree, partially rendered pages, and bracketed in browser tabs/window headings. It currently does not address similar issues in staff mode (frontend) and is not applicable to the 2.x versions of ArchivesSpace.
  • Creating a static page for the PUI (James Bullen, Hudson Molonglo): Can be used to create a static page for the PUI, such as an FAQ, instructions for searching, information about the archive, etc.
  • Create a sitemap for the PUI (Joshua Shaw, Dartmouth College): Adds a job to the staff interface that generates a sitemap for the PUI.

General Information about Plugins

  • Information about Plugins (ArchivesSpace): ReadMe file from ArchivesSpace plugins page on Github.
  • Writing an ArchivesSpace plugin (Mark Triggs, Teaspoon Consulting): "ArchivesSpace allows you to write custom code to add new features, or change the behaviour of existing features. This code takes the form of a plugin: you structure your code according to certain conventions and it is automatically loaded when the ArchivesSpace system starts up. This article looks at the source code behind a plugin for generating accession identifiers."
  • Writing plugins for ArchivesSpace (Laney McGlohon and Lora Woodford): Workshop at Code4Lib 2018 that aimed to demystify plugins through examples and hands-on activities, along with tips and tools for participants to build their own plugins.
  • ArchivesSpace Developer Screencasts: 20. Writing an importer plugin (Mark Triggs, Hudson Molonglo): Youtube video that demonstrates how to write a plugin that adds an importer to ArchivesSpace.
  • Turning an ArchivesSpace Plugin into Core Code (ArchivesSpace program team): One of the simplest and quickest ways to begin writing for the ArchivesSpace core code is to take an existing plugin and convert it into a pull request to the master branch of ArchivesSpace.

Integrations

The links below relate to ArchivesSpace integrations projects. Resources are loosely grouped by the type of system being integrated with ArchivesSpace such as digital preservation systems, content publication systems, import/export integrations, etc. Some links may appear in multiple categories.

Aggregated Discovery Layers

Many ArchivesSpace institutions have implemented multiple ways of searching across the variety of resources that they maintain, such as the ArchivesSpace public UI and published finding aids. Some would like to consolidate their data into a single search interface/discovery layer so that their patrons can search all of their collections in a single place.

  • ArcLight ( Stanford University, with assistance from a number of contributing institutions, including University of Michigan, Princeton University, Duke University, Indiana University, the National Library of Medicine, Georgia Tech, the Chemical Heritage Foundation, and the Rockefeller Archives Center.): According to its website, ArcLight is “a Blacklight-based environment to support discovery and delivery for archives and special collections, initiated by Stanford University Libraries in late 2014. The vision for ArcLight has been to support discovery and delivery of archives and special collections (both physical and digital), to improve presentation and usability for archival description, and to enable integration with systems like Samvera, ArchivesSpace, and request management systems.” ArcLight wiki, ArcLight Google Group, ArcLight YouTube

Digital Asset Management

Metadata for digital objects can exist in both ArchivesSpace and a digital asset management or repository system. This leads to a duplication of metadata between these systems. System integration offers an opportunity to record metadata in one system, relying on the integration to automatically duplicate it in the other.

  • Starchive (American Song Archives): The objective is to create a digital asset management system with a creative and kinetic interface, allowing for private user workspaces, plus the added benefits of professional archival standards built into the system. This system will allow both staff and users to work within this virtual space in a visually engaging and fun way while also providing a strong and secure backend control offered by ArchivesSpace. The system will ultimately benefit both museum, public history and archives by providing virtual workspace for curation, digital exhibit layouts, archival processing, digital asset metadata projects and virtual research rooms.

Digital Preservation Systems

Some ArchivesSpace institutions make use of digital preservation systems for ingests. The descriptive information in ArchivesSpace should be able to aid in appraisal and arrangement, and can replicate this data in digital preservation systems. Furthermore, institutions can write “location” information for digital objects back to ArchivesSpace. In fact, a number of digital preservation integrations already exist.

  • Archivematica(Artefactual): Archivematica includes functionality that allows users to associate objects in Archivematica to related objects in ArchivesSpace. Supports ArchivesSpace 1.5.3 and later versions. Tested with 2.5, but not yet tested with 2.7+. User community and/or support provided by Artefactual based on service agreement. (Including the Rockefeller workflow). Due to the nature of the integration involving three systems, Artefactual does rely on the archivists at Bentley to test and report problems. (The Bentley is also active in fixing issues as community contributors). Artefactual tests the ArchivesSpace integration but does not test the DSpace integration.
  • ArchivesSpace-Archivematica Integration (Rockefeller Archive Center): Integration endpoints for Archivematica.
  • ArchivesSpace Integration documentation from Archivematica (Archivematica): Includes mapping samples between ArchivesSpace and Archivematica.
  • Caltech Archives Integration Tools (Caltech Library): A collection of tools utilities and services for integrating ArchivesSpace with other systems.
  • Bridging Technologies to Efficiently Arrange and Describe Digital Archives: the Bentley Historical Library's ArchivesSpace-Archivematica-DSpace Workflow Integration Project (Max Eckard, Dallas Pillen, and Mike Shallcross): "The integration of ArchivesSpace and Archivematica in an end-to-end workflow that will include the automated deposit of content into a DSpace repository. This article provides context of the project and offers an in-depth exploration of the project's key development tasks, all of which were provided by Artefactual Systems, the developers of Archivematica."
  • ArchivesSpace Integration Use Cases (Samvera Archivists Interest Group - formerly the Hydra Archivists Working Group): Contains links to user stories from various institutions about how they would like to integrate ArchivesSpace with their Samvera-(formerly, Hydra)-based repositories.
  • Archive-It - ArchivesSpace Integration (Archive-It): Blog post about the new Archive-It integration with ArchivesSpace. Includes link to documentation and plugins.
  • Islandora ArchivesSpace (LYRASIS): Includes modules, scripts, forms, and a plugin to integrate ASpace with Islandora metadata and digital objects.
  • Preservica (Preservica): Preservica includes functionality that allows users to associate objects in Preservica to related objects in ArchivesSpace. Documentation is available for registered Preservica users and a brief overview of the integration is available. Recorded webinar. Supports ArchivesSpace 1.5.0 and later versions. Tested with 2.6, but not yet tested with 2.7+. Support provided through Preservica's support desk as specified in the user agreement.

Import/Export

  • Link (Archive-It) Seeds to related ArchivesSpace collections (Mary Haberle, Archive-It): The "Related Archival Materials" metadata field makes it possible for partners using ArchivesSpace to integrate non-web collections in their holdings into seed-level Archives-It records.
  • ArchivesSpace Batch Exporter (University of Georgia Libraries): A program to batch export EAD, PDF, MARCXML, and Container Labels of resources from ArchivesSpace. Additionally, you can select cleanup options for EAD.xml files and upload resources to XTF-built finding aid websites.
  • ArchivesSpace DAO Links to DSpace Item Records (Georgetown University Library): Workflow to export and re-purpose ArchivesSpace metadata as a DSpace item description. Workflow to create ArchivesSpace DAO records from DSpace metadata.
  • ArchivesSpace Preprocessor (Harvard Library): The ArchivesSpace Preprocessing system processes EAD files and applies changes (fixes) to them to allow for successful ingest into ArchivesSpace.
  • Atlas Systems: Aeon/ArchivesSpace Plugins
    • ArchivesSpace-Aeon Fulfillment Plugin: Replaces the default request button in the ArchivesSpace PUI to allow patrons to submit requests from the PUI to Aeon. Developed by Atlas Systems.
    • ArchivesSpace-Aeon Fulfillment Plugin Customization: A version of the Atlas plugin modified by the University of Maryland to place the request button on the Top Container page, so that the details sent to Aeon are of the box.
    • ArchivesSpace-Aeon Fulfillment Plugin: Implements a shopping-basket-style request list in the ArchivesSpace PUI. Developed by Hudson-Molonglo for Harvard University.
    • Aeon ArchivesSpace Client Addon: This addon is used to integrate the ArchivesSpace staff interface into the Aeon Client request form so that staff can search the records of their ArchivesSpace instance and import details into Aeon requests.
  • Circa (NCSU Libraries): Request and workflow management for archives and special collections. A web-based system for managing requests for special collections materials. The application includes a JSON API, built in Ruby on Rails, and a default front end written in Angular.js (v. 1.6.x). Circa provides close integration with ArchivesSpace, upon which the application depends for managing containers associated with specific collection components, as well as the location of those containers. It can also support requests for materials described in an ILS. Circa allows users to import data from ArchivesSpace via the AS API. Currently this requires the user to copy/paste the AS record URI into Circa, which it then uses to make the API request. Supports ArchivesSpace 2.5+; not tested with 2.7.0.
  • EADChecker (Harvard Library): Import/export integration for checking EADs against local standards via schematron. This is a small website intended to allow Harvard Archivists to check their EAD files prior to ingest by ArchivesSpace.
  • OnBase (Dartmouth College): Allows staff users to add documents classified as records to be uploaded to OnBase and associated/attached to records in ArchivesSpace. The documents can be retrieved from within the ArchivesSpace staff interface or viewed in OnBase. Requires ROBI API endpoints to be configured in ArchivesSpace. Keyword definitions and rules for associating document types are very much institution dependent and will require additional development to conform to a specific institution's OnBase environment and needs. Supports ArchivesSpace 2.7.0+.
  • Repurposing ArchivesSpace Metadata for Original MARC Cataloging (Carol Ou, Katherine L. Rankin, Cyndi Shein): "UNLV...completed a pilot project exploring the repurposing of descriptive metadata for archival collections stored in ArchivesSpace for the creation of original MAchine-Readable Cataloging (MARC) records contributed to OCLC WorldCat."

Content Publication

For ArchivesSpace users that do not use the ArchivesSpace public UI, integration helps them to publish finding aids or other descriptive data to external systems. A number of content publication integrations already exist.

  • staticAid (Hillel Arnold): A Jekyll static site generator for archival description serialized in JSON, generated via the ArchivesSpace REST API, or by other modular backends which can be added to the system.
  • AS2D8: ArchivesSpace-to-Drupal 8 integration (Jason Loeffler): AS2D8 is a series of Drupal modules for harvesting data from ArchviesSpace. AS2D8 extends the Drupal core Migrate API with plugins, provides sensible defaults for displaying ArchivesSpace resources in Drupal and all of the usual Drupal content and website management tools.
  • Aviary (Aviary): Using ArchivesSpace as the master metadata for your archives, Aviary can provide a synchronized access point for audiovisual content in your collections. Aviary maps metadata from ArchivesSpace and follows digital object version links to construct accessible digital objects for your users to interact with your collections. Aviary completes the process by creating a new digital object in ArchivesSpace so your users can navigate between Aviary and ArchivesSpace with ease. Webiner, slides, recording, etc.
  • Caltech Archives Integration Tools (Caltech Library): cait is a go library wrapping the ArchivesSpace REST API. Includes support for content export and static website generation tools Manage your content in ArchivesSpace but read and search the public content independent of the status of ArchivesSpace itself. Gives you more options for deployment as well as providing a clean separation of concerns for public/admin uses.

Workflow Enhancements and Tracking

  • Trello (Duke University): aspace-to-trello.py creates Trello cards based on ArchivesSpace accession records. The script is designed to be run as a scheduled cron job. When executed, the script will first query the ArchivesSpace API to identify recently created accession records and then it will create Trello cards for those accession records on a specified Trello board and list. Supports ArchivesSpace 2.7.0+.
  • Goobi (intranda GmbH): Open-source software suite for managing digitisation workflows. It has a plugin for importing from library catalogues in various formats. The one for JSON sources can be configured to query the ArchivesSpace API for archival objects and extract relevant metadata fields for digital surrogates.

Case Studies

  • Open-Source Opens Doors: A Case Study on Extending ArchivesSpace Code at UNLV Libraries (Cyndi Shein, Carol Ou, Karla Irwin, Carlos Lemus): "UNLV is in its third year of implementing...ArchivesSpace, and is sharing UNLV-developed code that extends ArchivesSpace's built-in function. The case study demonstrates how adopting and building upon community-created code and developing original local code is improving critical workflows that support creating collection descriptions, cleaning up metadata, and disseminating finding aids that are easier for researchers to comprehend."

Trainings and Documentation

The links below relate to ArchivesSpace training resources and/or documentation.

Implementation

The links below relate to ArchivesSpace implementation projects.

  • Implementing ArchivesSpace at Arizona State University (Elizabeth Dunham): Arizona State University Libraries became charter members of ArchivesSpace, an "open source archives information management application for managing and providing web access to archives, manuscripts and digital objects", in early 2013. This case study discusses the Libraries' migration of its Archives and Special Collections (ASC) from Microsoft Access, Archivists' Toolkit and FileMaker Pro to ArchivesSpace.
  • Implementing ArchivesSpace at NYPL: Part 1 (New York Public Library): "In 2014, the Archives Unit at The New York Public Library began its evaluation of ArchivesSpace. Following a rigorous review of the application, we began implementation in earnest in 2016, and started using it in production earlier this year. Historically, Special Collections developed its own systems for collection/data management, which could be developed and tailored to suit our needs. As such, moving from a homegrown data management system/model to a community-designed one represented a major shift in how the Library evaluates and implements systems. Instead of being able to build to our wants/needs from the ground up, ArchivesSpace required us to meet the application halfway in its assumptions and practices."
  • Customization Layer for ArchivesSpace 2.x (Georgetown University Libraries): Repository with Georgetown's branding and configuration customizations for ArchivesSpace.
  • Implementing ArchivesSpace with Docker (Michigan State University Libraries): A comprehensive example for implementing ArchivesSpace using Docker with documentation for setting up and customizing it.

APIs and Scripts

The links below relate to ArchivesSpace scripts and APIs.