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