LP1864056: Don't compare multiple new Date()s
[working/Evergreen.git] / docs / RELEASE_NOTES_3_2.adoc
1 Evergreen 3.2 Release Notes
2 ===========================
3 :toc:
4 :numbered:
5
6 Evergreen 3.2.10
7 ----------------
8
9 This release contains bug fixes improving on Evergreen 3.2.9.
10
11 Bug Fixes
12 ~~~~~~~~~
13
14 * Fix MARC View Display Issues (https://bugs.launchpad.net/evergreen/+bug/1843637[Bug 1843637])
15 * Add missing columns to patron record (https://bugs.launchpad.net/evergreen/+bug/1739607[Bug 1739607])
16 * Mark the permission.grp_descendants database table as STABLE (https://bugs.launchpad.net/evergreen/+bug/1768141[Bug 1768141])
17 * Webstaff locale picker repairs (https://bugs.launchpad.net/evergreen/+bug/1560805[Bug 1560805])
18 * Assign copy alert permissions (https://bugs.launchpad.net/evergreen/+bug/1811442[Bug 1811442])
19 * Fix issue where reports interface was partially loaded (https://bugs.launchpad.net/evergreen/+bug/1845050[Bug 1845050])
20 * Handle autorenewals when aging circulations (https://bugs.launchpad.net/evergreen/+bug/1840669[Bug 1840669])
21 * Default circulation auto_renewal field to FALSE (https://bugs.launchpad.net/evergreen/+bug/1839002[Bug 1839002])
22 * Add missing Auto Renewal fields to the IDL (https://bugs.launchpad.net/evergreen/+bug/1835577[Bug 1835577])
23 * Refactor auto_renewal back end code (https://bugs.launchpad.net/evergreen/+bug/1835035[Bug 1835035])
24 * Update Item Status templates for auto-renewal (https://bugs.launchpad.net/evergreen/+bug/1835085[Bug 1835085])
25 * Improve permissions when editing user accounts (e.g. editing your own account) (https://bugs.launchpad.net/evergreen/+bug/1842940[Bug 1842940])
26 * Reduce the cost of utility functions, speeding up search (https://bugs.launchpad.net/evergreen/+bug/1836963[Bug 1836963])
27 * Fixes Current Date in Date Returned in Circ History CSV (https://bugs.launchpad.net/evergreen/+bug/1813056[Bug 1813056])
28 * Fix Last Captured Hold Check for Holds Shelf (https://bugs.launchpad.net/evergreen/+bug/1827250[Bug 1827250])
29 * Only include OPAC-visible copies in SRU/Z39.50 holdings (https://bugs.launchpad.net/evergreen/+bug/1609556[Bug 1609556])
30 * Re-alphabetize Local & Server Administration Links (https://bugs.launchpad.net/evergreen/+bug/1803790[Bug 1803790])
31 * Allow saving Bill Full Details grids (https://bugs.launchpad.net/evergreen/+bug/1729435[Bug 1729435])
32 * Improve usability of Patron Bill History date selector (https://bugs.launchpad.net/evergreen/+bug/1841089[Bug 1841089])
33 * Fix when the "duplicate barcode" alert appears (https://bugs.launchpad.net/evergreen/+bug/1777698[Bug 1777698])
34 * Fix paging of pending patrons (https://bugs.launchpad.net/evergreen/+bug/1749970[Bug 1749970])
35 * Check bib visibility for located URI auto suggest (https://bugs.launchpad.net/evergreen/+bug/1802952[Bug 1802952])
36 * Patron Prefix and Suffix Display in Summary (https://bugs.launchpad.net/evergreen/+bug/1821969[Bug 1821969])
37 * Do not include Tag Owner in Tag (https://bugs.launchpad.net/evergreen/+bug/1825403[Bug 1825403])
38 * Avoid hard-coded paths in Apache config (https://bugs.launchpad.net/evergreen/+bug/1844720[Bug 1844720])
39 * Require some Storage submodules instead of use them (https://bugs.launchpad.net/evergreen/+bug/1835620[Bug 1835620])
40 * Remove extra grid refresh from configuration load (https://bugs.launchpad.net/evergreen/+bug/1846038[Bug 1846038])
41
42 Acknowledgements
43 ~~~~~~~~~~~~~~~~
44 We would like to thank the following individuals who contributed code,
45 testing and documentation patches to the 3.2.10 point release of Evergreen:
46
47 * Bill Erickson
48 * Chris Sharp
49 * Dan Briem
50 * Dan Wells
51 * Galen Charlton
52 * Garry Collum
53 * Jane Sandberg
54 * Jason Boyer
55 * Jason Stephenson
56 * Jeff Davis
57 * Jeff Godin
58 * Jennifer Pringle
59 * John Amundson
60 * Josh Stompro
61 * Kyle Huckins
62 * Michele Morgan
63 * Mike Rylander
64 * Remington Steed
65 * Terran McCanna
66
67 Evergreen 3.2.9
68 ----------------
69 This release is a security release that fixes cross-site scripting
70 (XSS) vulnerabilities in the Evergreen public catalog. This release
71 also includes several other bugfixes improving on Evergreen 3.2.8.
72
73 Security Issue: XSS Vulnerability in Public Catalog
74 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
75 This release fixes several cross-site scripting (XSS) vulnerabilities
76 in the public catalog. When upgrading, Evergreen administrators should
77 review whether any of the following templates have been customized
78 or overridden. If so, either the template should be replaced with the
79 stock version or the XSS fix (which entails adding the `| html` filter
80 in several places) applied to the customized version.
81
82  * `Open-ILS/src/templates/opac/browse.tt2`
83  * `Open-ILS/src/templates/opac/parts/ebook_api/base_js.tt2`
84  * `Open-ILS/src/templates/opac/parts/header.tt2`
85  * `Open-ILS/src/templates/opac/parts/place_hold.tt2`
86  * `Open-ILS/src/templates/opac/parts/place_hold_result.tt2`
87  * `Open-ILS/src/templates/opac/parts/result/adv_filter.tt2`
88
89 They should also review the following templates.  If these templates have
90 been customized or overridden, either the template should be replaced with
91 the stock version or the XSS fix (which entails adding `rel="nofollow` to
92 external links) applied to the customized version.
93
94 * `Open-ILS/src/templates/opac/parts/record/summary.tt2`
95 * `Open-ILS/src/templates/opac/parts/result/table.tt2`
96
97
98 Other Bugfixes
99 ~~~~~~~~~~~~~~
100 Evergreen 3.2.9 also includes the following changes:
101
102 General
103 ^^^^^^^
104
105 * Users can now save sort priorities for grids throughout the client
106 (https://bugs.launchpad.net/evergreen/+bug/1790169[Bug 1790169])
107
108 Circulation
109 ^^^^^^^^^^^
110
111 * Default hold transit slips no longer include patron's personal
112 information (https://bugs.launchpad.net/evergreen/+bug/1735847[Bug 1735847])
113 * Fixes an issue with the reshelving process
114 (https://bugs.launchpad.net/evergreen/+bug/1018011[Bug 1018011])
115
116 Reports
117 ^^^^^^^
118
119 * Fixes issues related to cloning templates made in the XUL client
120 (https://bugs.launchpad.net/evergreen/+bug/1796945[Bug 1796945])
121
122
123 Acknowledgements
124 ~~~~~~~~~~~~~~~~
125 We would like to thank the following individuals who contributed code,
126 tests and documentation patches to the 3.2.9 security release of
127 Evergreen:
128
129 * Thomas Berezansky
130 * Jason Boyer
131 * Galen Charlton
132 * Jeff Davis
133 * April Durrence
134 * Jason Etheridge
135 * Blake Graham-Henderson
136 * Andrea Buntz Neiman
137 * Debbie Luchenbill
138 * Dan Pearl
139 * Jane Sandberg
140 * Dan Scott
141 * Chris Sharp
142 * Remington Steed
143 * Jason Stephenson
144 * Dan Wells
145 * Derek C. Zoladz
146
147
148 Evergreen 3.2.8
149 ---------------
150
151 This release contains bug fixes improving on Evergreen 3.2.7.
152 All bug fixes refer to the web staff client unless otherwise specified.
153
154 Bug fixes
155 ~~~~~~~~~
156
157 General
158 ^^^^^^^
159
160 * Accessibility improvements to the date picker calendar button (https://bugs.launchpad.net/evergreen/+bug/1796903[Bug #1796903])
161 * Blank values in CSV grid downloads now show as blank instead of reading 'null' (https://bugs.launchpad.net/evergreen/+bug/1766982[Bug #1766982])
162 * Fixes invalid language codes in the staff client and KPAC (https://bugs.launchpad.net/evergreen/+bug/1802593[Bug #1802593])
163 * Fixes display issue with menus at certain screen resolutions (https://bugs.launchpad.net/evergreen/+bug/1813078[Bug 1813078])
164 * Removes duplicate columns from several grids (https://bugs.launchpad.net/evergreen/+bug/1683385[Bug 1683385])
165 * Adds a login failed message to the Angular sign in screen when appropriate (https://bugs.launchpad.net/evergreen/+bug/1834969[Bug 1834969])
166
167 Acquisitions
168 ^^^^^^^^^^^^
169
170 * Adds fund year to Distribution Formula fund dropdown menu (https://bugs.launchpad.net/evergreen/+bug/1329920[Bug 1329920])
171
172 Cataloging
173 ^^^^^^^^^^
174
175 * Extra whitespace in 856$9 subfields no longer prevents located URIs from being displayed in electronic resource records. (https://bugs.launchpad.net/evergreen/+bug/1722827[Bug #1722827])
176 * Fixes issue in Item Status import where spaces or empty lines in barcode files caused an import failure (https://bugs.launchpad.net/evergreen/+bug/1798187[Bug #1798187])
177 * The Item Status list and detail views now have the same actions available. (https://bugs.launchpad.net/evergreen/+bug/1775920[Bug #1775920])
178 * Adds record summary display to merge records (https://bugs.launchpad.net/evergreen/+bug/1739292[Bug #1739292])
179 * Fixes issue in Bucket grids where grid configurations were not saving correctly (https://bugs.launchpad.net/evergreen/+bug/1805895[Bug# 1805895])
180 * "Local catalog" is now at the top of the list of Z39.50 sources. (https://bugs.launchpad.net/evergreen/+bug/1787676[Bug #1787676])
181 * Fixes issue with authority_control_field.pl script (https://bugs.launchpad.net/evergreen/+bug/1650409[Bug #1650409])
182 * Fixes an issue with the "Retrieve Last Bib Record" action. (https://bugs.launchpad.net/evergreen/+bug/1830424[Bug #1830424])
183 * Fixes an issue with the Edit buttons in the Merge Records interface. (https://bugs.launchpad.net/evergreen/+bug/1836229[Bug #1836229])
184 * Fixes an issue with the _Clear_ button in the holdings template editor. (https://bugs.launchpad.net/evergreen/+bug/1803584[Bug #1803584])
185
186
187 Circulation
188 ^^^^^^^^^^^
189
190 * Fixes slowness issues with checkin and checkout grids (https://bugs.launchpad.net/evergreen/+bug/1777207[Bug #1777207])
191 * Fixes an issue that allowed staff to renew items to dates in the past. (https://bugs.launchpad.net/evergreen/+bug/1034058[Bug #1034058])
192 * Fixes an error that occured when checking in lost items when a certain setting was enabled. (https://bugs.launchpad.net/evergreen/+bug/1511765[Bug #1511765])
193 * Fixes an issue that caused the money summary to be missing from the patron record Bills tab. (https://bugs.launchpad.net/evergreen/+bug/1800484[Bug #1800484])
194 * Multiple improvements to the Mark Damaged Popup. (Bugs https://bugs.launchpad.net/evergreen/+bug/1759864[#1759864] and https://bugs.launchpad.net/evergreen/+bug/1742523[#1742523])
195
196 Development
197 ^^^^^^^^^^^
198
199 * Updates to the Angular client's .editorconfig file. (https://bugs.launchpad.net/evergreen/+bug/1838136[Bug #1838136])
200
201 Public catalog
202 ^^^^^^^^^^^^^^
203
204 * Accessibility improvements to form fields. (https://bugs.launchpad.net/evergreen/+bug/1735768[Bug #1735768])
205
206 Reports
207 ^^^^^^^
208
209 * Users can now hard code a list of filter values in a report template (https://bugs.launchpad.net/evergreen/+bug/1785061[Bug #1785061])
210 * Fixes an issue that caused column labels to re-sort when deleting fields in a template. (https://bugs.launchpad.net/evergreen/+bug/1751800[Bug #1751800])
211 * Fixes column type for Billing Totals and Billing Paid columns (https://bugs.launchpad.net/evergreen/+bug/1681930[Bug #1681930])
212
213
214 Acknowledgments
215 ~~~~~~~~~~~~~~~
216 We would like to thank the following individuals who contributed code,
217 testing and documentation patches to the 3.2.8 point release of
218 Evergreen:
219
220 * Kristy Bauman
221 * Jason Boyer
222 * Dan Briem
223 * Andrea Buntz Neiman
224 * Galen Charlton
225 * Garry Collum
226 * Dawn Dale
227 * Jeff Davis
228 * Bill Erickson
229 * James Fournie
230 * Rogan Hamby
231 * Kyle Huckins
232 * Cheyenne Jones
233 * Tiffany Little
234 * Jeanette Lundgren
235 * Geoff Sams
236 * Jane Sandberg
237 * Chris Sharp
238 * Remington Steed
239 * Jason Stephenson
240 * Josh Stompro
241 * Meg Stroup
242 * Dan Wells
243 * Beth Willis
244
245
246 Evergreen 3.2.7
247 ----------------
248
249 This release contains bug fixes improving on Evergreen 3.2.6.
250 All bug fixes refer to the web staff client unless otherwise specified.
251
252 Bug fixes
253 ~~~~~~~~~
254
255 Circulation
256 ^^^^^^^^^^^
257 * Corrects a rounding error that caused fines to exceed the max fines
258 amount
259 (https://bugs.launchpad.net/evergreen/+bug/1704819[Bug #1704819])
260 * Corrects an issue with printing Items Out receipts
261 (https://bugs.launchpad.net/evergreen/+bug/1790896[Bug #1790896])
262 * SIP Visa payments are now recorded as credit card, rather than cash
263 payments
264 (https://bugs.launchpad.net/evergreen/+bug/1796942[Bug #1796942])
265 * Converting change to patron credit no longer requires staff members
266 to refresh the screen to see the new credit
267 (https://bugs.launchpad.net/evergreen/+bug/1775639[Bug #1775639])
268 * The patron summary now includes tooltips that were available in
269 the XUL client
270 (https://bugs.launchpad.net/evergreen/+bug/1772206[Bug #1772206])
271 * The patron holds grid now includes a SMS Carrier column
272 (https://bugs.launchpad.net/evergreen/+bug/1748265[Bug #1748265])
273 * When registering a new patron from Pending Patrons, the address
274 type dropdown now supports a default value
275 (https://bugs.launchpad.net/evergreen/+bug/1816180[Bug #1816180])
276 * The Items Out grid now includes a Monograph Parts column
277 (https://bugs.launchpad.net/evergreen/+bug/1789257[Bug #1789257])
278 * The annotate checkbox on the bill payment screen is now sticky
279 (https://bugs.launchpad.net/evergreen/+bug/1759343[Bug #1759343])
280 * Group member details grid settings can now be saved
281 (https://bugs.launchpad.net/evergreen/+bug/1774707[Bug #1774707])
282 * The patron registration date of birth field can now display a
283 format example
284 (https://bugs.launchpad.net/evergreen/+bug/1819181[Bug #1819181])
285
286 Cataloging
287 ^^^^^^^^^^
288
289 * The MARC editor displays a warning when a cataloger attempts to
290 close the tab without saving
291 (https://bugs.launchpad.net/evergreen/+bug/1538678[Bug #1538678])
292 * The MARC editor displays a warning when permissions issues
293 prevent a record from saving
294 (https://bugs.launchpad.net/evergreen/+bug/1693580[Bug #1693580])
295 * The holdings editor saves default values more consistently
296 (https://bugs.launchpad.net/evergreen/+bug/1812900[Bug #1812900])
297 * The flat-text editor now uses a monospace font
298 (https://bugs.launchpad.net/evergreen/+bug/1817601[Bug #1817601])
299 * Statistical categories and their entries are now alphabetized in the
300 holdings editor (Bugs
301 https://bugs.launchpad.net/evergreen/+bug/1744386[Bug #1744386] and
302 https://bugs.launchpad.net/evergreen/+bug/1777184[Bug #1777184])
303 * The holdings editor now lists monograph parts in reverse alphabetical
304 order
305 (https://bugs.launchpad.net/evergreen/+bug/1760893[Bug #1760893])
306 * Buckets created from the MARC Batch Import process are now available
307 in the MARC Batch Edit interface
308 (https://bugs.launchpad.net/evergreen/+bug/1440890[Bug #1440890])
309 * The record bucket interface only displays the Merge action when
310 multiple records are selected
311 (https://bugs.launchpad.net/evergreen/+bug/1760599[Bug #1760599])
312 * Fixes an issue with the displayed number of items out
313 (https://bugs.launchpad.net/evergreen/+bug/1770217[Bug #1770217])
314
315 Client
316 ^^^^^^
317
318 * Fixes conflicting dependency information caused be the release of
319 Angular 8
320 (https://bugs.launchpad.net/evergreen/+bug/1830972[Bug #1830972])
321 * Angular grids include several new accessibility features and
322 keyboard shortcuts
323 (https://bugs.launchpad.net/evergreen/+bug/1816480[Bug #1816480])
324 * The menu in the top right corner is now named "Logout and more..."
325 (https://bugs.launchpad.net/evergreen/+bug/1796914[Bug #1796914])
326 * Several dropdown menus now require less scrolling
327 (https://bugs.launchpad.net/evergreen/+bug/1669120[Bug #1669120])
328
329
330 Public Catalog
331 ^^^^^^^^^^^^^^
332
333 * Avoids Internal Server Errors on search result page
334 (https://bugs.launchpad.net/evergreen/+bug/1155706[Bug #1155706])
335 * Double clicking the Place Hold button can no longer result in
336 multiple holds
337 (https://bugs.launchpad.net/evergreen/+bug/1029601[Bug #1029601])
338
339 Reports
340 ^^^^^^^
341
342 * Adds a more user-friendly interface for boolean filters
343 (https://bugs.launchpad.net/evergreen/+bug/1642337[Bug #1642337])
344
345 System administration
346 ^^^^^^^^^^^^^^^^^^^^^
347
348 * Improves consistency in terminology in the Local Administration
349 screen
350 (https://bugs.launchpad.net/evergreen/+bug/1776913[Bug #1776913])
351 * The Library Settings Editor now displays some example timezones
352 for the lib.timezone setting
353 (https://bugs.launchpad.net/evergreen/+bug/1817332[Bug #1817332])
354
355 Automated tests
356 ^^^^^^^^^^^^^^^
357 * Fixes an automated test related to translations and internationalization
358 (https://bugs.launchpad.net/evergreen/+bug/1768987[Bug #1768987])
359
360 Database
361 ^^^^^^^^
362
363 * Adds some foreign key functions that may be missing from your database
364 (https://bugs.launchpad.net/evergreen/+bug/1772028[Bug #1772028])
365
366
367 Acknowledgments
368 ~~~~~~~~~~~~~~~
369 We would like to thank the following individuals who contributed code,
370 testing and documentation patches to the 3.2.7 point release of
371 Evergreen:
372
373 * John Amundson
374 * a. bellenir
375 * Jason Boyer
376 * Galen Charlton
377 * Garry Collum
378 * Dawn Dale
379 * Jeff Davis
380 * Bill Erickson
381 * Jason Etheridge
382 * Lynn Floyd
383 * Jeff Godin
384 * Rogan Hamby
385 * Kyle Huckins
386 * Sam Link
387 * Terran McCanna
388 * Michele Morgan
389 * Bill Ott
390 * Suzanne Paterno
391 * Dan Pearl
392 * Mike Risher
393 * Geoff Sams
394 * Janet Schrader
395 * Remington Steed
396 * Jason Stephenson
397 * Josh Stompro
398 * Cesar Velez
399 * Dan Wells
400
401 Evergreen 3.2.6
402 ---------------
403
404 This release contains bug fixes improving on Evergreen 3.2.5.
405 All bug fixes refer to the web staff client unless otherwise specified.
406
407 Bug fixes
408 ~~~~~~~~~
409
410 General
411 ^^^^^^^
412
413 * Fixes a compatibility problem with the Item Status screen related to
414   JavaScript arrow functions
415   (https://bugs.launchpad.net/evergreen/+bug/1821196[Bug #1821196])
416
417 Booking
418 ^^^^^^^
419
420 * Fixes a bug in the Booking URL path that failed with newer Apache
421   (https://bugs.launchpad.net/evergreen/+bug/1823387[Bug #1823387])
422
423 Circulation
424 ^^^^^^^^^^^
425
426 * Fixes a display bug with the patron record Group Members list
427   (https://bugs.launchpad.net/evergreen/+bug/1642036[Bug #1642036])
428 * Fixes title sort on the patron Items Out Screen
429   (https://bugs.launchpad.net/evergreen/+bug/1782014[Bug #1782014])
430 * Fixes a refresh bug on the catalog record Holds View tab when moving between
431   records (https://bugs.launchpad.net/evergreen/+bug/1792188[Bug #1792188])
432 * Fixes the ability to place holds from item buckets
433   (https://bugs.launchpad.net/evergreen/+bug/1806394[Bug #1806394])
434
435 Cataloging
436 ^^^^^^^^^^
437
438 * Fixes a bug where copy templates would not apply properly
439   (https://bugs.launchpad.net/evergreen/+bug/1788680[Bug #1788680])
440 * Fixes the default cursor focus on the holdings editor
441   (https://bugs.launchpad.net/evergreen/+bug/1752968[Bug #1752968])
442 * Fixes a bug that failed to honor the "Retain empty bib records"
443   (cat.bib.keep_on_empty) setting when transferring items
444   (https://bugs.launchpad.net/evergreen/+bug/1333893[Bug #1333893])
445 * Fixes a bug that failed to include deleted bib records in TCN search
446   (https://bugs.launchpad.net/evergreen/+bug/1813633[Bug #1813633])
447
448 System administration
449 ^^^^^^^^^^^^^^^^^^^^^
450
451 * Added database indexes to speed up purging of Action Trigger event output
452   fields (https://bugs.launchpad.net/evergreen/+bug/1778940[Bug #1778940])
453 * Fixes the help text in action_trigger_aggregator.pl related to the remote-acct
454   argument (https://bugs.launchpad.net/evergreen/+bug/1803729[Bug #1803729])
455 * Adds a missing page title for the Closed Dates Editor
456   (https://bugs.launchpad.net/evergreen/+bug/1814943[Bug #1814943])
457 * Adds a missing page title for the Statistical Popularity Badges admin page
458   (https://bugs.launchpad.net/evergreen/+bug/1826890[Bug #1826890])
459
460
461 Acknowledgments
462 ~~~~~~~~~~~~~~~
463 We would like to thank the following individuals who contributed code,
464 testing and documentation patches to the 3.2.6 point release of
465 Evergreen:
466
467 * John Amundson
468 * Jason Boyer
469 * Galen Charlton
470 * Garry Collum
471 * Jeff Davis
472 * Bill Erickson
473 * Blake Graham-Henderson
474 * Rogan Hamby
475 * Millissa Macomber
476 * Terran McCanna
477 * Mike Rylander
478 * Jane Sandberg
479 * Janet Schrader
480 * Remington Steed
481 * Jason Stephenson
482 * Josh Stompro
483 * Dan Wells
484 * Beth Willis
485 * John Yorio
486
487
488 Evergreen 3.2.5
489 ---------------
490
491 This release contains bug fixes improving on Evergreen 3.2.4.
492 All bug fixes refer to the web staff client unless otherwise specified.
493
494 Bug fixes
495 ~~~~~~~~~
496
497 General
498 ^^^^^^^
499
500 * Improves the web client splash screen by linking the images along with their links
501   (https://bugs.launchpad.net/evergreen/+bug/1802662[Bug #1802662])
502
503 Circulation
504 ^^^^^^^^^^^
505
506 * Allows the Title Hold screen to remember previously selected pickup library
507   (https://bugs.launchpad.net/evergreen/+bug/1665534[Bug #1665534])
508 * Sorting improvements for printing the Holds Pull List
509   (https://bugs.launchpad.net/evergreen/+bug/1749502[Bug #1749502])
510 * Better display for non-catalogued checkouts in the offline checkout preview
511   pane (https://bugs.launchpad.net/evergreen/+bug/1818576[Bug #1818576])
512
513 Cataloging
514 ^^^^^^^^^^
515
516 * Fixes a bug that changed subfield order in bib record after editing a linked
517   authority (https://bugs.launchpad.net/evergreen/+bug/712490[Bug #712490])
518 * Allows opening multiple selected items in Item Status screen from the Holdings
519   View (https://bugs.launchpad.net/evergreen/+bug/1734775[Bug #1734775])
520 * Adds missing "Deleted?" column choice to Record Buckets
521   (https://bugs.launchpad.net/evergreen/+bug/1746360[Bug #1746360])
522 * Fixes the batch Call Number label field on the Call Number editor to populate
523   from the MARC record (https://bugs.launchpad.net/evergreen/+bug/1793196[Bug
524   #1793196])
525 * Fixes a bug to allow editing the call number label for some but not all
526   attached items (https://bugs.launchpad.net/evergreen/+bug/1794588[Bug
527   #1794588])
528 * Fixes the sort order of Parts on the Holdings View
529   (https://bugs.launchpad.net/evergreen/+bug/1800178[Bug #1800178])
530 * Adds missing action "Find Originating Acquisition" to Cataloging actions menu
531   (https://bugs.launchpad.net/evergreen/+bug/1705497[Bug #1705497])
532 * Keeps the Item Status screen updated after editing items
533   (https://bugs.launchpad.net/evergreen/+bug/1721109[Bug #1721109])
534 * Fixes a bug with the "checked" state of the Item note "Public Note" checkbox
535   (https://bugs.launchpad.net/evergreen/+bug/1778571[Bug #1778571])
536 * Fixes a bug with Item Alert counts in the Holdings view
537   (https://bugs.launchpad.net/evergreen/+bug/1798628[Bug #1798628])
538 * Improved display when merging bib records from a bucket (side by side, with
539   optional holdings) (https://bugs.launchpad.net/evergreen/+bug/1739293[Bug
540   #1739293])
541 * Fixes issues where edits to MARC records would fail to save during merge
542   (https://bugs.launchpad.net/evergreen/+bug/1776736[Bug #1776736])
543
544 System administration
545 ^^^^^^^^^^^^^^^^^^^^^
546
547 * Web client (websocket) logins are now properly tracked as user activity
548   (https://bugs.launchpad.net/evergreen/+bug/1818153[Bug #1818153])
549 * Fixes some log warnings related to Holds Depth
550   (https://bugs.launchpad.net/evergreen/+bug/1667497[Bug #1667497])
551 * Fixes a bug in the fine generator related to Bookings
552   (https://bugs.launchpad.net/evergreen/+bug/1819796[Bug #1819796])
553 * Fixes the Group Penalty Threshold link under the Local Administration menu
554   (https://bugs.launchpad.net/evergreen/+bug/1812389[Bug #1812389])
555 * Fixes a typo in seed data and all related PO files for translation
556   (https://bugs.launchpad.net/evergreen/+bug/1759238[Bug #1759238])
557 * Fixes an error in the sitemap_generator script when using the shortname
558   parameter (https://bugs.launchpad.net/evergreen/+bug/1808006[Bug #1808006])
559
560
561 Acknowledgments
562 ~~~~~~~~~~~~~~~
563 We would like to thank the following individuals who contributed code,
564 testing and documentation patches to the 3.2.5 point release of
565 Evergreen:
566
567 * John Amundson
568 * Jason Boyer
569 * Adam Bowling
570 * Steven Callender
571 * Galen Charlton
572 * Garry Collum
573 * Bill Erickson
574 * Jason Etheridge
575 * Rogan Hamby
576 * Elaine Hardy
577 * Kyle Huckins
578 * Sam Link
579 * Tiffany Little
580 * Terran McCanna
581 * Michele Morgan
582 * Geoff Sams
583 * Jane Sandberg
584 * Janet Schrader
585 * Chris Sharp
586 * Ben Shum
587 * Remington Steed
588 * Jason Stephenson
589 * Josh Stompro
590 * Dan Wells
591
592
593 Evergreen 3.2.4
594 ---------------
595
596 This release contains bug fixes improving on Evergreen 3.2.3.
597 All bug fixes refer to the web staff client unless otherwise specified.
598
599 Bug fixes
600 ~~~~~~~~~
601
602 Accessibility
603 ^^^^^^^^^^^^^
604
605 * Adds appropriate alt text to the Evergreen splash page (https://bugs.launchpad.net/evergreen/+bug/1802594[Bug #1802594])
606 * The public catalog search box now only autofocuses when searching is the main purpose of the page (https://bugs.launchpad.net/evergreen/+bug/1796225[Bug #1796225])
607
608 Acquisitions
609 ^^^^^^^^^^^^
610
611 * Fixes an issue that prevented purchase orders to not open in a new tab (https://bugs.launchpad.net/evergreen/+bug/1813290[Bug #1813290])
612
613 Circulation
614 ^^^^^^^^^^^
615
616 * The Billing History grids now save their configuration in the database (https://bugs.launchpad.net/evergreen/+bug/1806709[Bug #1806709])
617
618 Cataloging
619 ^^^^^^^^^^
620
621 * Catalogers can now set the Bib Source in the Z39.50 Overlay and Import interfaces (https://bugs.launchpad.net/evergreen/+bug/1727345[Bug #1727345])
622 * Fixes an issue where publishers display in the publication date column in copy buckets (https://bugs.launchpad.net/evergreen/+bug/1812698[Bug #1812698])
623 * Electronic reources no longer display a call number called _##URI##_ in the Volume Editor (https://bugs.launchpad.net/evergreen/+bug/1752665[Bug #1752665])
624 * Spine/pocket label templates can now include circulation library and owning library (https://bugs.launchpad.net/evergreen/+bug/1726568[Bug #1726568])
625
626
627 Reports
628 ^^^^^^^
629
630 * Fixes an issue where external documentation links can open in the reports module (https://bugs.launchpad.net/evergreen/+bug/1784893[Bug #1784893])
631 * Fixes an issue where publishers display as a publication date in reports (https://bugs.launchpad.net/evergreen/+bug/1812698[Bug #1812698])
632
633 Search
634 ^^^^^^
635
636 * Staff users can now set their prefered default Advanced Search pane (https://bugs.launchpad.net/evergreen/+bug/1799963[Bug #1799963])
637 * The public catalog search box now only autofocuses when searching is the main purpose of the page (https://bugs.launchpad.net/evergreen/+bug/1796225[Bug #1796225])
638
639 System administration
640 ^^^^^^^^^^^^^^^^^^^^^
641
642 * The _DELETE_COPY_ALERT_ permission no longer needs to be granted on the consortium level (https://bugs.launchpad.net/evergreen/+bug/1783421[Bug #1783421])
643
644 Angular client
645 ^^^^^^^^^^^^^^
646
647 * The angular client now uses Angular 7 (https://bugs.launchpad.net/evergreen/+bug/1801984[Bug #1801984])
648 * The angular client grid actions can now be disabled depending on the criteria of which rows are selected (https://bugs.launchpad.net/evergreen/+bug/1808268[Bug #1808268])
649 * Angular client pages now display their own titles in the browser tab, rather than _AngEG_ (https://bugs.launchpad.net/evergreen/+bug/1813647[Bug #1813647])
650
651
652 Acknowledgments
653 ~~~~~~~~~~~~~~~
654 We would like to thank the following individuals who contributed code,
655 tests and documentation patches to the 3.2.4 point release of
656 Evergreen:
657
658 * John Amundson
659 * Jason Boyer
660 * Galen Charlton
661 * Jeff Davis
662 * James Fournie
663 * Angela Kilsdonk
664 * Sam Link
665 * Tiffany Little
666 * Terran McCanna
667 * Michele Morgan
668 * Mike Rylander
669 * Jane Sandberg
670 * Chris Sharp
671 * Jason Stephenson
672 * Ben Shum
673 * Cesar Velez
674 * Dan Wells
675
676 Evergreen 3.2.3
677 ----------------
678 This release contains bug fixes improving on Evergreen 3.2.3.
679 All bug fixes refer to the staff client unless otherwise specified.
680
681 Bug fixes
682 ~~~~~~~~~
683
684 General
685 ^^^^^^^
686
687 * Hatch is now deprecated for local data storage.  Hatch is
688 still recommended for printing in certain situations.
689
690 Acquisitions
691 ^^^^^^^^^^^^
692
693 * The new `edi_order_pusher.pl` now only pushes purchase orders
694 with a state of "on-order", to prevent older purchase orders
695 from being unintentionally pushed to vendors.
696
697 Cataloging
698 ^^^^^^^^^^
699
700 * The Z39.50 and record bucket interfaces now open relevant 
701 catalog records in new tabs.
702 * Fixes a bug that prevented batch importing authority records.
703 * The template dropdown in the holdings editor now provides more
704 space to accommodate longer template names.
705 * The drop-down of copy tag types in the Manage Copy Tags dialog
706 now includes the owning library of the copy tag type.
707
708 Circulation
709 ^^^^^^^^^^^
710
711 * Fixes an issue with recalling checked-out materials.
712 * Added several missing columns to the patron bills grid.
713 * Corrected the display of the Bill Type column in the patron bills grid.
714 * Clarified the names of the "Billing Location" and "Grocery Billing
715 Location" columns in the patron bills grid.
716 * The Bill Full Details grid now includes a billing location column
717 for both circulation and grocery bills, as well as the owning library for
718 circulation bills.
719 * The Billing History transactions grid now remembers any changes that
720 users make to the column settings.
721 * Fixes an issue with printing multiple copies of bills.
722 * Fixes an issue with saving self-registered patron accounts.
723 * Staff can now delete self-registered patron accounts.
724
725 System administration
726 ^^^^^^^^^^^^^^^^^^^^^
727
728 * Fixes the marc_stream_importer to be compatible with Vandelay session
729 tracking.
730 * Includes an accessibility improvement for the Acquisitions
731 Administration interfaces.
732
733
734 Acknowledgments
735 ~~~~~~~~~~~~~~~
736 We would like to thank the following individuals who contributed code,
737 tests and documentation patches to the 3.2.3 point release of
738 Evergreen:
739
740 * John Amundson
741 * Jason Boyer
742 * Andrea Buntz Neiman
743 * Jeff Davis
744 * Bill Erickson
745 * Kyle Huckins
746 * Angela Kilsdonk
747 * Katie G. Martin
748 * Terran McCanna
749 * Mike Rylander
750 * Jane Sandberg
751 * Janet Schrader
752 * Chris Sharp
753 * Remington Steed
754 * Jason Stephenson
755 * Cesar Velez
756
757
758 Evergreen 3.2.2
759 ----------------
760 This release contains bug fixes improving on Evergreen 3.2.1.
761 All bug fixes refer to the web staff client unless otherwise specified.
762
763 Bug fixes
764 ~~~~~~~~~
765
766 General
767 ^^^^^^^
768
769 * Fixes a bug that blocked logging in from mobile browsers
770 * Fixes a readability issue with mobile menus
771 * Fixes performance issue related to grid tooltips.
772 * Fixes an issue that caused some grid columns to appear
773 empty.
774
775 Cataloging
776 ^^^^^^^^^^
777
778 * Improves the functionality of setting a default tab of a bib record
779 * The web client now remembers the most recently selected copy template
780 * Adds help tips to Print Item Labels Settings tab
781 * If you add or edit copies and/or volumes from the Holdings View tab,
782 the view now automatically refreshes to show your changes.
783 * Provides an upgrade to MODS 3.3 for older Evergreen installations.
784 * Improves usability of Z39.50 MARC View.
785
786
787 Circulation
788 ^^^^^^^^^^^
789
790 * Fixes a daylight savings time-related circulation bug.
791 * Fixes a bug that caused deleted items to show up on the holds shelf.
792 * Staff can now place multiple email addresses into the patron registration/
793 edit form, depending on the value of the `ui.patron.edit.au.email.regex`
794 library setting.
795 * Fixes an issue with the offline circulation module.
796 * When merging two users, the non-lead account is now completely purged from
797 the database, rather than simply being marked as deleted.
798 * Fixes a bug which prevented the canceling of holds from the title
799 record.
800
801 Public catalog
802 ^^^^^^^^^^^^^^
803
804 * Removes incorrect copy counts from metarecord search results pages
805 * Electronic resources now display in the browse interfaces
806 * Restores ability to request password resets
807
808 System administration
809 ^^^^^^^^^^^^^^^^^^^^^
810
811 * The example Apache 2.4 configuration now enables remoteip.
812 * Improves syntax in the fm_idl file.
813
814
815 Acknowledgements
816 ~~~~~~~~~~~~~~~~
817 We would like to thank the following individuals who contributed code,
818 tests and documentation patches to the 3.2.2 point release of
819 Evergreen:
820
821 * Jason Boyer
822 * Galen Charlton
823 * Garry Collum
824 * Bill Erickson
825 * Rogan Hamby
826 * Rosie Le Faive
827 * Jeanette Lundgren
828 * Kathy Lussier
829 * Michele Morgan
830 * Mike Rylander
831 * Jane Sandberg
832 * Janet Schrader
833 * Chris Sharp
834 * Ben Shum
835 * Remington Steed
836 * Jason Stephenson
837 * Cesar Velez
838 * Dan Wells
839
840 Evergreen 3.2.1
841 ----------------
842 This release contains bug fixes improving on Evergreen 3.2.0.
843
844 Bug fixes
845 ~~~~~~~~~
846
847 * Adds several columns to the items out grid.
848 * Adds the ability to copy patron addresses to the clipboard.
849 * Fixes several issues with adding new items and call numbers.
850 * Adds links to catalog records from the query and pending tabs of the Record Buckets interface.
851 * Corrects the date format used in several bucket interfaces.
852 * Adds a loading spinner to interfaces that are embedded in the web staff client via iframe
853 (such as the catalog).
854 * The new Angular 6 interfaces now use the correct favicon.
855
856 Acknowledgements
857 ~~~~~~~~~~~~~~~~
858 We would like to thank the following individuals who contributed code,
859 tests and documentation patches to the 3.2.1 point release of
860 Evergreen:
861
862 * John Amundson
863 * a. bellenir
864 * Jason Boyer
865 * Galen Charlton
866 * Garry Collum
867 * Dawn Dale
868 * Bill Erickson
869 * Kathy Lussier
870 * Mike Rylander
871 * Jane Sandberg
872 * Jason Stephenson
873 * Cesar Velez
874 * Dan Wells
875
876
877 3.2.0 Upgrade notes
878 -------------------
879
880 Disabling of Legacy XUL Staff Client
881 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
882 The legacy XUL staff client is no longer supported in Evergreen
883 3.2.x and the server-side installation no longer supports a
884 direct connection by a version XUL client by default.  *All
885 users of Evergreen 3.2.x are strongly urged to complete their
886 switch to the web staff client as part of upgrading to 3.2.x.*
887
888 Evergreen administrators who for some reason continue to wish
889 to deploy the XUL staff client can do so at their risk by
890 supplying `STAFF_CLIENT_STAMP_ID` during the `make install` step
891 and using `make_release` to create installers for the staff client.
892 However, no community support will be provided for the XUL client.
893
894
895
896 Acq Invoice Reports
897 ~~~~~~~~~~~~~~~~~~~
898
899 Existing Acquisitions report templates that reference the invoice 'complete'
900 field should be modified to check whether the new close_date field is NOT NULL
901 instead.
902
903 At deploy time, all invoices with a 'complete' value of TRUE will have their
904 'close_date' field set to NOW.  A value is required, since this field is
905 now the source of whether an invoice is open or closed.
906
907 However, no values will be applied to the closed_by field for already closed
908 invoices.
909
910
911 Angular6 Base Application
912 ~~~~~~~~~~~~~~~~~~~~~~~~~
913
914 System Admin Upgrade Notes
915 ^^^^^^^^^^^^^^^^^^^^^^^^^^
916
917 Like the AngularJS application, Evergreen releases will come with all
918 web browser staff client code pre-compiled.  Admins only need to add an
919 Apache configuration change.
920
921 Add the following stanza to /etc/apache2/eg_vhost.conf.
922
923 [source,conf]
924 --------------------------------------------------------------------------
925 RewriteCond %{REQUEST_URI}  ^/eg2/
926 RewriteCond %{REQUEST_URI}  !^/eg2/([a-z]{2}-[A-Z]{2})/
927 RewriteRule ^/eg2/(.*) https://%{HTTP_HOST}/eg2/en-US/$1 [R=307,L]
928
929 <Directory "/openils/var/web/eg2/en-US">
930     FallbackResource /eg2/en-US/index.html
931 </Directory>
932 --------------------------------------------------------------------------
933
934 For multi-locale sites, see the bottom section of
935 Open-ILS/examples/apache[_24]/eg_vhost.conf.in for a sample fr-CA
936 configuration.  The section starts with "/eg2/ client setup and locale
937 configuration"
938
939 Developer Upgrade Notes
940 ^^^^^^^^^^^^^^^^^^^^^^^
941
942 Developers building Angular code on existing installations need to update
943 their version of NodeJS by re-running the -developer prereqs installer.
944
945 [source,sh]
946 --------------------------------------------------------------------------
947 sudo make -f Open-ILS/src/extras/Makefile.install <osname>-developer
948 --------------------------------------------------------------------------
949
950
951 Asynchronous Vandelay Imports
952 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
953
954 Users of NGINX as a reverse proxy may need to set a suitable
955 `client_max_body_size` value in the NGINX configuration so that large
956 MARC record uploads are not truncated. Note that this would have
957 always been necessary, but since this feature allows larger files
958 to be more reliably queued and imported, the need to set `client_max_body_size`
959 became more apparent.
960
961
962 Browser Client Settings & Preferences Stored on the Server
963 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
964
965 A new permission APPLY_WORKSTATION_SETTING has been added to control who
966 may apply values to workstation settings.  Use something like the following
967 to apply the permission to all staff accounts (mileage may vary):
968
969 [source,sh]
970 --------------------------------------------------------------------------
971 INSERT INTO permission.grp_perm_map (grp, perm, depth)
972 VALUES (
973     (SELECT id FROM permission.grp_tree WHERE name = 'Staff'), -- name may vary
974     (SELECT id FROM permission.perm_list WHERE code =
975 'APPLY_WORKSTATION_SETTING'),
976     0 -- or 1, 2, etc.
977 );
978 --------------------------------------------------------------------------
979
980 Workstation setting types matching values previously stored in the browser
981 (via localStorage or Hatch) are created as part of this feature.  During
982 upgrade, admins should consider whether any of these new setting types
983 should be transferred to user and/or org unit settings instead.  Setting
984 type changes can be made at any time, but when a setting type is deleted
985 all of its data is deleted, so a change in type means re-applying the
986 settings in the browser client.
987
988 Values stored in the browser will automatically migrate to server settings
989 as each setting is accessed in the browser client.  Once migrated, the
990 in-browser copies are deleted.
991
992 If a setting type does not exist where the browser expects one, the
993 value is stored in-browser instead and a warning is issued in the console.
994
995
996
997
998 3.2.0 New Features
999 ------------------
1000
1001
1002 Acquisitions
1003 ~~~~~~~~~~~~
1004
1005 Auto-Cancel Line items When All Copies Are Canceled
1006 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1007 When a copy (line item detail) is canceled through the Acquisitions interface, 
1008 the parent line item is also canceled if all copies for that line item are also 
1009 canceled.  The cancel reason given will come from:
1010
1011 . The cancel reason for the just-canceled copy if it's a Keep Debits true 
1012 cancel reason.
1013 . The cancel reason from any other copy on the lineitem that has a Keep 
1014 Debits true cancel reason.
1015 . The cancel reason for the just-canceled copy if no copies have a Keep
1016 Debits true cancel reason.
1017
1018
1019 Invoice Closed Date and Closed By Fields
1020 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1021 Acquisitions invoices have 2 new fields:
1022
1023 * Close Date -- This is set to the time when the ACQ user clicks the "Close"
1024   button in the invoice interface.
1025   ** This field 'replaces' the existing 'complete' field.  An invoice is
1026      considered complete if a close date value is set.
1027 * Closed By -- This is set to the logged in staff user who performs the 
1028   "Close" action.
1029
1030 As with the now-defunct 'complete' field, but new fields are cleared in the 
1031 event an invoice is reopened.
1032
1033 These new fields are visible in the invoice interface under the 
1034 'Show Details' action for closed invoices.
1035
1036 Upgrading Invoice Reports
1037 +++++++++++++++++++++++++
1038
1039 Existing report templates that reference the invoice 'complete' field 
1040 should be modified to check whether the new close_date field is NOT NULL
1041 instead.
1042
1043 Other Upgrade Considerations
1044 ++++++++++++++++++++++++++++
1045
1046 At deploy time, all invoices with a 'complete' value of TRUE will have their
1047 'close_date' field set to NOW.  A value is required, since this field is
1048 now the source of whether an invoice is open or closed.
1049
1050 However, no values will be applied to the closed_by field for already closed
1051 invoices.
1052
1053
1054
1055 Patron Acquisitions Requests
1056 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1057
1058 The existing interface for staff-mediated patron acquisition requests has been replaced in the web staff client with a re-implementation written in AngularJS, with some minor bug fixes (including access from the Patron interface) and other improvements.
1059
1060
1061
1062 Administration
1063 ~~~~~~~~~~~~~~
1064
1065 Hold Targeter Script has been Replaced
1066 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1067
1068 The original hold_targeter.pl script has been renamed to
1069 "hold_targeter_legacy.pl", and the new-style hold targeting
1070 script has been renamed to "hold_targeter.pl".  Administrators
1071 will want to change their crontab files to reflect this.
1072
1073 .Previous Syntax
1074 [source,bash]
1075 ---------------------------------------------------------------------
1076 -*/15 * * * *   . ~/.bashrc && $EG_BIN_DIR/hold_targeter.pl $SRF_CORE
1077 ---------------------------------------------------------------------
1078
1079 .New Syntax
1080 [source,bash]
1081 -----------------------------------------------------------------------------------
1082 -*/15 * * * *   . ~/.bashrc && $EG_BIN_DIR/hold_targeter.pl --osrf-config
1083 $SRF_CORE
1084 -----------------------------------------------------------------------------------
1085
1086 The sample crontab file at `Open-ILS/examples/crontab.example` reflects
1087 this change.
1088
1089
1090
1091 Architecture
1092 ~~~~~~~~~~~~
1093
1094 Angular6 Base Application
1095 ^^^^^^^^^^^^^^^^^^^^^^^^^
1096 With Evergreen 3.2, we introduce the initial infrastructure for
1097 migrating to a new version of Angular.  The structure of the new code
1098 is quite different from the AngularJS code and it runs as a separate
1099 application which communicates with the AngularJS app via shared storage
1100 and in-page URLs that link back and forth between the two.
1101
1102 For this release, users will only be directed to the new Angular site
1103 when navigating to Administration => Acquisitions Administration.  Once
1104 on this page, some of the admin interfaces will presented as Angular6
1105 interfaces, while others will direct users back to the AngularJS
1106 application.  The Angular6 interfaces are the simpler, grid-based
1107 interfaces.
1108
1109 Acquisitions Admin Angular6 Interfaces
1110 ++++++++++++++++++++++++++++++++++++++
1111
1112  * Cancel Reasons
1113  * Claim Event Types
1114  * Claim Policies
1115  * Claim Policy Actions
1116  * Claim Types
1117  * Currency Types
1118  * EDI Accounts
1119  * EDI Messages
1120  * Exchange Rates
1121  * Fund Tags
1122  * Invoice Item Types
1123  * Invoice Payment Method
1124  * Line Item Alerts
1125  * Line Item MARC Attribute Definitions
1126
1127 System Admin Upgrade Notes
1128 ++++++++++++++++++++++++++
1129
1130 Like the AngularJS application, Evergreen releases will come with all
1131 web browser staff client code pre-compiled.  Admins only need to add an
1132 Apache configuration change.
1133
1134 Add the following stanza to /etc/apache2/eg_vhost.conf.
1135
1136 [source,conf]
1137 --------------------------------------------------------------------------
1138 RewriteCond %{REQUEST_URI}  ^/eg2/
1139 RewriteCond %{REQUEST_URI}  !^/eg2/([a-z]{2}-[A-Z]{2})/
1140 RewriteRule ^/eg2/(.*) https://%{HTTP_HOST}/eg2/en-US/$1 [R=307,L]
1141
1142 <Directory "/openils/var/web/eg2/en-US">                                       
1143     FallbackResource /eg2/en-US/index.html                                     
1144 </Directory>  
1145 --------------------------------------------------------------------------
1146
1147 For multi-locale sites, see the bottom section of
1148 Open-ILS/examples/apache[_24]/eg_vhost.conf.in for a sample fr-CA
1149 configuration.  The section starts with "/eg2/ client setup and locale
1150 configuration"
1151
1152 Developer Upgrade Notes
1153 +++++++++++++++++++++++
1154
1155 Developers building Angular code on existing installations need to update 
1156 their version of NodeJS by re-running the -developer prereqs installer.
1157
1158 [source,sh]
1159 --------------------------------------------------------------------------
1160 sudo make -f Open-ILS/src/extras/Makefile.install <osname>-developer
1161 --------------------------------------------------------------------------
1162
1163
1164 Cataloging
1165 ~~~~~~~~~~
1166
1167 Add UPC to z39.50 search for OCLC and LOC
1168 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1169 Add UPC as a search attribute for both OCLC and LOC targets in
1170 z39.50 for cataloging.
1171
1172
1173 Asynchronous Vandelay Imports
1174 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1175
1176 Vandelay imports are now monitored from the browser client asynchronously,
1177 meaning the client requests updates from the server instead of waiting for 
1178 the server to respond to the original import request.  This changes allows 
1179 for incremental progress updates in the browser client.
1180
1181 New Database Table
1182 ++++++++++++++++++
1183
1184 This adds a new database table vandelay.session_tracker for tracking
1185 in-progress vandelay upload activity.  A new tracker row is added for
1186 each of "upload", "enqueue", and "import" actions, linked for a given
1187 session by the value stored in the "session_key" field.
1188
1189 The table tracks other potentially useful data, like the staff member
1190 and workstation where the action was performed.
1191
1192 Upgrade notes
1193 +++++++++++++
1194 Users of NGINX as a reverse proxy may need to set a suitable
1195 `client_max_body_size` value in the NGINX configuration so that large
1196 MARC record uploads are not truncated. Note that this would have
1197 always been necessary, but since this feature allows larger files
1198 to be more reliably queued and imported, the need to set `client_max_body_size`
1199 became more apparent.
1200
1201
1202
1203
1204 Support for Last Inventory Date
1205 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1206 Evergreen now provides an option to add an inventory date to items to facilitate
1207 the process of performing inventory in libraries. Staff can add an inventory
1208 date to an item in one of the following ways:
1209  * From the check in screen, there is now an Update Inventory check in modifier.
1210 When selected, scanned barcodes will have the current date/time added as the
1211 inventory date while the item is checked in.
1212  * From the Item Status screen, an action is available to add the current 
1213 date/time as the inventory date to selected items.
1214
1215 This new feature will also store the workstation that was used when the
1216 inventory date was updated.
1217
1218
1219
1220 Parallel Ingest with pingest.pl
1221 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1222 A program named pingest.pl is now installed to allow faster bibliographic record
1223 ingest.  It performs ingest in parallel so that multiple batches can
1224 be done simultaneously.  It operates by splitting the records to be
1225 ingested up into batches and running all of the ingest methods on each
1226 batch.  You may pass in options to control how many batches are run at
1227 the same time, how many records there are per batch, and which ingest
1228 operations to skip.
1229
1230 NOTE: The browse ingest is presently done in a single process over all
1231 of the input records as it cannot run in parallel with itself.  It
1232 does, however, run in parallel with the other ingests.
1233
1234 Command Line Options
1235 ++++++++++++++++++++
1236 pingest.pl accepts the following command line options:
1237
1238 --host::
1239     The server where PostgreSQL runs (either host name or IP address).
1240     The default is read from the PGHOST environment variable or
1241     "localhost."
1242
1243 --port::
1244     The port that PostgreSQL listens to on host.  The default is read
1245     from the PGPORT environment variable or 5432.
1246
1247 --db::
1248     The database to connect to on the host.  The default is read from
1249     the PGDATABASE environment variable or "evergreen."
1250
1251 --user::
1252     The username for database connections.  The default is read from
1253     the PGUSER environment variable or "evergreen."
1254
1255 --password::
1256     The password for database connections.  The default is read from
1257     the PGPASSWORD environment variable or "evergreen."
1258
1259 --batch-size::
1260     Number of records to process per batch.  The default is 10,000.
1261
1262 --max-child::
1263     Max number of worker processes (i.e. the number of batches to
1264     process simultaneously).  The default is 8.
1265
1266 --skip-browse::
1267 --skip-attrs::
1268 --skip-search::
1269 --skip-facets::
1270 --skip-display::
1271     Skip the selected reingest component.
1272
1273 --start-id::
1274     Start processing at this record ID.
1275
1276 --end-id::
1277     Stop processing when this record ID is reached.
1278
1279 --pipe::
1280     Read record IDs to reingest from standard input.  This option
1281     conflicts with --start-id and/or --end-id.
1282
1283 --max-duration::
1284     Stop processing after this many total seconds have passed.  The
1285     default is to run until all records have been processed.
1286
1287 --help::
1288     Show the help text.
1289
1290
1291
1292 View Authority Record by Database ID
1293 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1294
1295 A new interface allows catalogers to retrieve a specific
1296 authority record using its database ID.  Catalogers can
1297 find those IDs in subfield $0 of matching fields in
1298 bibliographic records.
1299
1300 To use the new authority record viewer:
1301
1302 . Click *Cataloging -> Retrieve Authority Record by ID*.
1303 . Type in the ID number of the authority record you are
1304 interested in. Don't include any prefixes, just the ID
1305 number.
1306 . Click *Submit*.
1307 . View or edit the authority record as needed.
1308
1309
1310
1311 Circulation
1312 ~~~~~~~~~~~
1313
1314
1315
1316 Autorenewal of Loans
1317 ^^^^^^^^^^^^^^^^^^^^
1318 Circulation policies in Evergreen can now be configured to automatically renew
1319 certain items checked out on patron accounts. Circulations will be renewed
1320 automatically up to a custom limit (the `max_auto_renewal` field) and patrons
1321 will not need to log in to their OPAC accounts or ask library staff to manually
1322 renew materials.
1323
1324 Two new action triggers have been added to Evergreen that permit the Auto-Renew
1325 feature. They can be found, configured, and enabled in Administration>Local
1326 Administration>Notifications/Action Triggers. They are named **Autorenew** and
1327 **AutorenewNotify**.
1328
1329 The **Autorenew** A/T definition uses the `checkout.due` hook to automatically
1330 validate and renew (in the reactor) circulations on the day they are due,
1331 grouped by user. The output events of this definition is is the input used by
1332 the related **AutorenewNotify** A/T that simply uses a new hook called
1333 `autorenewal` to notify patrons via email of their currently due or
1334 auto-renewed items.
1335
1336 In the webstaff's Patron Items Out page, the new column `AutoRenewalsRemaining`
1337 indicates how many autorenewals are available for a particular circulation.
1338
1339
1340
1341
1342
1343 Emergency Closing Handler
1344 ^^^^^^^^^^^^^^^^^^^^^^^^
1345
1346 Staff are provided with interfaces and mechanisms to create library closings
1347 that, in addition to affecting future circulation and booking due dates, and
1348 hold shelf expirations, will automatically move existing circulation and booking
1349 due dates and hold shelf expiration times. This new functionality is
1350 conceptually described as Emergency Closings and business logic implementing it
1351 as the Emergency Closing Handler. It contains additions and adjustments to the
1352 user interface, business logic, and database layers. Access to this
1353 functionality is available through the Closed Dates Editor interface in the
1354 staff client which has been ported to AngularJS.
1355
1356 Overview
1357 ++++++++
1358
1359 This development has created new business logic code to inspect, in real time,
1360 existing circulation, booking, and hold records, and modify such date and time
1361 stamps so that the circulation, booking, or hold will end in the same state it
1362 would have if the closing had existed at the time the circulation or booking
1363 occurred, or the hold was placed and captured. Of specific note, hourly loans
1364 will have their due date adjusted to be the end of the day following the
1365 closing.
1366
1367 When the Emergency Closing is saved, any fines accrued during the closing may be
1368 voided, as settings dictate, with the exception of circulations that have been
1369 marked as LOST or LONG OVERDUE. That is, even for LOST and LONG OVERDUE
1370 circulations with due dates that fall within the Emergency Closing, no fine
1371 adjustment will be applied. Emergency Closing processing is permanent, and
1372 cannot be rolled back.
1373
1374 This functionality is explicitly initiated by staff action. If staff do not
1375 request an Emergency Closing, existing circulations, bookings, and holds will
1376 not be processed and adjusted. However, if staff request any Closing that starts
1377 nearer in time than the length of the longest circulation duration configured
1378 for use in the Evergreen instance they will be prompted with the option to
1379 create the closing as an Emergency Closing.
1380
1381 Action/Trigger hooks have been created for circulations and bookings that are
1382 adjusted by the Emergency Closing Handler. These will facilitate the creation of
1383 notifications to patrons that the due date has changed and to alert them to
1384 potential changes in accrued fines.
1385
1386 Booking start dates are explicitly ignored in this implementation. Because an
1387 Emergency Closing is, by its nature, an unexpected event, it will be up to staff
1388 to address any bookings which intersect with a new Emergency Closings. Reports
1389 can be used to identify booking start dates that overlap with a closing and that
1390 may require staff intervention.
1391
1392 Staff requesting and Emergency Closing must have the new EMERGENCY_CLOSING
1393 permission.  Some text describing the feature.
1394
1395
1396
1397
1398
1399 Patron Preferred Name and Name Search Keywords
1400 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1401
1402 Preferred Name
1403 ++++++++++++++
1404
1405 Adds a new set of patron preferred name fields for prefix, first,
1406 middle, last, and suffix allowing patrons to provide preferred name
1407 information.  Preferred names are optional and each acts as an overlay
1408 to the analogous primary name field, making it possible to provide
1409 preferred name values for individual fields.
1410
1411 For example, a patron named William Erickson may have a preferred first
1412 name (pref_first_given_name) of Bill, in which case the preferred name
1413 would be Bill Erickson.  Note a preferred last name is not required in
1414 this case as the code uses primary name values as defaults when not
1415 replaced with a preferred version.
1416
1417 * Patrons will see primary names displayed in the catalog when set.
1418 * Staff will see both primary name and preferred name in the patron
1419   summary side bar.
1420 * Patron searches for any given name field will search both the primary
1421   and preferred name data.
1422 * Preferred name fields are available in Action/Trigger templates and
1423   are present in various patron-focused print templates.
1424
1425 Name Keywords
1426 ++++++++++++++
1427
1428 Adds a new field to store miscellaneous patron name search terms.  These
1429 values are only for searching and do not appear in any interfaces, apart
1430 from the patron summary side bar and the patron edit UI.
1431
1432 Included is a new search field in the patron search UI which searches
1433 keyword values and all other name fields.  It's essentially a global patron
1434 name keyword search.
1435
1436
1437
1438
1439 Client
1440 ~~~~~~
1441
1442 Disabling of legacy XUL staff client
1443 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1444 The legacy XUL staff client is no longer supported in Evergreen
1445 3.2.x and the server-side installation no longer supports a
1446 direct connection by a version XUL client by default.  All
1447 users of Evergreen 3.2.x are strongly urged to complete their
1448 switch to the web staff client as part of upgrading to 3.2.x.
1449
1450 Evergreen administrators who for some reason continue to wish
1451 to deploy the XUL staff client can do so at their risk by
1452 supplying `STAFF_CLIENT_STAMP_ID` during the `make install` step
1453 and using `make_release` to create installers for the staff client.
1454 However, no community support will be provided for the XUL client.
1455
1456
1457
1458
1459 Permission Group Display Entries
1460 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1461 In some cases, it is useful to have the ability to reorder permission, or to make
1462 only specific groups available in the permission group selector for specific
1463 Org Units. An interface has been made available to allow this.
1464
1465 Group Tree Display Entry Interface
1466 ++++++++++++++++++++++++++++++++++
1467
1468 Permission Group Display Entries can be reordered, added, or removed via
1469 _Administration -> Local Admin -> Permission Tree Display Entries_.
1470 Select the Org Unit you wish to edit the entries in.
1471
1472 Entries may be added using the Add functionality, creating entries based
1473 on permission groups that have not been added to the tree for the Org
1474 Unit you wish to add them to.
1475
1476 image::media/pgtde_01.png[Group Tree Display Entry Admin UI]
1477
1478 Moving an Entry
1479 +++++++++++++++
1480 Moving an entry will shift its position up or down in the patron profile
1481 selector for a given Org Unit.
1482
1483 * Select an entry
1484 * Press either the *Move Up* or *Move Down* button. The entry will be 
1485 moved up or down, accordingly.
1486 * Click *Save* to save your edits.  
1487
1488 NOTE: You may only move up or down entries that have sibling entries.
1489
1490 Removing an Entry
1491 +++++++++++++++++
1492 If you want a particular Org Unit to not have access to specific
1493 entries, you may remove an entry. Removing an entry will remove it from 
1494 view. The entry will be removed from the database.
1495
1496 * Select an entry and press the *Remove* button.
1497
1498 Adding an Entry
1499 +++++++++++++++
1500 You may add entries from permission groups that are not currently
1501 reflected in the permission group tree. This is useful for moving 
1502 entries to different parents, or making them root entries.
1503
1504 image::media/pgtde_02.png[Add Entry modal]
1505
1506 * If desired, select an entry to be used as the parent entry. 
1507 * Press the *Add* button. 
1508 * Select a permission group from the dropdown.
1509 * If you've selected a parent entry, you may check the *Add Root Entry*
1510 box to override that parent and add the entry on the root level. 
1511 * If you did not select a parent entry, the entry will be added on the root 
1512 level of the tree.
1513
1514
1515
1516 Browser Client Settings & Preferences Stored on the Server
1517 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1518 Browser client settings and preferences that should persist over time are
1519 now stored as settings on the server.  This allows settings to follow
1520 users and workstations and reduces problems associated with losing settings 
1521 as a result of clearing browser data.
1522
1523 The browser client honors setting values stored as user settings, workstation
1524 settings, and org unit settings, depending on which setting types are
1525 locally configured.
1526
1527 Setting Types
1528 +++++++++++++
1529
1530 * No setting can be both a user and workstation setting.  They are mutually
1531   exclusive.
1532 * Any setting can be an org unit setting in addition to being a user or
1533   workstation setting.
1534
1535 Read-Only Settings
1536 ++++++++++++++++++
1537
1538 Read-only settings are useful for defining values that staff can use but
1539 not modify.  For example, admins may wish to prevent users from locally
1540 modifying the grid configuration for a given interface so it remains
1541 consistent for all users.
1542
1543 A setting is read-only when an org unit setting type exists (regardless of 
1544 whether a value is applied) and no user or workstation setting type exists.
1545
1546 Server-Stored Workstation Settings Workstation Admin View
1547 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1548
1549 There's a new "Server Workstation Prefs" tab to the stored preferences
1550 workstation admin interface.  From here, users can view which
1551 preferences are stored as server-stored workstation preferences and
1552 delete select values.
1553
1554 Upgrade Notes
1555 +++++++++++++
1556
1557 A new permission APPLY_WORKSTATION_SETTING has been added to control who
1558 may apply values to workstation settings.  Use something like the following
1559 to apply the permission to all staff accounts (mileage may vary):
1560
1561 [source,sh]
1562 --------------------------------------------------------------------------
1563 INSERT INTO permission.grp_perm_map (grp, perm, depth) 
1564 VALUES (
1565     (SELECT id FROM permission.grp_tree WHERE name = 'Staff'), -- name may vary
1566     (SELECT id FROM permission.perm_list WHERE code = 'APPLY_WORKSTATION_SETTING'),
1567     0 -- or 1, 2, etc.
1568 );
1569 --------------------------------------------------------------------------
1570
1571 Workstation setting types matching values previously stored in the browser
1572 (via localStorage or Hatch) are created as part of this feature.  During
1573 upgrade, admins should consider whether any of these new setting types 
1574 should be transferred to user and/or org unit settings instead.  Setting
1575 type changes can be made at any time, but when a setting type is deleted
1576 all of its data is deleted, so a change in type means re-applying the 
1577 settings in the browser client.
1578
1579 Values stored in the browser will automatically migrate to server settings
1580 as each setting is accessed in the browser client.  Once migrated, the
1581 in-browser copies are deleted.  
1582
1583 If a setting type does not exist where the browser expects one, the 
1584 value is stored in-browser instead and a warning is issued in the console.
1585
1586
1587 More consistent terminology in the client
1588 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1589 Terminology has been updated in the staff client so that we consistently use
1590 the same name to describe the same thing. The following updates have been made:
1591
1592   * The term 'item' is now consistently used to describe the barcoded entity
1593 that had been previously been called both an 'item' and a 'copy'. As a result,
1594 we now use the terms 'item buckets', 'item tags', and 'item alerts'.
1595   * The term 'volume' is no longer used in the client, with the exception of
1596 serials, where the term is used to describe serial volumes. The term 'call
1597 number' will replace volume in most other places.
1598   * 'Holdings' is a more general term used to describe a combination of items
1599 and call numbers.
1600   * The term 'Shelving Location' is used consistently in favor of 'Copy
1601 Location.'
1602
1603
1604
1605
1606 OPAC
1607 ~~~~
1608
1609
1610
1611 Batch Actions In the Public Catalog
1612 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1613 The public catalog now displays checkboxes on the bibliographic and
1614 metarecord constituents results pages. Selecting one or more titles
1615 by using the checkboxes will dynamically add those title to the
1616 temporary list, which is now renamed the cart.
1617
1618 Above the results lists there is now a bar with a select-all checkbox,
1619 a link to the cart management page that also indicates the number of
1620 of titles in the cart, and a link to remove from the cart titles that
1621 are selected on the currently displayed results page.
1622
1623 The search bar now includes an icon of a cart and displays the number
1624 of titles currently in the cart. Next to that icon is a menu of cart
1625 actions.
1626
1627 The cart actions available are Place Hold, Print Title Details,
1628 Email Title Details, Add Cart to Saved List, and Clear Cart. In the
1629 web staff client, the cart actions also include Add Cart to Bucket.
1630 When an action is selected from this menu, the user is given an
1631 opportunity to confirm the action and to optionally empty the cart
1632 when the action is complete. The action is applied to all titles
1633 in the cart.
1634
1635 Clicking on the cart icon brings the user to a page listing the
1636 titles in the cart. From there, the user can select specific records
1637 to request, print, email, add to a list, or remove from the cart.
1638
1639 The list of actions on the record details page now provides separate
1640 links for adding the title to a cart or to a permanent list.
1641
1642 The permanent list management page in the public catalog now also
1643 includes batch print and email actions.
1644
1645 Additional information
1646 ++++++++++++++++++++++
1647 * The checkboxes do not display on the metarecord results page, as
1648   metarecords currently cannot be put into carts or lists.
1649 * The checkboxes are displayed only if JavaScript is enabled. However,
1650   users can still add items to the cart and perform batch actions on
1651   the cart and on lists.
1652 * A template `config.tt2` setting, `ctx.max_cart_size`, can be used to
1653   set a soft limit on the number of titles that can be added to the
1654   cart. If this limit is reached, checkboxes to add more records to the
1655   cart are disabled unless existing titles in the cart are removed
1656   first. The default value for this setting is 500.
1657
1658 Developer notes
1659 +++++++++++++++
1660
1661 This patch adds to the public catalog two routes that return JSON
1662 rather than HTML:
1663
1664 * `GET /eg/opac/api/mylist/add?record=45`
1665 * `GET /eg/opac/api/mylist/delete?record=45`
1666
1667 The JSON response is a hash containing a mylist key pointing to the list
1668 of bib IDs of contents of the cart.
1669
1670 The record parameter can be repeated to allow adding or removing
1671 records as an atomic operation. Note that this change also now available
1672 to `/eg/opac/mylist/{add,delete}`
1673
1674 More generally, this adds a way for EGWeb context loaders to specify that
1675 a response should be emitted as JSON rather than rendering an HTML
1676 page using `Template::Toolkit`.
1677
1678 Specifically, if the context as munged by the context loader contains
1679 a `json_response` key, the contents of that key will to provide a
1680 JSON response. The `json_response_cookie` key, if present, can be used
1681 to set a cookie as part of the response.
1682
1683 Template Toolkit processing is bypassed entirely when emitting a JSON
1684 response, so the context loader would be entirely responsible for
1685 localization of strings in the response meant for direct human
1686 consumption.
1687
1688
1689
1690
1691 New class for searchbar when on the homepage
1692 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1693
1694 This adds the `.searchbar-home` class to the div that contains the searchbar
1695 when on the homepage.  This allows sites to customize the searchbar differently
1696 on the homepage than in other places the search bar appears (for example,
1697 offering a large, Google-style search bar on the homepage only).
1698
1699
1700 Username Login Hint
1701 ^^^^^^^^^^^^^^^^^^^
1702 To make customization easier, the username hint on the OPAC login page ("Please
1703 include leading zeros...") has been moved to a separate TT2 template.  If you
1704 have customized the hint text, you will need to add your modifications to
1705 username_hint.tt2.
1706
1707
1708
1709 Acknowledgments
1710 ---------------
1711 The Evergreen project would like to acknowledge the following
1712 organizations that commissioned developments in this release of
1713 Evergreen:
1714
1715 * BC Libraries Cooperative
1716 * Consortium Of Ohio Libraries
1717 * CW MARS
1718 * Georgia Public Library Service
1719 * Indiana State Library
1720 * Lake Agassiz Regrional Library
1721 * MassLNC
1722 * North Texas Library Consortium
1723 * Northwest Regional Library
1724 * Pennsylvania Integrated Library System
1725 * South Carolina State Library
1726
1727 We would also like to thank the following individuals who contributed
1728 code, translations, documentations patches and tests to this release of
1729 Evergreen:
1730
1731 * Felicia Beaudry
1732 * Jason Boyer
1733 * Andrea Buntz Neiman
1734 * Eva Cerninakova
1735 * Galen Charlton
1736 * Garry Collum
1737 * Jeff Davis
1738 * Bill Erickson
1739 * Jason Etheridge
1740 * Lynn Floyd
1741 * Jeff Godin
1742 * Blake Graham-Henderson
1743 * Francisco J Guel-Mendoza
1744 * Kyle Huckins
1745 * Mary Jinglewski
1746 * Angela Kilsdonk
1747 * Kathy Lussier
1748 * Katie G. Martin
1749 * Jennifer Pringle
1750 * Morkor Quarshie
1751 * Mike Rylander
1752 * Jane Sandberg
1753 * Chris Sharp
1754 * Ben Shum
1755 * Remington Steed
1756 * Jason Stephenson
1757 * Cesar Velez
1758 * Dan Wells
1759 * Stephan Woidowski
1760
1761 We also thank the following organizations whose employees contributed
1762 patches:
1763
1764 * BC Libraries Cooperative
1765 * Calvin College
1766 * Catalyte
1767 * Equinox Open Library Initiative
1768 * Government of Manitoba
1769 * Kenton County Public Library
1770 * King County Library System
1771 * Linn-Benton Community College
1772 * MassLNC
1773 * Sigio
1774
1775 We regret any omissions.  If a contributor has been inadvertently
1776 missed, please open a bug at http://bugs.launchpad.net/evergreen/
1777 with a correction.
1778