April 2025 - Evergreen-commits - Evergreen Mailing Lists Server

[GIT] Evergreen ILS branch rel_3_13 updated. 43bdf904a6af6d631014f9301628a5dd974f808d
by Git User 21 Apr '25

21 Apr '25

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Evergreen ILS". The branch, rel_3_13 has been updated via 43bdf904a6af6d631014f9301628a5dd974f808d (commit) from 7c994436d777e30c5e73a5476ca0e1fd739b87ac (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- commit 43bdf904a6af6d631014f9301628a5dd974f808d Author: Mike Rylander <mrylander(a)gmail.com> Date: Thu Apr 10 15:41:00 2025 -0400 LP#2092695: Add field info to report template table aliases When calculating the alias to use for a table in a report, we need to include the linking column names to disambiguate which "version" of the joined table we're passing through in a particular join path. This commit does that whenever there is column-level data available. To test: 1) Create a template starting from the Hold Transit source that displays the Shortname of the Sending Library AND the Destination Library. See that the template cause an error when run. 2) Apply this patch, and then clone the template from (1). See that the report runs correctly. NOTE: To fix templates without having to clone them and then clean up the old ones, you can choose the Clone action on the template, change the URL path component from "clone" to "edit" once it loads, and then save the template. The join aliases are calculated when the template is saved, so this will repair the template in place. Release-note: Fix report table alias calculation for joins Signed-off-by: Mike Rylander <mrylander(a)gmail.com> Signed-off-by: Galen Charlton <gmc(a)equinoxOLI.org> diff --git a/Open-ILS/src/eg2/src/app/staff/reporter/share/reporter.service.ts b/Open-ILS/src/eg2/src/app/staff/reporter/share/reporter.service.ts index f34775b063..5e14aa73f9 100644 --- a/Open-ILS/src/eg2/src/app/staff/reporter/share/reporter.service.ts +++ b/Open-ILS/src/eg2/src/app/staff/reporter/share/reporter.service.ts @@ -1501,6 +1501,9 @@ export class ReporterService { pathHash += ' -> '; if (n.stateFlag) {pathHash += ' [Required]';} } + if (n.callerData.fmField?.name) { + pathHash += n.callerData.fmField.name + '.'; + } pathHash += n.callerData.fmClass; }); return Md5.hashStr(pathHash); ----------------------------------------------------------------------- Summary of changes: Open-ILS/src/eg2/src/app/staff/reporter/share/reporter.service.ts | 3 +++ 1 file changed, 3 insertions(+) hooks/post-receive -- Evergreen ILS

1 0

[GIT] Evergreen ILS branch main updated. d6f4414afb5237cddc3f659b2ae633c1f688851b
by Git User 21 Apr '25

21 Apr '25

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Evergreen ILS". The branch, main has been updated via d6f4414afb5237cddc3f659b2ae633c1f688851b (commit) from 2822019f45d5ce6c0b7e1340503d2aaba1b39e27 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- commit d6f4414afb5237cddc3f659b2ae633c1f688851b Author: Mike Rylander <mrylander(a)gmail.com> Date: Thu Apr 10 15:41:00 2025 -0400 LP#2092695: Add field info to report template table aliases When calculating the alias to use for a table in a report, we need to include the linking column names to disambiguate which "version" of the joined table we're passing through in a particular join path. This commit does that whenever there is column-level data available. To test: 1) Create a template starting from the Hold Transit source that displays the Shortname of the Sending Library AND the Destination Library. See that the template cause an error when run. 2) Apply this patch, and then clone the template from (1). See that the report runs correctly. NOTE: To fix templates without having to clone them and then clean up the old ones, you can choose the Clone action on the template, change the URL path component from "clone" to "edit" once it loads, and then save the template. The join aliases are calculated when the template is saved, so this will repair the template in place. Release-note: Fix report table alias calculation for joins Signed-off-by: Mike Rylander <mrylander(a)gmail.com> Signed-off-by: Galen Charlton <gmc(a)equinoxOLI.org> diff --git a/Open-ILS/src/eg2/src/app/staff/reporter/share/reporter.service.ts b/Open-ILS/src/eg2/src/app/staff/reporter/share/reporter.service.ts index c19ec2078a..c7cf9a37ac 100644 --- a/Open-ILS/src/eg2/src/app/staff/reporter/share/reporter.service.ts +++ b/Open-ILS/src/eg2/src/app/staff/reporter/share/reporter.service.ts @@ -1509,6 +1509,9 @@ export class ReporterService { pathHash += ' -> '; if (n.stateFlag) {pathHash += ' [Required]';} } + if (n.callerData.fmField?.name) { + pathHash += n.callerData.fmField.name + '.'; + } pathHash += n.callerData.fmClass; }); return Md5.hashStr(pathHash); ----------------------------------------------------------------------- Summary of changes: Open-ILS/src/eg2/src/app/staff/reporter/share/reporter.service.ts | 3 +++ 1 file changed, 3 insertions(+) hooks/post-receive -- Evergreen ILS

1 0

[GIT] Evergreen ILS branch rel_3_15 updated. 39e44b53bcdd0f842a2c13bd9e465f4dcad8a488
by Git User 21 Apr '25

21 Apr '25

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Evergreen ILS". The branch, rel_3_15 has been updated via 39e44b53bcdd0f842a2c13bd9e465f4dcad8a488 (commit) from 9d3d17cc97ffcdf5c463ab0b5a6121d1d017bcf8 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- commit 39e44b53bcdd0f842a2c13bd9e465f4dcad8a488 Author: Mike Rylander <mrylander(a)gmail.com> Date: Thu Apr 10 15:41:00 2025 -0400 LP#2092695: Add field info to report template table aliases When calculating the alias to use for a table in a report, we need to include the linking column names to disambiguate which "version" of the joined table we're passing through in a particular join path. This commit does that whenever there is column-level data available. To test: 1) Create a template starting from the Hold Transit source that displays the Shortname of the Sending Library AND the Destination Library. See that the template cause an error when run. 2) Apply this patch, and then clone the template from (1). See that the report runs correctly. NOTE: To fix templates without having to clone them and then clean up the old ones, you can choose the Clone action on the template, change the URL path component from "clone" to "edit" once it loads, and then save the template. The join aliases are calculated when the template is saved, so this will repair the template in place. Release-note: Fix report table alias calculation for joins Signed-off-by: Mike Rylander <mrylander(a)gmail.com> Signed-off-by: Galen Charlton <gmc(a)equinoxOLI.org> diff --git a/Open-ILS/src/eg2/src/app/staff/reporter/share/reporter.service.ts b/Open-ILS/src/eg2/src/app/staff/reporter/share/reporter.service.ts index c19ec2078a..c7cf9a37ac 100644 --- a/Open-ILS/src/eg2/src/app/staff/reporter/share/reporter.service.ts +++ b/Open-ILS/src/eg2/src/app/staff/reporter/share/reporter.service.ts @@ -1509,6 +1509,9 @@ export class ReporterService { pathHash += ' -> '; if (n.stateFlag) {pathHash += ' [Required]';} } + if (n.callerData.fmField?.name) { + pathHash += n.callerData.fmField.name + '.'; + } pathHash += n.callerData.fmClass; }); return Md5.hashStr(pathHash); ----------------------------------------------------------------------- Summary of changes: Open-ILS/src/eg2/src/app/staff/reporter/share/reporter.service.ts | 3 +++ 1 file changed, 3 insertions(+) hooks/post-receive -- Evergreen ILS

