github archivesspace/archivesspace v3.3.0
V3.3.0
on GitHub

latest releases: v3.4.0-RC0, v3.3.1
19 months ago

Release notes for 3.3.0

This release includes many small bug fixes and feature enhancements. Of particular note are some enhancements to spawning from accessions and an option for logged in users to change their own passwords. As part of the spawning improvements, the plugin Hudson Molonglo developed for The New School Archives and Special Collections to link accessions to archival objects has been incorporated into the core code of ArchivesSpace.

Configurations and Migrations

This release includes several modifications to the configuration defaults file: 

-# The ArchivesSpace Solr index listens on port 8090 by default.  You can
-# set it to something else below.
+# The ArchivesSpace Solr index url default.  You can set it to something else below.
-AppConfig[:solr_backup_number_to_keep] = 1
+# By default no backups. If enabling (by setting > 0) then you must also ensure
+# that AppConfig[:solr_index_directory] is set to the correct path
+AppConfig[:solr_backup_number_to_keep] = 0
-AppConfig[:solr_index_directory] = proc { File.join(AppConfig[:data_directory], "solr_index") }
-AppConfig[:solr_home_directory] = proc { File.join(AppConfig[:data_directory], "solr_home") }
+# Set the path to the solr index for the external Solr instance.
+# This setting is used by the solr backups configuration but only
+# applies if the solr index directory is accessible to ArchivesSpace.
+AppConfig[:solr_index_directory] = File.join('', 'var', 'solr', 'data', 'archivesspace', 'data')
+AppConfig[:max_boolean_queries] = 1024 # ArchivesSpace Solr default
+# record types resolved for record inheritance
+AppConfig[:record_inheritance_resolves] = [
+  'ancestors',
+  'ancestors::linked_agents',
+  'ancestors::subjects',
+  # 'ancestors::instances::sub_container::top_container',
+]
+AppConfig[:frontend_branding_img] = 'archivesspace/archivesspace.small.png'
+AppConfig[:frontend_branding_img_alt_text] = 'ArchivesSpace - a community served by Lyrasis.'
+# Whether to expand all additional information blocks at the bottom of record pages by default. `true` expands all blocks, `false` collapses all blocks.
+AppConfig[:pui_expand_all] = true
+AppConfig[:pui_display_facets_alpha] = false
+# Resolving linked events can have a big impact on performance. If the number of linked
+# events surpasses the max then the events will not be resolved and a more abridged
+# record will be displayed to keep memory usage under control as the no. of events grows
+AppConfig[:max_linked_events_to_resolve] = 100
+# Prior to 3.2.0, multiple ARKs may have been created without
+# the user intending to do so. Setting this to true will make
+# database upgrade 158 attempt to clean up unwanted extra ARKs.
+# When multiple rows in the ARK table reference the same resource
+# or archival object, the first one created will be kept
+# and the rest discarded.
+# Use with caution and test thoroughly.
+AppConfig[:prune_ark_name_table] = false
+# If the PUI is enabled, add resource finding aid URLs to MARC exports
+AppConfig[:include_pui_finding_aid_urls_in_marc_exports] = false
+# If enabled, use slugs instead of URIs in finding aid links (856 $u)
+AppConfig[:use_slug_finding_aid_urls_in_marc_exports] = false
+# Turns on representative file version features - still in development
+AppConfig[:enable_representative_file_version] = false

This release includes 5 new database migrations. The schema number for this release is 164.

Other Considerations:

As part of the spawning improvements, the functionality of the plugin Hudson Molonglo developed for The New School Archives and Special Collections to link accessions to archival objects has been incorporated into the core code of ArchivesSpace.

Community Contributions

