The ability to import fund updates via csv file in order to bulk edit funds

Description

Note: this was split into two stories one for export () and this one for Import.

Purpose: Users need to be able to export and import their ledgers in order to bulk edit Fund and Budget details easily

Use cases:

  • Librarian administrator logs into folio after finishing fiscal year rollover. The librarian needs to allocate money to all budgets in the new fiscal year. User downloads all budgets and updates numbers in spreadsheet. Uploads all numbers to update values in Finances

  • Library may want to upload budget numbers for planned budgets for the coming year. This would require us to have the ability to choose what fiscal year we are adding the budget information to.

  • Mid fiscal year it is sometimes necessary to make updates to budget allocations. TO do this we would export budgets and make changes to the necessary budgets. Uploading these changes would result in increases or decreases in allocation for the budget that were changed.

High-Level Requirements:

These requirements needed to be updated to accommodate the new element Expense class. It could also makes sense to split this feature into separate requirements for import and export. https://folio-org.atlassian.net/wiki/x/zgpU

Note changing the Fund information and budget information at the same time may be confusing. Could be helpful to separate these into separate actions.

Processing allocations needs to be done in a manner that preserves all processes as if each allocation were manually updated within the UI. Each budget should show an associated transaction by the person who loaded the updated allocation data.

Additional information:

Approach: https://folio-org.atlassian.net/wiki/display/DD/Data+export+by+using+Spring+Batch

See also:

Miro board:

In scope:

  • Output of empty form for upload

  • Ingest of specifically formatted csv to update funds

  • Logging of fund updates for audit purposes

  • “Rollback” or similar in the event of errors

  • Validation screen with ability to edit prior to committing changes

    • Validation screen for bulk changes also available without requiring csv upload

  • Update by Ledger, Group

Out of scope:

  • Creating any type of transfer, payment or credit using this process.

  • Creating new Funds during this process

  • Creating new FY, Ledger, Group

  • Renaming FY, Ledger, Group, Fund

Grooming

Export to CSV

Priority

Development Team

Assignee

Solution Architect

Parent Field Value

None

Parent Status

None

Attachments

8

is blocked by

is defined by

Checklist

hide

TestRail: Results

Activity

Show:

Joseph Reimers March 3, 2025 at 4:15 PM

In order to mitigate risk, batch allocation by group is being removed from Sunflower and will be completed in a later release.

Magda Zacharska May 6, 2022 at 9:27 PM

This functionality is currently planned to be a part of the bulk edit app - using with CSV approach.

cc:

Molly Driscoll December 2, 2021 at 10:43 PM

 and  this feature relates to a request from the Acquisitions Task force to be able to export financial transactions from a ledger. Could you please add a comment here to outline some of your use cases to better assist  with defining requirements? Thanks!

Cate Boerema August 22, 2018 at 9:14 AM

No, it definitely shouldn't! It should be a new feature and have an epic link. Something must have gone wrong when I imported it from file. I'm glad it was still included in the gap analysis! I'll change to a feature and link to the Acquisitions epic.

FYI

Khalilah Gambrell August 21, 2018 at 8:31 PM

- should this be a bug?

Details

Reporter

PO Rank

Estimation Notes and Assumptions

If users need the system to actually create budgets and make allocation this must be done as a new feature and estimates might change. If we can assume the budgets will already exist this could be handle as a bulk edit feature. export list of budgets, make changes in excel, import them back in.

Front End Estimate

Front End Estimator

Front-End Confidence factor

Back End Estimate

Back End Estimator

Back-End Confidence factor

Release

SA support

Tech Design Ready

Yes

Requirements Ready

Yes

Rank: FLO (MVP Sum 2020)

Rank: 5Colleges (Full Jul 2021)

Rank: Cornell (Full Sum 2021)

Rank: Chalmers (Impl Aut 2019)

Rank: GBV (MVP Sum 2020)

Rank: hbz (TBD)

Rank: Hungary (MVP End 2020)

Rank: MI State-Lib of MI (Sum 2021)

Rank: TAMU (MVP Jan 2021)

Rank: Chicago (MVP Sum 2020)

Rank: Leipzig (ERM Aut 2019)

Rank: MO State (MVP June 2020)

Rank: U of AL (MVP Oct 2020)

Rank: Leipzig (Full TBD)

Rank: Lehigh (MVP Summer 2020)

TestRail: Cases

Open TestRail: Cases

TestRail: Runs

Open TestRail: Runs

Created June 28, 2018 at 8:49 AM
Updated April 10, 2025 at 11:32 PM
TestRail: Cases
TestRail: Runs