BACKEND - Lost items requiring ACTUAL COST: Generate 'skeleton' list of items

Purpose: Request a list of lost items requiring actual cost and then bill the patron a lost item fee.

Story: As a staff member who charges patrons for lost items, I need a list of items to have selectors find the replacement price for and then bill the patron for that amount.

Special note: Attached mock-up SKELETON-2-lost-items-requiring-actual-costs.png is the one that should be used for this user story. Attached mock-up 2-lost-items-requiring-actual-costs.png is provided to show what the page will look like after all of the related user stories have been completed.

Scenarios:

1. Scenario
   • Given the Users app Users search results page Actions drop-down
   • When open
   • Then show new drop-down option Lost items requiring actual costs (as shown in attached mock-up 1-users-actions-button-lost-items.png)
2. Scenario
   • Given the Lost items requiring actual costs option in Users app Users search results page Actions drop-down
   • When selected
   • Then search for items meeting this criteria:
     • For Declared lost items...
       • Item status is 'Declared lost'
       • No fee/fine 'Action' record exists with Fee/fine type of 'Lost item fee'
       • Loan is still open
     • For Aged to lost items...
       • Item status is 'Aged to lost'
       • lostItemHasBeenBilled (from Loan Record) is "true"
       • No fee/fine 'Action' record exists with Fee/fine type of 'Lost item fee (actual cost)'
       • Loan is still open
3. Scenario
   • Given the search for items completed (Scenario 2)
   • When no items found matching the criteria
   • Then:
     • Open Lost items requiring actual costs page (as shown in attached mock-up SKELETON-2-lost-items-requiring-actual-costs.png), displaying: No results found. (in gray text, in the middle of the results page, similar to what FOLIO currently does when searching for users (see attached example No-users-found-search-example.jpg))
     • Display '0 records found' on top of page (as shown in attached mock-up SKELETON-2-lost-items-requiring-actual-costs.png)
     • Activate Search button
4. Scenario
   • Given the search for items completed (Scenario 2)
   • When items found matching the criteria
   • Then open Lost items requiring actual costs page (as shown in attached mock-up SKELETON-2-lost-items-requiring-actual-costs.png) with most recent lost items (Date of loss) appearing on top of the report
     • Report columns
       • Patron column
         • Last name, First name Middle name (from User information record)
       • Loss type column
         • Item status (from the Item record)
       • Date of loss column
         • Date the item was declared lost or aged to lost. This date is available in the Loan 'Action' record by looking for the 'Action' record with an Action of 'Declared lost' or 'Aged to lost' and then grabbing the Action date
       • Instance column
         • Title (Material type) (from Item record) Instead of the full Title, display three lines (or 75 characters of Title, with ... representing more (clicking on ... will present entire Title plus Material type (as shown in attached mock-up 6-show-long-title.png))
       • Permanent item location column
         • Item location: Permanent from the Location section of the Item record
       • Fee/fine owner column
         • Fee/fine owner is derived from the Item location: Permanent by using this location to find the Primary service point and then seeing which Fee/fine owner is associated with that Primary service point at Settings>Users>Fee/fine: Owners
       • Fee/fine type column
         • 'Automatic' Fee/fine type from the Manual charges table at Settings>Users>Fee/fine: Manual charges (for ACTUAL COST this is 'Lost item fee (actual cost))
       • Actions column
         • Charge fee button
     • Insert number of records returned where '# records found' is to be displayed on top of page (as shown in attached mock-up SKELETON-2-lost-items-requiring-actual-costs.png)
     • Activate Search button
5. Scenario
   • Given the Lost items requiring actual costs page
   • When Search button pressed
   • Then:
     • Present items from originally listed in the order they were initially
     • If search results in no items found, display: No results for "<insert-search-entered>". Please check your spelling and filters. (in gray text, in the middle of the results page like FOLIO currently does when searching for users (see attached example No-users-found-search-example.jpg))
6. Scenario
   • Given the Lost items requiring actual costs page
   • When sort icon is clicked on a previously unsorted column
   • Then sort in ascending order, flipping the sort icon from down arrow to up arrow
7. Scenario
   • Given the Lost items requiring actual costs page
   • When sort icon is clicked on a previously sorted column
   • Then sort in opposite order, flipping the sort icon as needed