Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

DCB Cancellation flow details

Context

In the (single tenant) FOLIO Requests app, the user can perform one of the actions available in the Actions menu: Cancel, Edit, Duplicate, Move, Reorder. We need to decide on the expected behavior for those actions for the ECS TLR Requests. Additionally, action menu priority:

  1. Cancel

  2. Edit

  3. Reorder

  4. Move (not available in Ramsons)

  5. Duplicate (not available in Ramsons)

Logically, we have the following entities - actually, ECS TLR, primary circulation request, and secondary circulation request. At the same time, ECS TLR is an internal entity of the application, and there are no UI forms for it to be displayed to users. Users can only see and work with primary and secondary circulation requests.

Drawio
lbox
mVer2
zoom1
simple0
zoominComment10
inCommentcustContentId0644907073
pageId644939858
custContentIdlbox6449070731
diagramDisplayNameUntitled Diagram-1733135363571.drawio
1contentVer1
revision1
baseUrlhttps://folio-org.atlassian.net/wiki
diagramNameUntitled Diagram-1733135363571.drawio
pCenter0
width721
links
tbstyle
height441

...

Circulation Request status

and Circulation request type

Open - Not yet filled

Open - In transit

Open - Awaiting pickup

Open - Awaiting delivery

Primary Circulation Request

(Borrowing Tenant)

  • Сlose both requests - primary and secondary

  • Сlose both requests - primary and secondary

  • Сlose both requests - primary and secondary

  • Сlose both requests - primary and secondary

Secondary Circulation Request

(Lending Tenant)

  • Сlose the secondary request

  • For the primary request, you need to continue looking for options for fulfillment

  • Cancellation is not available

  • Сlose the secondary request

  • For the primary request, you need to continue looking for options for fulfillment

  • Cancellation is not availableСlose the secondary request

  • For the primary request, you need to continue looking for options for fulfillment

  • Cancellation is not available

  • Сlose the secondary request

  • For the primary request, you need to continue looking for options for fulfillment

  • Cancellation is not available

Challenge: At the current stage of the ECS TLR implementation, do we need the ability to close only the secondary request, leaving the ability to continue the search, or do we focus on canceling both requests at once?

...

The current DCB implementation assumes that related requests are canceled all at once (2 or 3). It is worth noting, however, that FOLIO mod-dcb does not know what OpenRS does on their side while canceling, so FOLIO mod-dcb simply performs a status update when receiving a message from OpenRS.

...

  • During the meeting, it was decided that cancellation of the Secondary Circulation Request for ECS TLR from the Lending tenant will not be available, see

    Jira Legacy
    serverSystem Jira
    serverId01505d01-b853-3c2e-90f1-ee9b165564fc
    keyUIREQ-1090

...

Fields that can be changed when editing

and Circulation request type

Expiration date

Fulfillment preference (Hold shelf / Delivery)

Pickup location

Primary Circulation Request

(Borrowing Tenant)

  • Can be changed

  • Propagate the new value to the Secondary Circulation Request

  • Can be changed

  • Propagate the new value to the Secondary Circulation Request

  • Can be changed

  • Propagate the new value to the Secondary Circulation Request

Secondary Circulation Request

(Lending Tenant)

  • Editing is not available

  • There is little point in changing the values here

  • Editing is not availableThere is little point in changing the values here

  • Editing is not available

DCB / Open ReShare does not provide the ability to set or change the parameters mentioned (there are no fields for this in the Edge DCB FOLIO API - https://s3.amazonaws.com/foliodocs/api/edge-dcb/s/edge-dcb.html# tag/circulation). Additionally, these parameters are not set when creating requests from mod-dcb https://github.com/folio-org/mod-dcb/blob/master/src/main/java/org/folio/dcb/service/impl/RequestServiceImpl.java#L52

...

  1. Reordering on the part of the Primary Circulation request is allowed; the changes should be synchronized to the Secondary Circulation request.

  2. Reordering on the part of the Secondary Circulation request is not available (the same as for Cancel and Edit actions).

Duplicate

*Not available in Ramsons

Action scope:

  • Item level requests: You can duplicate open requests but you will need to change either the requester or the item to save the request, as there cannot be two requests on the same item by the same requester. Closed requests can be duplicated, but you will need to enter a requester barcode.

  • Title-level requests: You can duplicate any open title-level request. When you duplicate the request, you will need to change the instance or the requester, because a patron cannot have more than one open title-level request on the same instance.

...

  1. This action item should be hidden and unavailable in the Requests App UI menu both on Borrowing and Lending tenants .(in Ramsons)

  2. The workaround proposed is to create a new request from scratch.

Move

*Not available in Ramsons

Action scope: This action allows you to move a request from one item to another. For example, when a regular TLR exists, and some item is selected for request fulfillment, you can move the request to another available item. It is only applicable if the request status is Open - Not yet filled, later it’s not possible to move. (question) I wonder if there are any other move scenarios other than the one described above?

If you move a Primary Circulation Request it means the existing Secondary Circulation Request must be canceled and a new one created.

...

  1. This action item should be hidden and unavailable in the Requests App UI menu both on Borrowing and Lending tenants .(in Ramsons)

  2. The workaround proposed is to cancel the initial request and create a new one from scratch.