Page tree
Skip to end of metadata
Go to start of metadata


Notes on functionality

PO Release Presentations

Please include links to any slide decks and recordings

TopicPresentation DatePresenterSIG Meeting (date)Notes
Requests, Patron notices4/20/23RA SIG(starting at 5:35 in the meeting recording)
Loan. New staff and New patron info, incl. new 

token for patron notices

TBD (probably sometime in October 2023)RA SIG
German Reminder FeesTBD (probably sometime mid OctoberSeptember 2023)Florian Ruckelshausen RA SIG
Inventory advanced search modal9/6/23quickMARC subgroupStarting at 44:50 in the recording
Authority Control: Automated support/Heading validation9/6/23quickMARC subgroupStarting at 50:25 in the recording

Important Upgrade Considerations

This section outlines all changes that require special consideration for customers in production.  Configuration changes may be needed to prevent operational interruptions.  See checklist for guidelines on how to fill this out. 

Changes and Required Actions

Functional AreaChange or AdditionConsiderationsAction timing,
Action required
CommentsContact person,
Related JIRAs
Affected app or moduleWhat has been changed or added that should be noted for this releaseWhat challenges may arise related to this change or addition

When can the action be taken (before, during or after upgrade)?

If applicable, detail what action(s) must be taken here

Is this action required for the next release?

Name of user leaving comment: comment on what you encountered or ask a question @mention Contact personUser name of person that can provide additional detail.
Include issue link for bug fix, story or feature that applies
System wideRefresh token support. Expiring token support. See the guide for more information.Third party integrations that use non-expiring legacy tokens will need to be updated to use a new token endpoint during the deprecation period of Poppy. Within Poppy both the legacy and new login endpoints will be supported.

Integrations that use the edge API are unaffected.

System operators can configure access and refresh token TTLs through configuration documented here.
Follow instructions here for updating third party integrations and for configuration.

Steve Ellis 

FOLIO-3627 - Getting issue details... STATUS

Inventory, SRS, Data importDefault MARC-Instance mapping updated to change multiple classification fields or repeated subfields within one classification field are handled

Libraries should review and decide: 

  1. If existing Instances should be refreshed against the updated map, so that all existing instances reflect these changes

See Update of mapping to correct handling of repeated classification fields and subfields for additional details.

Follow the instructions to update the mapping rules. 

Mandatory change. 

Note that any revised mappings will only apply to Instances created or updated via MARC Bibs after the map is updated. To refresh existing Instances against the current SRS MARC Bibs and current map, the library may consider running Script 3 described here: Scripts for Inventory, Source Record Storage, and Data Import Cleanup


Ann-Marie Breaux 

MODDICORE-323 - Getting issue details... STATUS

Inventory, SRS, Data import

Default MARC-Instance mapping updated to adjust punctuation handling for the 1xx/7xx contributor fields and for the $e/$j relator terms

If the library wants more name relator terms to be standardized, for searching and filtering, this update will help.

Libraries should review and decide: 

  1. If existing Instances should be refreshed against the updated map, so that all existing instances reflect these changes

See Update of mapping to adjust punctuation handling for 1xx/7xx contributors and $e/$j relator terms for additional details.

Follow the to update the mapping rules. 

Mandatory change. 

Note that any revised mappings will only apply to Instances created or updated via MARC Bibs after the map is updated. To refresh existing Instances against the current SRS MARC Bibs and current map, the library may consider running Script 3 described here: Scripts for Inventory, Source Record Storage, and Data Import Cleanup


Ann-Marie Breaux 

MODDICORE-347 - Getting issue details... STATUS

MODDICORE-355 - Getting issue details... STATUS

Settings. Patron Overdue Policy. Reminder fee section.

The overdue policies has been extended with an additional section to define “Reminder fees”. The policy is defining the wanted process to bill reminder fees.


Reminder schedule. The process runs nightly and once per day. It creates the appropriate reminders for overdue items if an overdue policy with an active reminder fee section is in effect.

The process is honoring closed days, so if a service point is closed for a whole day the process does not create reminders on this day for the given service point. 



UXPROD-2015 - Getting issue details... STATUS

UXPROD-4159 - Getting issue details... STATUS

Florian Ruckelshausen 

Charlotte Whitt 













Loan records. Add patron info and add staff info

Loan-related notes/comments (action based):

Two new buttons for adding this information is now available from the detailed loan display, and the check-out screen when clicking the three dots.



The notes/comments are searchable in the Circulation log app. 


