docs/RELEASE_NOTES_3_5.adoc

   1 Evergreen 3.5 Release Notes
   2 ===========================
   3 :toc:
   4 :numbered:
   5
   6 == Evergreen  3.5.5 ==
   7
   8 This release contains bug fixes improving on Evergreen 3.5.4.
   9
  10 === Bug Fixes ===
  11
  12 ==== Catalog ====
  13
  14 * Fixes an issue displaying highlighting in traditional and bootstrap catalogue (https://bugs.launchpad.net/bugs/1923225[Bug 1923225])
  15 * Fixes an issue displaying works with the word "hidden" in the title (https://bugs.launchpad.net/bugs/1930933[Bug 1930933])
  16
  17
  18 ==== Circulation ====
  19
  20 * Preferred Name is now the prominent display name (https://bugs.launchpad.net/bugs/1924185[Bug 1924185])
  21 * Unchanged workstation settings are no longer re-applied on every checkin (https://bugs.launchpad.net/bugs/1918362[Bug 1918362])
  22
  23 === Acknowledgements ===
  24
  25 We would like to thank the following individuals who contributed code,
  26 testing and documentation patches to the 3.5.5 point release of Evergreen:
  27
  28
  29 * Galen Charlton
  30 * Jeff Davis
  31 * Michele Morgan
  32 * Jane Sandberg
  33 * Jason Stephenson
  34
  35 == Evergreen  3.5.4 ==
  36
  37 This release contains bug fixes improving on Evergreen 3.5.3, including
  38 a security bug fix.
  39
  40 === Bug Fixes ===
  41
  42 Security
  43 ^^^^^^^^
  44
  45 * Fixes an XSS bug in MARC fields that are rendered as HTML (https://bugs.launchpad.net/bugs/1902965[Bug 1902965])
  46
  47 Administration
  48 ^^^^^^^^^^^^^^
  49
  50 * Angular admin pages now scope to the appropriate library (https://bugs.launchpad.net/bugs/1873322[Bug 1873322])
  51
  52 Client
  53 ^^^^^^
  54
  55 * Angular Staff Client Hamburger Menu is no longer clipped off screen (https://bugs.launchpad.net/bugs/1915323[Bug 1915323])
  56
  57 OPAC
  58 ^^^^
  59
  60 * Terms Governing Use and Reproduction Note Displays Twice in Record Details (https://bugs.launchpad.net/bugs/1917804[Bug 1917804])
  61
  62 Staff catalog
  63 ^^^^^^^^^^^^^
  64
  65 * Angular Catalog: Part column missing from Item table (https://bugs.launchpad.net/bugs/1899405[Bug 1899405])
  66 * Publication information in angular search results does not display from tag 264 (https://bugs.launchpad.net/bugs/1896840[Bug 1896840])
  67
  68 Performance
  69 ^^^^^^^^^^^
  70
  71 * Search indexes use GIN by default (https://bugs.launchpad.net/bugs/1703658[Bug 1703658])
  72
  73 === Upgrade notes ===
  74
  75 A partial reingest is required to extract the new publisher data for display.
  76 This query may be long-running.
  77
  78 [source,sql]
  79 --------------------------------------------------------------------------
  80 WITH affected_bibs AS (
  81     SELECT DISTINCT(bre.id) AS id
  82     FROM biblio.record_entry bre
  83     JOIN metabib.real_full_rec mrfr
  84     ON (mrfr.record = bre.id AND mrfr.tag = '264')
  85     WHERE NOT bre.deleted
  86 )
  87 SELECT metabib.reingest_metabib_field_entries(id, TRUE, FALSE, TRUE, TRUE)
  88 FROM affected_bibs;
  89 --------------------------------------------------------------------------
  90
  91
  92
  93 === Acknowledgements ===
  94
  95 We would like to thank the following individuals who contributed code,
  96 testing and documentation patches to the 3.5.4 point release of Evergreen:
  97
  98
  99 * Jason Boyer
 100 * Dan Briem
 101 * Garry Collum
 102 * Jeff Davis
 103 * Bill Erickson
 104 * Galen Charlton
 105 * Michele Morgan
 106 * Jane Sandberg
 107 * Jason Stephenson
 108
 109 Evergreen 3.5.3
 110 ---------------
 111
 112 This release contains bug fixes improving on Evergreen 3.5.2,
 113 including a security bug fix.
 114
 115 Bug Fixes
 116 ~~~~~~~~~
 117
 118 Security
 119 ^^^^^^^^
 120
 121 * Fix an issue where `open-ils.pcrud` backends could crash with
 122 a segmentation fault under certain conditions that could be invoked
 123 by an external attacker, thus leading to a potential denial
 124 of service attack.
 125
 126 Staff Interface
 127 ^^^^^^^^^^^^^^^
 128 * Expert Search in the staff interface now respects the search library.
 129 (https://bugs.launchpad.net/evergreen/+bug/1468132[Bug 1468132])
 130 * The Items Out page is now less prone to cause `open-ils.actor` backend
 131 exhaustion. It now also displays a progress bar while loading.
 132 (https://bugs.launchpad.net/evergreen/+bug/1913811[Bug 1913811])
 133 * Grids in the staff interface no longer require that a row
 134 be selected in order to activate a grid action that doesn't
 135 logically require that at least one row be selected.
 136 (https://bugs.launchpad.net/evergreen/+bug/1670457[Bug 1670457])
 137 * The display of total amounted billed, owed, and paid on the patron
 138 Bills page now reflects just open bills with a non-zero balance, fixing
 139 an issue where the totals could include paid billings for transactions
 140 that are still open.
 141 (https://bugs.launchpad.net/evergreen/+bug/1772955[Bug 1772955])
 142 * The pending patron interface now respects the library setting whether
 143 to set the patron's initial password to the last four digits of their
 144 phone number.
 145 (https://bugs.launchpad.net/evergreen/+bug/1887852[Bug 1887852])
 146 * Several interfaces, including Mark Missing, adding patrons to a bucket
 147 from a search, and applying a default item status now use batch
 148 API calls for better efficiency.
 149 (https://bugs.launchpad.net/evergreen/+bug/1896285[Bug 1896285])
 150 * Fix an issue where the holdings editor would not close its window
 151 when the Save & Exit button was clicked.
 152 (https://bugs.launchpad.net/evergreen/+bug/1913219[Bug 1913219])
 153 * Fix an issue where a double barcode scan could create a precat
 154 item without giving the staff member the chance to review the
 155 form before submitting it.
 156 (https://bugs.launchpad.net/evergreen/+bug/1778522[Bug 1778522])
 157 * Fix an issue preventing the staff interface from being used
 158 on various Android and iOS devices.
 159 (https://bugs.launchpad.net/evergreen/+bug/1901760[Bug 1901760])
 160 * Fix an issue where the report editor could supply the wrong
 161 kind of input for an aggregate filter.
 162 (https://bugs.launchpad.net/evergreen/+bug/1858114[Bug 1858114])
 163
 164 Public Catalog
 165 ^^^^^^^^^^^^^^
 166
 167 * Fix an issue where titles could run together when viewing a
 168 carousel with a mobile browser.
 169 (https://bugs.launchpad.net/evergreen/+bug/1868147[Bug 1868147])
 170 * The order that items in a carousel display in is now more
 171 predictable. For example, for 'Top Circulated Items' carousels,
 172 the order is from most circulated to least circulated.
 173 (https://bugs.launchpad.net/evergreen/+bug/1866406[Bug 1866406])
 174 * Carousels no longer display deleted items.
 175 (https://bugs.launchpad.net/evergreen/+bug/1836254[Bug 1836254])
 176 * CGI parameters in the public catalog are now consistently forced
 177 to be separated by ampersands rather than semicolons.
 178 (https://bugs.launchpad.net/evergreen/+bug/1687545[Bug 1687545]) and
 179 (https://bugs.launchpad.net/evergreen/+bug/1914116[Bug 1914116])
 180
 181 Administration
 182 ^^^^^^^^^^^^^^
 183
 184 * The EDI Webrick installer now works on Ubuntu 18.04
 185 (https://bugs.launchpad.net/evergreen/+bug/1901900[Bug 1901900])
 186
 187 Acknowledgements
 188 ~~~~~~~~~~~~~~~~
 189 We would like to thank the following individuals who contributed code,
 190 testing and documentation patches to the 3.5.3 point release of Evergreen:
 191
 192 * John Amundson
 193 * Zavier Banks
 194 * Jason Boyer
 195 * Dan Briem
 196 * Galen Charlton
 197 * Garry Collum
 198 * Jeff Davis
 199 * Bill Erickson
 200 * Ruth Frasur
 201 * Blake Graham-Henderson
 202 * Angela Kilsdonk
 203 * Terran McCanna
 204 * Michele Morgan
 205 * Jane Sandberg
 206 * Mike Rylander
 207 * Chris Sharp
 208 * Jason Stephenson
 209
 210 Evergreen 3.5.2
 211 ---------------
 212
 213 This release contains bug fixes improving on Evergreen 3.5.1.
 214
 215 Bug Fixes
 216 ~~~~~~~~~
 217
 218 Accessibility
 219 ^^^^^^^^^^^^^
 220
 221 * Help popovers in the AngularJS staff client can now be opened using keyboard navigation
 222 (https://bugs.launchpad.net/evergreen/+bug/1801947[Bug 1801947])
 223 * Keyboard navigation improvement to the Register/Edit Patron screen
 224 (https://bugs.launchpad.net/evergreen/+bug/1840329[Bug 1840329])
 225 * Decorative icons in the navbar are now aria-hidden
 226 (https://bugs.launchpad.net/evergreen/+bug/1795720[Bug 1795720])
 227 * The staff login page now contains an apporopriate heading
 228 (https://bugs.launchpad.net/evergreen/+bug/1839365[Bug 1839365])
 229
 230 Acquisitions
 231 ^^^^^^^^^^^^
 232
 233 * Improve wording in acquisitions line item actions menu
 234 (https://bugs.launchpad.net/evergreen/+bug/1418694[Bug 1418694])
 235
 236 Administration
 237 ^^^^^^^^^^^^^^
 238
 239 * Permission Group Interface refreshes after making permission changes
 240 (https://bugs.launchpad.net/evergreen/+bug/1891355[Bug 1891355])
 241 * Permissions for creating/modifying booking reservations can now be
 242 scoped by org unit
 243 (https://bugs.launchpad.net/evergreen/+bug/1835127[Bug 1835127])
 244 * Fixes issues with sharing settings in the reporter
 245 (https://bugs.launchpad.net/evergreen/+bug/1851413[Bug 1851413])
 246 * It is now possible to report on non-cataloged circulations
 247 separately from non-cataloged in-house uses
 248 (https://bugs.launchpad.net/evergreen/+bug/1788260[Bug 1788260])
 249 * Prevents duplicated report outputs
 250 (https://bugs.launchpad.net/evergreen/+bug/1893463[Bug 1893463])
 251 * Fixes a UI issue in the reporter
 252 (https://bugs.launchpad.net/evergreen/+bug/1207744[Bug 1207744])
 253 * Improves description of an org unit setting
 254 (https://bugs.launchpad.net/evergreen/+bug/1325704[Bug 1325704])
 255
 256 Cataloging
 257 ^^^^^^^^^^
 258
 259 * Catalogers can now batch edit call numbers from item buckets
 260 (https://bugs.launchpad.net/evergreen/+bug/1747664[Bug 1747664])
 261 * The item editor now displays all circulation modifiers when batch updating
 262 (https://bugs.launchpad.net/evergreen/+bug/1844732[Bug 1844732])
 263 * When merging bibliographic records, the deleted record is now also marked as
 264 inactive (https://bugs.launchpad.net/evergreen/+bug/1771386[Bug 1771386])
 265 * The staff catalog now includes a UPC search option
 266 (https://bugs.launchpad.net/evergreen/+bug/1885764[Bug 1885764])
 267 * Catalogers can now choose "AND" or "OR" as the root node of a record match set
 268 (https://bugs.launchpad.net/evergreen/+bug/1839562[Bug 1839562])
 269 * The Replace Item Barcode screen now displays an error message when trying to
 270 replace a barcode with a barcode already in use (Bugs
 271 https://bugs.launchpad.net/evergreen/+bug/1362743[1362743]
 272 and https://bugs.launchpad.net/evergreen/+bug/1890498[1890498])
 273 * The Angular Catalog's Holding View grid now includes more columns
 274 (https://bugs.launchpad.net/evergreen/+bug/1892077[Bug 1892077])
 275 * The Angular Catalog's Holding View grid context menu no longer includes horizontal scroll bars
 276 (https://bugs.launchpad.net/evergreen/+bug/1890849[Bug 1890849])
 277 * Fixes an issue that caused the Holdings View grid to not display all necessary holdings
 278 (https://bugs.launchpad.net/evergreen/+bug/1845047[Bug 1845047])
 279 * Fixes an issue with the Staff Catalog call number browse
 280 (https://bugs.launchpad.net/evergreen/+bug/1889685[Bug 1889685])
 281 * Fixes an issue with exporting MARC records via a CSV file
 282 (https://bugs.launchpad.net/evergreen/+bug/1850825[Bug 1850825])
 283 * Fixes an issue with the queue type selector in the Inspect Queue screen
 284 (https://bugs.launchpad.net/evergreen/+bug/1890351[Bug 1890351])
 285 * Display a helpful message when a staff catalog barcode search doesn't match
 286 any barcodes (https://bugs.launchpad.net/evergreen/+bug/1896083[Bug 1896083])
 287 * Filters in the angular staff catalog now differentiate between OPAC visible
 288 and OPAC invisible values
 289 (https://bugs.launchpad.net/evergreen/+bug/1872867[Bug 1872867])
 290
 291
 292
 293 Circulation
 294 ^^^^^^^^^^
 295
 296 * The Patron Edit form now reflects the opac.hold_notify user setting, if set
 297 (https://bugs.launchpad.net/evergreen/+bug/1879993[Bug 1879993])
 298 * The Register Patron form can now set default password according to a patron's
 299 phone number when the org setting "Patron: password from phone #" is TRUE
 300 (https://bugs.launchpad.net/evergreen/+bug/1900184[Bug 1900184])
 301 * The Patron self-registration form now persists a patron's selected home library,
 302 even if they refresh the form in their browser
 303 (https://bugs.launchpad.net/evergreen/+bug/1361270[Bug 1361270])
 304 * Offline circulation interface now lists organizational units in the correct order
 305 (https://bugs.launchpad.net/evergreen/+bug/1724019[Bug 1724019])
 306 * Several improvements to placing holds in the Angular staff catalog
 307 (https://bugs.launchpad.net/evergreen/+bug/1851882[Bug 1851882])
 308 * The org unit selector in the staff catalog holds tab is now sticky
 309 (https://bugs.launchpad.net/evergreen/+bug/1889113[Bug 1889113])
 310 * Fixes an issue that resulted in displaying duplicate holds in the catalog's View
 311 Holds tab (https://bugs.launchpad.net/evergreen/+bug/1865564[Bug 1865564])
 312 * Fixes an issue in which cataloged resources sometimes do not appear in the
 313 Booking Pull List (https://bugs.launchpad.net/evergreen/+bug/1882828[Bug 1882828])
 314 * The Booking Pull List grid now allows users to save their grid settings
 315 (https://bugs.launchpad.net/evergreen/+bug/1882825[Bug 1882825])
 316 * Fixes an issue with the hold targeter
 317 (https://bugs.launchpad.net/evergreen/+bug/1508208[Bug 1508208])
 318 * Fixes an issue that prevents items from circulating when OpenSRF is installed
 319 with non-default router names
 320 (https://bugs.launchpad.net/evergreen/+bug/1904220[Bug 1904220])
 321
 322 Client
 323 ^^^^^^
 324
 325 * Fixes an issue with keyboard shortcuts in the Angular Staff Client
 326 (https://bugs.launchpad.net/evergreen/+bug/1883126[Bug 1883126])
 327 * Fixes an issue that caused a blank screen to appear
 328 (https://bugs.launchpad.net/evergreen/+bug/1855737[Bug 1855737])
 329
 330
 331 Public Catalog
 332 ^^^^^^^^^^^^^^
 333
 334 * Fixes an issue which prevented Zotero from gathering metadata from the
 335 public catalog (https://bugs.launchpad.net/evergreen/+bug/1776954[Bug 1776954])
 336
 337 Acknowledgements
 338 ~~~~~~~~~~~~~~~~
 339 We would like to thank the following individuals who contributed code,
 340 testing and documentation patches to the 3.5.2 point release of Evergreen:
 341
 342 * Jason Boyer
 343 * Dan Briem
 344 * Galen Charlton
 345 * Garry Collum
 346 * Jeff Davis
 347 * Bill Erickson
 348 * Jason Etheridge
 349 * Ruth Frasur
 350 * Rogan Hamby
 351 * Elaine Hardy
 352 * Shula Link
 353 * Tiffany Little
 354 * Mary Llewellyn
 355 * Terran McCanna
 356 * Christine Morgan
 357 * Michele Morgan
 358 * Jennifer Pringle
 359 * Mike Risher
 360 * Mike Rylander
 361 * Jane Sandberg
 362 * Dan Scott
 363 * Chris Sharp
 364 * Remington Steed
 365 * Jason Stephenson
 366 * Jennifer Weston
 367 * Beth Willis
 368
 369
 370 Evergreen 3.5.1
 371 ---------------
 372
 373 This release contains bug fixes improving on Evergreen 3.5.0.
 374
 375 Bug Fixes
 376 ~~~~~~~~~
 377
 378
 379 Administration
 380 ^^^^^^^^^^^^^^
 381
 382 * Fixes a bug that caused the Emergency Closing handler to skip circulations with fines (https://bugs.launchpad.net/evergreen/+bug/1870605[Bug 1870605])
 383 * The column headers in the Copy Status configuration screen have improved labels (https://bugs.launchpad.net/evergreen/+bug/1848573[Bug 1848573])
 384 * Fixes an incorrect link to the Match Set configuration screen (https://bugs.launchpad.net/evergreen/+bug/1840294[Bug 1840294])
 385 * Updates the descriptions of the _circ.staff_client.receipt_ library settings (https://bugs.launchpad.net/evergreen/+bug/1705302[Bug 1705302])
 386 * The labels of the All Circulations reporter sources have been clarified (https://bugs.launchpad.net/evergreen/+bug/1852443[Bug 1852443])
 387 * The emergency closing form provides additional guidance about end dates (https://bugs.launchpad.net/evergreen/+bug/1867524[Bug 1867524])
 388 * The badge_score_generator.pl script is now installed as part of an Evergreen install (https://bugs.launchpad.net/evergreen/+bug/1847784[Bug 1847784])
 389 * User preferred names and name keywords are now purged from the database when the user is purged
 390 (https://bugs.launchpad.net/evergreen/+bug/1802166[Bug 1802166])
 391 * Fixes a bug with the "months ago" functionality in the reporter (https://bugs.launchpad.net/evergreen/+bug/1885759[Bug 1885759])
 392 * Angular call number prefix/suffix admin pages no longer let you edit sort key (https://bugs.launchpad.net/evergreen/+bug/1889251[Bug 1889251])
 393
 394 Cataloging
 395 ^^^^^^^^^^
 396
 397 * Various improvements to the MARC Editor (Bugs https://bugs.launchpad.net/evergreen/+bug/1735568[Bug 1735568] and
 398 https://bugs.launchpad.net/evergreen/+bug/1830443[Bug 1830443])
 399 * Fixes an issue with undeleting bibliographic records (https://bugs.launchpad.net/evergreen/+bug/1845241[Bug 1845241])
 400 * Item status now alerts the user about invalid barcodes uploaded from a file (https://bugs.launchpad.net/evergreen/+bug/1847784[Bug 1847784])
 401 * You can now open multiple items in Item Status from an item bucket (https://bugs.launchpad.net/evergreen/+bug/1735828[Bug 1735828])
 402 * The experimental catalog now allows searching by format (https://bugs.launchpad.net/evergreen/+bug/1886118[Bug 1886118])
 403 * The experimental catalog now displays the bib call number according to the search library's org unit setting
 404 (https://bugs.launchpad.net/evergreen/+bug/1874897[Bug 1874897])
 405 * Fixes an issue with adding and editing call numbers in the experimental catalog (https://bugs.launchpad.net/evergreen/+bug/1878079[Bug 1878079])
 406 * Newly added items and call numbers have distinct styling (https://bugs.launchpad.net/evergreen/+bug/1731370[Bug 1731370])
 407 * Fixes an issue with hold activation dates (https://bugs.launchpad.net/evergreen/+bug/1783793[Bug 1783793])
 408 * Adds item creator and editor to holdings editor grids (https://bugs.launchpad.net/evergreen/+bug/1811466[Bug 1811466])
 409 * The experimental catalog authority MARC editor can now delete and undelete authority records
 410 (https://bugs.launchpad.net/evergreen/+bug/1866546[Bug 1866546])
 411
 412 Circulation
 413 ^^^^^^^^^^^
 414
 415 * Overdue items are now highlighted in red in the Items Out screen (https://bugs.launchpad.net/evergreen/+bug/1775286[Bug 1775286])
 416 * Fixes an issue that caused patron stat cat information to persist between patrons in the Patron Edit screen
 417 (https://bugs.launchpad.net/evergreen/+bug/1844365[Bug 1844365])
 418 * The Pending User Buckets now allow more than 100 users (https://bugs.launchpad.net/evergreen/+bug/1754387[Bug 1754387])
 419 * Fixes an issue that caused long patron names to obscure important parts of circulation screens
 420 (https://bugs.launchpad.net/evergreen/+bug/1805860[Bug 1805860])
 421 * Prevents an incorrect "Input is out of range" validation error in the date pickers of the check out and renewal
 422 screens (https://bugs.launchpad.net/evergreen/+bug/1864056[Bug 1864056])
 423 * Long overdue and lost and paid items now count toward patron limits (https://bugs.launchpad.net/evergreen/+bug/1747542[Bug 1747542])
 424 * The holds shelf list now includes columns for "User Alias" and "User Alias or Display Name" (https://bugs.launchpad.net/evergreen/+bug/1712854[Bug 1712854])
 425 * In the messages tab of a patron's account, you can now change the date range of displayed archived penalties
 426 (https://bugs.launchpad.net/evergreen/+bug/1775940[Bug 1775940])
 427 * Fixes an issue with hanging transits (https://bugs.launchpad.net/evergreen/+bug/1819542[Bug 1819542])
 428 * Fixes some hold targeting logic (https://bugs.launchpad.net/evergreen/+bug/1886852[Bug 1886852])
 429 * Fixes an issue with default billing type prices (https://bugs.launchpad.net/evergreen/+bug/1776757[Bug 1776757])
 430 * The experimental catalog's hold grid now includes both date and time for hold request time (https://bugs.launchpad.net/evergreen/+bug/1889296[Bug 1889296])
 431 * Sounds now play when an item alert pops up in the web client (https://bugs.launchpad.net/evergreen/+bug/1851541[Bug 1851541])
 432 * Autorenewal notifications now display a more intelligible message (https://bugs.launchpad.net/evergreen/+bug/1842431[Bug 1842431])
 433
 434 Client
 435 ^^^^^^
 436
 437 * New installations of Evergreen will prevent problematic caching of the Angular client (https://bugs.launchpad.net/evergreen/+bug/1775276[Bug 1775276])
 438 * All screens in the angular client now have a banner to indicate which screen it is (https://bugs.launchpad.net/evergreen/+bug/1474874[Bug 1474874])
 439 * Fixes a bug that caused inconsistent hotkey behavior (https://bugs.launchpad.net/evergreen/+bug/1886713[Bug 1886713])
 440 * The Angular client has been upgraded to be compatible with moment-timezone 0.5.29 (https://bugs.launchpad.net/evergreen/+bug/1884787[Bug 1884787])
 441 * Fixes an issue with comboboxes (typeaheads) in the Angular client (https://bugs.launchpad.net/evergreen/+bug/1882591[Bug 1882591])
 442 * Publicly visible buckets are now known as Shareable buckets (https://bugs.launchpad.net/evergreen/+bug/1717996[Bug 1717996])
 443
 444 Feeds
 445 ^^^^^
 446
 447 * Fixes an issue with HTML item feed cover images (https://bugs.launchpad.net/evergreen/+bug/1674364[Bug 1674364])
 448
 449 Public catalog
 450 ^^^^^^^^^^^^^^
 451
 452 * The list of holdings in the OPAC now considers call number suffix in its sorting (https://bugs.launchpad.net/evergreen/+bug/1795469[Bug 1795469])
 453 * The Exclude Electronic Resources checkbox now works properly when locale picker is enabled (https://bugs.launchpad.net/evergreen/+bug/1847343[Bug 1847343])
 454
 455 QA
 456 ^^
 457
 458 * Adds automated tests for the barcode completion feature (https://bugs.launchpad.net/evergreen/+bug/1847680[Bug 1847680])
 459
 460 Search
 461 ^^^^^^
 462
 463 * Fixes an issue with SRU search (https://bugs.launchpad.net/evergreen/+bug/1833300[Bug 1833300])
 464 * Fixes an issue with searching the catalog from the staff client (https://bugs.launchpad.net/evergreen/+bug/1858701[Bug 1858701])
 465 * The experimental catalog basket clears when a staff member logs out (https://bugs.launchpad.net/evergreen/+bug/1867834[Bug 1867834])
 466 * Fixes an accessibility issue with the catalog search on the splash page (https://bugs.launchpad.net/evergreen/+bug/1839369[Bug 1839369])
 467
 468 Upgrade notes
 469 ~~~~~~~~~~~~~
 470
 471 Evergreen administrators should update existing apache configuration files
 472 so that the Angular index.html file is never cached by the client.  This
 473 can be done by changing the Angular setup section of the apache configuration
 474 that starts with:
 475
 476 [source,xml]
 477 ----
 478 <Directory "/openils/var/web/eg2/en-US">
 479 ----
 480
 481 or similar in the apache configuration. Add the following after the
 482 FallbackResource directive:
 483
 484 [source,xml]
 485 ----
 486     <Files "index.html">
 487       <IfModule mod_headers.c>
 488         Header set Cache-Control "no-cache, no-store, must-revalidate"
 489         Header set Pragma "no-cache"
 490         Header set Expires 0
 491       </IfModule>
 492     </Files>
 493 ----
 494
 495 Finally, ensure that the mod_headers apache module is enabled by running the
 496 following commands on all apache servers as the root user:
 497
 498 [source,bash]
 499 ----
 500 a2enmod headers
 501 sudo /etc/init.d/apache2 restart
 502 ----
 503
 504 Purge User Preferred Names
 505 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 506 The new, user preferred name fields are now set to NULL in the
 507 database when a user account is purged via the staff client or using
 508 the actor.usr_delete function in the database.
 509
 510 To clear the preferred name fields from records that have already been
 511 purged, run the following SQL update:
 512
 513 [source,sql]
 514 ----
 515 UPDATE actor.usr
 516 SET pref_prefix = NULL,
 517     pref_first_given_name = NULL,
 518     pref_second_given_name = NULL,
 519     pref_family_name = NULL,
 520     pref_suffix = NULL,
 521     name_keywords = NULL
 522 WHERE usrname ~ ('^' || id || '-PURGED')
 523 AND NOT active
 524 AND deleted
 525 AND (
 526   pref_prefix IS NOT NULL OR
 527   pref_first_given_name IS NOT NULL OR
 528   pref_second_given_name IS NOT NULL OR
 529   pref_family_name IS NOT NULL OR
 530   pref_suffix IS NOT NULL OR
 531   name_keywords IS NOT NULL
 532 );
 533 ----
 534
 535 Acknowledgements
 536 ~~~~~~~~~~~~~~~~
 537 We would like to thank the following individuals who contributed code,
 538 testing and documentation patches to the 3.5.1 point release of Evergreen:
 539
 540 * John Amundson
 541 * A. Bellenir
 542 * Jason Boyer
 543 * Steven Callender
 544 * Galen Charlton
 545 * Jeff Davis
 546 * Bill Erickson
 547 * Jason Etheridge
 548 * Ruth Frasur
 549 * Blake Graham Henderson
 550 * Rogan Hamby
 551 * Elaine Hardy
 552 * Kyle Huckins
 553 * Shula Link
 554 * Tiffany Little
 555 * Christine Morgan
 556 * Michele Morgan
 557 * Terran McCanna
 558 * Gina Monti
 559 * Mike Risher
 560 * Mike Rylander
 561 * Jane Sandberg
 562 * Dan Scott
 563 * Jason Stephenson
 564 * Josh Stompro
 565 * John Yorio
 566
 567 Evergreen 3.5.0
 568 ---------------
 569
 570 Upgrade notes
 571 -------------
 572
 573 New Action Trigger hook for patron registration
 574 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 575 Use of the new Action Trigger stgu.created hook requires changes to
 576 your action_trigger_filters.json file.  See below for more details.
 577
 578 New prerequisite - Email::MIME Perl module
 579 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 580 The Email::MIME Perl module is now required, so be sure to run the
 581 prerequisite installation procedure for your Linux distribution before
 582 upgrading Evergreen.
 583
 584
 585
 586 New Features for 3.5.0
 587 ----------------------
 588
 589 Administration
 590 ~~~~~~~~~~~~~~
 591
 592 Do not cache the Angular application root
 593 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 594
 595 Evergreen administrators should update existing apache configuration files
 596 so that the Angular index.html file is never cached by the client.  This
 597 can be done by changing the Angular setup section of the apache configuration
 598 that starts with:
 599
 600 [source, conf]
 601 ----
 602 <Directory "/openils/var/web/eg2/en-US">
 603 ----
 604
 605 or similar in the apache configuration. Add the following after the
 606 FallbackResource directive:
 607
 608 [source, conf]
 609 ----
 610     <Files "index.html">
 611       <IfModule mod_headers.c>
 612         Header set Cache-Control "no-cache, no-store, must-revalidate"
 613         Header set Pragma "no-cache"
 614         Header set Expires 0
 615       </IfModule>
 616     </Files>
 617 ----
 618
 619 Finally, ensure that the mod_headers apache module is enabled by running the
 620 following commands on all apache servers as the root user:
 621
 622 [source, sh]
 623 ----
 624 a2enmod headers
 625 /etc/init.d/apache2 restart
 626 ----
 627
 628
 629 Repair of Self-closing HTML Tags
 630 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 631 The most recent release of JQuery requires valid closing tags for X/HTML elements.
 632 These were repaired within affected OPAC/Staff Client TT2 templates, but care should
 633 be taken in Action/Trigger templates to make sure closing tags are present where
 634 appropriate.  The stock template for PO HTML was affected.
 635 See https://bugs.launchpad.net/evergreen/+bug/1873286[LP#1873286] for details.
 636
 637 Aged Money Changes
 638 ^^^^^^^^^^^^^^^^^^
 639
 640 Two new global flag settings have been added to control if/when billings and
 641 payments are aged.  Both settings are disabled by default.
 642
 643 * 'history.money.age_with_circs'
 644  ** Age billings and payments linked to circulations when the cirulcation
 645     is aged.
 646 * 'history.money.retention_age'
 647   ** Age billings and payments based on the age of the finish date for
 648      the linked transaction.
 649   ** To age money based on this setting, there is a new srfsh script
 650      at (by default) /openils/bin/age_money.srfsh.
 651
 652 Aged Payment Additional Fields
 653 ++++++++++++++++++++++++++++++
 654
 655 The aged payment table now has accepting_usr, cash_drawer, and billing
 656 columns to improve reporting of aged money.
 657
 658 Manual Data Migration of Aged Money
 659 +++++++++++++++++++++++++++++++++++
 660
 661 For users that wish to age money along with circulations (global flag
 662 'history.money.age_with_circs' is set to true), it's necessary to manaully
 663 age money for circulations which have already been aged.  This can be
 664 done directly in the database with SQL:
 665
 666 NOTE: This SQL can take a very long time to run on large databases, so
 667 it may be necessary to process aged circulations in batches instead
 668 of all at once.
 669
 670 [source,sql]
 671 -------------------------------------------------------------------------
 672 SELECT money.age_billings_and_payments_for_xact(circ.id)
 673 FROM action.aged_circulation circ
 674 -- limit to aged circs with billings
 675 JOIN money.billing mb ON mb.xact = circ.id;
 676 -------------------------------------------------------------------------
 677
 678
 679 PostgreSQL 10 Support
 680 ^^^^^^^^^^^^^^^^^^^^^
 681 PostgreSQL 10 is now available for installation with Evergreen.  Please
 682 see the installation documentation for details.
 683
 684 New Action Trigger hook for patron registration
 685 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 686 Evergreen now includes a new type of Action Trigger hook: stgu.created.
 687 This hook will trigger upon the patron registration submission form. In
 688 addition to the new hook, an example Action Trigger definition is
 689 provided (disabled by default) entitled "Patron Registered for a card
 690 stgu.created". With clever timing and delay settings, a library can
 691 receive a single notification containing all of the pending patron
 692 registrations for a given time interval. No special server-side
 693 considerations required unless you introduce a new granularity. There
 694 is, however, a new clause introduced to the
 695 "action_trigger_filters.json.example" file.
 696
 697 If you wish to use this new hook, be sure to include this clause in your
 698 local "action_trigger_filters.json" file:
 699
 700 ----
 701 "stgu.created" : {
 702         "context_org": "home_ou",
 703         "filter": {
 704             "complete": "f"
 705         }
 706     }
 707 ----
 708
 709 SendEmail Reactor Updated to use Email::MIME
 710 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 711 The SendEmail reactor for Action/Trigger has been updated to use the
 712 Email::MIME Perl module for proper encoding of the email message
 713 header fields.  You should notice no functional difference in the
 714 sending of emails.
 715
 716
 717
 718 Cataloging
 719 ~~~~~~~~~~
 720
 721 Enriched/Full MARC Editor Ported to Angular
 722 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 723 The full MARC editor is now implemented in Angular.  This change impacts
 724 both the experimental Angular catalog and the MARC edit option within
 725 MARC Batch Import/Export (Vandelay) Queue manager.
 726
 727 Patron View tab in Experimental Catalog
 728 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 729 The record view screen in the Experimental Catalog now has a
 730 _Patron View_ tab.  This tab displays a view of the record in
 731 the OPAC, as a patron would see it.
 732
 733 The _Patron View_ tab replaces the previous _View in Catalog_
 734 button.
 735
 736
 737
 738 Circulation
 739 ~~~~~~~~~~~
 740
 741 New Hold Sort Order: Traditional with Holds-chase-home-lib-patrons
 742 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 743
 744 This is a new entry under Administration -> Server Administration ->
 745 Best-Hold Selection Sort Order in the staff client.  It prioritizes holds
 746 such that a given item, based on its owning library, will prefer patrons with
 747 a matching home library, no matter the pickup library.
 748
 749
 750 Angular Staff Catalog Holds Patron Search Support
 751 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 752 The Angular staff catalog now supports patron searching directly from
 753 the holds placement interace.
 754
 755 Hide Print List Button On Self Check Home Page
 756 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 757 The _Print List_ button is no longer displayed on the main page
 758 of the self check interface. This addresses an issue where
 759 users were observed to either hit the _Print List_ button and
 760 walk away or hit it *and* the _Logout_ button, causing duplicate
 761 receipts to be printed.  The _Print List_ button continues to
 762 be displayed on the _Items Out_, _Holds_, and _Fines Details_ pages
 763 of the self check interface.
 764
 765 Update Hold Notification Information
 766 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 767 The public catalog and staff client now have the ability to update
 768 existing holds if a patron or a staff member changes certain
 769 notification preferences or contact information.  Evergreen will detect
 770 these changes and prompt the staff user or patron user and ask if they
 771 want to update existing holds with the new contact information and/or
 772 notification preferences.
 773
 774
 775
 776 Client
 777 ~~~~~~
 778
 779 Angular Staff Catalog Preferences Page
 780 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 781 Adds a new "Catalog Preferences" interface, accessible directly from the
 782 catalog.  The UI houses the search preferences (default search lib,
 783 preferred library, default search tab) and a new staff-specific
 784 hits-per-page setting.  Other preferences may be added later.
 785
 786 Adds support for selecting a default search tab using the existing
 787 'eg.search.adv_pane' setting.
 788
 789 Hatch File Writer Print Option
 790 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 791 Adds a new stock print option in the Hatch printer configuration interface
 792 called Hatch File Writer (translatable).  When selected, any print content
 793 that is delivered to this printer is translated into text where necessary
 794 and written to a file in the Hatch profile directory.
 795
 796 The name of the file written is based on the print context:
 797 "receipt.<context>.txt".  For example, 'receipt.label.txt'.
 798
 799 Angular Staff Catalog gets Search Highlighting
 800 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 801 Search text highlighting is now supported on the search results and
 802 record details pages in the Angular staff catalog for searches that
 803 support highlighting.
 804
 805
 806
 807 OPAC
 808 ~~~~
 809
 810 Custom CSS in OPAC
 811 ^^^^^^^^^^^^^^^^^^
 812 There is now a library setting called opac.patron.custom_css. This can be
 813 populated with CSS that will load in the OPAC after the stylesheets and
 814 allow for custom CSS without editing server side templates. The permission
 815 UPDATE_ORG_UNIT_SETTING.opac.patron.custom_css manages access to it.
 816
 817
 818
 819 SIP
 820 ~~~
 821
 822 Add patron_status_always_permit_loans Option to SIP Server
 823 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 824 Evergreen now has a new `oils_sip.xml` login attribute called
 825 `patron_status_always_permit_loans` that specifies whether
 826 the charge privileges denied, renewal privilges denied, and
 827 card reported lost flags in the patron status block should be
 828 coerced to permissive values regardless of the actual state
 829 of the patron record. Turning this on works around an issue
 830 where a 2019-12 change by the Hoopla SIP2 client takes those flag
 831 fields into account, but some libraries may not wish those
 832 to block a patron's access to online resources that use
 833 SIP2 to authenticate. This setting can also be set as
 834 an `implementation_config` option; note that if it is set to
 835 'true' or 'false' as a login attribute, the login attribute will
 836 override whatever is set in the `implementation_config`.
 837
 838
 839
 840
 841 Acknowledgments
 842 ---------------
 843 The Evergreen project would like to acknowledge the following
 844 organizations that commissioned developments in this release of
 845 Evergreen:
 846
 847 * King County Library System
 848 * MassLNC
 849 * PaILS
 850
 851 We would also like to thank the following individuals who contributed
 852 code, translations, documentations patches and tests to this release of
 853 Evergreen:
 854
 855 * Jason Boyer
 856 * Galen Charlton
 857 * Garry Collum
 858 * Dawn Dale
 859 * Jeff Davis
 860 * Bill Erickson
 861 * Jason Etheridge
 862 * Lynn Floyd
 863 * Ruth Frasur
 864 * Blake Graham-Henderson
 865 * Rogan Hamby
 866 * Terran McCanna
 867 * Mike Risher
 868 * Mike Rylander
 869 * Jane Sandberg
 870 * Chris Sharp
 871 * Josh Stompro
 872 * Cesar Velez
 873
 874
 875 We also thank the following organizations whose employees contributed
 876 patches:
 877
 878 * BC Libraries Cooperative
 879 * Catalyte
 880 * Equinox Open Library Initiative
 881 * Georgia Public Library Service
 882 * Indiana State Library
 883 * King County Library System
 884 * Lake Agassiz Regional Library
 885 * Linn-Benton Community College
 886 * MOBIUS
 887
 888 We regret any omissions.  If a contributor has been inadvertently
 889 missed, please open a bug at http://bugs.launchpad.net/evergreen/
 890 with a correction.
 891