1 0

[GIT] Evergreen ILS branch rel_3_15 updated. 9d3d17cc97ffcdf5c463ab0b5a6121d1d017bcf8
by Git User 21 Apr '25

21 Apr '25

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Evergreen ILS". The branch, rel_3_15 has been updated via 9d3d17cc97ffcdf5c463ab0b5a6121d1d017bcf8 (commit) via ad4eb93681386c6c78b517f57b20c1057dfbff7f (commit) via 76a410448442ffcc5e1d695a9684adc7760dc82f (commit) from 52c59d65a57e25106e82d3fad0408b319e5bdf45 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- commit 9d3d17cc97ffcdf5c463ab0b5a6121d1d017bcf8 Author: Jane Sandberg <js7389(a)princeton.edu> Date: Mon Apr 21 12:11:15 2025 -0700 LP2107209: follow-up: add some docs Signed-off-by: Jane Sandberg <js7389(a)princeton.edu> diff --git a/docs/modules/admin_initial_setup/pages/designing_your_catalog.adoc b/docs/modules/admin_initial_setup/pages/designing_your_catalog.adoc index c3d78582bb..43796391b0 100644 --- a/docs/modules/admin_initial_setup/pages/designing_your_catalog.adoc +++ b/docs/modules/admin_initial_setup/pages/designing_your_catalog.adoc @@ -744,3 +744,10 @@ would create a large, Google-style search bar on the homepage only: } ---- +== Editing displayed subfields == + +You may wish to customize which subfields are displayed in certain areas, such as +the list view. You can configure this in your catalog's `config.tt2` file. Find +the `search.links_from_880` hash, and add a list of subfields you either wish to +include or exclude from the display for the given field. + commit ad4eb93681386c6c78b517f57b20c1057dfbff7f Author: Terran McCanna <tmccanna(a)georgialibraries.org> Date: Fri Apr 18 17:01:37 2025 -0400 LP2107209 OPAC fix for broken author links when extra MARC 100 subfields exist Newer cataloging standards make use of additional subfields that were not excluded in the code, and this ended up creating search query links that produced no results. To test: - Edit a MARC record to add a subfield $1 with a link in it to a 100 field. - Search for the title in the public OPAC. - On the search results page, note that the author displays the extraneous content. The generated link also includes the extraneous content. Clicking on it produces no search results. This problem can also be created with subfields $t, $c, $f, $g, and perhaps others. The error can also be demonstrated on the My Account pages under Lists and Holds. Apply the patch, then test again. The patch also includes functionality to control the included or excluded subfields on a per-field basis for fields 100, 110, 111, 245, 260, 264, 250, and 505 - although, not all of these fields are actually being used to created search query links within the OPAC at this time. Release-note: Fixes broken author links when additional subfields exist in the MARC record. Signed-off-by: Terran McCanna <tmccanna(a)georgialibraries.org> Signed-off-by: Jane Sandberg <js7389(a)princeton.edu> diff --git a/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 b/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 index 73206bd0e5..1d054108dd 100755 --- a/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 +++ b/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 @@ -159,10 +159,12 @@ search.adv_config = [ # Set up custom include/exclude subfield lists for various different 880-linked # datafields. # +# Example exclusion: '245' => { exclude => 'fghks678' } search.links_from_880 = { - 100 => { include => 'ac' }, - 245 => { exclude => 'fghk016789' } + '100' => { include => 'ad' }, + '110' => { include => 'ad' }, + '111' => { include => 'acd' } }; ############################################################################## diff --git a/Open-ILS/src/templates-bootstrap/opac/parts/config.tt2 b/Open-ILS/src/templates-bootstrap/opac/parts/config.tt2 index ab3278a7d9..a2f6a48461 100755 --- a/Open-ILS/src/templates-bootstrap/opac/parts/config.tt2 +++ b/Open-ILS/src/templates-bootstrap/opac/parts/config.tt2 @@ -148,6 +148,18 @@ search.adv_config = [ # Set the default height of the select boxes. Defaults to 4. #search.default_adv_select_height = 4; +############################################################################## +# Set up custom include/exclude subfield lists for various different 880-linked +# datafields. +# +# Example exclusion: '245' => { exclude => 'fghks678' } + +search.links_from_880 = { + '100' => { include => 'ad' }, + '110' => { include => 'ad' }, + '111' => { include => 'acd' } +}; + ############################################################################## # For each search box the default "query type" value can be specified here # This is the actual backend value, not the label diff --git a/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 b/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 index 81ddb96283..f1a785b67d 100755 --- a/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 +++ b/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 @@ -4,15 +4,16 @@ # See "Model A" in http://www.loc.gov/marc/bibliographic/ecbdmulti.html # and $6 description in http://www.loc.gov/marc/bibliographic/ecbdcntf.html MACRO get_graphic_880s BLOCK; + # Define subfields to include or exclude in config.tt2 - search.links_from_880 include_sf = search.links_from_880.$target_field.include; exclude_sf = search.links_from_880.$target_field.exclude || 'ew01456789'; test_sf = ''; IF include_sf.length == 0; # we must use an exclusion list, even if it's the default one - test_sf = 'not(contains(' _ exclude_sf _ ', @code))'; - ELSE - test_sf = 'contains(' _ include_sf _ ', @code)'; + test_sf = 'not(contains("' _ exclude_sf _ '", @code))'; + ELSE; + test_sf = 'contains("' _ include_sf _ '", @code)'; END; FOR node IN xml.findnodes('//*[@tag="' _ target_field _ '"]'); commit 76a410448442ffcc5e1d695a9684adc7760dc82f Author: Mike Rylander <mrylander(a)gmail.com> Date: Thu Apr 17 14:35:37 2025 -0400 Example configurable include/exclude list for 880-linked field search link building Signed-off-by: Mike Rylander <mrylander(a)gmail.com> Signed-off-by: Terran McCanna <tmccanna(a)georgialibraries.org> Signed-off-by: Jane Sandberg <js7389(a)princeton.edu> diff --git a/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 b/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 index 3acc9f22c1..73206bd0e5 100755 --- a/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 +++ b/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 @@ -155,6 +155,16 @@ search.adv_config = [ # Set the default height of the select boxes. Defaults to 4. #search.default_adv_select_height = 4; +############################################################################## +# Set up custom include/exclude subfield lists for various different 880-linked +# datafields. +# + +search.links_from_880 = { + 100 => { include => 'ac' }, + 245 => { exclude => 'fghk016789' } +}; + ############################################################################## # For each search box the default "query type" value can be specified here # This is the actual backend value, not the label diff --git a/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 b/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 index 890b9b67cb..81ddb96283 100755 --- a/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 +++ b/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 @@ -4,10 +4,21 @@ # See "Model A" in http://www.loc.gov/marc/bibliographic/ecbdmulti.html # and $6 description in http://www.loc.gov/marc/bibliographic/ecbdcntf.html MACRO get_graphic_880s BLOCK; + include_sf = search.links_from_880.$target_field.include; + exclude_sf = search.links_from_880.$target_field.exclude || 'ew01456789'; + test_sf = ''; + + IF include_sf.length == 0; + # we must use an exclusion list, even if it's the default one + test_sf = 'not(contains(' _ exclude_sf _ ', @code))'; + ELSE + test_sf = 'contains(' _ include_sf _ ', @code)'; + END; + FOR node IN xml.findnodes('//*[@tag="' _ target_field _ '"]'); raw_vals = []; core_val = ''; - FOR subnode IN node.findnodes('./*[not(contains("e w 0 4 5 6 7 8 9", @code))]'); + FOR subnode IN node.findnodes('./*[' _ test_sf _ ']'); raw_vals.push(subnode.textContent()); END; core_val = raw_vals.join(" "); ----------------------------------------------------------------------- Summary of changes: .../src/templates-bootstrap/opac/parts/config-fresh.tt2 | 12 ++++++++++++ Open-ILS/src/templates-bootstrap/opac/parts/config.tt2 | 12 ++++++++++++ Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 | 14 +++++++++++++- .../admin_initial_setup/pages/designing_your_catalog.adoc | 7 +++++++ 4 files changed, 44 insertions(+), 1 deletion(-) hooks/post-receive -- Evergreen ILS