UXPROD-3913 - Getting issue details... STATUS

Axel Dörrer 

Charlotte Whitt 

Patron notices

A new token supporting sending patron notices with the new patron information has been developed: 

{{loan.additionalInfo}}




UXPROD-3913 - Getting issue details... STATUS

Axel Dörrer 

Charlotte Whitt 

Julie Bickle 

Patron notices

7 new tokens for users primary address information supporting sending printed letters with a final reminder to patrons:





Patron notices

Addition:

Given: You have a lost item policy that charges the actual cost + a notice policy that sends notices with the existing trigger “Lost item fee(s), charged”,
When: You bill the actual cost for an item that has aged to lost,
Then: A notice is sent to the patron, according to the settings in the notice policy.

There are no new options or features in the notice policy or the notice templates; rather, the existing triggers have expanded their scope.

UXPROD-3573.docx

Please note: This ALSO works for items that have been declared lost.

Before upgrading to Poppy and/or switching to actual cost, please review whether your notice policies and/or templates (e.g. wording) need to or can be updated as a consequence.

Remember: Updates to a notice policy are applied when the open loan is next updated. Updates to the lost item policy are NOT applied to open loans.


Julie Bickle 

UXPROD-3573 - Getting issue details... STATUS

Patron notices

Addition:

Given: You have billed the actual cost for a lost item (both whether aged to lost or declared lost) + you have a notice policy that sends notices with the existing trigger “Lost item returned - fee(s) adjusted”,
When: The lost item is checked in (returned),
Then: A notice is sent to the patron, according to the settings in the notice policy.

There are no new options or features in the notice policy or the notice templates; rather, the existing triggers have expanded their scope.

UXPROD-3740.docx


Before upgrading to Poppy and/or switching to actual cost, please review whether your notice policies and/or templates (e.g. wording) need to or can be updated as a consequence.

Remember: Updates to a notice policy are applied when the open loan is next updated. Updates to the lost item policy are NOT applied to open loans


Julie Bickle 

UXPROD-3740 - Getting issue details... STATUS

Patron notices

Addition:

Lost item fees (set cost, actual cost and processing fee) can be bundled into one notice, overnight (or whenever you have agreed to with your hosting provider).

The functionality works the same as for notices trigged by the “Loan due date/time”:

  • There is a new “Mutliple fee/fine charges” token pair to add to the templates: #feeCharges  &  /feeCharges
  • For the triggering event “Lost item fee(s) charged”, there are two new options to select:
    • Send overnight with multiple lost item fee charges by patron.  – This option will bundle any open lost item charges into one email (by standard, up to 100 charges). MUST contain the multiple charges tokens: #feeCharges  &  /feeCharges
    • Send throughout the day with one lost item fee charge per notice.  – This represents existing functionality, and will be the default setting in your existing notice policies that use this trigger. MUST NOT contain the multiple charges tokens: #feeCharges  &  /feeCharges

UXPROD-3998.docx


Before upgrading to Poppy and/or selecting this option, please review whether your notice policies and/or templates (e.g. wording) need to or can be updated as a consequence.

Remember: Updates to a notice policy are applied when the open loan is next updated. Updates to the lost item policy are NOT applied to open loans. 


Julie Bickle 

UXPROD-3998 - Getting issue details... STATUS

Patron notices

Mandatory change:

Overdue fines can be bundled into one notice. The functionality is very similar as for check in and out notices:

  • There is a new “Mutliple fee/fine charges” token pair that MUST be added to the templates: #feeCharges  &  /feeCharges
    Otherwise, the notices will have an empty email body.
  • For the notice policy trigger “Overdue fine, returned”: The overdue fines generated in a single check in session are bundled when the check in session is closed.
  • For the notice policy trigger “Overdue fine, renewed”: The overdue fines are bundled when you renew multiple items at the same time. 

UXPROD-3999.docx


Mandatory change:

Before upgrading to Poppy and/or selecting this option, you MUST update the relevant notice templates to include the multiple charges tokens. Otherwise, the notices will have an empty email body.

In addition, please review whether your notice policies and/or templates (e.g. wording) need to or can be updated as a consequence.

Remember: Updates to a notice policy are applied when the open loan is next updated. Updates to the lost item policy are NOT applied to open loans. 


Julie Bickle 

UXPROD-3999 - Getting issue details... STATUS

