docs/RELEASE_NOTES_3_3.adoc

   1 Evergreen 3.3 Release Notes
   2 ===========================
   3 :toc:
   4 :numbered:
   5
   6 Upgrade notes
   7 -------------
   8
   9 Upgrading PostgreSQL
  10 ^^^^^^^^^^^^^^^^^^^^
  11 Evergreen now supports PostgreSQL 9.6 and 10.
  12 If you upgrade your database from a PostgreSQL version of 9.5, or
  13 lower, to PostgreSQL versions 9.6 or 10, you will need to recreate 3
  14 indexes in additon to the normal database upgrade steps.  The index
  15 recreation is necessary because of changes to the PostgreSQL
  16 `unaccent` extension module.
  17
  18 The following snippet of SQL code will do the necessary steps:
  19
  20 [source,sql]
  21 ------------------------------------------------------------------------
  22 DROP INDEX actor_usr_first_given_name_unaccent_idx;
  23 DROP INDEX actor_usr_second_given_name_unaccent_idx;
  24 DROP INDEX actor_usr_family_name_unaccent_idx;
  25 CREATE INDEX actor_usr_first_given_name_unaccent_idx ON actor.usr
  26       (evergreen.unaccent_and_squash(first_given_name));
  27 CREATE INDEX actor_usr_second_given_name_unaccent_idx ON actor.usr
  28       (evergreen.unaccent_and_squash(second_given_name));
  29 CREATE INDEX actor_usr_family_name_unaccent_idx ON actor.usr
  30       (evergreen.unaccent_and_squash(family_name));
  31 ------------------------------------------------------------------------
  32
  33
  34 New Features
  35 ------------
  36
  37 Administration
  38 ~~~~~~~~~~~~~~
  39
  40 Include Item Status in marc_export Items Export
  41 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  42 The marc_export script now includes the item status in the 852 subfield s when exporting items.
  43
  44 Ability to Reingest Certain Record Attributes In pingest.pl
  45 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  46 An option, `--attr`, has been added to the `pingest.pl` support script
  47 that allows the user to specify which record attributes to reingest.
  48 It can be used one or more times to specify one or more attributes to
  49 ingest.  It can be omitted to reingest all record attributes.  This
  50 option is ignored if the `--skip-attrs` option is used.
  51
  52 The `--attr` option is most useful after doing something specific that
  53 requires only a partial ingest of records.  For instance, if you add a
  54 new language to the `config.coded_value_map` table, you will want to
  55 reingest the `item_lang` attribute on all of your records.  The
  56 following command line will do that, and only that, ingest:
  57
  58 ----
  59 $ /openils/bin/pingest.pl --skip-browse --skip-search --skip-facets \
  60     --skip-display --attr=item_lang
  61 ----
  62
  63
  64
  65 Architecture
  66 ~~~~~~~~~~~~
  67
  68 Database Support for PostgreSQL 10
  69 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  70 The Evergreen database can now be built with PostgreSQL version 10.
  71
  72 This update has implications for developers who write PgTap tests.  In
  73 versions of PostgreSQL prior to 10, one could write `\set ECHO` to
  74 disable the echoing of commands as they were run.  In PostgreSQL
  75 version 10, using `\set` without a value is an error.  One should now
  76 write `\set ECHO none` in order to disable the echoing of commands.
  77 This latter form works in all versions of PostgreSQL currently
  78 supported by Evergreen.
  79
  80
  81
  82 Ubuntu 18.04 Bionic Beaver
  83 ^^^^^^^^^^^^^^^^^^^^^^^^^^
  84 Evergreen can now be installed on Ubuntu 18.04 Bionic Beaver.  To
  85 install the prerequisites, use ubuntu-bionic as the Makefile.install
  86 target.
  87
  88 This update also fixes a Perl warning in the HoldNotify module that is
  89 an error in the version of Perl (5.26) that is installed on Ubuntu
  90 18.04.
  91
  92
  93
  94
  95 Cataloging
  96 ~~~~~~~~~~
  97
  98 MARC Import/Export Interface Update (Angular Port)
  99 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 100 This MARC Import/Export (AKA Vandelay) interface is now built on
 101 Angular(7) instead of Dojo.  The functionality is consistent with the
 102 previous version of the interface, with minor UI adjustments to match
 103 the Angular style, plus one new interface called 'Recent Imports'.
 104
 105 Import Templates
 106 ++++++++++++++++
 107 Users may now save sets of import attributes from the MARC import form as
 108 named templates.  Users may select a default template, applied on page load
 109 by default, and users may delete existing templates.
 110
 111 Recent Imports Tab
 112 ++++++++++++++++++
 113 This is a new interface which allows users to see active and recent
 114 Vandelay sesssions originating from the same workstation or logged in
 115 user account.  Active sessions include real-time progress information so
 116 the user may track the progress without refreshing the page.
 117
 118 This interface makes it possible to exit the main import tab or the
 119 Vandelay interface altogether and return at a later time to check on
 120 import progress.  It also allows users to start multiple imports at
 121 the same time and follow the status of each in one interace.
 122
 123
 124
 125 Circulation
 126 ~~~~~~~~~~~
 127
 128 Patron Parent/Guardian Field
 129 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 130 Patrons now have a new dedicated parent/guardian field.  This field is
 131 editable in the patron edit interface, displays in the patron
 132 summary side bar on the browser client, and is search-able from the
 133 patron search interface in the browser client.
 134
 135 Patron Editor
 136 +++++++++++++
 137 In addition to the standard "show" and "suggest" visibility settings,
 138 the new guardian field comes with a library setting
 139 'ui.patron.edit.guardian_required_for_juv' ("GUI: Juvenile account
 140 requires parent/guardian").  When this setting is applied, a value
 141 will be required in the patron editor when the juvenile flag is active.
 142
 143 Upgrade Notes
 144 +++++++++++++
 145 Sites who traditionally store parent/guardian information in the
 146 patron 'Secondary Identification' field can migrate values from this
 147 field to the new guardian field with the following SQL:
 148
 149 [source,sql]
 150 -------------------------------------------------------------------------
 151 BEGIN;
 152
 153 -- 1. Find the local ID of the parent/guardian identification type
 154
 155 SELECT * FROM config.identification_type;
 156
 157 -- 2. On my test system, the id is "101".  It will vary!.
 158 -- Migrate the value from the ident2 field to the guardian field.
 159
 160 UPDATE actor.usr
 161     SET guardian = ident_value2
 162 WHERE
 163     ident_type2 = 101 -- !! CHANGE TO SUIT
 164     AND ident_value2 IS NOT NULL
 165     AND ident_value2 <> '';
 166
 167 -- 3. delete the original secondary identification data
 168
 169 UPDATE actor.usr
 170     SET ident_value2 = NULL, ident_type2 = NULL
 171 WHERE
 172     ident_type2 = 101; -- !! CHANGE TO SUIT
 173
 174 COMMIT;
 175 -------------------------------------------------------------------------
 176
 177
 178 Allow Others to Use My Account (Privacy Waiver)
 179 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 180 Patrons who wish to authorize other people to use their account may
 181 now do so via My Account.  In the Search and History Preferences tab
 182 under Account Preferences, a new section labeled "Allow others to use
 183 my account" allows patrons to enter a name and indicate that the
 184 specified person is allowed to place holds, pickup holds, view
 185 borrowing history, or check out items on their account.  This
 186 information is displayed to circulation staff in the patron account
 187 summary in the web client.  (Staff may also add, edit, and remove
 188 entries via the patron editor.)
 189
 190 A new library setting, "Allow others to use patron account (privacy
 191 waiver)," is used to enable or disable this feature.
 192
 193
 194
 195 Client
 196 ~~~~~~
 197
 198 Booking Administration Moved To Angular
 199 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 200 The Administration => Booking Administration pages have been ported to
 201 Angular using the new Angular grids.  Entry points from both AngularJS
 202 and Angular apps point to the new interfaces.
 203
 204 Option to Enable Experimental Angular Staff Catalog
 205 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 206 A new org unit setting labeled 'GUI: Enable Experimental Angular
 207 Staff Catalog' (ui.staff.angular_catalog.enabled) has been added, allowing
 208 sites to enable a menu option in the browser client for accessing
 209 the experimental Angular staff catalog.
 210
 211 When set to true, a new entry in the navigation bar appears in the
 212 Cataloging menu labled "Staff Catalog (Experimental)".
 213
 214 New Features (Since 3.2)
 215 ++++++++++++++++++++++++
 216  * Pub date filter
 217  * Copy location filter
 218  * Group formats and editions
 219  * Identifier search
 220  * MARC search
 221  * Browse search
 222  * Place holds
 223  * Record baskets and actions
 224  * Record detail tabs/actions point to AngularJS versions where needed.
 225  * Record detail View In Catalog button
 226
 227
 228
 229 OPAC
 230 ~~~~
 231
 232 View upcoming booking reservations in the OPAC
 233 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 234 A new tab in the My Account section of the OPAC shows
 235 patrons information about reservations on their account.
 236 Here, patrons can check on upcoming reservations, as
 237 well as reservations they currently have checked out.
 238
 239 Note: this interface pulls its timezone from the Library
 240 Settings Editor.  Make sure that you have a timezone
 241 listed for your library in the Library Settings Editor
 242 before using this feature.
 243
 244 Display UPC as Option for Public Catalog Advanced Search
 245 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 246 The Numeric Search tab of the public catalog Advanced Search
 247 now includes an option to search by UPC (Universal Product Code).
 248
 249
 250
 251 Acknowledgments
 252 ---------------
 253 The Evergreen project would like to acknowledge the following
 254 organizations that commissioned developments in this release of
 255 Evergreen:
 256
 257 * Pennsylvania Integrated Library System (PaILS)
 258
 259 We would also like to thank the following individuals who contributed
 260 code, translations, documentations patches and tests to this release of
 261 Evergreen:
 262
 263 * Steve Callender
 264 * Bill Erickson
 265 * Rogan Hamby
 266 * Ben Shum
 267 * Jason Stephenson
 268 * Dan Wells
 269 * John Yorio
 270
 271
 272 We also thank the following organizations whose employees contributed
 273 patches:
 274
 275 * CW MARS
 276 * Equinox Open Library Initiative
 277 * King County Library System
 278 * Linn-Benton Community College
 279
 280 We regret any omissions.  If a contributor has been inadvertently
 281 missed, please open a bug at http://bugs.launchpad.net/evergreen/
 282 with a correction.