1 0

[GIT] Evergreen ILS branch main updated. 2822019f45d5ce6c0b7e1340503d2aaba1b39e27
by Git User 21 Apr '25

21 Apr '25

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Evergreen ILS". The branch, main has been updated via 2822019f45d5ce6c0b7e1340503d2aaba1b39e27 (commit) via 9c5c63f75c0671f5b68c2d35aede0e7d3937bece (commit) via c55bc22f3b3ee066f5f0822bd3e9e880f09cf655 (commit) from 998e6c492adf1c754392f7249dde1236bd5522e0 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- commit 2822019f45d5ce6c0b7e1340503d2aaba1b39e27 Author: Jane Sandberg <js7389(a)princeton.edu> Date: Mon Apr 21 12:11:15 2025 -0700 LP2107209: follow-up: add some docs Signed-off-by: Jane Sandberg <js7389(a)princeton.edu> diff --git a/docs/modules/admin_initial_setup/pages/designing_your_catalog.adoc b/docs/modules/admin_initial_setup/pages/designing_your_catalog.adoc index e52f1f5808..264469f716 100644 --- a/docs/modules/admin_initial_setup/pages/designing_your_catalog.adoc +++ b/docs/modules/admin_initial_setup/pages/designing_your_catalog.adoc @@ -749,3 +749,10 @@ would create a large, Google-style search bar on the homepage only: } ---- +== Editing displayed subfields == + +You may wish to customize which subfields are displayed in certain areas, such as +the list view. You can configure this in your catalog's `config.tt2` file. Find +the `search.links_from_880` hash, and add a list of subfields you either wish to +include or exclude from the display for the given field. + commit 9c5c63f75c0671f5b68c2d35aede0e7d3937bece Author: Terran McCanna <tmccanna(a)georgialibraries.org> Date: Fri Apr 18 17:01:37 2025 -0400 LP2107209 OPAC fix for broken author links when extra MARC 100 subfields exist Newer cataloging standards make use of additional subfields that were not excluded in the code, and this ended up creating search query links that produced no results. To test: - Edit a MARC record to add a subfield $1 with a link in it to a 100 field. - Search for the title in the public OPAC. - On the search results page, note that the author displays the extraneous content. The generated link also includes the extraneous content. Clicking on it produces no search results. This problem can also be created with subfields $t, $c, $f, $g, and perhaps others. The error can also be demonstrated on the My Account pages under Lists and Holds. Apply the patch, then test again. The patch also includes functionality to control the included or excluded subfields on a per-field basis for fields 100, 110, 111, 245, 260, 264, 250, and 505 - although, not all of these fields are actually being used to created search query links within the OPAC at this time. Release-note: Fixes broken author links when additional subfields exist in the MARC record. Signed-off-by: Terran McCanna <tmccanna(a)georgialibraries.org> Signed-off-by: Jane Sandberg <js7389(a)princeton.edu> diff --git a/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 b/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 index 73206bd0e5..1d054108dd 100755 --- a/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 +++ b/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 @@ -159,10 +159,12 @@ search.adv_config = [ # Set up custom include/exclude subfield lists for various different 880-linked # datafields. # +# Example exclusion: '245' => { exclude => 'fghks678' } search.links_from_880 = { - 100 => { include => 'ac' }, - 245 => { exclude => 'fghk016789' } + '100' => { include => 'ad' }, + '110' => { include => 'ad' }, + '111' => { include => 'acd' } }; ############################################################################## diff --git a/Open-ILS/src/templates-bootstrap/opac/parts/config.tt2 b/Open-ILS/src/templates-bootstrap/opac/parts/config.tt2 index ab3278a7d9..a2f6a48461 100755 --- a/Open-ILS/src/templates-bootstrap/opac/parts/config.tt2 +++ b/Open-ILS/src/templates-bootstrap/opac/parts/config.tt2 @@ -148,6 +148,18 @@ search.adv_config = [ # Set the default height of the select boxes. Defaults to 4. #search.default_adv_select_height = 4; +############################################################################## +# Set up custom include/exclude subfield lists for various different 880-linked +# datafields. +# +# Example exclusion: '245' => { exclude => 'fghks678' } + +search.links_from_880 = { + '100' => { include => 'ad' }, + '110' => { include => 'ad' }, + '111' => { include => 'acd' } +}; + ############################################################################## # For each search box the default "query type" value can be specified here # This is the actual backend value, not the label diff --git a/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 b/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 index 81ddb96283..f1a785b67d 100755 --- a/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 +++ b/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 @@ -4,15 +4,16 @@ # See "Model A" in http://www.loc.gov/marc/bibliographic/ecbdmulti.html # and $6 description in http://www.loc.gov/marc/bibliographic/ecbdcntf.html MACRO get_graphic_880s BLOCK; + # Define subfields to include or exclude in config.tt2 - search.links_from_880 include_sf = search.links_from_880.$target_field.include; exclude_sf = search.links_from_880.$target_field.exclude || 'ew01456789'; test_sf = ''; IF include_sf.length == 0; # we must use an exclusion list, even if it's the default one - test_sf = 'not(contains(' _ exclude_sf _ ', @code))'; - ELSE - test_sf = 'contains(' _ include_sf _ ', @code)'; + test_sf = 'not(contains("' _ exclude_sf _ '", @code))'; + ELSE; + test_sf = 'contains("' _ include_sf _ '", @code)'; END; FOR node IN xml.findnodes('//*[@tag="' _ target_field _ '"]'); commit c55bc22f3b3ee066f5f0822bd3e9e880f09cf655 Author: Mike Rylander <mrylander(a)gmail.com> Date: Thu Apr 17 14:35:37 2025 -0400 Example configurable include/exclude list for 880-linked field search link building Signed-off-by: Mike Rylander <mrylander(a)gmail.com> Signed-off-by: Terran McCanna <tmccanna(a)georgialibraries.org> Signed-off-by: Jane Sandberg <js7389(a)princeton.edu> diff --git a/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 b/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 index 3acc9f22c1..73206bd0e5 100755 --- a/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 +++ b/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 @@ -155,6 +155,16 @@ search.adv_config = [ # Set the default height of the select boxes. Defaults to 4. #search.default_adv_select_height = 4; +############################################################################## +# Set up custom include/exclude subfield lists for various different 880-linked +# datafields. +# + +search.links_from_880 = { + 100 => { include => 'ac' }, + 245 => { exclude => 'fghk016789' } +}; + ############################################################################## # For each search box the default "query type" value can be specified here # This is the actual backend value, not the label diff --git a/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 b/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 index 890b9b67cb..81ddb96283 100755 --- a/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 +++ b/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 @@ -4,10 +4,21 @@ # See "Model A" in http://www.loc.gov/marc/bibliographic/ecbdmulti.html # and $6 description in http://www.loc.gov/marc/bibliographic/ecbdcntf.html MACRO get_graphic_880s BLOCK; + include_sf = search.links_from_880.$target_field.include; + exclude_sf = search.links_from_880.$target_field.exclude || 'ew01456789'; + test_sf = ''; + + IF include_sf.length == 0; + # we must use an exclusion list, even if it's the default one + test_sf = 'not(contains(' _ exclude_sf _ ', @code))'; + ELSE + test_sf = 'contains(' _ include_sf _ ', @code)'; + END; + FOR node IN xml.findnodes('//*[@tag="' _ target_field _ '"]'); raw_vals = []; core_val = ''; - FOR subnode IN node.findnodes('./*[not(contains("e w 0 4 5 6 7 8 9", @code))]'); + FOR subnode IN node.findnodes('./*[' _ test_sf _ ']'); raw_vals.push(subnode.textContent()); END; core_val = raw_vals.join(" "); ----------------------------------------------------------------------- Summary of changes: .../src/templates-bootstrap/opac/parts/config-fresh.tt2 | 12 ++++++++++++ Open-ILS/src/templates-bootstrap/opac/parts/config.tt2 | 12 ++++++++++++ Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 | 14 +++++++++++++- .../admin_initial_setup/pages/designing_your_catalog.adoc | 7 +++++++ 4 files changed, 44 insertions(+), 1 deletion(-) hooks/post-receive -- Evergreen ILS

