Bugzilla – Attachment 186375 Details for
Bug 19814
Batch Check-in function
Home
|
New
|
Browse
|
Search
|
[?]
|
Reports
|
Help
|
New Account
|
Log In
[x]
|
Forgot Password
Login:
[x]
Testing guidance
BATCH_RETURNS_TEST_PLAN.md (text/markdown), 5.48 KB, created by
Martin Renvoize (ashimema)
on 2025-09-11 13:39:04 UTC
(
hide
)
Description:
Testing guidance
Filename:
MIME Type:
Creator:
Martin Renvoize (ashimema)
Created:
2025-09-11 13:39:04 UTC
Size:
5.48 KB
patch
obsolete
># Batch Returns Feature - Test Plan for Librarians > >## Overview > >This proof-of-concept adds batch return functionality to Koha's circulation returns page, specifically designed for RFID workflows while maintaining full backward compatibility with manual barcode entry. > >## New Features > >1. **Automatic RFID Batch Processing**: Scan multiple items with RFID pad - system automatically detects and processes all returns >2. **Manual Batch Mode**: Toggle in settings to enable textarea for typing/pasting multiple barcodes >3. **Comprehensive Results Display**: View status, messages, and details for each returned item >4. **Seamless Integration**: No changes to existing single-item workflow > >## Test Scenarios > >### Test 1: Traditional Single Item Returns (Should work exactly as before) > >**Purpose**: Verify existing workflow is unchanged > >**Steps**: > >1. Go to Circulation â Check in >2. Enter a single barcode in the input field >3. Press Enter or click "Check in" >4. Verify item processes normally with all existing messages/alerts > >**Expected Result**: â Identical behavior to current system > >--- > >### Test 2: Manual Batch Returns > >**Purpose**: Test manual multi-barcode entry > >**Steps**: > >1. Go to Circulation â Check in >2. Click the settings icon (âï¸) next to input field >3. Check "Enable batch mode for multiple returns" >4. Notice input field expands to textarea >5. Enter multiple barcodes, one per line: > > ``` > 39999000001310 > 39999000001328 > 39999000001336 > ``` > >6. Click "Check in" > >**Expected Result**: > >- â Batch results table appears showing each barcode >- â Success/failure status for each item >- â Individual messages (holds, transfers, etc.) per item >- â Regular checked-in items list also populated > >--- > >### Test 3: RFID Batch Scanning (Key Feature) > >**Purpose**: Test automatic RFID workflow > >**Prerequisites**: RFID pad configured to output newline-delimited barcodes > >**Steps**: > >1. Go to Circulation â Check in >2. Leave input field in default single-line mode >3. Place multiple items on RFID pad and scan >4. Observe interface automatically expands and shows all scanned barcodes >5. Wait approximately 0.5 seconds after scanning completes >6. System should automatically submit and process all items > >**Expected Result**: > >- â Interface automatically switches to batch mode when RFID data arrives >- â All scanned barcodes visible in expanded textarea >- â Automatic submission after brief delay >- â Batch results showing all processed items > >--- > >### Test 4: Mixed Success/Failure Results > >**Purpose**: Verify error handling in batch mode > >**Steps**: > >1. Enable batch mode (manually or via RFID) >2. Enter mix of valid and invalid barcodes: > > ``` > ValidBarcode123 > InvalidBarcode999 > AnotherValidOne456 > ``` > >3. Submit batch > >**Expected Result**: > >- â Valid items show "Returned" status with green indicators >- â Invalid barcodes show "Invalid barcode" with red indicators >- â Appropriate error messages for each failed item >- â Successful returns still process normally > >--- > >### Test 5: Special Circulation Scenarios > >**Purpose**: Test batch handling of holds, transfers, recalls > >**Steps**: > >1. Return items that have various conditions: > - Item with hold for pickup at current location > - Item needing transfer to another branch > - Overdue item > - Item with recall >2. Use batch mode to return multiple items with different statuses > >**Expected Result**: > >- â Hold notifications appear in batch results >- â Transfer messages displayed appropriately >- â All circulation messages preserved per item >- â Same behavior as single-item returns > >--- > >### Test 6: Settings Integration > >**Purpose**: Verify batch mode integrates with existing return settings > >**Steps**: > >1. Enable various return settings (Book drop mode, Forgive fines, etc.) >2. Test both single and batch returns with these settings active >3. Toggle batch mode on/off while other settings enabled > >**Expected Result**: > >- â All existing return settings work with batch mode >- â Settings apply consistently to batch-processed items >- â No conflicts between batch mode and other options > >--- > >## User Experience Questions for Feedback > >### RFID Workflow > >1. Does the automatic detection and expansion feel natural during RFID scanning? >2. Is the 0.5-second delay appropriate, or would you prefer longer/shorter? >3. Are all scanned barcodes clearly visible before automatic submission? > >### Manual Batch Mode > >1. Is the settings location for "Enable batch mode" intuitive? >2. Does the textarea expansion/collapse work smoothly? >3. Is the batch results table clear and informative? > >### Results Display > >1. Are success/failure indicators clear enough? >2. Do you get sufficient detail about each returned item? >3. Are error messages helpful for problem resolution? > >### Overall Workflow > >1. Does this enhance or complicate your returns process? >2. Would you use RFID batch returns in daily operations? >3. Any missing information or functionality? > >## Known Limitations (Proof of Concept) > >- Bundle items and multi-part confirmations not yet tested in batch mode >- Performance with very large batches (50+ items) not yet optimized >- Some complex circulation scenarios may need additional testing > >## Feedback Needed > >Please test these scenarios and provide feedback on: > >- Usability and workflow integration >- RFID compatibility with your hardware >- Performance with typical batch sizes >- Any bugs or unexpected behavior >- Suggestions for improvements > >--- > >_This is a proof-of-concept implementation seeking librarian feedback before full development._
You cannot view the attachment while viewing its details because your browser does not support IFRAMEs.
View the attachment on a separate page
.
View Attachment As Raw
Actions:
View
Attachments on
bug 19814
:
186374
| 186375