Title level requestsAddition:
Institutions will now be able to choose to have title level request holds fail OR always succeed, following Circulation rules. (Through Orchid, holds can always be placed, regardless of Circulation rules).
When this setting is enabled, title level holds will work only when an item record is present. (A future enhancement will address title level holds when item records are not present)Settings > Circulation > Title level requests. Select the box next to "Fail to create title level hold when request is blocked by circulation rule" to prevent holds from succeeding when Circulation rules do not allow them. 
Consortia, mod-search

New tenant initialization parameter (centralTenantId) to define tenant for db structure and indices creation.


Pass 'centralTenantId' parameter on all consortia tenants initialization (with a value of central tenant id).


ConsortiumMod-consortia can be enabled for libraries that want to share data between multiple FOLIO tenants. Enabling this funcitonality will add additional functions and require at least one user account to have additional permissions to take advantage of these functions

Deployment instruction to setup consortia env is created:

Steps to setup Consortia env

Kitfox has already created an automation pipeline using this instruction for dev/testing needs for 4 tenants, FSE should create similar for prod usage for 61 tenants. 


Serhii Nosko can you please add details here regarding actions and timing required to enable this funcitonality. thanks!

Fees/fines: Actual costAdditions:
Actual cost, fee/fine, and status details have been added to the Actual cost processing page. You can now access the processing page through the Action menu on the User details record. An "X" has been added to enable people to leave the processing page without needing to use the back button on the browser. 



OAI-PMHConsortial permissions required for multitenant settings.

Viachaslau Khandramai and Mikita Siadykh  please provide additional details.
Users Loans

When the "Anonymize all loans" button is clicked a confirmation modal will now appear before the anonymization takes place. 




UXPROD-3906

Amelia Sutton 

Users Search

The keyword search in the Users app will now match on a user's middle name. Therefore Users keyword search now matches on:

  • username
  • personal.firstName
  • personal.preferredFirstName
  • personal.lastName
  • personal.middleName
  • personal.email
  • barcode
  • id
  • externalSystemId
  • customFields



UIU-2860

Amelia Sutton 

New Apps


Removed Apps

Permissions Updates

AppNew PermissionsDeprecated PermissionsProduct Owner
Users

Following permissions are necessary for users who will be assigning patron and staff info to the loan record:

Users: User loans: add patron information

Users: User loans: add staff information


Settings > Tenantui-tenant-settings.settings.location.view- "Settings (Tenant): View locations" - this will allow users to view the tenant location tree but be unable to create, update or delete institutions, campuses, libraries or locations
Erin Nettifee 
InvoicesInvoice: Pay invoices in a different fiscal year - This will allow users to specify the fiscal year of an invoice for processing in that year. Even without this permission users will now be able to see the assigned fiscal year of an invoice record.N/A
Consortia manager
  • Consortia API module - all permissions


  • Consortia: Assign and unassign affiliations - Allows a user to add or remove affiliations of other users
  • Consortia: View affiliations - Allows a user to view the affiliations of other users
  • Consortium manager: Can create, edit and remove settings - Allows a user to perform build create, edit and delete actions via the consortia manager BUT user must also have correct permissions in individual tenants to carry out these actions
  • Consortium manager: Can share settings to all members - Allows a user to create settings that will be shared by all members and only editable in the central tenant.
  • Consortium manager: Can view existing settings - Allows a user to view all the settings of members they are affiliated with via the consortia manager
  • Settings (Consortia): Can view and edit consortia membership - Allows a user to view and edit the details of the list of members in the settings app of the central tenant.
  • Settings (Consortia): Can view consortia membership - Allows a user to view the details of the list of members in the settings app of the central tenant.
N/A
Settings > Users

New Invisible Permissions:

  • Settings (Users): Can view manual charges - Allows a user to view the Manual Charges section of Users Settings
  • Settings (Users): Can view if comment required - Allows a user to view the Comment Required section of Users Settings
  • Settings (Users): Can view waive reasons - Allows a user to view the Waive Reasons section of Users Settings
  • Settings (Users): Can view payment methods - Allows a user to view the Payment Methods section of Users Settings
  • Settings (Users): Can view refund reasons - Allows a user to view the Refund reasons section of Users Settings
  • Settings (Users): Can view owners - Allows a user to view the Owners section of Users Settings
  • Settings (Users): Can view transfer accounts - Allows a user to view the Transfer Accounts section of Users Settings
  • Settings (Users): Can view patron blocks conditions - Allows a user to view the Conditions section of Users Settings
  • Settings (Users): Can view patron blocks limits - Allows a user to view the Limits section of Users Settings
  • Settings (Users): Can view patron blocks templates - Allows a user to view the Templates section of Users Settings

