Backend: Claim returned: mark an item claim returned
Description
Environment
None
Potential Workaround
None
Attachments
2
blocks
clones
defines
has to be done after
is cloned by
relates to
Checklist
hideTestRail: Results
Activity
Show:

Bohdan Suprun February 7, 2020 at 10:12 AM
Verified on snapshot.
Following has been added:
Endpoint: POST /circulation/loans/<loanId>/claim-item-returned
Item status:
Claimed returned
Loan action:
claimedReturned
Claimed returned date for loan:
loan.claimedReturnedDate
Closing as dev only.
Done
Details
Assignee
Bohdan SuprunBohdan Suprun(Deactivated)Reporter
Emma BoettcherEmma BoettcherPriority
P3Story Points
8Sprint
NoneDevelopment Team
ProkopovychFix versions
TestRail: Cases
Open TestRail: CasesTestRail: Runs
Open TestRail: Runs
Details
Details
Assignee

Reporter

Priority
Story Points
8
Sprint
None
Development Team
Prokopovych
Fix versions
TestRail: Cases
Open TestRail: Cases
TestRail: Runs
Open TestRail: Runs
Created January 17, 2020 at 5:11 PM
Updated August 7, 2020 at 10:40 AM
Resolved February 7, 2020 at 10:13 AM
TestRail: Cases
TestRail: Runs
Purpose: Patrons may think they have returned items that are still showing as checked out on their account. When this happens, the item is still considered loaned to the patron, but the library will treat the item differently from other items on the patron's account (the item will not be considered overdue, and it will be searched for extensively). This story allows the staff user to distinguish checked out items from items that are claim returned.
Scenarios
Scenario
Given an open loan with the status Checked out, Aged to lost, or Declared lost on the user's open loan history
When the action menu is open
Then show Claim returned as a menu item
Rank: 2nd on list, below renew and above change due date
Scenario
Given an open loan
When viewing loan details
Then display Claim returned button
Left of Renew, right of Change due date button
Scenario
Given the Claim returned option for a single loan (loan details, action menu on loan history)
When clicked
Then display the Claim returned modal
Title: Confirm claim returned
Text: <title of item> (<material type of item>) (Barcode: <barcode of item>) will be claimed returned.
Input:
Additional information (required)
Notify patron On mockup but do not display, out of scope
Buttons
Cancel
Confirm
inactive until user has entered at least one character in Additional information
Scenario
Given a Claim returned modal
When the user clicks confirm
Then:
change the status of the item to Claim returned
close the modal
Scenario
Given a Claim returned modal
When the user clicks cancel
Then:
do not change the status of the item to Claim returned
close the modal
Scenario
Given a loan for an item that is Claim returned
When viewing loan details
Then populate as follows:
Claimed returned: show date and time item was claimed returned
Action history: show row for claimed returned
Action date: Date and time item was claimed returned
Action: Claimed returned
Due date: same as due date in preceding row
Item status: Claim returned
Source: Lastname, firstname (and link to user profile) of user who marked item claim returned
Comments: Comments entered in the Additional information field of Claim returned modal
Scenario
Given loan for an item that is not claim returned
When viewing loan details
Then populate as follows:
Claimed returned: -
Notes
Last scenario is to get rid of "TODO" text in loan details, which should no longer appear.
Mockups are attached that illustrate scenarios 1, 2 and 4 (the modal-lost.png shows a later stage of the claim process, but the buttons and action menu show the new claim returned option).
Permission for this action is in