threadcount-community/docs/manual/reference/keyboard-and-scanner.md

title, section, order, summary, screen, role, keywords

title	section	order	summary	screen	role	keywords
Keyboard and scanner	reference	3	Setting up a USB barcode scanner, the symbologies ThreadCount reads and prints, the keys the screens answer to, and how printing works.	Counter, Stock › Count, Stock › On hand	Admin or Issuer	usb scanner, keyboard wedge, enter, suffix, barcode, ean-13, code 128, keyboard, shortcut, escape, tab, print, labels, slip, pop-up

Setting up a USB scanner

ThreadCount has no scanner driver. A USB scanner in keyboard mode (keyboard wedge) types the code into whichever field has focus, and the field acts when it receives Enter.

1. Set the scanner to keyboard mode. Most are out of the box; the scanner's own manual has the setup barcode.
2. Set the suffix to Enter (carriage return). A Tab suffix moves focus instead, and nothing is recorded.
3. Click into the scan field first. Keystrokes that land anywhere else do nothing. No screen listens for a scan outside its field.
4. Scan a known garment to test. On Stock › Count its count goes up by 1.

Spaces before and after the code are trimmed.

Where a scan goes

Screen	Field	What Enter does
Counter	Scan barcode, then Enter, under 2 · Scan items	Adds 1 of that size to the pickup; a repeat scan adds another
Stock › Count	Scan barcode to count +1, then Enter, focused on arrival	Adds 1 to that size's count
Stock › On hand › Scan to add	Scan with a USB scanner, or type the code and press Enter, focused on open	Finds the garment, or offers to add it
A garment's page, Scan sizes	The size prompt, focused on open	Binds the code to the chosen size
A garment's page, a size's barcode field	The code	Saves it

A code nobody has bound, or one bound to an archived garment, opens Unknown barcode on Counter and Stock › Count. An Admin picks the garment and size to bind it; an Issuer is told only an Admin can. See barcodes.

Formats

Where	Formats
USB scanner	Whatever the scanner types. A binding keeps up to 64 characters.
Camera, in the browser and the counter app	EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93
Printed labels	EAN-13 for a valid 13-digit code, Code 128 for anything else

Generate barcodes on a garment's page gives each size with no code a 13-digit EAN-13 starting 29, the GS1 range reserved for use inside one organisation, so any scanner reads it.

At a window 780 pixels wide or narrower, a SCAN button sits at the bottom right. On Counter and Stock › Count it opens the camera for that screen; anywhere else it opens search with the camera running, to find a person, a garment or an order. It hides while a dialog is open. Which browsers can use the camera is on scanning and browsers.

Keys the screens answer to

ThreadCount has no single-key shortcuts. These are the keys the screens handle.

Key	Where	Does
Enter	The scan fields above	Records the scan
Enter	Settings › Issuing rules, New staff group	Adds the group
Enter	A Rename dialog, New name	Saves
Enter	A garment's page, Add a size	Adds the size
Escape	Any dialog	Closes it
Tab, Shift+Tab	Any dialog	Moves round the dialog's controls without leaving it
Down arrow	Staff record, Manager search	Moves from the search box to the first match
Up and Down arrows	The manager matches	Move between names
Escape	Manager search while changing	Cancels the change

Keys in this manual

The manual has its own keys, on the website at /docs and inside the app under Help.

Key	Where	Does
/	Any manual page, when you are not typing in a field	Puts the cursor in the search box
Up and Down arrows	The search results	Move between results
Enter	The search results	Opens the highlighted page, at the matching section when the match was a heading
Escape	The search box	Closes the results

Every manual page also has Print and Copy link in the rail beside the page, on a wide enough screen. A printed manual page leaves off the section tree and the rail.

Printing

Printing uses the browser's own print dialog. Two routes lead there.

• A print page in a new tab opens the dialog after half a second and keeps a Print button for another try. These are the collection or delivery slip (1 to 3 copies), the order form (Print the form on a staff record or a request), the supplier order sheet (Print in the order list, Order sheet on an order) and labels (Print labels on a garment's page).
• A print window carries the document itself: Print on Reports, which prints the selected tab, Print count sheet on Stock › Count, Print credit slip on Counter, and the hand-in receipt. If the browser blocks it, ThreadCount says Pop-up blocked — allow pop-ups for ThreadCount to print.

The label sheet holds 6 labels to an A4 page. From a garment's page it prints one label per garment on hand for each size with a code, after you confirm the number. A single code prints 1 to 24 copies, 6 unless set.

The menu, the mobile bar and the SCAN button are left off a printed screen.

Careful The counter app cannot print. A print page opened there says This app can't print. Open this page in a browser — on the computer at the counter — to print it.