fix typo in 3.8.1 release notes
[evergreen-equinox.git] / docs / RELEASE_NOTES_3_8.adoc
index 01f56a3..f0f31d4 100644 (file)
@@ -3,7 +3,181 @@
 :numbered:
 :toclevels: 3
 
-== Evergreen 3.8-beta ==
+== Evergreen 3.8.1 ==
+
+This release contains bug fixes improving on Evergreen 3.8.0
+
+=== Upgrade notes ===
+
+The fix for https://bugs.launchpad.net/evergreen/+bug/1939338[Launchpad bug 1939338] modifies the `fm_IDL.xml` file.  To ensure that everything is up-to-date, existing Evergreen sites should run `autogen.sh` after restarting OpenSRF services and before restarting Apache.
+
+=== Bug Fixes ===
+
+==== Acquisitions ====
+
+* Protects real copies from deletion by an acqusitions line item cancel 
+(https://bugs.launchpad.net/evergreen/+bug/1928003[Bug 1928003])
+* Fixes an issue where EDIWriter.pm was not correctly applying some attribute types (https://bugs.launchpad.net/evergreen/+bug/1930740[Bug 1930740])
+* Fixes the Providers form to be more friendly to screenreaders (https://bugs.launchpad.net/evergreen/+bug/1950507[Bug 1950507])
+
+
+==== Administration ====
+
+* Adds rdeleted parameter to the pingest.pl script (https://bugs.launchpad.net/evergreen/+bug/1862652[Bug 1862652])
+* Fixes bug where Carousels could only be viewed & edited by their creating user (https://bugs.launchpad.net/evergreen/+bug/1939338[Bug 1939338])
+* Updates Hopeless Holds interface so Title links open in a new tab (https://bugs.launchpad.net/evergreen/+bug/1909681[Bug 1909681])
+* Fixes an issue where specific 'opensrf' user is required in oils_ctl.sh and autogen.sh https://bugs.launchpad.net/evergreen/+bug/1900005[Bug 1900005])
+* Adds MARC_NAMESPACE to Const.pm (https://bugs.launchpad.net/evergreen/+bug/1930747[Bug 1930747])
+* Fixes an issue preventng correct MADS processing of field 755 (https://bugs.launchpad.net/evergreen/+bug/1800871[Bug 1800871])
+* Adds default columns in the Angular staff catalog View Holds tab (https://bugs.launchpad.net/evergreen/+bug/1907123[Bug 1907123])
+* Adds filters to MARC Coded Value Map grid (https://bugs.launchpad.net/evergreen/+bug/1843970[Bug 1843970])
+
+==== API ====
+
+* Makes changes to the eBook API to support Overdrive's updated Checkouts API (https://bugs.launchpad.net/evergreen/+bug/1951021[Bug 1951021])
+* Fixes issue where loading records with located URIs deleted and recreated call_numbers (https://bugs.launchpad.net/evergreen/+bug/1482757[Bug 1482757])
+
+
+==== Architecture ====
+
+* Fixes typo in fm_idl.xml (https://bugs.launchpad.net/evergreen/+bug/1957840[Bug 1957840])
+* Fixes an issue where retrieving a title via SuperCat can crash if the title has a serial unit with statcats (https://bugs.launchpad.net/evergreen/+bug/1970486[Bug 1970486])
+* Upgrades karma in NPM dependencies (https://bugs.launchpad.net/evergreen/+bug/1965432[Bug 1965432])
+* Fixes variable in log_me sub (https://bugs.launchpad.net/evergreen/+bug/1778783[Bug 1778783])
+* Fixes material icons package error in NPM install (https://bugs.launchpad.net/evergreen/+bug/1969232[Bug 1969232])
+
+
+==== Catalog ==== 
+
+* Fixes an issue in the traditional staff catalog where PLACE_UNFILLABLE_HOLD override fails if there are no items available (https://bugs.launchpad.net/evergreen/+bug/1906842[Bug 1906842])
+* Fixes an issue in the Patron Search from Place Holds modal where barcode search was failing (https://bugs.launchpad.net/evergreen/+bug/1955927[Bug 1955927])
+* Restores Hold links in the staff catalog detail page that were broken by a Chrome update (https://bugs.launchpad.net/evergreen/+bug/1964019[Bug 1964019])
+* Fixes an issue in the traditional staff catalog where user settings wouldn't load in the Place Holds interface (https://bugs.launchpad.net/evergreen/+bug/1939426[Bug 1939426])
+* Excludes empty bibs with transcendent=f from location limited staff searches (https://bugs.launchpad.net/evergreen/+bug/1746800[Bug 1746800])
+* Fixes issue in the traditional staff catalog where Patron Barcode Completion didn't populate correctly in the Place Holds interface (https://bugs.launchpad.net/evergreen/+bug/1965317[Bug 1965317])
+* Fixes an issue in the Angular staff catalog where monograph parts were sorting incorrectly in the Place Holds interface (https://bugs.launchpad.net/evergreen/+bug/1965161[Bug 1965161])
+* Adds default columns in the Angular staff catalog View Holds tab (https://bugs.launchpad.net/evergreen/+bug/1907123[Bug 1907123])
+
+==== Cataloging ====
+
+* Fixes a regression where owning libraries were not indicated in the Holdings View dropdown (https://bugs.launchpad.net/evergreen/+bug/1739277[Bug 1739277])
+* Fixes an issue where batch deletes from an item bucket exhausted drones (https://bugs.launchpad.net/evergreen/+bug/1949910[Bug 1949910])
+* Fixes an issue where the Holdings View showed incorrect item counts (https://bugs.launchpad.net/evergreen/+bug/1933275[Bug 1933275])
+* Adds Author field to Item Buckets (https://bugs.launchpad.net/evergreen/+bug/1800474[Bug 1800474])
+* Fixes an issue where batch removal of items from an item bucket exhausted drones (https://bugs.launchpad.net/evergreen/+bug/1968082[Bug 1968082])
+* Splits Active Date and Create Date into separate columns in Angular Holdings View (https://bugs.launchpad.net/evergreen/+bug/1916600[Bug 1916600])
+* Adds Author field to Item Buckets (https://bugs.launchpad.net/evergreen/+bug/1800474[Bug 1800474])
+* Fixes copy templates setting to allow migration of copy templates from AngularJS to Angular (https://bugs.launchpad.net/evergreen/+bug/1951162[Bug 1951162])
+* Angular copy location editor can now pass multiple context org unit IDs (https://bugs.launchpad.net/evergreen/+bug/1956626[Bug 1956626])
+
+
+==== Circulation ====
+
+* Excludes child organizational units when fleshing standing penalties (https://bugs.launchpad.net/evergreen/+bug/1959461[Bug 1959461])
+* Fixes invalidate email regression (https://bugs.launchpad.net/evergreen/+bug/1950826[Bug 1950826])
+* Fixes a bug where Patron Search could cause the browser to become unresponsive (https://bugs.launchpad.net/evergreen/+bug/1959904[Bug 1959904])
+* Fixes issue with slow user merging or deleting (https://bugs.launchpad.net/evergreen/+bug/1960956[Bug 1960956])
+* Fixes display issue in Hold Shelf Record Summary Detail View (https://bugs.launchpad.net/evergreen/+bug/1838580[Bug 1838580])
+* Adds server-side saving for Holds Groups grids (https://bugs.launchpad.net/evergreen/+bug/1956003[Bug 1956003])
+* Fixes download & print issue with Angular Holds Pull List (https://bugs.launchpad.net/evergreen/+bug/1958265[Bug 1958265])
+* Adds duplicate barcode check to Item Status Replace Barcode (https://bugs.launchpad.net/evergreen/+bug/1950468[Bug 1950468])
+
+
+==== Client ====
+
+* Improved filtering on egBasicComboBox typeaheads (https://bugs.launchpad.net/evergreen/+bug/1819233[Bug 1819233])
+* Corrects print template data field names for Items Out template (https://bugs.launchpad.net/evergreen/+bug/1766726[Bug 1766726])
+* Implements batch method for adding users to a bucket (https://bugs.launchpad.net/evergreen/+bug/1946531[Bug 1946531])
+* Fixes untranslatable strings in the Historical Bills print template (https://bugs.launchpad.net/evergreen/+bug/1772631[Bug 1772631])
+
+==== Course Materials ====
+
+* Adds owning library check to Course Terms uniqueness constraint 
+(https://bugs.launchpad.net/evergreen/+bug/1942645[LP1942645])
+* Fixes course search issue (https://bugs.launchpad.net/evergreen/+bug/1913340[Bug 1913340])
+
+==== Documentation ====
+
+* Updates to Print Template Export documentation (https://bugs.launchpad.net/evergreen/+bug/1929592[Bug 1929592])
+* Added Advanced Authorities documentation (https://bugs.launchpad.net/evergreen/+bug/1944205[Bug 1944205])
+* Corrections to Override Actions documentation
+* Updates to Barcode Completion documentation
+* Added Course Materials documentation
+* Updates to Holds documentation
+* Updates to z39.50 documentation
+* Updates to OPAC Lists documentation
+* Added relevant Conference videos to some documentation pages
+* Updates to Using the Public Access Catalog documentation
+* Updates to Billing documentation
+
+==== OPAC ====
+
+* Fixes an issue in the Bootstrap OPAC where changing a branch did not clear the shelving location list (https://bugs.launchpad.net/evergreen/+bug/1946019[Bug 1946019])
+* Restores line breaks in Patron Messages (https://bugs.launchpad.net/evergreen/+bug/1927990[Bug 1927990])
+* Fixes an issue where some electronic resource links would not display in the Bootstrap OPAC (https://bugs.launchpad.net/evergreen/+bug/1950394[Bug 1950394])
+* Fixes an issue in the Bootstrap OPAC where the 'More Details' button was not translatable (https://bugs.launchpad.net/evergreen/+bug/1919494[Bug 1919494])
+* Fixes an issue where a hold in the status "Hold Shelf Delay" displayed blank in the OPAC (https://bugs.launchpad.net/evergreen/+bug/1959405[Bug 1959405])
+* Fixes Bootstrap OPAC 'More Details' button so it toggles to 'Less Details' when clicked (https://bugs.launchpad.net/evergreen/+bug/1920039[Bug 1920039])
+* Fixes circ history CSV export in the Bootstrap OPAC (https://bugs.launchpad.net/evergreen/+bug/1954923[Bug 1954923])
+* Fixes color contrast on Bootstrap OPAC forms (https://bugs.launchpad.net/evergreen/+bug/1942240[Bug 1942240])
+* Fixes formatting in Bootstrap OPAC My Lists (https://bugs.launchpad.net/evergreen/+bug/1907863[Bug 1907863])
+* Fixes a bug in the Bootstrap OPAC where the self-registration library setting wasn't honored (https://bugs.launchpad.net/evergreen/+bug/1958163[Bug 1958163])
+* Adds Matomo support to the Bootstrap OPAC (https://bugs.launchpad.net/evergreen/+bug/1966802[Bug 19668020])
+* Stopgap fix to prevent OPAC payment when zero-dollar or negative bills are present on a patron's account (https://bugs.launchpad.net/evergreen/+bug/1965579[Bug 19965579])
+
+
+==== Serials ====
+
+* Fixes an issue where subscription manager fetched too many parallel requests (https://bugs.launchpad.net/evergreen/+bug/1949389[Bug 1949389])
+
+==== Self Check ====
+
+* Adds Preferred Name to self checkout (https://bugs.launchpad.net/evergreen/+bug/1847827[Bug1847827])
+
+
+=== Acknowledgements ===
+
+We would like to thank the following individuals who contributed code,
+testing and documentation patches to the 3.8.1 point release of Evergreen:
+
+* MaryAnn Alexander
+* John Amundson
+* Jason Boyer
+* Dan Briem
+* Jennifer Bruch
+* Christine Burns
+* Steve Callender
+* Galen Charlton
+* Garry Collum
+* Jeff Davis
+* Bill Erickson
+* Jason Etheridge
+* Lynn Floyd
+* Ruth Frasur
+* Jeff Godin
+* Elaine Hardy
+* Blake Graham Henderson
+* Kyle Huckins
+* Tiffany Little
+* Shula Link
+* Mary Llewellyn
+* Terran McCanna
+* Gina Monti
+* Michele Morgan
+* Andrea Buntz Neiman
+* Jennifer Pringle
+* Mike Risher
+* Mike Rylander
+* Jane Sandberg
+* Chris Sharp
+* Jason Stephenson
+* Josh Stompro
+* Jennifer Weston
+* Beth Willis
+* Jessica Woolford
+
+
+== Evergreen 3.8.0 ==
 
 === Upgrade notes ===
 
 * My Account URL
 * Maximum number of spelling suggestions that may be offered
 * Stripe ISO 4217 currency code
-* Use an all lowercase version of a Stripe-supported ISO 4217 currency code.  Defaults to "usd"
 * Use Item Price or Cost as Primary Item Value
 * Use Item Price or Cost as Backup Item Value
 * Staff Catalog Search Filters
@@ -53,9 +226,80 @@ CREATE TABLE auditor.backup_usr_alert_msg AS
    WHERE alert_message IS NOT NULL;
 ----
 
+==== Reindexing for Search Suggestions ====
+
+The upgrade includes a partial reindexing to update search suggestions. After
+running the schema upgrade script, e.g., `version-upgrade/3.7.1-3.8.0-upgrade-db.sql`,
+the reindexing can be done as follows.
+
+First, in a `psql` session connected to your Evergreen database, run:
+
+[source,sql]
+----
+\a
+\t
+
+\o title
+select value from metabib.title_field_entry where source in (select id from biblio.record_entry where not deleted);
+\o author
+select value from metabib.author_field_entry where source in (select id from biblio.record_entry where not deleted);
+\o subject
+select value from metabib.subject_field_entry where source in (select id from biblio.record_entry where not deleted);
+\o series
+select value from metabib.series_field_entry where source in (select id from biblio.record_entry where not deleted);
+\o identifier
+select value from metabib.identifier_field_entry where source in (select id from biblio.record_entry where not deleted);
+\o keyword
+select value from metabib.keyword_field_entry where source in (select id from biblio.record_entry where not deleted);
+
+\o
+\a
+\t
+\q
+----
+
+Then, from the command line:
+
+[source,sh]
+----
+$ ~/EG-src-path/Open-ILS/src/support-scripts/symspell-sideload.pl title > title.sql
+$ ~/EG-src-path/Open-ILS/src/support-scripts/symspell-sideload.pl author > author.sql
+$ ~/EG-src-path/Open-ILS/src/support-scripts/symspell-sideload.pl subject > subject.sql
+$ ~/EG-src-path/Open-ILS/src/support-scripts/symspell-sideload.pl series > series.sql
+$ ~/EG-src-path/Open-ILS/src/support-scripts/symspell-sideload.pl identifier > identifier.sql
+$ ~/EG-src-path/Open-ILS/src/support-scripts/symspell-sideload.pl keyword > keyword.sql
+----
+
+Then finally, back in `psql`:
+
+[source,sql]
+----
+ALTER TABLE search.symspell_dictionary SET UNLOGGED;
+TRUNCATE search.symspell_dictionary;
+
+\i identifier.sql
+\i author.sql
+\i title.sql
+\i subject.sql
+\i series.sql
+\i keyword.sql
+
+CLUSTER search.symspell_dictionary USING symspell_dictionary_pkey;
+REINDEX TABLE search.symspell_dictionary;
+ALTER TABLE search.symspell_dictionary SET LOGGED;
+VACUUM ANALYZE search.symspell_dictionary;
+
+DROP TABLE search.symspell_dictionary_partial_title;
+DROP TABLE search.symspell_dictionary_partial_author;
+DROP TABLE search.symspell_dictionary_partial_subject;
+DROP TABLE search.symspell_dictionary_partial_series;
+DROP TABLE search.symspell_dictionary_partial_identifier;
+DROP TABLE search.symspell_dictionary_partial_keyword;
+----
+
 ==== Updating Reports on Patron Notes ====
 
-The underlying data structure for patron notes has  changed with all notes
+The underlying data structure for patron notes has changed with all notes
 living in the `actor.usr_message` table, so report writers will need to change
 the following paths in existing reports:
 
@@ -248,10 +492,10 @@ will be required for changes to take effect.
 Key differences from the AngularJS Holdings and Item Attr. editor 
 interfaces include the following:
 
-* Tabbed Holdings vs. Item Attr interfaces
+* Tabbed Holdings vs. Item Attr. interfaces.
 ** With option to display as a unified interface without tabs.
 * Item Attr. fields retain position when showing/hiding
-* Improve keyboard navigation of Item Attr. editor
+* Improve keyboard navigation of Item Attr. editor.
 * Templates are once again managed directly in the Item Attr. editor.
 * Item Attr. displays values as counts summaries with option to edit by
   clicking on a field (or tabbing + Enter) a la XUL.
@@ -289,7 +533,7 @@ they are used for sorting and paging.
 ===== Bib Record -1 Can No Longer Be Edited =====
 
 Now when retrieving the bibliographic record with the id of -1 the
-delete button will be missing and save button is disabled.
+delete button will be missing and the save button is disabled.
 
 In addition, new database rules now protect bib record ID -1,
 call number ID -1 and copy location ID 1 from editing.
@@ -329,7 +573,7 @@ This feature adds two new library settings:
  * Use Item Price or Cost as Primary Item Value
  * Use Item Price or Cost as Backup Item Value
 
-which intersect the behavior of these existing settings:
+Which intersect the behavior of these existing settings:
 
  * Charge lost on zero
  * Default Item Price
@@ -358,7 +602,7 @@ settings and consider cost first and then price second.
 The primary intended use case for this feature is:
 
  - If there's an acquisition cost, charge this as the lost value.
- - If there's not an acquisition cost, but there's price, charge the price.
+ - If there's not an acquisition cost, but there's a price, charge the price.
  - If neither, charge the default value.
 
 ===== Library selector on the holds pull list =====
@@ -368,10 +612,14 @@ This allows staff to view the pull list of any library where they have
 VIEW_HOLDS permissions, rather than having to log in to a workstation
 at that library.
 
+===== Angular Holds Pull List =====
+
+The holds pull list now uses Angular and has an address of `/eg2/en-US/staff/circ/holds/pull-list`.
+
 ===== New Item Triggered Events Log =====
 
 A reimplementation of the Item Triggered Events Log interface, building
-on the Patron Triggered Events Log Angular reimplemenation.
+on the Patron Triggered Events Log Angular reimplementation.
 
 ===== Template Support for Information and My Account URLs =====
 
@@ -414,7 +662,7 @@ include.  Example:
 
 This reworks the override action dialogs in the patron display for Check Out
 and Items Out, and in the Circulation -> Renew Items interface.  It exposes the
-auto-override behavior as checkboxes giving staff more fine grained control
+auto-override behavior as checkboxes giving staff more fine-grained control
 over which events are auto-forced or skipped upon subsequent encounters.  It
 also changes the Cancel action for batch renewals to abort the remaining
 renewals in the batch, and makes it so that new authorization credentials
@@ -557,7 +805,7 @@ made successfully before recording it.
 * The Bootstrap public catalog now displays cover images on the My Account
   items checked out, check out history, holds, and holds history pages.
 * Carousels on the public catalog home page now take up 80% of the page width
-  by default rather than just 40%
+  by default rather than just 40%.
 
 ==== Reports ====
 
@@ -573,6 +821,15 @@ To add the view, a system administrator will need to (re-)run
 the example.reporter-extension.sql script, which will create 
 the new view in the database.
 
+===== Hold/Copy Ratio Report Source Changes =====
+
+This standardizes how the existing Hold/Copy Ratio reports sources count holdable copies; notably, metarecord copies are no longer counted in these report sources and all sources now use action.hold_copy_map. 
+
+Any reports using these sources will need to be rewritten.
+
+A new source that breaks out counts by patron home library was also added, named Hold/Copy Ratio per Bib and Home Library.
+
+
 ===== Add Dewey Call Number Blocks and Ranges to Reports =====
 
 A new view is added to the reporter with links from Call Number that
@@ -615,6 +872,7 @@ Evergreen:
 
 * Adam Bowling
 * Andrea Buntz Neiman
+* Angela Kilsdonk
 * Beth Willis
 * Bill Erickson
 * Blake Graham-Henderson
@@ -644,6 +902,7 @@ Evergreen:
 * Katie G. Martin
 * Kyle Huckins
 * Lindsay Stratton
+* Lisa Carlucci
 * Lynn Floyd
 * Mary Llewellyn
 * Michele Morgan
@@ -657,6 +916,7 @@ Evergreen:
 * Stephen Wills
 * Terran McCanna
 * Tiffany Little
+* Verbio Group
 
 We also thank the following organizations whose employees contributed
 patches:
@@ -683,4 +943,3 @@ patches:
 We regret any omissions.  If a contributor has been inadvertently
 missed, please open a bug at http://bugs.launchpad.net/evergreen/
 with a correction.
-