UI | Add 7 new tokens to staff slip Due date receipt

Description

Purpose: Add 7 new tokens to staff slip: Due date receipt. The new tokens support repeatable circulation (aka Reading Room Circulation Functionality). The tokens are to be added to the the token modal in the staff slip templates.

Out of scope: {{requestTypeToken}} new custom token based on settings value and request type. See: .

Scenarios:

  1. Scenario:

  • Log into FOLIO Snapshot as user Diku_admin - or any given FOLIO environment, as test user.

  • Go to the Settings app.

  • Given: Settings  >  Circulation  >  General > Staff slips > Due date receipt template and open existing template

  • When: I click on the tokens button { } in the template editor the “Add token” modal will pop-up

  • Then: I see in the section called Item following 7 new tokens, which are added at the end of the list of existing Item tokens as shown in the UX mock

    • {{item.accessionNumber}} Accession number

    • {{item.administrativeNotes}} Item administrative notes

    • {{item.datesOfPublication}} Year of publication -- at the instance level and not the item level -- needed for monographs held at the instance level

    • {{item.editions}} Editions - Part of the instance record

    • {{item.physicalDescriptions}} Physical description

    • {{item.instanceHrid}} - Instance HRID

    • {{item.instanceHridImage}} Instance HRID - A text and barcode representation of the Instance HRID

 

 

  1. Scenario:

  • When previewing the Due date receipt template by click on the button ‘Preview’

  • Then following text for the 7 new tokens - if selected - will display in preview (see the text in bold):

    • {{item.accessionNumber}} Accession number: 1234RFID

    • {{item.administrativeNotes}} Item administrative notes: Send to bookbinder

    • {{item.datesOfPublication}} Year of publication -- at the instance level and not the item level -- needed for monographs held at the instance level: 2016

    • {{item.editions}} Editions - Part of the instance record: 2nd. edition

    • {{item.physicalDescriptions}} Physical description: xx, 238 p. : ill. ; 24 cm.

    • {{item.instanceHrid}} - Instance HRID: inst000000000022

    • {{item.instanceHridImage}} Instance HRID - A text and barcode representation of the Instance HRID: [inst000000000022 barcode image]

 

Tips for how to generate a Due date receipt:

Due date receipt. This slip is available in the Check out app, when you go to Loan details, and in the Users app, when you go to Open loans or Loan details.

  1. Go to the User app and check the loans for the given user who has checked out the item with Accession number information. Expand the "Loans" accordion on user details pane and click on the "open loans" link.

  2. "Loans" page is opened for the given user.
    "Open loans" tab is selected
    List of all open loans for selected user is displayed in table view

  3. Click on "Print Due Date Receipt" button on loan details page

  4. Printing preview window is opened
    Opened window contains Due date receipt for selected loan as configured in precondition.

  5. Confirm printing -> save the generated slip on local machine -> open downloaded ".pdf" file

  6. Downloaded Due date receipt is opened
    Due date receipt contains data from loan selected in step #13 organized as set in precondition

Environment

None

Potential Workaround

None

Attachments

13

Checklist

hide

Activity

Show:

Charlotte Whitt March 9, 2025 at 8:54 PM
Edited

Manual test on FOLIO Snapshot-2, version mod-circulation 24.4.0-SNAPSHOT, https://folio-snapshot-2.dev.folio.org/users/2205005b-ca51-4a04-87fd-938eefa8f6de/loans/open

All works as expected. You rock I’ll close the ticket as done.

Charlotte Whitt March 4, 2025 at 10:14 AM
Edited

Hi - what you noticed as

Comment on Scenario 2: Realized later that I wasn’t supposed to do this, but I checked and added our 7 new tokens. Add token, Preview generates this slightly strange preview

That has nothing to do with our new work, but that is how a string of tokens will be previewed, This behavior goes for all tokens

Charlotte Whitt March 4, 2025 at 10:03 AM
Edited

Hi - the double “rfid rfid” is entered like this in the item record, the administrative note: https://nls-dev.folio-dev.indexdata.com/inventory/view/07c22b6d-ee22-4b5a-86ec-10391814bac1/135cbc11-3d6f-4715-8bbd-6911fa3dd82c/2a542e31-8fc8-4fe3-a1c6-6c77fbe0f1f1?filters=staffSuppress.false&qindex=hrid&query=in00000000013&sort=title

So all is good

I’ll move the ticket to In review. Mike has merged the code to master (FOLIO Snapshot). The new work should be present when afternoon’s version of FOLIO Snapshot-2 (http://folio-snapshot-2.dev.folio.org/) is launched.

Bodil Wennerlund March 4, 2025 at 9:51 AM

Tried generating av due date receipt:

 

Bodil Wennerlund March 4, 2025 at 9:39 AM

Don’t worry, I closed without saving.

Done

Details

Assignee

Reporter

Tester Assignee

Priority

Sprint

Development Team

Klemming

Release

Sunflower (R1 2025)

TestRail: Cases

Open TestRail: Cases

TestRail: Runs

Open TestRail: Runs
Created February 1, 2025 at 3:10 PM
Updated March 9, 2025 at 9:27 PM
Resolved March 9, 2025 at 8:55 PM
TestRail: Cases
TestRail: Runs