1 0

[GIT] Evergreen ILS branch rel_3_14 updated. 8c90a487ecf0b75b5fd99792d32273d4b4182b0f
by Git User 21 Apr '25

21 Apr '25

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Evergreen ILS". The branch, rel_3_14 has been updated via 8c90a487ecf0b75b5fd99792d32273d4b4182b0f (commit) via 957819e13e96c9f38d323184e43b6c2e718e63b2 (commit) via eb9d673382e1c7b319cf892d84fbf68b76cec44d (commit) from 13ca38f1c81f84ed2953b2bb77d740fc4b9d5223 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- commit 8c90a487ecf0b75b5fd99792d32273d4b4182b0f Author: Jane Sandberg <js7389(a)princeton.edu> Date: Mon Apr 21 12:11:15 2025 -0700 LP2107209: follow-up: add some docs Signed-off-by: Jane Sandberg <js7389(a)princeton.edu> diff --git a/docs/modules/admin_initial_setup/pages/designing_your_catalog.adoc b/docs/modules/admin_initial_setup/pages/designing_your_catalog.adoc index e52f1f5808..264469f716 100644 --- a/docs/modules/admin_initial_setup/pages/designing_your_catalog.adoc +++ b/docs/modules/admin_initial_setup/pages/designing_your_catalog.adoc @@ -749,3 +749,10 @@ would create a large, Google-style search bar on the homepage only: } ---- +== Editing displayed subfields == + +You may wish to customize which subfields are displayed in certain areas, such as +the list view. You can configure this in your catalog's `config.tt2` file. Find +the `search.links_from_880` hash, and add a list of subfields you either wish to +include or exclude from the display for the given field. + commit 957819e13e96c9f38d323184e43b6c2e718e63b2 Author: Terran McCanna <tmccanna(a)georgialibraries.org> Date: Fri Apr 18 17:01:37 2025 -0400 LP2107209 OPAC fix for broken author links when extra MARC 100 subfields exist Newer cataloging standards make use of additional subfields that were not excluded in the code, and this ended up creating search query links that produced no results. To test: - Edit a MARC record to add a subfield $1 with a link in it to a 100 field. - Search for the title in the public OPAC. - On the search results page, note that the author displays the extraneous content. The generated link also includes the extraneous content. Clicking on it produces no search results. This problem can also be created with subfields $t, $c, $f, $g, and perhaps others. The error can also be demonstrated on the My Account pages under Lists and Holds. Apply the patch, then test again. The patch also includes functionality to control the included or excluded subfields on a per-field basis for fields 100, 110, 111, 245, 260, 264, 250, and 505 - although, not all of these fields are actually being used to created search query links within the OPAC at this time. Release-note: Fixes broken author links when additional subfields exist in the MARC record. Signed-off-by: Terran McCanna <tmccanna(a)georgialibraries.org> Signed-off-by: Jane Sandberg <js7389(a)princeton.edu> diff --git a/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 b/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 index 73206bd0e5..1d054108dd 100755 --- a/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 +++ b/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 @@ -159,10 +159,12 @@ search.adv_config = [ # Set up custom include/exclude subfield lists for various different 880-linked # datafields. # +# Example exclusion: '245' => { exclude => 'fghks678' } search.links_from_880 = { - 100 => { include => 'ac' }, - 245 => { exclude => 'fghk016789' } + '100' => { include => 'ad' }, + '110' => { include => 'ad' }, + '111' => { include => 'acd' } }; ############################################################################## diff --git a/Open-ILS/src/templates-bootstrap/opac/parts/config.tt2 b/Open-ILS/src/templates-bootstrap/opac/parts/config.tt2 index b7b4403b97..a33ecbf4be 100755 --- a/Open-ILS/src/templates-bootstrap/opac/parts/config.tt2 +++ b/Open-ILS/src/templates-bootstrap/opac/parts/config.tt2 @@ -157,6 +157,18 @@ search.adv_config = [ # Set the default height of the select boxes. Defaults to 4. #search.default_adv_select_height = 4; +############################################################################## +# Set up custom include/exclude subfield lists for various different 880-linked +# datafields. +# +# Example exclusion: '245' => { exclude => 'fghks678' } + +search.links_from_880 = { + '100' => { include => 'ad' }, + '110' => { include => 'ad' }, + '111' => { include => 'acd' } +}; + ############################################################################## # For each search box the default "query type" value can be specified here # This is the actual backend value, not the label diff --git a/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 b/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 index aaf3a6638b..4a6db666cb 100755 --- a/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 +++ b/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 @@ -4,15 +4,16 @@ # See "Model A" in http://www.loc.gov/marc/bibliographic/ecbdmulti.html # and $6 description in http://www.loc.gov/marc/bibliographic/ecbdcntf.html MACRO get_graphic_880s BLOCK; + # Define subfields to include or exclude in config.tt2 - search.links_from_880 include_sf = search.links_from_880.$target_field.include; exclude_sf = search.links_from_880.$target_field.exclude || 'ew01456789'; test_sf = ''; IF include_sf.length == 0; # we must use an exclusion list, even if it's the default one - test_sf = 'not(contains(' _ exclude_sf _ ', @code))'; - ELSE - test_sf = 'contains(' _ include_sf _ ', @code)'; + test_sf = 'not(contains("' _ exclude_sf _ '", @code))'; + ELSE; + test_sf = 'contains("' _ include_sf _ '", @code)'; END; FOR node IN xml.findnodes('//*[@tag="' _ target_field _ '"]'); commit eb9d673382e1c7b319cf892d84fbf68b76cec44d Author: Mike Rylander <mrylander(a)gmail.com> Date: Thu Apr 17 14:35:37 2025 -0400 Example configurable include/exclude list for 880-linked field search link building Signed-off-by: Mike Rylander <mrylander(a)gmail.com> Signed-off-by: Terran McCanna <tmccanna(a)georgialibraries.org> Signed-off-by: Jane Sandberg <js7389(a)princeton.edu> diff --git a/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 b/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 index 3acc9f22c1..73206bd0e5 100755 --- a/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 +++ b/Open-ILS/src/templates-bootstrap/opac/parts/config-fresh.tt2 @@ -155,6 +155,16 @@ search.adv_config = [ # Set the default height of the select boxes. Defaults to 4. #search.default_adv_select_height = 4; +############################################################################## +# Set up custom include/exclude subfield lists for various different 880-linked +# datafields. +# + +search.links_from_880 = { + 100 => { include => 'ac' }, + 245 => { exclude => 'fghk016789' } +}; + ############################################################################## # For each search box the default "query type" value can be specified here # This is the actual backend value, not the label diff --git a/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 b/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 index e44b078723..aaf3a6638b 100755 --- a/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 +++ b/Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 @@ -4,10 +4,21 @@ # See "Model A" in http://www.loc.gov/marc/bibliographic/ecbdmulti.html # and $6 description in http://www.loc.gov/marc/bibliographic/ecbdcntf.html MACRO get_graphic_880s BLOCK; + include_sf = search.links_from_880.$target_field.include; + exclude_sf = search.links_from_880.$target_field.exclude || 'ew01456789'; + test_sf = ''; + + IF include_sf.length == 0; + # we must use an exclusion list, even if it's the default one + test_sf = 'not(contains(' _ exclude_sf _ ', @code))'; + ELSE + test_sf = 'contains(' _ include_sf _ ', @code)'; + END; + FOR node IN xml.findnodes('//*[@tag="' _ target_field _ '"]'); raw_vals = []; core_val = ''; - FOR subnode IN node.findnodes('./*[not(contains("e w 0 4 5 6 7 8 9", @code))]'); + FOR subnode IN node.findnodes('./*[' _ test_sf _ ']'); raw_vals.push(subnode.textContent()); END; core_val = raw_vals.join(" "); ----------------------------------------------------------------------- Summary of changes: .../src/templates-bootstrap/opac/parts/config-fresh.tt2 | 12 ++++++++++++ Open-ILS/src/templates-bootstrap/opac/parts/config.tt2 | 12 ++++++++++++ Open-ILS/src/templates-bootstrap/opac/parts/misc_util.tt2 | 14 +++++++++++++- .../admin_initial_setup/pages/designing_your_catalog.adoc | 7 +++++++ 4 files changed, 44 insertions(+), 1 deletion(-) hooks/post-receive -- Evergreen ILS

