Q1 2020 (Fameflower) Release Notes

Table of Contents

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:

• Inventory items now have a restricted set of valid statuses. Environments which are using their own statuses will need to change their records accordingly. The statuses are as follows (the capitalisation is important):  Available; Awaiting pickup; Awaiting delivery; Checked out; In process; In transit; Missing; On order; Paged; Declared lost; Order closed and Claimed returned.
• Overdue fine policies must be set up and circulation rules have to refer to policies that exist.  If you do not charge overdue fines, you need to create one overdue fine policy that is for an overdue fine of 0 and use that overdue fine policy for every circulation rule.
• Lost item fine policies must be set up and circulation rules have to refer to policies that exist.  If you do not charge lost item fees, you need to create one lost item fee policy that is for a lost item fee of blank and use that lost item fee policy for every circulation rule.  Here is an example of a default Lost Item Fee Policy to use if you do not charge lost item fees.  The one required setting you will need to enter is the For lost items not charged a fee/fine, close the loan after interval.  This setting is needed to insure that the loan is eventually closed.
• Upon deployment make sure that automatic fee/fine types were added to the mod-feesfines database.  Otherwise overdue fine creation functionality will not work for Q1 2020 release and lost item processing will not work for Q2 2020 release. To check, make a call to /feefines?query=automatic==true.  The response should contain 4 entries: "Overdue fine", "Lost item fee", Lost item processing fee" and "Replacement processing fee."
• All Service Points must be associated with a Fee/Fine Owner at Settings>Users>Fee/Fine: Owners for overdue fines to work properly.  If an overdue fine is calculated for an item with an Effective Location whose Primary Service Point is not associated to a Fee/Fine Owner, the overdue fine will NOT be charged to the patron.  (In the future we will have a Default Fee/fine Owner to be charged.  See UXPROD-2278 for details.)
• mod-calendar: History/audit tables (table names starting with audit_) are truncated (all data deleted) on upgrade. The format of the audit tables has been changed in RMB 25.0.0, there is no conversion because RMB versions before 25 were outdated and unsupported in Edelweiss.
• nodejs >= 10.0.0 is required to build the stripes (UI) javascript bundle. Previous releases supported nodejs >= 8.0.0.
• PubSub is being used and required in Fameflower. PubSub module allows use of the event-driven approach in cross-module interactions. This module works on top of Kafka/Zookeeper to deliver messages and create a queue of events. For supporting messaging between modules and correct PubSub mechanism work, it needs to have a Kafka/Zookeeper stack for FOLIO environments. It's important to have the right order on environments setup. First of all, start Kafka, then mod-pub-sub and after it, all other modules with dependencies on PubSub modules.  For more information on installation or verifying that Kafka and PubSub are working together properly, consult the PubSub readme documentation or contact Oleksii Kuzminov Taras Spashchenko.  
• Organizations codes must now be unique. This will prevent the migration of your organization records from Edelweiss to Fameflower if the Code they are using is used by another organization that was migrated first. There is a fix, but it was decided that this can wait until the Q2 release so there will be no Hotfix. A workaround would be making sure you have no duplicate code before the migration begins. JIRA issue  MODORGSTOR-68 - Getting issue details... STATUS
• User barcodes must be unique. This includes barcodes which have been set to an empty string. To workaround make sure you have no duplicate barcode before the migration begins. MODUSERS-192 - Getting issue details... STATUS
• Order Fields have changed. The "Renewal accordion" on the POL has been replaced by "Ongoing order information" accordion. As a result libraries may want to revisit order templates. existing orders should not be affected as the data will be migrated in the backend.

MODULE LIMITATIONS: 

