Create and update a Printer

In KanbanBOX, it is possible to configure one or more printers, and then direct the printing of cards to the most appropriate one. It is also possible to set a default printer for KanbanBOX different from the system default (for example, the system default printer has a print size of A4 210 x 297 mm, while the KanbanBOX default printer has a size of 95 x 60 mm).

Adding a Printer

1. Go to Print > Add Printer.
2. KanbanBOX will perform an initial check to verify that the QZ-Tray software is installed on the PC. See Linking with QZ-Tray.
3. Fill in the fields of the form to configure the printer.

For all printers

Field	Options	Definition
Type	1. Network Printer 2. Local Printer	Allows you to choose the type of printer to configure. 1. Must be connected via IP address. Available with any type of sharing. 2. Uses those installed on the PC and searches for them by "name". Available only with Sharing = Personal.

Network Printers

Field	Options	Definition
Name	-	Identifier with which the printer will be identifiable in the "Printers" table and usable in the "Selection Rules Printing Method".
Host	-	IP address of the network printer.
Port	-	Port for connection to the network printer (standard: 9100).
Protocol	ZPL	Printer language, currently only ZPL is available. As network printers, only those that support the Zebra Programming Language (ZPL) can be used. This limitation is due to the QZ-Tray software.
DPI	-	Dots per Inch (printer factory setting)
Print Darkness	0-100%	Indicates how dark the print will be. In thermal transfer printers, it can help prevent ribbon burning.

Local Printers

Field	Options	Definition
Name	-	In this dropdown menu, all printers installed on the current device will be listed. However, the correct functioning of QZ-Tray is still necessary.
Protocol	1. ZPL 2. Standard	1. For printers that support the ZPL language (can receive any custom ZPL commands). 2. For other printers.
Rasterization	Yes/No	By enabling this option, vector PDF files generated by KanbanBOX for printing will be converted to bitmap before sending to the printer.
Content Resizing	Yes/No	By enabling this option, in cases where the print content is smaller than the total label width, it will automatically scale until filling the print area.

Printer Selection Rules

The Printing Method Selection Rules allow the user to choose which printing action to use when KanbanBOX processes the printing of a card, based on certain parameters.

If no "printing method selection rule" is active, or the card you want to print does not meet the parameters of any active printing rule, the default action will be to open the PDF in a popup.

1. Go to Print > Printer Selection Rules.
2. Click on New Rule.
3. Fill in the fields of the form to configure the printer.

Field	Options	Definition
Rule Type	1. Specific User 2. Specific Container 3. Specific Customer 4. Specific Supplier 5. Specific Filter 6. Specific Template 7. Card Type 8. Supplier Type 9. Customer Type 10. Link Type 11. All cards	Through the dropdown menu, you can choose by what criterion the printing rule should be processed. For each of these options, except "All cards", selecting them will display a new dropdown menu with various available choice options. 1. Specific User: the rule is applied only when the user requesting the print is the one specified in the rule. 2. Specific Container: the rule is applied only when the container indicated on the card matches that specified in the rule. 3. Specific Customer: the rule is applied only when the customer of the link matches that specified in the rule. 4. Specific Supplier: the rule is applied only when the supplier of the link matches that specified in the rule. 5. Specific Filter: the rule is applied only when the card to be printed falls within the filter specified in the rule. 6. Specific Template: the rule is applied only when the template of the card to be printed matches that specified in the rule. 7. Card Type: the rule is applied only when the type (reusable, disposable) of the card to be printed matches that specified in the rule. 8. Supplier Type: the rule is applied only when the type of supplier (external, internal) of the link matches that specified in the rule. 9. Customer Type: the rule is applied only when the type of customer (external, internal) of the link matches that specified in the rule. 10. Link Type: the rule is applied only when the link type (purchase, movement, production, sale) matches that specified in the rule. 11. All cards: the rule applies to any card printed within the license.
Action Type	1. Download PDF File 2. Open PDF File in Browser 3. Open PDF File in New Window 4. Open PDF File in Popup Window 5. Send to Configured Printer 6. System Default Printer	This option allows you to choose which action to trigger when KanbanBOX processes a print. 1. Download PDF File: Download the file to the PC. 2. Open PDF File in Browser: Redirect to the PDF viewing page. 3. Open PDF File in New Window: Opens a new browser window containing the PDF view. 4. Open PDF File in Popup Window: Without leaving the page, opens a popup on the screen containing the PDF view. 5. Send to Configured Printer: allows you to choose from the configured printers, through another dropdown menu that appears subsequently. 6. Direct Print: Print via QZ-Tray using the default printer set in the operating system.
Rule Status	1. Disabled 2. Enabled	Allows you to choose whether to keep the rule Enabled or Disabled in the license, at the time of creation or modification.

Print Queue Grouping

The print queue is grouped by:

• Template

• Printing Action

• Printer (if present)

Linking with QZ-Tray

To help the user understand whether the system is working correctly or not when printing via QZ Tray, KanbanBOX checks the connection with the software in two phases.

1. Adding a Printer

When creating a new printer, KanbanBOX checks the availability of the software.

a. QZ-Tray connection check

b. QZ-Tray is installed and connected

c. QZ-Tray is not installed or cannot connect to KanbanBOX

2. Printing Process

An indicator has been added to the board that appears only when QZ Tray is actually used to launch a print, and it indicates the following states:

a. Print in launch phase

b. Error in print launch

c. Print successfully launched

The indicator automatically disappears after a certain number of seconds.