1 0

[GIT] Evergreen ILS branch main updated. 998e6c492adf1c754392f7249dde1236bd5522e0
by Git User 18 Apr '25

18 Apr '25

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Evergreen ILS". The branch, main has been updated via 998e6c492adf1c754392f7249dde1236bd5522e0 (commit) from e28cdfd3574b64dd9de0f76bd655a550028824d4 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- commit 998e6c492adf1c754392f7249dde1236bd5522e0 Author: spmorrison <101879901+spmorrison(a)users.noreply.github.com> Date: Fri Apr 18 08:56:22 2025 -0400 Docs: file folder cleanup Release-note: Delete docs/modules/local_admin/assets/images/emergency_closing_handler directory Signed-off-by: Susan Morrison <smorrison(a)georgialibraries.org> Signed-off-by: Andrea Buntz Neiman <abneiman(a)equinoxinitiative.org> diff --git a/docs/modules/local_admin/assets/images/emergency_closing_handler/delete closing.png b/docs/modules/local_admin/assets/images/emergency_closing_handler/delete closing.png deleted file mode 100644 index c75983665d..0000000000 Binary files a/docs/modules/local_admin/assets/images/emergency_closing_handler/delete closing.png and /dev/null differ diff --git a/docs/modules/local_admin/assets/images/emergency_closing_handler/example closing.png b/docs/modules/local_admin/assets/images/emergency_closing_handler/example closing.png deleted file mode 100644 index c6f1f9385a..0000000000 Binary files a/docs/modules/local_admin/assets/images/emergency_closing_handler/example closing.png and /dev/null differ diff --git a/docs/modules/local_admin/assets/images/emergency_closing_handler/possibly emergency closure_section.png b/docs/modules/local_admin/assets/images/emergency_closing_handler/possibly emergency closure_section.png deleted file mode 100644 index fb14e00961..0000000000 Binary files a/docs/modules/local_admin/assets/images/emergency_closing_handler/possibly emergency closure_section.png and /dev/null differ diff --git a/docs/modules/local_admin/assets/images/emergency_closing_handler/possibly emergency closure_toast.png b/docs/modules/local_admin/assets/images/emergency_closing_handler/possibly emergency closure_toast.png deleted file mode 100644 index 4d598da279..0000000000 Binary files a/docs/modules/local_admin/assets/images/emergency_closing_handler/possibly emergency closure_toast.png and /dev/null differ diff --git a/docs/modules/local_admin/assets/images/emergency_closing_handler/upcoming closure listing.png b/docs/modules/local_admin/assets/images/emergency_closing_handler/upcoming closure listing.png deleted file mode 100644 index cc7852ce85..0000000000 Binary files a/docs/modules/local_admin/assets/images/emergency_closing_handler/upcoming closure listing.png and /dev/null differ ----------------------------------------------------------------------- Summary of changes: .../emergency_closing_handler/delete closing.png | Bin 25476 -> 0 bytes .../emergency_closing_handler/example closing.png | Bin 102446 -> 0 bytes .../possibly emergency closure_section.png | Bin 99042 -> 0 bytes .../possibly emergency closure_toast.png | Bin 11760 -> 0 bytes .../upcoming closure listing.png | Bin 33499 -> 0 bytes 5 files changed, 0 insertions(+), 0 deletions(-) delete mode 100644 docs/modules/local_admin/assets/images/emergency_closing_handler/delete closing.png delete mode 100644 docs/modules/local_admin/assets/images/emergency_closing_handler/example closing.png delete mode 100644 docs/modules/local_admin/assets/images/emergency_closing_handler/possibly emergency closure_section.png delete mode 100644 docs/modules/local_admin/assets/images/emergency_closing_handler/possibly emergency closure_toast.png delete mode 100644 docs/modules/local_admin/assets/images/emergency_closing_handler/upcoming closure listing.png hooks/post-receive -- Evergreen ILS