Permissions Renamed (new names in bold):

  • Settings (Users): Can create, edit and remove feefines renamed to Settings (Users): Can create, edit and remove manual charges 
  • Settings (Users): Can create, edit and remove comments renamed to Settings (Users): Can edit if comment required
  • Settings (Users): Can create, edit and remove waives renamed to Settings (Users): Can create, edit and remove waive reasons
  • Settings (Users) Can create, edit and remove payments renamed to Settings (Users): Can create, edit and remove payment methods
  • Settings (Users): Can create, edit and remove feefines renamed to Settings (Users): Can create, edit and remove manual charges
  • Settings (Users): Can create, edit and remove refunds renamed to Settings (Users): Can create, edit and remove refund reasons
  • Settings (Users): Create, edit, and view departments renamed to Settings (Users): Can create, edit, and view departments
  •  Settings (Users): Create, edit, view, and delete departments renamed to Settings (Users): Can create, edit, view, and delete departments'

Permission Renamed and made Invisible (new name in bold):

  • Settings (Users): View departments renamed to Settings (Users): Can view departments and made invisible

New Visible Permissions:

  • Settings (Users): Can view general entries - Allows a user to view all sections under the General header in Users Settings (Permission sets, Patron groups, Address Types, Departments, and Custom Fields)
  • Settings (Users): Can view feefines-related entries - Allows a user to view all sections under the Fee/fine header in Users Settings EXCEPT Transfer criteria (Owners, Manual charges, Waive reasons, Payment methods, Refund reasons, Comment required, and Transfer Accounts)
  • Settings (Users): Can view all patron blocks entries - Allows a user to view all sections under the Patron blocks header in Users Settings (Conditions, Limits, and Templates)
  • Settings (Users) View all settings - Allows a user to view all sections in Users Settings (EXCEPT Transfer criteria). 

Inventory/quickMARCquickMARC: Create new MARC bibliographic record: Required for users to be able to create a new MARC bib record via a new option in the Inventory actions menuN/A

Known Issues

General

AppKnown issueWorkaroundJIRA issueProduct Owner
Title level requestsRecalls are unevenly distributed when there is no item to page and there is at least one item that is not checked out but is "available" for a recall to be placed upon
Stephanie Buck 
Users PermissionsThe permission "ui-users.create"

UIU-2955 - Getting issue details... STATUS

Additional known issues (Reminder change filter to Release = Poppy)

Key Summary T Updated Potential Workaround Development Team Status Resolution Release
Loading...
Refresh

Notes on functionality

AppNotesJiraProduct Owner
RequestsOptional columns now available: Effective call number string and Pickup service point. They can be added in the Actions dropdown. Both columns are sortable. When sorting the effective call number string column, the sort is based on a normalized effective call number string (effective shelving order) which excludes prefixes from the sort. A user can do a basic "starts with" search for a call number, with or without a prefix. If the search within Requests begins with the call number (no prefix), it will only search the call number. It will not yield results for any searches that include information beyond the call number (e.g., suffix, copy number +).

UIREQ-898, UIREQ-901,

UIREQ-899UIREQ-900

Settings > Tenant > LocationsImprovement in UI for navigating through the location tree in Settings. The number on "institution" now links to the number of campuses; The number on "campus" now links to the number of libraries; the number on "libraries" now links to the number of locations.

UXPROD-3813 - Getting issue details... STATUS

Erin Nettifee until mid-August

Settings > Tenant > LocationsImprovement in navigating through the location tree in settings. If you choose menu options in a specific area of settings, the choices will "stick" if you go to other areas of the locations tree or settings. That way you don't have to reselect options from the drop-down menu every time.

Note that each part of the tree is distinct - e.g., if you go to libraries and select institution A and campus B to display library C and D, and then you go to the campus page, it will not have anything pre-selected. 

UXPROD-3812 - Getting issue details... STATUS

Erin Nettifee until mid-August
Circulation rulesThe circulation rules now have the metadata object, allowing libraries to see who last updated the rules and when. 

UXPROD-3629 - Getting issue details... STATUS

Erin Nettifee until mid-August; after, ask in #resource-access

Post-Release Hotfixes

Date (verified in BugFest)Bug fixedDocumentation on GitHub
DateHotfix release (needs more info added here)github link




New Features by Epic (Sub-Project)


Closed Bugs


All Closed Bugs and Stories


Remaining Open Bugs at Time of Release 

  • No labels