v4.2.0
Breaking risk
⚠ Upgrade required
- Supports Solr 9.9 and Java 21; this is the last version that supports Java 11 (upcoming jRuby upgrades will drop Java 11 support).
- New configuration options `AppConfig[:resource_fields_not_to_duplicate]` for Resource duplication and favicon customization settings (`pui_png_favicon`, `pui_svg_favicon`, `frontend_png_favicon`, `frontend_svg_favicon`).
Notable features
- Configurable exclusion of specific fields when duplicating a Resource record
- Option to exclude URIs from PDF exports generated in the staff interface
Full changelog
Release notes for v4.2.0
This release contains bug fixes plus some small feature improvements. Bug fixes include correcting an issue with the download of the PDF on the public interface on mobile devices and correcting an issue that prevented setting a user as inactive in the staff interface from some of the views. Small feature improvements include the addition of a configuration to set which fields are included when the Duplicate Resource functionality in the staff interface is used and a new option to exclude URIs from PDFs downloaded from the staff interface. There are also a number of small fixes to improve accessibility, particularly for the public interface.
Configurations and Migrations
This release adds two new configuration options to the configuration file:
1. Resource fields to exclude when duplicating a resource
When duplicating a resource fields are generally copied over from the original resource to the duplicated one. An option to exclude specific fields from resource record duplication is now available. Note: If required resource record fields (e.g. 'level') are added here, they will be ignored.
Example:
AppConfig[:resource_fields_not_to_duplicate] = ['finding_aid_status', 'finding_aid_author']
This configuration option is empty by default, so all fields are included in resource duplication - no changes in behavior since the previous version.
2. Favicon customization
A set of configuration options have been added allowing easy customization of the favicons used on the public and staff user interfaces.
To customize the favicons it is now possible to add png and svg versions of the icons in:
- directory:
plugins/local/public/assets/imagesfor the public user interface - directory:
plugins/local/frontend/assets/imagesfor the staff user interface
and set the corresponding configuration options:
# Public UI:
AppConfig[:pui_png_favicon] = '/assets/images/custom-favicon.png'
AppConfig[:pui_svg_favicon] = '/assets/images/custom-favicon.svg'
# Staff UI:
AppConfig[:frontend_png_favicon] = 'archivesspace/custom-favicon.png'
AppConfig[:frontend_svg_favicon] = 'archivesspace/custom-favicon.svg'
The standard ArchivesSpace favicon is used by default.
No migrations or solr configuration changes
This release includes no new database migrations. The solr schema and configuration are also not updated.
Solr and Java versions (when using the zip distribution):
Support for Solr 9.9 and Java 21 has been added for this release. Because of upcoming upgrades to our version of jRuby, version 4.2.0 of the application is the last that will support Java 11. If using docker, you do not need to worry about these dependencies.
Plugin considerations:
The standard caution to check plugins before upgrading applies. Due to changes in the rendering of the tree for the Resources read-only page (the show view) in the staff interface, any plugins that modify this feature will likely need to be updated.
Notable dependency updates since v4.1.1 include:
| Dependency | v4.1.1 | v4.2.0 |
|-----------------|--------|----------|
| Bundler | 2.5.15 | 2.6.9 |
| jdbc-mysql | 8.0.30 | 9.1.0.1 |
| Rails | 6.1.6 | 6.1.7.10 |
| rufus-scheduler | 2.0.24 | 3.9.2 |
| rubyzip | 1.3.0 | 3.2.2 |
| write_xlsx | 1.01.0 | 1.12.3 |
| net-ldap | 0.16.3 | 0.20.0 |
| oai | 1.2.1 | 1.3.0 |
If using plugins with any of the above dependencies, make sure they are tested with v4.2.0 before upgrading your production installation.
Community Contributions
Our thanks go out to these members of the community for their code contributions:
-
Alexander Duryee:
- Adding modified_since to API docs
-
Brian Hoffman:
- remove stranded reports code
- Avoid Memory Leaks in Converters
-
DJ Hayes:
- Fix release badge
-
Harris Papazoglou:
- ANW-1023: Default Top Container values (#3732)
- ANW-1794: fixes custom report filter to show enum value
- ANW-1802: adds enum fields to user_defined select in custom reports. (#3728)
- ANW-1811: Usage dates on form names (#3545)
- ANW-1903: Provide two Plus One buttons on the Create Batch Locations form (#3725)
- ANW-2101: Translation missing for new values in event_event_type
- ANW-2143: Replaces 'authoritive' and 'authoritative' with 'authorized' on people facing labels (#3724)
- ANW-2199: Fix issues with CSV export (#3710)
- ANW-2217: Fix top container title-with-semicolon bug for PUI pdf export (#3729)
- ANW-2347: Fix translation keys related to top_container_mgmt (#3700)
-
Jonny Bylsma:
- ANW 2445: Extend launcher to allow log appending
-
Joshua Shaw:
- Allow Indexer Hooks to access Ancestor data in PUI Index (#3667)
- fix job log wrapping
- Indexer State files for Trees
- add documentation for jobs_with_files endpoint
-
Laura L. R. Sinhur:
- Translated using Weblate (Ukrainian)
-
Lora Woodford:
- ANW-2564 Batch Update Location description
- ANW-2546 Add apple-touch-icon to frontend and public (#3789)
- ANW_2494 Remove jquery.kiketable.colsizable.css
- ANW-2476 Set resource fields not to duplicate in AppConfig
- ANW-2459 Do not duplicate ao note persistent_id
-
Lydia Tang:
- Translated using Weblate (Polish)
-
Mark Triggs:
- Optimize handling of deletes against Solr (#3702)
-
Michael Glanznig:
- Translations update from Hosted Weblate (German)
-
Regine Heberlein:
- ANW-2145 adds two subrecords of the extent record to MARC serialization (#3797)
-
René Vlak:
- Translations update from Hosted Weblate (Dutch)
-
Vasilis Chouliaras:
- ANW-1811: Usage dates on form names (#3545)
Total community contributions accepted: 31
JIRA Tickets and Pull Requests Completed
- PR: 3957: Translations update from Hosted Weblate (#3957)
- PR: 3955 - ANW-2519: ANW-2519 fix delete digital objects spec and accession spawn digital object spec (#3955)
- PR: 3964 - ANW-2519: Release v4.2.x
- PR: 3964: Release v4.2.x
- PR: 3964 - ANW-2607: Release v4.2.x
- PR: 3964 - ANW-2330: Release v4.2.x
- PR: 3964 - ANW-2616: Release v4.2.x
- PR: 3919 - ANW-2610: ANW-2610 build docker images also on release branches
- PR: 3916 - ANW-2609: ANW-2609 Don't allow dangerous html tags in mixed content
- PR: 3917: Moving E2E documentation to tech docs
- PR: 3830 - ANW-1763: ANW-1763: Add "Create and Link" for Related Accessions (#3830)
- PR: 3914: Upgrade JS top level dev dependencies
- PR: 3901 - ANW-1682: ANW-1682: Add skip to main content link in Staff User Interface (SUI) (#3901)
- PR: 3907 - ANW-2187: ANW-2187 Fix missing translation for revision_statement option in staff batch find and replace select menu
- PR: 3906: Translations update from Hosted Weblate (#3906)
- PR: 3903: Translations update from Hosted Weblate (#3903)
- PR: 3904: Translations update from Hosted Weblate (#3904)
- PR: 3905: Translations update from Hosted Weblate (#3905)
- PR: 3909: Translations update from Hosted Weblate
- PR: 3910: Translations update from Hosted Weblate
- PR: 3911: Translations update from Hosted Weblate
- PR: 3908: Translations update from Hosted Weblate
- PR: 3902: Translations update from Hosted Weblate (#3902)
- PR: 3899 - ANW-2592: ANW-2592 Move PUI facets badge counts to enable screen reader access (#3899)
- PR: 3876 - ANW-2589: ANW-2589 Fix ARIA bugs in linkers across record types
- PR: 3897 - ANW-2593: ANW-2593 Fix PUI 'more facets' keyboard focus behavior
- PR: 3890 - ANW-2519: ANW-2519 fix flakey specs (#3890)
- PR: 3732 - ANW-1023: ANW-1023: Default Top Container values (#3732)
- PR: 3892 - ANW-2600: ANW-2600 Fix staff ARKS modal accessibility errors
- PR: 3891: Translations update from Hosted Weblate
- PR: 3888: Translations update from Hosted Weblate
- PR: 3885: Translations update from Hosted Weblate
- PR: 3887: Translations update from Hosted Weblate
- PR: 3884: Translations update from Hosted Weblate
- PR: 3878: Anw 2584 fix nokogiri version and remove jrack jackson
- PR: 3879: Translations update from Hosted Weblate (#3879)
- PR: 3878 - ANW-2584: Anw 2584 fix nokogiri version and remove jrack jackson
- PR: 3883: Translations update from Hosted Weblate
- PR: 3882: Translations update from Hosted Weblate
- PR: 3880: Translations update from Hosted Weblate
- PR: 3877 - ANW-2594: ANW-2594 Fix space calculator accessibility bugs
- PR: 3871 - ANW-2584: ANW-2584 updated jackson jars (#3871)
- PR: 3854 - ANW-2463: ANW-2463: Fix PUI pdf download on mobile operating systems (#3854)
- PR: 3863: Fix flaky log feed specs
- PR: 3867: Translations update from Hosted Weblate
- PR: 3868: Translations update from Hosted Weblate
- PR: 3869: Translations update from Hosted Weblate
- PR: 3870: Translations update from Hosted Weblate
- PR: 3860 - ANW-1680: ANW-1680: Add underline on hover to staff keyboard shortcuts footer button
- PR: 3850: Anw 2584 update dependencies
- PR: 3853 - ANW-2590: ANW-2590: Make staff footer links blue by default, consistent with PUI footer links
- PR: 3852 - ANW-1680: Use Rails
t()helper instead ofI18n.t()in PUI footer for '_html' suffix support - PR: 3851: Translations update from Hosted Weblate
- PR: 3844 - ANW-2215: ANW-2215 Fix staff flickering tooltips with long content
- PR: 3849 - ANW-1680: ANW-2586, ANW-1680: Fix frontend keyboard shortcuts, and add a footer button to show the shortcuts modal
- PR: 3846: Translations update from Hosted Weblate
- PR: 3848: Translations update from Hosted Weblate
- PR: 3847: Translations update from Hosted Weblate
- PR: 3842: Update npm devDependencies versions via 'npm audit fix --package-lock-only' (#3842)
- PR: 3843: Update the dev container to java21
- PR: 3800 - ANW-2542: ANW-2542: Fix secondary sort menu in search results table (#3800)
- PR: 3836 - ANW-2455: ANW-2455 Fix redundant pui search icon label
- PR: 3835 - ANW-1679: ANW-1679: Fix the import job drag and drop hint text contrast
- PR: 3834: Translations update from Hosted Weblate
- PR: 3825 - ANW-2427: ANW-2427 Add 'Include URIs' option to staff resource PDF export
- PR: 3832 - ANW-2519: Anw 2519 fix flaky agents spec
- PR: 3831 - ANW-2519: ANW-2519 address flaky specs (#3831)
- PR: 3725 - ANW-1903: ANW-1903: Provide two Plus One buttons on the Create Batch Locations form (#3725)
- PR: 3823 - ANW-2619: ANW-2619 wait for ajax on defaults pages
- PR: 3822 - ANW-1309: ANW-1309 - Fix i18n typos and bad wrapping within agent alternate sets (#3822)
- PR: 3728 - ANW-1802: ANW-1802: adds enum fields to user_defined select in custom reports. (#3728)
- PR: 3815 - ANW-2187: ANW-2187: Add missing translation for import_current_ark menu option in Batch Find and Replace job form
- PR: 3817: Add wiki link for End-to-End test suite details
- PR: 3807 - ANW-1796: ANW-1796 External document links on the PUI should open in a separate tab (#3807)
- PR: 3812 - ANW-2566: ANW-2566 Fix site-wide PUI document heading hierarchy bugs
- PR: 3811 - ANW-2565: ANW-2565: Fix broken skip links on the PUI resource 'view digital material' page
- PR: 3810: Translations update from Hosted Weblate
- PR: 3809 - ANW-2564: ANW-2564 Batch Update Location description
- PR: 3797 - ANW-2145: ANW-2145 adds two subrecords of the extent record to MARC serialization (#3797)
- PR: 3805 - ANW-1696: ANW-1696 Fix browse column preferences '[no value]' inheritance translation bug
- PR: 3801: remove stranded reports code
- PR: 3798: Translations update from Hosted Weblate
- PR: 3799 - ANW-2492: ANW-2492 Add
forattribute to the label for the PUI select language box input (#3799) - PR: 3796: Translations update from Hosted Weblate
- PR: 3795: Translations update from Hosted Weblate
- PR: 3794: Translations update from Hosted Weblate
- PR: 3787 - ANW-2540: ANW-2540 Fix the empty display of 'false' values in search results for Agents and Assessments
- PR: 3783 - ANW-2529: ANW-2529, ANW-2536, ANW-2171: Fix staff search tables sorting
- PR: 3783 - ANW-2171: ANW-2529, ANW-2536, ANW-2171: Fix staff search tables sorting
- PR: 3783 - ANW-2536: ANW-2529, ANW-2536, ANW-2171: Fix staff search tables sorting
- PR: 3792: Translations update from Hosted Weblate
- PR: 3791: Translations update from Hosted Weblate
- PR: 3789 - ANW-2546: ANW-2546 Add apple-touch-icon to frontend and public (#3789)
- PR: 3790: Adding modified_since to API docs
- PR: 3779: Translations update from Hosted Weblate
- PR: 3778: Translations update from Hosted Weblate
- PR: 3770: Translations update from Hosted Weblate
- PR: 3767: Translations update from Hosted Weblate
- PR: 3765: standardize all docker compose to image: mysql:8
- PR: 3763: Translations update from Hosted Weblate
- PR: 3726 - ANW-2101: ANW-2101: Translation missing for new values in event_event_type
- PR: 3727 - ANW-1794: ANW-1794: fixes custom report filter to show enum value
- PR: 3760 - ANW-794: ANW-794 do not return published items from unpublished collections (#3760)
- PR: 3758 - ANW-2519: ANW-2519 run only on push as detecting the docker tag on pull_request events does not work (#3758)
- PR: 3759: Avoid Memory Leaks in Converters (#3759)
- PR: 3759: Avoid Memory Leaks in Converters
- PR: 3754 - ANW-1552: ANW-1552: Validate mixed content in title fields for those record types whose title supports it (#3754)
- PR: 3757: update gems
- PR: 3756: Translations update from Hosted Weblate
- PR: 3755: Wait for javascript on the new subject form before attempting to fill out fields (#3755)
- PR: 3748 - ANW-2026: ANW-2026 Fix table sorting on all linker browse modals (#3748)
- PR: 3752: Revise README for e2e test setup instructions (#3752)
- PR: 3753: Translations update from Hosted Weblate
- PR: 3751: Translations update from Hosted Weblate
- PR: 3749 - ANW-2519: ANW-2519 improve performance and reduce flakiness on e2e tests
- PR: 3750: Translations update from Hosted Weblate
- PR: 3746: fix: Remove unnecessary record creation in frontend events spec
- PR: 3742 - ANW-1993: ANW-1993: Fix Assessments records linker 'View' popover
- PR: 3738 - ANW-2403: ANW-2403: Fix PUI
aria-expandedbugs in global nav and InfiniteTree (#3738) - PR: 3740: Translations update from Hosted Weblate
- PR: 3724 - ANW-2143: ANW-2143: Replaces 'authoritive' and 'authoritative' with 'authorized' on people facing labels (#3724)
- PR: 3667: Allow Indexer Hooks to access Ancestor data in PUI Index (#3667)
- PR: 3734 - ANW-1870: ANW-1870: Remove non-breaking space character from public infinite_records template
- PR: 3730 - ANW-1874: ANW-1874: Limit Agent linker is_primary usage in templates to record types with is_primary in their schema (#3730)
- PR: 3729 - ANW-2217: ANW-2217: Fix top container title-with-semicolon bug for PUI pdf export (#3729)
- PR: 3722 - ANW-1968: ANW-1968: Fix the broken agent and record linkers on the Classification Term Defaults form (#3722)
- PR: 3719: Translations update from Hosted Weblate
- PR: 3716: Hotfix: Change merge modal confirmation button color from default to primary
- PR: 3710 - ANW-2199: ANW-2199: Fix issues with CSV export (#3710)
- PR: 3715 - ANW-2365: ANW-2365: Fix the hardcoded
include-unpublishedsearch parameter in the url that generates a pdf for a resource in the frontend - PR: 3545 - ANW-1811: ANW-1811: Usage dates on form names (#3545)
- PR: 3701: convert public accessibility specs to feature specs (#3701)
- PR: 3700 - ANW-2347: ANW-2347: Fix translation keys related to top_container_mgmt (#3700)
- PR: 3712 - ANW-2389: ANW-2389 Fix agent non-full-mode empty spaces bug
- PR: 3702: Optimize handling of deletes against Solr (#3702)
- PR: 3709: Translations update from Hosted Weblate
- PR: 3705: Translations update from Hosted Weblate
- PR: 3706: Translations update from Hosted Weblate
- PR: 3708: Translations update from Hosted Weblate
- PR: 3707: Translations update from Hosted Weblate
- PR: 3699: Fix for release building because of concurrent-ruby v1.3.5 has removed the dependency on logger
- PR: 3697: concurrent-ruby v1.3.5 has removed the dependency on logger
- PR: 3696: Start testing Solr v9.9.0
- PR: 3687: fix flakiness, reduce spec duration, rearrange spec groups to balance runtime (#3687)
- PR: 3694: migration 142 fails without securerandom
- PR: 3692: Translations update from Hosted Weblate
- PR: 3690 - ANW-2476: ANW-2476 Set resource fields not to duplicate in AppConfig
- PR: 3691: run e2e tests only when pushing to the default branch of the repository
- PR: 3689: Translations update from Hosted Weblate
- PR: 3688: Bump nokogiri from 1.18.8 to 1.18.9 in /e2e-tests
- PR: 3686: fix permissions on workflow (#3686)
- PR: 3685: only run e2e tests on master branch
- PR: 3684: Fix frontend Safari table column horizontal scroll bug
- PR: 3683 - ANW-2251: ANW-2251 Fix infinite tree record pane request path for prefixed domains
- PR: 3622: Indexer State files for Trees
- PR: 3481 - ANW-2251: ANW-2251: Replace the largetree in the resource show view with the InfiniteTree (#3481)
- PR: 3680: common translated using Weblate (Ukrainian) (#3680)
- PR: 3678: Fix the flaky enumerations_spec and "fix" the flaky trees_spec
- PR: 3666: Translations update from Hosted Weblate
- PR: 3660: Translations update from Hosted Weblate
- PR: 3661: Translations update from Hosted Weblate
- PR: 3659: Translations update from Hosted Weblate
- PR: 3658: Translations update from Hosted Weblate
- PR: 3656: ANW 2445: Extend launcher to allow log appending
- PR: 3653 - ANW-2422: ANW-2422: Fix Suppressed badge in staff tree bug
- PR: 3652: Dockerfile updates
- PR: 3645: frontend_help translated using Weblate (Polish) (#3645)
- PR: 3490 - ANW-2309: ANW-2309: Show arbitrary
InfiniteTreenode on page load (#3490) - PR: 3644: Translations update from Hosted Weblate
- PR: 3643: Translations update from Hosted Weblate
- PR: 3641: Translations update from Hosted Weblate
Total Pull Requests accepted: 163
Total Jira Tickets closed: 82