1 0

[GIT] Evergreen ILS branch rel_3_15 updated. 52c59d65a57e25106e82d3fad0408b319e5bdf45
by Git User 18 Apr '25

18 Apr '25

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Evergreen ILS". The branch, rel_3_15 has been updated via 52c59d65a57e25106e82d3fad0408b319e5bdf45 (commit) from 4917c26baa1ddddd7f0473ea2cacebf48ab16691 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- commit 52c59d65a57e25106e82d3fad0408b319e5bdf45 Author: spmorrison <101879901+spmorrison(a)users.noreply.github.com> Date: Fri Apr 18 08:53:26 2025 -0400 Docs: LP2063846 screenshots Release-note: Fixes screenshot location for Emergency Closing Handler Signed-off-by: Susan Morrison <smorrison(a)georgialibraries.org> Signed-off-by: Andrea Buntz Neiman <abneiman(a)equinoxinitiative.org> diff --git a/docs/modules/admin/assets/images/emergency_closing/delete closing.png b/docs/modules/admin/assets/images/emergency_closing/delete closing.png new file mode 100644 index 0000000000..c75983665d Binary files /dev/null and b/docs/modules/admin/assets/images/emergency_closing/delete closing.png differ diff --git a/docs/modules/admin/assets/images/emergency_closing/example closing.png b/docs/modules/admin/assets/images/emergency_closing/example closing.png new file mode 100644 index 0000000000..c6f1f9385a Binary files /dev/null and b/docs/modules/admin/assets/images/emergency_closing/example closing.png differ diff --git a/docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_section.png b/docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_section.png new file mode 100644 index 0000000000..fb14e00961 Binary files /dev/null and b/docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_section.png differ diff --git a/docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_toast.png b/docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_toast.png new file mode 100644 index 0000000000..4d598da279 Binary files /dev/null and b/docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_toast.png differ diff --git a/docs/modules/admin/assets/images/emergency_closing/upcoming closure listing.png b/docs/modules/admin/assets/images/emergency_closing/upcoming closure listing.png new file mode 100644 index 0000000000..cc7852ce85 Binary files /dev/null and b/docs/modules/admin/assets/images/emergency_closing/upcoming closure listing.png differ ----------------------------------------------------------------------- Summary of changes: .../assets/images/emergency_closing/delete closing.png | Bin 0 -> 25476 bytes .../images/emergency_closing/example closing.png | Bin 0 -> 102446 bytes .../possibly emergency closure_section.png | Bin 0 -> 99042 bytes .../possibly emergency closure_toast.png | Bin 0 -> 11760 bytes .../emergency_closing/upcoming closure listing.png | Bin 0 -> 33499 bytes 5 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 docs/modules/admin/assets/images/emergency_closing/delete closing.png create mode 100644 docs/modules/admin/assets/images/emergency_closing/example closing.png create mode 100644 docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_section.png create mode 100644 docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_toast.png create mode 100644 docs/modules/admin/assets/images/emergency_closing/upcoming closure listing.png hooks/post-receive -- Evergreen ILS

1 0

[GIT] Evergreen ILS branch rel_3_15 updated. 4917c26baa1ddddd7f0473ea2cacebf48ab16691
by Git User 18 Apr '25

