Notes on functionality
PO Release Presentations
Please include links to any slide decks and recordings
Topic | Presentation Date | Presenter | SIG Meeting (date) | Notes |
---|---|---|---|---|
Requests, Patron notices | 4/20/23 | RA 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 Fees | TBD (probably sometime mid OctoberSeptember 2023) | Florian Ruckelshausen | RA SIG | |
Inventory advanced search modal | 9/6/23 | quickMARC subgroup | Starting at 44:50 in the recording | |
Authority Control: Automated support/Heading validation | 9/6/23 | quickMARC subgroup | Starting 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 Area | Change or Addition | Considerations | Action timing, Action required | Comments | Contact person, Related JIRAs |
---|---|---|---|---|---|
Affected app or module | What has been changed or added that should be noted for this release | What 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 person | User name of person that can provide additional detail. Include issue link for bug fix, story or feature that applies |
System wide | Refresh 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 | |
Inventory, SRS, Data import | Default MARC-Instance mapping updated to change multiple classification fields or repeated subfields within one classification field are handled | Libraries should review and decide:
| 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 | ||
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:
| 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 | ||
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. | |||
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. | |||
Patron notices | A new token supporting sending patron notices with the new patron information has been developed: {{loan.additionalInfo}} | ||||
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”, There are no new options or features in the notice policy or the notice templates; rather, the existing triggers have expanded their scope. | 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. | ||
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”, There are no new options or features in the notice policy or the notice templates; rather, the existing triggers have expanded their scope. | 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 | |||
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”:
| 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. | |||
Patron notices | Mandatory change: Overdue fines can be bundled into one notice. The functionality is very similar as for check in and out notices:
| 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. | |||
Title level requests | Addition: 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). | |||
Consortium | Mod-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: 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 cost | Additions: 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-PMH | Consortial 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. | ||||
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:
|
New Apps
Removed Apps
Permissions Updates
App | New Permissions | Deprecated Permissions | Product 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 > Tenant | ui-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 | |
Invoices | Invoice: 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 |
| N/A | |
Settings > Users | New Invisible Permissions:
Permissions Renamed (new names in bold):
Permission Renamed and made Invisible (new name in bold):
New Visible Permissions:
| ||
Inventory/quickMARC | quickMARC: 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 menu | N/A |
Known Issues
General
App | Known issue | Workaround | JIRA issue | Product Owner |
---|---|---|---|---|
Title level requests | Recalls 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 Permissions | The permission "ui-users.create" |
Additional known issues (Reminder change filter to Release = Poppy)
Notes on functionality
App | Notes | Jira | Product Owner |
---|---|---|---|
Requests | Optional 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 +). | ||
Settings > Tenant > Locations | Improvement 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. | Erin Nettifee until mid-August | |
Settings > Tenant > Locations | Improvement 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. | Erin Nettifee until mid-August | |
Circulation rules | The circulation rules now have the metadata object, allowing libraries to see who last updated the rules and when. | Erin Nettifee until mid-August; after, ask in #resource-access |
Post-Release Hotfixes
Date (verified in BugFest) | Bug fixed | Documentation on GitHub |
---|---|---|
Date | Hotfix release (needs more info added here) | github link |