• mod-data-export is a new module which can be used to export bibliographic data in MARC binary format. For Q1 the only supported storage for file export will AWS S3. For configuration steps please see (https://github.com/folio-org/mod-data-export/blob/master/README.md)(For questions contact Kruthi Vuppala / Magda Zacharska )
  (Note: There will be  platform agnostic implementations in future releases)
• raml module builder (RMB) based back-end modules should use RMB version 29.3.* or 29.4.*. The platform core team will provide hot-fixes only for these versions during the period of time where Fameflower is the latest FOLIO release. The module spreadsheet indicates each module's RMB version.
• raml module builder (RMB) based back-end modules should not be installed or updated in parallel but one by one in sequence. Otherwise some might fail with "tuple concurrently updated" (RMB-598).

Known Issues 

• Patron groups that contain non-alpha numeric characters cannot be used for filtering in Users app UIU-1568 - Getting issue details... STATUS
• When you pay or waive a fee/fine from the Fee/Fine Details page, the action will not take effect until you manually refresh the browser page.  If you fail to do so, and enter the payment/waive again, the transaction will be entered again with no way to get rid of it.  UIU-1644 - Getting issue details... STATUS

Orders

• When creating an order line and saving it with the Package toggle disable and then editing it and enabling the package toggle or vice versa could result in unwanted receiving records (receiving titles). This will be handled by the following issue during Q2  MODORDERS-374 - Getting issue details... STATUS
• Related invoices are not displayed at the PO level. When processing invoices against POLs you will be able to view the POL and see related invoices. However, even though they display on the POL they will not show as related invoices on the PO.  MODINVOICE-148 - Getting issue details... STATUS  will complete this work
• Order prefixes and suffixes are not added to the order number during order creation when using the respective dropdown fields on order form. However, you can allow order number to be edited in settings and manually add prefix and suffix to order number in UI. The following issues will resolve this in Q2 and migrate data as needed. 

  key	summary	type	created	updated	due	assignee	reporter	priority	status	resolution

  Loading...

  Refresh
• There are two remaining permissions for mod orders that are no longer usable as they have been removed. However, they may still appear in old databases: 'Orders: Check-in items' and 'Orders: Receive/Check-in items'. These permissions will be cleaned up with a script or some additional code in mod-perms for dealing with deprecated permissions. See the following issues for status
  • MODPERMS-78 - Getting issue details... STATUS MODORDERS-382 - Getting issue details... STATUS

Finance

• In some circumstances when creating a new budget you are not able to allocate more than 0 dollars. After creating the budget allocations can be made as needed but the system sometimes chokes when trying to create the allocation along with the budget.  MODFIN-129 - Getting issue details... STATUS
• View transactions. If you have viewed a previous budgets transactions you need to click view transactions, click 'x' to close it, click view transactions again to refresh the list.  UIF-210 - Getting issue details... STATUS

Data Import: (Questions? Check with Ann-Marie Breaux (Deactivated))

• Matches: Can match between MARC Bibs and Inventory Instances/Holdings/Items only. Will add matching between MARC Bibs and MARC Bibs in Q2
• Actions: Can create MARC Bibs, Inventory Instances, Inventory Holdings, and Inventory Items only. Will add updating for those record types in Q2.
• Field mappings: Can create field mappings for Inventory Instances/Holdings/Items except for 4 specialized types of fields, which will be added as hotfixes for Fameflower:
  • Checkboxes
  • Date pickers
  • Reference values/Dropdowns
  • Repeatable fields
  • Will add field mapping modifications for MARC Bibs in Q2
• Job profiles: Can create job profiles that include the acceptable matches, actions, and field mappings described above. One bug, UIDATIMP-413 needs to be resolved and hotfixed to Fameflower before the job profiles will work properly.

Post-Release Hotfixes

New Features by Epic (Sub-Project)

Closed Bugs

Project	Priority
	P1	P2	P3	P4	P5	TBD	T:
Bug Fest	0	0	1	0	0	0	1
Chalmers	2	2	2	1	0	20	27
ERM Platform	0	0	6	0	0	42	48
FOLIO	0	2	4	1	0	7	14
JIRA Configuration	0	0	2	0	0	0	2
Okapi	2	8	0	0	0	8	18
RAML Module Builder	2	5	0	0	0	4	11
Reporting Tools	0	0	0	0	0	1	1
data-import-processing-core	2	0	0	0	0	0	2
edge-patron	0	0	0	0	0	1	1
mod-authtoken	0	2	0	0	0	1	3
mod-calendar	1	0	0	0	0	3	4
mod-circulation	4	10	6	0	1	9	30
mod-circulation-storage	0	1	0	0	0	1	2
mod-configuration	0	0	1	0	0	0	1
mod-courses	4	2	0	0	1	9	16
mod-customfields	0	1	1	0	0	1	3
mod-data-export	0	2	1	0	0	1	4
mod-di-converter-storage	3	3	0	0	0	0	6
mod-erm-usage	0	0	1	0	0	3	4
mod-feesfines	4	3	1	0	0	1	9
mod-finance	0	1	1	0	0	0	2
mod-finance-storage	1	2	4	0	0	0	7
mod-inventory	2	5	1	0	0	3	11
mod-inventory-storage	3	8	4	0	0	2	17
mod-invoice	1	1	2	0	0	0	4
mod-invoice-storage	0	1	1	0	0	0	2
mod-kb-ebsco-java	0	0	3	0	0	0	3
mod-login-saml	0	0	0	0	0	1	1
mod-marccat	0	0	1	0	1	17	19
mod-ncip	0	0	0	0	0	1	1
mod-notes	0	0	1	0	0	0	1
mod-notify	1	1	0	0	0	0	2
mod-orders	1	4	3	0	0	0	8
mod-orders-storage	0	1	0	0	0	0	1
mod-organizations-storage	0	0	3	0	0	0	3
mod-password-validator	0	1	0	0	0	0	1
mod-permissions	0	0	0	0	0	1	1
mod-pubsub	0	2	0	0	0	0	2
mod-sender	1	1	0	0	0	0	2
mod-source-record-manager	4	4	2	0	0	0	10
mod-source-record-storage	0	1	0	0	0	0	1
mod-template-engine	0	2	0	0	0	0	2
mod-users	0	1	1	0	0	3	5
mod-users-bl	0	0	0	0	0	1	1
stripes-components	0	2	4	1	0	3	10
stripes-connect	1	0	2	0	0	1	4
stripes-core	0	0	3	0	0	0	3
stripes-final-form	0	0	1	0	0	1	2
stripes-smart-components	0	0	7	0	0	1	8
stripes-testing	0	0	1	0	0	1	2
stripes-util	0	1	0	0	0	0	1
ui-acquisition-units	0	0	1	0	0	0	1
ui-calendar	0	0	2	0	0	3	5
ui-checkin	1	0	1	0	0	1	3
ui-checkout	2	4	3	1	0	0	10
ui-circulation	2	1	6	0	0	1	10
ui-courses	5	7	2	1	0	5	20
ui-data-export	0	2	2	0	0	0	4
ui-data-import	4	11	10	0	0	0	25
ui-developer	0	0	1	0	0	0	1
ui-eholdings	0	6	7	0	0	2	15
ui-erm-usage	0	0	1	0	0	6	7
ui-finance	0	1	8	0	0	0	9
ui-finc	0	0	2	0	0	12	14
ui-inventory	1	16	4	1	0	1	23
ui-invoice	0	2	2	2	0	0	6
ui-marccat	0	0	2	0	0	13	15
ui-myprofile	0	0	1	0	0	0	1
ui-notes	0	0	1	0	0	0	1
ui-orders	1	5	11	2	0	1	20
ui-organizations	0	1	8	1	0	0	10
ui-plugin-create-item	0	0	1	0	0	0	1
ui-plugin-find-contact	0	0	1	0	0	0	1
ui-plugin-find-import-profile	0	1	1	0	0	0	2
ui-plugin-find-instance	0	0	1	0	0	0	1
ui-plugin-find-interface	0	0	1	0	0	0	1
ui-plugin-find-organization	0	0	1	0	0	0	1
ui-plugin-find-po-line	0	0	1	0	0	0	1
ui-plugin-find-user	0	0	0	0	0	2	2
ui-receiving	0	4	5	0	0	0	9
ui-requests	1	12	9	0	0	2	24
ui-search	0	0	1	0	0	0	1
ui-tags	0	0	1	0	0	0	1
ui-tenant-settings	0	0	1	1	0	0	2
ui-users	13	17	20	0	0	12	62
Total Unique Issues:	69	170	190	12	3	209	653

Showing 86 of 86 statistics.
View in Jira

All Closed Bugs and Stories

Remaining Open Bugs at Time of Release