18 Apr '25

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Evergreen ILS". The branch, rel_3_15 has been updated via 4917c26baa1ddddd7f0473ea2cacebf48ab16691 (commit) from dc96ae62278a0db84e7c3eae52a28c2afc0d3700 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- commit 4917c26baa1ddddd7f0473ea2cacebf48ab16691 Author: spmorrison <101879901+spmorrison(a)users.noreply.github.com> Date: Tue Nov 12 15:02:54 2024 -0500 Resolves LP#2063846 Docs: Update emergency_closing_handler.adoc - Consolidated with https://docs.evergreen-ils.org/docs/latest/admin/closed_dates.html to create one page on closed dates - updated screenshots - added line about ability to see upcoming closures in library info page Signed-off-by: Gina Monti <gmonti(a)biblio.org> diff --git a/docs/modules/admin/pages/emergency_closing_handler.adoc b/docs/modules/admin/pages/emergency_closing_handler.adoc index 831e0cc680..0bf77ccc8e 100644 --- a/docs/modules/admin/pages/emergency_closing_handler.adoc +++ b/docs/modules/admin/pages/emergency_closing_handler.adoc @@ -1,101 +1,138 @@ -= Emergency Closing Handler = += Closed Dates Editor = :toc: -== Introduction == +indexterm:[Closed Dates] -The *Closed Dates Editor* now includes an Emergency Closing feature that allows libraries to shift due dates and expiry dates to the next open day. Overdue fines will be automatically voided for the day(s) the library is marked closed. Once an Emergency Closing is processed, it is permanent and cannot be rolled back. +The *Closed Dates Editor* can be accessed via *Administration -> Local Administration -> Closed Dates Editor*. -== Administration == +Within the Closed Dates Editor screen, scheduled closed dates are listed and can be scoped by a specific organizational unit and date. The date filter in the upper right-hand corner will show upcoming library closures on or after the selected date in the filter. -=== Permissions === +Entries in the Closed Dates Editor are in addition to the regular weekly closed days for each organizational unit. Both regular closed days and those entered in the Closed Dates Editor affect due dates and fines: -To create an Emergency Closing, the EMERGENCY_CLOSING permission needs to be granted to the user for all locations to be affected by an emergency closing. - -== Create an emergency closing == +* *Due dates.* Due dates that would fall on closed days are automatically pushed forward to the next open day. Likewise, if an item is checked out at 8pm, for example, and would normally be due on a day when the library closes before 8pm, Evergreen pushes the due date forward to the next open day. +* *Overdue fines.* Overdue fines may not be charged on days when the library is closed. This fine behavior depends on how the _Charge fines on overdue circulations when closed_ setting is configured in the Library Settings Editor. -The Emergency Closing feature is located within the *Closed Dates Editor* screen, which can be accessed via *Administration -> Local Administration -> Closed Dates Editor*. +Closed dates do not affect the processing delays for Action/Triggers. For example, if your library has a trigger event that marks items as lost after 30 days, that 30-day period will include both open and closed dates. -Within the closed dates editor screen, scheduled closed dates are listed and can be scoped by specific org unit and date. The date filter in the upper right-hand corner will show upcoming library closings on or after the selected date in the filter. +Any closed dates entered in the interface will also appear on the xref:opac:linked_libraries.adoc[organizational unit’s library information page] under *Upcoming Closures* -[NOTE] -======================== -*NOTE* Before creating an Emergency Closure, delete any previously entered closures that overlap the Emergency Closure you wish to enter. Overlapping closed dates can cause issues in processing the Emergency Closure. -======================== +image::emergency_closing/upcoming closure listing.png[Upcoming closures] -Select *Add closing* to begin the emergency closing process. +== Adding a closure == +. Select _Administration -> Local Administration_. +. Select _Closed Dates Editor_. +. Select _Add Closing_. ++ image::emergency_closing/ECHClosedDatesEditorAddClosing.png[Add Closing] ++ +. A pop-up will appear with fields to fill out. ++ +image::emergency_closing/example closing.png[Create Closing for One Full Day] ++ +* *Library* - Using the dropdown window, select the organizational unit which will be closing. +* *Apply to all of my libraries* - When selected, this checkbox will apply the closing date to the selected organizational unit and any associated child organizational units. ++ +[NOTE] +==== +By default, creating a closed date in a parent organizational unit does _not_ also +close the child unit. For example, adding a system-level closure will not also +close all of that system's branches, unless you check the *Apply to all of my libraries* box. +==== ++ + +* *Closing type* - Available options in the dropdown window are _One Full Day_, _Multiple Days_, and _Detailed_ (for partial day closures). The _Multiple Days_ and _Detailed_ options will display different date options (e.g., start and end dates) in the next field if selected. ++ +image::emergency_closing/ECHLibraryClosingMultipleDays.png[Create Closing for Multiple Days] ++ -A pop-up will appear with fields to fill out. ++ +image::emergency_closing/ECHLibraryClosingDetailed.png[Create Detailed Closing] ++ +* *Date* - Click the calendar gadget to select which day or days the library will be closed. ++ +[NOTE] +==== +The Closed Dates editor is now date-aware. If a selected closed date is either in the past, or nearer in time than the end of the longest configured circulation period, staff will see a notification that says _Possible Emergency Closing_ in both the dialog box and in the bottom right-hand corner. See the Emergency Closing Handler section for information on how to manage emergency closures. +==== ++ +* *Reason* - Optionally enter the reason for the closure. Note that this will appear on the library’s contact page. +. Click *OK*. -image::emergency_closing/ECHLibraryClosingConstruction.png[Create Closing for One Full Day] +== Editing a closure == -*Library* - Using the dropdown window, select the org unit which will be closing. +To edit a closure, go to *Actions -> Edit closing*. -*Apply to all of my libraries* - When selected, this checkbox will apply the emergency closing date to the selected org unit and any associated child org unit(s). +image::emergency_closing/ECHEditClosing.png[Edit Closing] -*Closing Type* - The following Closing Type options are available in a drop down window: -* One full day -* Multiple days -* Detailed closing +A pop-up display will appear with the same format as creating a Closed Dates event. Once you make the changes, click *OK*. The Closed Dates Editor display will update. -The _Multiple days_ and _Detailed closing_ options will display different date options (e.g. start and end dates) in the next field if selected. +image::emergency_closing/ECHEditClosingModal.png[Edit Closing Pop-Up] -[NOTE] -======================== -*NOTE* There is an existing bug that pushes the due dates to the first day after the Emergency Closure even if that day is normally closed. So, if you need to enter an Emergency Closure for a Friday, but you are normally closed on Saturday and Sunday, be sure to enter the Emergency Closure for Friday through Sunday. -======================== +== Emergency closing handler == -image::emergency_closing/ECHLibraryClosingMultipleDays.png[Create Closing for Multiple Days] +The *Closed Dates Editor* includes an Emergency Closing feature that allows libraries to shift due dates and expiry dates to the next open day. Overdue fines will be automatically voided for the day(s) the library is marked closed. Once an Emergency Closing is processed, it is permanent and cannot be rolled back. -image::emergency_closing/ECHLibraryClosingDetailed.png[Create Detailed Closing] +When a date is chosen that is nearer in time than the end of the longest configured circulation period or in the past, then a _Possible Emergency Closing_ message will appear as a pop-up in the bottom right-hand corner of the screen. -*Date* - Select which day or days the library will be closed. +image::emergency_closing/possibly emergency closure_toast.png[Possible Emergency Closure Toast] -[NOTE] -======================== -*NOTE* The Closed Dates editor is now date-aware. If a selected closed date is either in the past, or nearer in time than the end of the longest configured circulation period, staff will see a notification that says "Possible Emergency Closing" in both the dialog box and in the bottom right-hand corner. -======================== +A _Possible Emergency Closure_ section will also appear in the Library Closing form. -*Reason* - Label the reason for library closing accordingly, e.g. 3/15 Snow Day +image::emergency_closing/possibly emergency closure_section.png[Possible Emergency Closure Section] -=== Emergency Closing Handler === +=== Adding an emergency closure === -When a date is chosen that is nearer in time than the end of the longest configured circulation period or in the past, then a *Possible Emergency Closing* message will appear in the pop-up and in the bottom right-hand corner of the screen. Below the Possible Emergency Closing message, two checkboxes appear: *Emergency* and *Process Immediately*. Both checkboxes must be manually selected in +[NOTE] +==== +Before creating an Emergency Closure, delete any previously entered closures that overlap the Emergency Closure you wish to enter. Overlapping closed dates can cause issues in processing the closure. +==== + +To add an emergency closure, follow the process for entering a regular closed date until you reach the *Possible Emergency Closure* section. [NOTE] -========================= -*NOTE* The *Emergency* checkbox must still be manually selected in order to actually set the closing as an Emergency Closing. -========================= +==== +There is an existing bug that pushes the due dates to the first day after the Emergency Closure even if that day is normally closed. So, if you need to enter an Emergency Closure for a Friday, but you are normally closed on Saturday and Sunday, be sure to enter the Emergency Closure for Friday through Sunday. +==== + +Below the Possible Emergency Closing message, two checkboxes appear: *Emergency* and *Process Immediately*. Both checkboxes must be manually selected in order to set the closure as an Emergency Closing. -By selecting the *Emergency* checkbox, the system will void any overdue fines incurred for that emergency closed day or days and push back any of the following dates to the next open day as determined by the library’s settings: +By selecting the *Emergency* checkbox, the system will void any overdue fines incurred for that emergency closed day(s) and push back any of the following dates to the next open day as determined by the library’s settings: * item due dates * shelf expire times * booking start times -image::emergency_closing/ECHClosingSnowDay.png[Create Emergency Closing] - -When selecting the *Process immediately* checkbox, Evergreen will enact the Emergency Closing changes immediately once the Emergency Closed Date information is saved. If Process immediately is not selected at the time of creation, staff will need to delete the original Emergency Closing and create a new one to make sure the Process immediately option is checked. If you go back to edit an entry to select the Process immediately checkbox, the Emergency processing will not occur. +When selecting the *Process immediately* checkbox, Evergreen will enact the Emergency Closing changes immediately once the Emergency Closed Date information is saved. Upon clicking *OK*, a progress bar will appear on-screen. After completion, the Closed Dates Editor screen will update, and under the Emergency Closing Processing Summary column, the number of affected/processed Circulations, Holds, and Reservations will be listed. image::emergency_closing/ECHLibraryClosingDone.png[Emergency Closing Processing Complete] [NOTE] -========================= -*NOTE* Processing can take some time, especially if you are creating an Emergency Closure at the system level and applying it to all branches. It's best to let it run and check back later to make sure that all circulations and holds processed. A successful processing is indicated by the green bar in the Emergency Closing Processing Summary column (shown in the screenshot above). If the bar is blue after processing, this indicates the processing did not complete correctly. -========================= +==== +Processing can take some time, especially if you are creating an Emergency Closure at the system level and applying it to all branches. It's best to let it run and check back later to make sure that all circulations and holds processed. A successful processing is indicated by the green bar in the Emergency Closing Processing Summary column (shown in the screenshot above). If the bar is blue after processing, this indicates the processing did not complete correctly. +==== -=== Editing Emergency Closings === +=== Editing an emergency closure === -If *Process immediately* is not selected during an Emergency Closing event creation, editing the existing Emergency Closing entry does not allow for proper processing. Staff will need to delete the original entry and create a new entry, making sure to select both the *Emergency Closing* and *Process immediately* options. +If *Process immediately* is not selected during an Emergency Closing event creation, staff can edit the closure entry, select the _Process immediately_ checkbox, and click *OK* to process the closure; however, the grid display does not update to show that the circulations and holds have been processed. -This caveat applies to editing the dates of an Emergency Closure as well. If the Emergency Closure dates need to be changed or extended, editing the existing entry does not process the circulations and holds properly. Either the original entry should be deleted and a new one created that encompasses the full date range, or a second Emergency Closure should be created to for the extended date range. +If the emergency closure dates need to be changed or extended, editing the existing entry _does not_ process the circulations and holds properly. Either the original entry should be deleted and a new one created that encompasses the full date range, or a second emergency closure should be created for the extended date range. -To edit the Reason field of an existing Emergency Closing event, go to *Actions -> Edit closing*. +== Deleting a closure == -image::emergency_closing/ECHEditClosing.png[Edit Closing] +To delete a regular or emergency closure, select the closure in the grid and go to *Actions -> Delete closing*. -A pop-up display will appear with the same format as creating a Closed Dates event. Once you make the changes, click *OK*. The Closed Dates Editor display will update. +image::emergency_closing/delete closing.png[Delete Closing] -image::emergency_closing/ECHEditClosingModal.png[Edit Closing Pop-Up] +== Permissions == + +To manage entries in the Closed Dates Editor, staff need the following permissions: + +* actor.org_unit.closed_date.create +* actor.org_unit.closed_date.update +* actor.org_unit.closed_date.delete + +To manage emergency closures, staff need the following additional permission: + +* EMERGENCY_CLOSING ----------------------------------------------------------------------- Summary of changes: .../admin/pages/emergency_closing_handler.adoc | 147 +++++++++++++-------- 1 file changed, 92 insertions(+), 55 deletions(-) hooks/post-receive -- Evergreen ILS