Our thanks go out to these members of the community for their code contributions:

  • Andrew Morrison:

    • Hide 'View Published' for published records in unpublished repositories
    • Fix inaccurate API endpoint description
    • Fix sorting of records with titles containing non-ASCII characters
    • Do not set up PUI route for handling ARK URLs if arks_enabled is false
    • Fix for PDF failure when predefined XML entities are unescaped

  • Brian Zelip:

    • ANW-616: Add a spawn component feature to accession record toolbar
    • ANW-730: Add PUI expand/collapse all config option
    • ANW-1493: Representative File Version: Backend Rules
    • ANW-1506: Display representative file version in PUI
    • ANW-1548: Unexpected digital object bulk import requirement of DO uri or thumbnail
    • Upgrade ESLint and Stylelint major versions
    • Patch npm dependency vulnerability

  • Corey Schmidt:

    • Update id_lookup_controller.rb API Examples
    • Update various api endpoints documentation
    • Add examples to archival_objects.rb

  • Don Richards:

    • ANW-1193: Show the type of import on the Import Job page
    • ANW-1382: MARCXML authority import fails when an 024 (other standard identifier) does not have a $a even though this can be valid

  • Greg Wiedeman:

    • API login request with expiring=false now returns feedback

  • Jacob Shelby:

    • Add API shell examples for agents publish and get enumeration by name

  • James Bullen:

    • Fix git version fail when head is detached

  • Jason Jordan:

    • ANW-1473: jruby letsencrypt rebase

  • Joshua Shaw:

    • Correct visibility for Delete button on Assessment View

  • Lora Woodford:

    • ANW-918: ns2 Namespace Remover background job
    • Note persistent id issue

  • Manny Rodriguez:

    • ANW-164: Add "create" option to linker in "update container profiles" option
    • ANW-340: Add support for sorting facets in alpha order
    • ANW-445: Add feature to allow bulk update for indicators
    • ANW-534: Add support for users to update their own accounts
    • ANW-699: Move 'add item' button to bottom for defined lists
    • ANW-857: Add a config.rb option for header logo and alt-text in frontend
    • ANW-1071: Include PUI link in MARC export when PUI is enabled
    • ANW-1095: Display all creators in public interface
    • ANW-1148: Bugfix for not being able to set an enumeration default
    • ANW-1162: Remove field prefix in MARCXML import
    • ANW-1165: Allow suppressed enum values to be deleted in one step
    • ANW-1168: Strip out quotes from the confirmation when deleting a repo
    • ANW-1182: Bugfix for 500 error thrown in date calculator
    • ANW-1201: Bugfix for UTF-8 chars in slugs breaking the PUI
    • ANW-1242: bugfix for lost formatting when expanding notes in PUI
    • ANW-1244: Bugfix for extent calculator adding result to wrong subrecord
    • ANW-1268: Bugfix for invalid EAD created when top_container.type left blank
    • ANW-1276: Bugfix for include_unpublished flag not passed to EAD agent export
    • ANW-1342: Add default value for extent type in deaccession show page
    • ANW-1360: Add URI to list of fields that can be displayed in search/browse
    • ANW-1374: Fix menu display for phone and tablet screen sizes
    • ANW-1393: Update source/rules/authority id columns in agents browse/search to reflect the changes in the agents module
    • ANW-1396: Update copy for preferences menu and page for clarity
    • ANW-1422: Display full record ID in PUI breadcrumb
    • ANW-1430: Change shortcut key from space to control for infinite scroll library
    • ANW-1434: Add sidebar links for events and linked via rights statement to events show
    • ANW-1478: Prevent create custom template button for showing unless permissions
    • ANW-1483: Correct maintenance states strings in EAC-CPF export
    • ANW-1487: Bugfix for translation missing error
    • ANW-1494: List custom report templates alphabetically in the reports area
    • ANW-1498: Change UI so make representative is disabled unless publish is checked
    • ANW-1519: Bugfix for non-repo records not linking properly when imported

  • Mark Triggs:

    • Print more diagnostic information on a DB connection failure

  • Michael Glanznig:

    • German Translations update from Hosted Weblate
    • Miscellaneous i18n updates & fixes
    • add proper i18n for titles of new records
    • add i18n to frontend and public interface footers

Total community contributions accepted: 126

