docs/RELEASE_NOTES_3_3.adoc

   1 Evergreen 3.3 Release Notes
   2 ===========================
   3 :toc:
   4 :numbered:
   5
   6 Evergreen 3.3.1
   7 ---------------
   8
   9 This release contains bug fixes improving on Evergreen 3.3.0.
  10
  11 Bug fixes
  12 ~~~~~~~~~
  13
  14 General
  15 ^^^^^^^
  16
  17 * Fixes a compatibility problem with the Item Status screen related to
  18   JavaScript arrow functions
  19   (https://bugs.launchpad.net/evergreen/+bug/1821196[Bug #1821196])
  20
  21 Booking
  22 ^^^^^^^
  23
  24 * Fixes a bug in the Booking URL path that failed with newer Apache
  25   (https://bugs.launchpad.net/evergreen/+bug/1823387[Bug #1823387])
  26
  27 Circulation
  28 ^^^^^^^^^^^
  29
  30 * Fixes a display bug with the patron record Group Members list
  31   (https://bugs.launchpad.net/evergreen/+bug/1642036[Bug #1642036])
  32 * Fixes title sort on the patron Items Out Screen
  33   (https://bugs.launchpad.net/evergreen/+bug/1782014[Bug #1782014])
  34 * Fixes a refresh bug on the catalog record Holds View tab when moving between
  35   records (https://bugs.launchpad.net/evergreen/+bug/1792188[Bug #1792188])
  36 * Fixes the ability to place holds from item buckets
  37   (https://bugs.launchpad.net/evergreen/+bug/1806394[Bug #1806394])
  38
  39 Cataloging
  40 ^^^^^^^^^^
  41
  42 * Fixes a bug where copy templates would not apply properly
  43   (https://bugs.launchpad.net/evergreen/+bug/1788680[Bug #1788680])
  44 * Fixes the default cursor focus on the holdings editor
  45   (https://bugs.launchpad.net/evergreen/+bug/1752968[Bug #1752968])
  46 * Fixes a bug with Postgres 10 support related to MARC Batch Import/Export
  47   (https://bugs.launchpad.net/evergreen/+bug/1820339[Bug #1820339])
  48 * Fixes a bug in the new MARC Import/Export related to Record Match Set
  49   expressions (https://bugs.launchpad.net/evergreen/+bug/1823982[Bug #1823982])
  50 * Fixes a bug that failed to honor the "Retain empty bib records"
  51   (cat.bib.keep_on_empty) setting when transferring items
  52   (https://bugs.launchpad.net/evergreen/+bug/1333893[Bug #1333893])
  53 * Fixes a bug that failed to include deleted bib records in TCN search
  54   (https://bugs.launchpad.net/evergreen/+bug/1813633[Bug #1813633])
  55
  56 System administration
  57 ^^^^^^^^^^^^^^^^^^^^^
  58
  59 * Added database indexes to speed up purging of Action Trigger event output
  60   fields (https://bugs.launchpad.net/evergreen/+bug/1778940[Bug #1778940])
  61 * Fixes the help text in action_trigger_aggregator.pl related to the remote-acct
  62   argument (https://bugs.launchpad.net/evergreen/+bug/1803729[Bug #1803729])
  63 * Adds a missing page title for the Closed Dates Editor
  64   (https://bugs.launchpad.net/evergreen/+bug/1814943[Bug #1814943])
  65 * Adds a missing page title for the Statistical Popularity Badges admin page
  66   (https://bugs.launchpad.net/evergreen/+bug/1826890[Bug #1826890])
  67 * Changes the direction of column sort indicators in the new Angular grids
  68   (https://bugs.launchpad.net/evergreen/+bug/1825578[Bug #1825578])
  69 * Adds Hatch printing support to the new Angular screens
  70   (https://bugs.launchpad.net/evergreen/+bug/1793005[Bug #1793005])
  71
  72
  73 Acknowledgments
  74 ~~~~~~~~~~~~~~~
  75 We would like to thank the following individuals who contributed code,
  76 testing and documentation patches to the 3.3.1 point release of
  77 Evergreen:
  78
  79 * John Amundson
  80 * Jason Boyer
  81 * Galen Charlton
  82 * Garry Collum
  83 * Jeff Davis
  84 * Bill Erickson
  85 * Jason Etheridge
  86 * Blake Graham-Henderson
  87 * Rogan Hamby
  88 * Millissa Macomber
  89 * Katie G. Martin
  90 * Terran McCanna
  91 * Mike Rylander
  92 * Jane Sandberg
  93 * Janet Schrader
  94 * Dan Scott
  95 * Ben Shum
  96 * Remington Steed
  97 * Jason Stephenson
  98 * Josh Stompro
  99 * Dan Wells
 100 * Beth Willis
 101 * John Yorio
 102
 103
 104 3.3.0 Upgrade notes
 105 -------------------
 106
 107 Migrating Parent/guardian information
 108 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 109 Sites who traditionally store parent/guardian information in the
 110 patron 'Secondary Identification' field can migrate values from this
 111 field to the new guardian field with the following SQL:
 112
 113 [source,sql]
 114 -------------------------------------------------------------------------
 115 BEGIN;
 116
 117 -- 1. Find the local ID of the parent/guardian identification type
 118
 119 SELECT * FROM config.identification_type;
 120
 121 -- 2. On my test system, the id is "101".  It will vary!.
 122 -- Migrate the value from the ident2 field to the guardian field.
 123
 124 UPDATE actor.usr
 125     SET guardian = ident_value2
 126 WHERE
 127     ident_type2 = 101 -- !! CHANGE TO SUIT
 128     AND ident_value2 IS NOT NULL
 129     AND ident_value2 <> '';
 130
 131 -- 3. delete the original secondary identification data
 132
 133 UPDATE actor.usr
 134     SET ident_value2 = NULL, ident_type2 = NULL
 135 WHERE
 136     ident_type2 = 101; -- !! CHANGE TO SUIT
 137
 138 COMMIT;
 139 -------------------------------------------------------------------------
 140
 141
 142 Upgrading PostgreSQL
 143 ~~~~~~~~~~~~~~~~~~~~
 144 Evergreen now supports PostgreSQL 9.6 and 10.
 145 If you upgrade your database from a PostgreSQL version of 9.5, or
 146 lower, to PostgreSQL versions 9.6 or 10, you will need to recreate 3
 147 indexes in additon to the normal database upgrade steps.  The index
 148 recreation is necessary because of changes to the PostgreSQL
 149 `unaccent` extension module.
 150
 151 The following snippet of SQL code will do the necessary steps:
 152
 153 [source,sql]
 154 ------------------------------------------------------------------------
 155 DROP INDEX actor_usr_first_given_name_unaccent_idx;
 156 DROP INDEX actor_usr_second_given_name_unaccent_idx;
 157 DROP INDEX actor_usr_family_name_unaccent_idx;
 158 CREATE INDEX actor_usr_first_given_name_unaccent_idx ON actor.usr
 159       (evergreen.unaccent_and_squash(first_given_name));
 160 CREATE INDEX actor_usr_second_given_name_unaccent_idx ON actor.usr
 161       (evergreen.unaccent_and_squash(second_given_name));
 162 CREATE INDEX actor_usr_family_name_unaccent_idx ON actor.usr
 163       (evergreen.unaccent_and_squash(family_name));
 164 ------------------------------------------------------------------------
 165
 166
 167 3.3.0 New Features
 168 ------------------
 169
 170 Administration
 171 ~~~~~~~~~~~~~~
 172
 173 Include Item Status in marc_export Items Export
 174 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 175 The marc_export script now includes the item status in the 852 subfield s when exporting items.
 176
 177 Ability to Reingest Certain Record Attributes In pingest.pl
 178 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 179 An option, `--attr`, has been added to the `pingest.pl` support script
 180 that allows the user to specify which record attributes to reingest.
 181 It can be used one or more times to specify one or more attributes to
 182 ingest.  It can be omitted to reingest all record attributes.  This
 183 option is ignored if the `--skip-attrs` option is used.
 184
 185 The `--attr` option is most useful after doing something specific that
 186 requires only a partial ingest of records.  For instance, if you add a
 187 new language to the `config.coded_value_map` table, you will want to
 188 reingest the `item_lang` attribute on all of your records.  The
 189 following command line will do that, and only that, ingest:
 190
 191 ----
 192 $ /openils/bin/pingest.pl --skip-browse --skip-search --skip-facets \
 193     --skip-display --attr=item_lang
 194 ----
 195
 196
 197
 198 Architecture
 199 ~~~~~~~~~~~~
 200
 201 Database Support for PostgreSQL 10
 202 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 203 The Evergreen database can now be built with PostgreSQL version 10.
 204
 205 This update has implications for developers who write PgTap tests.  In
 206 versions of PostgreSQL prior to 10, one could write `\set ECHO` to
 207 disable the echoing of commands as they were run.  In PostgreSQL
 208 version 10, using `\set` without a value is an error.  One should now
 209 write `\set ECHO none` in order to disable the echoing of commands.
 210 This latter form works in all versions of PostgreSQL currently
 211 supported by Evergreen.
 212
 213
 214
 215 Ubuntu 18.04 Bionic Beaver
 216 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 217 Evergreen can now be installed on Ubuntu 18.04 Bionic Beaver.  To
 218 install the prerequisites, use ubuntu-bionic as the Makefile.install
 219 target.
 220
 221 This update also fixes a Perl warning in the HoldNotify module that is
 222 an error in the version of Perl (5.26) that is installed on Ubuntu
 223 18.04.
 224
 225
 226
 227
 228 Cataloging
 229 ~~~~~~~~~~
 230
 231 MARC Import/Export Interface Update (Angular Port)
 232 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 233 This MARC Import/Export (AKA Vandelay) interface is now built on
 234 Angular(7) instead of Dojo.  The functionality is consistent with the
 235 previous version of the interface, with minor UI adjustments to match
 236 the Angular style, plus one new interface called 'Recent Imports'.
 237
 238 Import Templates
 239 ++++++++++++++++
 240 Users may now save sets of import attributes from the MARC import form as
 241 named templates.  Users may select a default template, applied on page load
 242 by default, and users may delete existing templates.
 243
 244 Recent Imports Tab
 245 ++++++++++++++++++
 246 This is a new interface which allows users to see active and recent
 247 Vandelay sesssions originating from the same workstation or logged in
 248 user account.  Active sessions include real-time progress information so
 249 the user may track the progress without refreshing the page.
 250
 251 This interface makes it possible to exit the main import tab or the
 252 Vandelay interface altogether and return at a later time to check on
 253 import progress.  It also allows users to start multiple imports at
 254 the same time and follow the status of each in one interace.
 255
 256
 257 Spine Label Sheet Printing
 258 ++++++++++++++++++++++++++
 259
 260 Catalogers can now print spine labels onto 8 1/2 x 11 inch label sheets.
 261
 262
 263 Circulation
 264 ~~~~~~~~~~~
 265
 266 Patron Parent/Guardian Field
 267 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 268 Patrons now have a new dedicated parent/guardian field.  This field is
 269 editable in the patron edit interface, displays in the patron
 270 summary side bar on the browser client, and is search-able from the
 271 patron search interface in the browser client.
 272
 273 Patron Editor
 274 +++++++++++++
 275 In addition to the standard "show" and "suggest" visibility settings,
 276 the new guardian field comes with a library setting
 277 'ui.patron.edit.guardian_required_for_juv' ("GUI: Juvenile account
 278 requires parent/guardian").  When this setting is applied, a value
 279 will be required in the patron editor when the juvenile flag is active.
 280
 281 Allow Others to Use My Account (Privacy Waiver)
 282 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 283 Patrons who wish to authorize other people to use their account may
 284 now do so via My Account.  In the Search and History Preferences tab
 285 under Account Preferences, a new section labeled "Allow others to use
 286 my account" allows patrons to enter a name and indicate that the
 287 specified person is allowed to place holds, pickup holds, view
 288 borrowing history, or check out items on their account.  This
 289 information is displayed to circulation staff in the patron account
 290 summary in the web client.  (Staff may also add, edit, and remove
 291 entries via the patron editor.)
 292
 293 A new library setting, "Allow others to use patron account (privacy
 294 waiver)," is used to enable or disable this feature.
 295
 296
 297
 298 Client
 299 ~~~~~~
 300
 301 Server and Booking Administration Moved To Angular
 302 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 303 The Administration => Server Administration and
 304 Administration => Booking Administration pages have been ported to
 305 Angular using the new Angular grids.  Entry points from both AngularJS
 306 and Angular web clients point to the new interfaces.
 307
 308 Option to Enable Experimental Angular Staff Catalog
 309 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 310 A new org unit setting labeled 'GUI: Enable Experimental Angular
 311 Staff Catalog' (ui.staff.angular_catalog.enabled) has been added, allowing
 312 sites to enable a menu option in the browser client for accessing
 313 the experimental Angular staff catalog.
 314
 315 When set to true, a new entry in the navigation bar appears in the
 316 Cataloging menu labled "Staff Catalog (Experimental)".
 317
 318 New Features (Since 3.2)
 319 ++++++++++++++++++++++++
 320  * Pub date filter
 321  * Copy location filter
 322  * Group formats and editions
 323  * Identifier search
 324  * MARC search
 325  * Browse search
 326  * Place holds
 327  * Record baskets and actions
 328  * Record detail tabs/actions point to AngularJS versions where needed.
 329  * Record detail View In Catalog button
 330
 331
 332
 333 OPAC
 334 ~~~~
 335
 336 View upcoming booking reservations in the OPAC
 337 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 338 A new tab in the My Account section of the OPAC shows
 339 patrons information about reservations on their account.
 340 Here, patrons can check on upcoming reservations, as
 341 well as reservations they currently have checked out.
 342
 343 Note: this interface pulls its timezone from the Library
 344 Settings Editor.  Make sure that you have a timezone
 345 listed for your library in the Library Settings Editor
 346 before using this feature.
 347
 348 Display UPC as Option for Public Catalog Advanced Search
 349 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 350 The Numeric Search tab of the public catalog Advanced Search
 351 now includes an option to search by UPC (Universal Product Code).
 352
 353
 354
 355 3.3.0 Acknowledgments
 356 ---------------------
 357 The Evergreen project would like to acknowledge the following
 358 organizations that commissioned developments in this release of
 359 Evergreen:
 360
 361 * King County Library System (KCLS)
 362 * MassLNC Evergreen Development Initiative
 363 * Pennsylvania Integrated Library System (PaILS)
 364
 365 We would also like to thank the following individuals who contributed
 366 code, translations, documentations patches and tests to this release of
 367 Evergreen:
 368
 369 * Adam Bowling
 370 * Steve Callender
 371 * Eva Cerninakova
 372 * Jeff Davis
 373 * Jason Etheridge
 374 * Bill Erickson
 375 * Rogan Hamby
 376 * Kathy Lussier
 377 * Terran McCanna
 378 * Andrea Buntz Neiman
 379 * Jennifer Pringle
 380 * Jane Sandberg
 381 * Chris Sharp
 382 * Ben Shum
 383 * Remington Steed
 384 * Jason Stephenson
 385 * Anahi Valdez
 386 * Dan Wells
 387 * Stephen Woidowski
 388 * John Yorio
 389
 390
 391 We also thank the following organizations whose employees contributed
 392 patches:
 393
 394 * BC Libraries Cooperative
 395 * Catalyte
 396 * CW MARS
 397 * Emerald Data Networks
 398 * Equinox Open Library Initiative
 399 * Georgia PINES
 400 * King County Library System
 401 * Linn-Benton Community College
 402 * MassLNC
 403
 404 We regret any omissions.  If a contributor has been inadvertently
 405 missed, please open a bug at http://bugs.launchpad.net/evergreen/
 406 with a correction.