1 0

[GIT] Evergreen ILS branch rel_3_14 updated. 13ca38f1c81f84ed2953b2bb77d740fc4b9d5223
by Git User 18 Apr '25

18 Apr '25

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Evergreen ILS". The branch, rel_3_14 has been updated via 13ca38f1c81f84ed2953b2bb77d740fc4b9d5223 (commit) from d9d7bbb28ef7a2a25e5bb4b5a77c7bbbb2705f35 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- commit 13ca38f1c81f84ed2953b2bb77d740fc4b9d5223 Author: spmorrison <101879901+spmorrison(a)users.noreply.github.com> Date: Fri Apr 18 08:53:26 2025 -0400 Docs: LP2063846 screenshots Release-note: Fixes screenshot location for Emergency Closing Handler Signed-off-by: Susan Morrison <smorrison(a)georgialibraries.org> Signed-off-by: Andrea Buntz Neiman <abneiman(a)equinoxinitiative.org> diff --git a/docs/modules/admin/assets/images/emergency_closing/delete closing.png b/docs/modules/admin/assets/images/emergency_closing/delete closing.png new file mode 100644 index 0000000000..c75983665d Binary files /dev/null and b/docs/modules/admin/assets/images/emergency_closing/delete closing.png differ diff --git a/docs/modules/admin/assets/images/emergency_closing/example closing.png b/docs/modules/admin/assets/images/emergency_closing/example closing.png new file mode 100644 index 0000000000..c6f1f9385a Binary files /dev/null and b/docs/modules/admin/assets/images/emergency_closing/example closing.png differ diff --git a/docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_section.png b/docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_section.png new file mode 100644 index 0000000000..fb14e00961 Binary files /dev/null and b/docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_section.png differ diff --git a/docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_toast.png b/docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_toast.png new file mode 100644 index 0000000000..4d598da279 Binary files /dev/null and b/docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_toast.png differ diff --git a/docs/modules/admin/assets/images/emergency_closing/upcoming closure listing.png b/docs/modules/admin/assets/images/emergency_closing/upcoming closure listing.png new file mode 100644 index 0000000000..cc7852ce85 Binary files /dev/null and b/docs/modules/admin/assets/images/emergency_closing/upcoming closure listing.png differ ----------------------------------------------------------------------- Summary of changes: .../assets/images/emergency_closing/delete closing.png | Bin 0 -> 25476 bytes .../images/emergency_closing/example closing.png | Bin 0 -> 102446 bytes .../possibly emergency closure_section.png | Bin 0 -> 99042 bytes .../possibly emergency closure_toast.png | Bin 0 -> 11760 bytes .../emergency_closing/upcoming closure listing.png | Bin 0 -> 33499 bytes 5 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 docs/modules/admin/assets/images/emergency_closing/delete closing.png create mode 100644 docs/modules/admin/assets/images/emergency_closing/example closing.png create mode 100644 docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_section.png create mode 100644 docs/modules/admin/assets/images/emergency_closing/possibly emergency closure_toast.png create mode 100644 docs/modules/admin/assets/images/emergency_closing/upcoming closure listing.png hooks/post-receive -- Evergreen ILS

1 0