JIRA Tickets and Pull Requests Completed

  • PR: 2765: make sure not to accidentally set resource as a parent
  • PR: 2763 - ANW-1585: ANW-1585 add text to spawned record message
  • PR: 2761: ensure datasource url is complete and better handle insertions to a resource that has no children
  • PR: 2740: Translations update from Hosted Weblate
  • PR: 2755: revise tree position selection when spawning component
  • PR: 2721: Fix public / staff app url link in footer for dev
  • PR: 2708 - ANW-1134: ANW-1134: Avoid resolving top_containers where it's unnecessary
  • PR: 2741: Translations update from Hosted Weblate
  • PR: 2742: Translations update from Hosted Weblate
  • PR: 2739: Translations update from Hosted Weblate
  • PR: 2749 - ANW-1494: ANW-1494: make custom report template sort case insensitive
  • PR: 2748 - ANW-1095: ANW-1095: don't show creators in two places on PUI show page
  • PR: 2745 - ANW-725: ANW-725: retain any default value notes when spawning
  • PR: 2744 - ANW-1071: ANW-1071: output a second 856 with PUI link only if distinct from ead_loc
  • PR: 2735 - ANW-1564: ANW-1564 further refactoring of admin-defined subrecord requirements
  • PR: 2733: Assessment View Delete Button Visibility
  • PR: 2729: fix git version fail when head is detached
  • PR: 2727: Hide 'View Published' for published records in unpublished repositories
  • PR: 2720: ANW-1193
  • PR: 2722 - ANW-287: ANW-287 move HM accession / component link plugin to core
  • PR: 2719 - ANW-1563: ANW-1563 alpha sort facets without breaking facet link
  • PR: 2691 - ANW-616: ANW-616 - adding a spawn component feature to accession record toolbar
  • PR: 2714: Build release updates june2022
  • PR: 2711: Fix inaccurate API endpoint description
  • PR: 2706 - ANW-1360: Updates to ANW-1360: Search and Browse ID column needed, i.e. Agents and Subjects
  • PR: 2697 - ANW-1360: ANW-1360: adding URI to list of fields that can be displayed in search/browse
  • PR: 2700 - ANW-1396: ANW-1396: Update copy for preferences menu and page for clarity
  • PR: 2705: restore digital object views in public app and turn off new representative file version functionality
  • PR: 2703 - ANW-1474: ANW-1474 refactor agent required field customization form
  • PR: 2702: Print more diagnostic information on a DB connection failure
  • PR: 2701: Fix sorting of records with titles containing non-ASCII characters
  • PR: 2696: Chore: Upgrade ESLint and Stylelint major versions
  • PR: 2695 - ANW-1548: ANW-1548 Unexpected digital object bulk import requirement of DO uri or thumbnail
  • PR: 2694 - ANW-1494: ANW-1494: List custom report templates alphabetically in the reports area
  • PR: 2693 - ANW-1478: ANW-1478: prevent create custom template button for showing unless permissions
  • PR: 2692 - ANW-1519: ANW-1519: bugfix for non-repo records not linking properly when imported
  • PR: 2690: Update id_lookup_controller.rb API Examples
  • PR: 2688 - ANW-1071: ANW-1071: include PUI link in MARC export
  • PR: 2686 - ANW-725: ANW-725 Spawn with default values
  • PR: 2684: Chore: Patch npm dependency vulnerability
  • PR: 2678: Some dev related pry updates
  • PR: 2663 - ANW-1393: ANW-1393: Update source/rules/authority id columns in agents browse/search to reflect the changes in the agents module
  • PR: 2675: Update various api endpoints documentation
  • PR: 2672: Translations update from Hosted Weblate
  • PR: 2671: Translations update from Hosted Weblate
  • PR: 2665: Translations update from Hosted Weblate
  • PR: 2670 - ANW-1522: ANW-1522 first pass at representative file versions for all record types
  • PR: 2668: ensure that solr checksum verification does not obscure 404 responses or tcp/http errors
  • PR: 2667: Translations update from Hosted Weblate
  • PR: 2666: Translations update from Hosted Weblate
  • PR: 2659 - ANW-1483: ANW-1483: correct maintenance states strings in EAC-CPF export
  • PR: 2656 - ANW-1506: ANW-1506 Display representative file version in PUI
  • PR: 2653: Refine default Solr config settings post external Solr transition
  • PR: 2658 - ANW-1498: ANW-1498: change UI so make representative is disabled unless publish is checked
  • PR: 2655: Small rename to new indicator container bulk operation
  • PR: 2654: Translations update from Hosted Weblate
  • PR: 2657: Translations update from Hosted Weblate
  • PR: 2591 - ANW-1396: ANW-1396: global preferences
  • PR: 2644 - ANW-1493: ANW-1493 Representative File Version: Backend Rules
  • PR: 2651 - ANW-1498: ANW-1498: update frontend so setting representative and published are linked
  • PR: 2650 - ANW-1382: ANW-1382
  • PR: 2647 - ANW-340: ANW-340: adding support for sorting facets in alpha order
  • PR: 2649: Note persistent id issue
  • PR: 2648: add config option to make migration 158 prune the ark_name table
  • PR: 2649 - ANW-918: Note persistent id issue
  • PR: 2646 - ANW-1422: ANW-1422: display full record ID in PUI breadcrumb
  • PR: 2645 - ANW-164: ANW-164: adding "create" option to linker in "update container profiles" option
  • PR: 2641 - ANW-445: ANW-445: adding feature to allow bulk update for indicators
  • PR: 2643 - ANW-1165: ANW-1165: allow suppressed enum values to be deleted in one step
  • PR: 2640 - ANW-1276: ANW-1276: bugfix for include_unpublished flag not passed to ead agent export
  • PR: 2639: fix typo for German language select
  • PR: 2637: Record Inheritance resolve updates
  • PR: 2638 - ANW-1095: ANW-1095: display all creators in public interface
  • PR: 2374 - ANW-1374: ANW-1374: Fix menu display for phone and tablet screen sizes
  • PR: 2636 - ANW-1487: ANW-1487: bugfix for translation missing error
  • PR: 2622 - ANW-534: ANW-534: Add support for users to update their own accounts
  • PR: 2635: Performance improvement for loading of linked event records in SUI
  • PR: 2632: Update merge subject api python example for #2519
  • PR: 2631: fix column key publish -> digital
  • PR: 2609: add proper i18n for titles of new records
  • PR: 2628 - ANW-807: ANW-807 make sure suppressed enum values don't block added values
  • PR: 2626: dedupe global_preferences locale key
  • PR: 2625 - ANW-1479: ANW-1479 & ANW-1484
  • PR: 2624 - ANW-1162: ANW-1162: remove field prefix in MarcXML import
  • PR: 2623: Do not set up PUI route for handling ARK URLs if arks_enabled is false
  • PR: 2621: Anw 1473 jruby letsencrypt rebase
  • PR: 2620: API login request with expiring=false now returns feedback
  • PR: 2561 - ANW-1182: ANW-1182: bugfix for 500 error thrown in date calculator
  • PR: 2619: Bootstrap is now required during docker build
  • PR: 2606: Misc i18n updates & fixes
  • PR: 2616: Migration 158 Legacy Data Issues
  • PR: 2617 - ANW-1244: ANW-1244: bugfix for extent calculator adding result to wrong subrecord
  • PR: 2608 - ANW-1268: ANW-1268: bugfix for invalid EAD created when top_container.type left blank
  • PR: 2614: Translations update from Hosted Weblate
  • PR: 2613: Translations update from Hosted Weblate
  • PR: 2612: Translations update from Hosted Weblate
  • PR: 2603: Translations update from Hosted Weblate
  • PR: 2602: Translations update from Hosted Weblate
  • PR: 2607 - ANW-1242: ANW-1242: bugfix for lost formatting when expanding notes in PUI
  • PR: 2604 - ANW-1168: ANW-1168: strip out quotes from the confirmation when deleting a repo
  • PR: 2599 - ANW-699: ANW-699: moving 'add item' button to bottom for defined lists
  • PR: 2593 - ANW-1430: ANW-1430: changing shortcut key from space to control for infinite scroll library
  • PR: 2592 - ANW-1434: ANW-1434: adding sidebar links for events and linked via rights statement to events show
  • PR: 2586: add i18n to frontend and public interface footers
  • PR: 2548 - ANW-1148: ANW-1148: bugfix for not being able to set an enumeration default
  • PR: 2577 - ANW-857: ANW-857: Adding a config.rb option for header logo and alt-text in frontend
  • PR: 2576 - ANW-164: ANW-164: fix visual bug in top container bulk operations
  • PR: 2566: Add examples to archival_objects.rb
  • PR: 2563 - ANW-1342: ANW-1342: adding default value for extent type in deaccession show page
  • PR: 2560 - ANW-1201: ANW-1201: bugfix for UTF-8 chars in slugs breaking the PUI
  • PR: 2553: Fix for PDF failure when predefined XML entities are unescaped
  • PR: 2549: Added API shell examples for agents publish and get enumeration by name
  • PR: 2538 - ANW-730: ANW-730: Add PUI expand/collapse all config option
    Total Pull Requests accepted: 113
Check out latest releases or
releases around archivesspace/archivesspace v3.3.0

Don't miss a new archivesspace release

NewReleases is sending notifications on new releases.

Get notifications