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