Difference between revisions of "Releases/Roadmap"
(→Digital objects: Add documentation links) |
(→Finding aids: Add docs link) |
||
| Line 151: | Line 151: | ||
* #10591 - Update finding aid XSLTs with formatting improvements | * #10591 - Update finding aid XSLTs with formatting improvements | ||
| + | |||
| + | '''Related documentation''' | ||
| + | |||
| + | * [https://www.accesstomemory.org/docs/2.6/user-manual/reports-printing/print-finding-aid/ Generate, upload, download, and print finding aids] | ||
| + | |||
| + | Note: the documentation is unchanged by these enhancements, other than updating a few screenshots. | ||
===Import/Export=== | ===Import/Export=== | ||
Revision as of 16:34, 7 July 2020
Main Page > Releases > Releases/Roadmap
On this page, you'll find summaries about upcoming releases, and issue tickets related to them. As the releases are finalized, elements on this page will be used to draft the formal release announcements found here.
Tip
You can also check out the issues associated with upcoming releases by looking at the Roadmap page in our issue tracker.
Contents
Release 2.6
Accession records
We've added the ability to include alternative identifiers on accession records. Following the guidelines of the new Canadian Archival Accession Information Standard (CAAIS, the first national accessions standard, modeled off the ICA standards in structure), these identifiers can each be given a type (reusable terms managed in a new taxonomy) and also have corresponding note fields. These new fields are also supported in the CSV import templates, and have been added to the search index. We've also added the ability to associate physical storage containers with accession records, and turned the Extent field into a multi-line input.
Sponsored by the Provincial Archives of Saskatchewan
- #13198 - Allow multi-line input on accession "Received Extent Units" field in edit page
Sponsored by the Government of the Northwest Territories
- #13254 - Add the ability to add multiple identifiers to accessions, with type and note values
- #13262 - CSV import for accession alternative identifiers
- #13265 - Add search support for accession alternative identifiers
- #13269 - Add the ability to associate accessions with physical storage containers
Related documentation
Updated accessions CSV template:
Analytics
We've extended the way that Google Analytics can be customized in AtoM, by adding basic Google Tag Manager support. With proper configuration, this would allow site administrators to get insight into how often a download is triggered, a finding aid accessed, and more.
Sponsored by the United Nations Archives and Records Management Section
- #13284 - Add Google Tag Manager support
Related documentation
Authority records
In addition to overhauling the authority record import templates, we've also added the ability to see related authority records in term search and browse results (such as subjects and places), as well as adding new advanced search options to filter authority records by the relationship type to other authorities.
General bug fixes and enhancements
- #13157 - Add paging to authority record description relations to avoid editing timeouts
Sponsored by an undisclosed organization
- #13275 - Display related authority records on Term view and Taxonomy browse pages
- #13276 - Filter authority record searches by relationship type
Related documentation
Updated 2.6 Authority record CSV import templates:
Clipboard
The Clipboard module now includes a configurable section that can be used to allow clipboard results to be sent to a third-party site as a JSON array, using HTTP POST or GET methods. This can be used to integrate with a third party reference management application, for example.
Sponsored by the Bernard Becker Medical Library Archives at Washington University in St. Louis
- #12800 - Add JSON export of AtoM clipboard items for third-party integrations
Related documentation
Command-line tasks
In addition to the enhancements described in the Digital Obects section of these release notes, we've also added a few new enhancements to help with maintenance. These include a new task to output the index for a specific description, a task to move authority record description relations from one actor to another, and more.
- #13189 - Add task to move authority record description relations from one actor to another
- #13257 - Add ES version to search:status task output
- #13291 - Add task to output search index data for a target description
- #13358 - Add option to the build nested set task to exclude types
See also the various CLI task enhancements in the Digital objects section.
Related documentation
- Move authority record relations
- Check ES status
- Output the index of a description
- Rebuild the nested set
Digital objects
We have replaced the Flash-based flowplayer used for streaming media with a modern HTML5 based player (mediaElementJs). MediaElement has Flash fallback for legacy browsers, and supports aria tags, captions, plugins for additional functionality and more. We've also updated two digital object command-line tasks and added new options to them, including adding a method to delete all digital objects associated with a particular repository, and an option in the digital object load task to replace existing attached digital objects.
General bug fixes and enhancements
- #13196 - CLI regenerate derivatives task produces error when --slug used with --no-overwrite
- #13243 - Regression: identifier and title context lost on link digital object page
Sponsored by the Oregon Historical Society
- #12902 - Replace flowplayer with an HTML5 media player and update default derivative generation
- #12903 - Add new option to Digital object regen-derivatives task to allow regenerating only video file derivatives
Sponsored by the Provincial Archives of Saskatchewan
- #13103 - Add --attach-only option to digital object load task
- #13126 - Add --skip-nested-set-build option to digital object load task
Sponsored by the University of Saskatchewan Libraries
- #13152 - Add --replace option to digital object load task to allow uploads to replace existing digital objects
Sponsored by the Archives Society of Alberta
- #13288 - Overhaul digitalobject:delete task and add new options to delete all digital objects associated with a repository, and limit to a specific media type
Related documentation
Note: the documentation for linking digital objects is unchanged by the upgrade to a new media player. Some screenshots in the documentation may have been updated.
Finding aids
In collaboration with Dalhousie University Library, we've implemented some minor but much needed usability and formatting improvements to the finding aid layouts.
General bug fixes and enhancements
- #12707 - Finding aids will display custom levels as "otherlevel" instead of using otherlevel value
Collaboratively developed / sponsored by Dalhousie University Library
- #10591 - Update finding aid XSLTs with formatting improvements
Related documentation
Note: the documentation is unchanged by these enhancements, other than updating a few screenshots.
Import/Export
The authority record CSV import templates have received a major overhaul - now there is no separate Alias CSV (it has been merged into the main authority record CSV), and the relationships CSV can be imported via the user interface, as well as used to add relationships to existing authorities (previously it could only be imported via the command-line at the same time as an accompanying authority record CSV that contained all referenced records). The accessions CSV template got three previously unsupported fields added, a new bulk authority CSV export task was added to the command-line, and a brand new physical storage CSV import has been added to the command-line as well, which will support update imports. A command-line "roundtrip" option has been added to the descriptions CSV import that vastly improves matching when exporting records, updating the CSV, and then reimporting them into the same system. Finally, a few fixes and new setting options for the DC XML export should improve its utility for those using the OAI Repository module to expose records for harvesting.
General bug fixes and enhancements
- #6317 - EAD <repository> will not import properly if it is not nested in a <corpname> element
- #13130 - DC XML should include inherited creator(s) at lower levels
- #12281 - Add roundtrip option to CLI CSV import for better matching
- #13204 - An apostrophe in the repository code will cause EAD XML imports to fail
- #13246 - Add --limit option to task for caching XML representations
Sponsored by the WUSTL Bernard Becker Medical Library Archives
- #12799 - Add donorNotes column to CSV import template for Accessions
Sponsored by the University of Saskatchewan Libraries
- #13148 - Add support for command-line bulk authority record CSV export task
Sponsored by the Government of the Northwest Territories
- #13262 - Add CSV import support for accession alternative identifiers
- #13310 - Add donorFax and donorContactPerson columns to Accession CSV import
Sponsored by the City of Vancouver Archives
- #13183 - Add CSV import for physical locations
- #13185 - Add ability to update physical storage data via CSV import
Sponsored by the University of Strathclyde Archives and Special Collections
- #13244 - Add setting to determine if identifier or reference code is used in DC XML
Sponsored by an undisclosed organization
- #13249 - Add support for digital object CSV import/export for authority records
- #13277: Alias and relations added to CSV GUI import for Authority records
- #13279: Add relationship type to authority record relations CSV import and export
- #13280: Create relationships between existing authority records via CSV import
- #13282: Add Alias fields (parallelNames, standardizedNames, and otherFormNames) to Authority Record CSV export
OAI Repository
In addition to some of the DC XML export enhancements outlined in the Import/Export section, we've also addressed some outstanding bugs in the OAI Repository module.
General bug fixes and enhancements
- #12387 - OAI-PMH GetRecord verb should filter Draft descriptions consistent with other verb responses
- #13163 - OAI identify command base URL does not respect HTTPS; appends index.php unnecessarily
Contributed via community pull request from Rohan Ferris
- #13025 - Convert UTC time to localtime in OAI requests
Performance, Stability, and Internals
We've implemented a number of internal enhancements to improve AtoM's overall performance and stability - these changes are predominantly focused on deletions, upgrades, indexing, and CSV imports. One of the biggest changes was upgrading AtoM’s MySQL version to 8.0, and using the Percona Monitoring & Management (PMM) tool to identify key areas for query optimization. Most significantly, in several areas we have replaced the nested set queries (used to manage hierarchical relations in a flat relational database) with MySQL8’s implementation of Common Table Expressions (CTE; sometimes referred to as WITH queries). Overall this has led to significant performance gains - details of which have been captured on issue ticket #13224. We've also optimized the search indexing and the CSV import task - and some new options in some of the command line task (captured in other sections of this roadmap) also helped us optimize some of our processes that use these tasks.
- #10306 - Improve foreign key declarations in database schema
- #13220 - Upgrade to MySQL 8
- #13221 - Avoid schema differences between a default install and an upgraded database
- #13224 - Improve hierarchy management queries
- #13237 - Reconsider nested set implementation in some models
- #13239 - Improve deletion of nested set hierarchies (especially terms)
- #13350 - Reduce likelihood of issues when upgrading from 1.x to 2.6.x
- #13352 - Reduce resource save/indexing count on description CSV import
- #13354 - Avoid nested set update on descriptions CSV import (reduce DB deadlocks)
- #13355 - Reduce memory usage on descriptions CSV import
- #13356 - Remove lft field from description ES index
- #13261 - Improve Elasticsearch indexing process
- #13362 - Move analyze table calls to the end of the upgrade process
Physical storage
In addition to the new command-line physical storage CSV import (described in the Import/Export section), we've also added a brand new CSV report to the physical storage module. This report focuses on container relations with accessions and descriptions, and can be customized on export.
General bug fixes and enhancements
- #13201 - Browse physical storage page does not show values that have not been translated
Sponsored by the Government of the Northwest Territories
- #13269 - Add new CSV report for physical storage location reporting
Related documentation
Search/Browse
We've added some minor enhancements and bug fixes to the search and browse options in AtoM that should improve the overall experience.
General bug fixes and enhancements
- #5173 - Improve default alphabetic sort to better reflect natural sort expectations
- #13186 - Add user-configurable setting for treeview paging limit
Sponsored by the Government of the Northwest Territories
- #12471 - Hovering over a truncated facet filter doesn't show the full name in simple label tooltip
Sponsored by the Bernard Becker Medical Library Archives at Washington University in St. Louis
- #12797 - Make "Browse digital objects" link on description view page context sensitive
Sponsored by the Provincial Archives of Sasksatchewan
- #13175 - Improve information object search indexing speed
Sponsored by the Mills Archive
- #13230 - Date range sorting is broken following Elasticsearch upgrade in 2.5.x
Collaboratively prepared by community user Monica Wood (University of Tasmania) and Artefactual Systems
- #13299 - If unique records count matches count of only other language, language facet should not display
Settings
The Visible elements module got a few new DACS-related options, and the full-width treeview has some additional settings to increase the paging limit (up to 10,000 records per load), and to make the tree collapsible on first load (much like the advanced search panel). We've also added a simple notification that appears on Save in the settings page, to better confirm to end users that the changes have been applied.
- #13105 - Add warning message to security settings page
Sponsored by the WUSTL Bernard Becker Medical Library Archives
- #12798 - Add Visible elements module for DACS area headings
- #13049 - Add DACS Physical access field to Visible elements
- #13135 - Add new setting to make full-width treeview collapsible
Sponsored by Strathclyde University Archives
- #13320 - Increase treeview pager limit setting from 1,000 to a max value of 10,000
Bug fixes and other tickets
- #13173 - If identifiers contain syntax that conforms to markdown syntax, the identifier is rendered in markdown
- #13174 - Jobs can hang if console output is greater than 64KiB
- #13196 - CLI regenerate derivatives task produces error when --slug used with --no-overwrite
Seealso
For a full list of issues related to the 2.6 release, see the following links to our issue tracker:
Wishlist
This project in our issue tracker is where new unsponsored feature requests for Access to Memory (AtoM) can be added. This allows us to log feature requests, and begin discussion about requirements and design without adding confusion to the main AtoM project's issue tracker as to which features will be included in an upcoming release.
See the AtoM Wishlist project here:
Tip
Once you've followed the link above, you can click on the "Issues" link at the top of the page to browse all issue tickets in the AtoM Wishlist. You can sort the list of issues by clicking on a column header, and use the Filter drop-down menu to the right to customize the query.
How the Wishlist works
When features are sponsored by an institution, or developed and submitted via community pull request, they will be copied to the main AtoM project in our issue tracker (here), and marked verified in the Wishlist project. Developer discussion, quality assurance testing, and other related updates will be posted to the related development ticket in the main AtoM project.
The tested version tag can be used in the Wishlist's issue description to keep track of when the feature was requested (e.g. which version of AtoM was most recent when the feature request came in)
The target version will only be applied before a Wishlist ticket is verified (closed) and copied to the main AtoM project.
Seealso
- We've got information on our main AtoM issue tracker, and how you can use it to submit a bug report here: Resources/Issue tracker.
- Got questions? Not sure if something is a bug or not, if a wishlist feature might be of interest to the rest of the community, or if something is already on our upcoming development roadmap? Why not make a post in our AtoM User Forum?