https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=19814
--- Comment #44 from Martin Renvoize (ashimema) <[email protected]> --- # 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 are receiving this mail because: You are watching all bug changes. _______________________________________________ Koha-bugs mailing list [email protected] https://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-bugs website : http://www.koha-community.org/ git : http://git.koha-community.org/ bugs : http://bugs.koha-community.org/
