Printing

Printer configuration

To allow the Connector to recognize available printers on a workstation, a file named application.yml containing the names of all printers that will be used will need to be placed in the <ldc-home> directory (which can be found under Windows (C:)\Users\<user>\AppData\Local\OCLC\localdeviceconnector).
 

To find the names of the printers and create the file:

1. Open the Start menu on your device and search for Microsoft PowerShell.
2. Click the PowerShell icon to launch the program.
3. Type Get-Printer in Windows PowerShell and hit enter.
4. A list of configured printers will appear.
5. Copy and paste the contents of the example application.yml file below into a new Notepad or Notepad++ file:

6. Each printer that should be configured in the Local Device Connector will need to have its own entry in this file. The id field can be freely chosen as long as it is unique and does not include any spaces, but the name field should be identical to the name given in the result of the 'Get-Printer' command.
    

    Caution: Do not include any spaces in the id fields entered in your application.yml file. Including spaces here can prevent the Local Device Connector from launching correctly.

7. Once all printers have been added to this file, save the file under Windows (C:)\Users\<user>\AppData\Local\OCLC\localdeviceconnector with the name application.yml and the file type set to All types.
8. You may need to restart the Connector in order for the printers you configured to show as options in the Console. To stop the Connector, right-click on the Local Device Connector icon in the taskbar and select Quit. Once you have stopped the Connector, double-click the desktop icon to relaunch it.

 Alternative printer configuration workflows

It is possible to configure as many printers as desired in the application.yml file, so it may be more efficient to create the file with all available printers and share the same file across all workstations. Then, when users complete the setup in the Console configuration, they would just need to select the correct printers from the available list instead of creating a new application.yml file for each workstation.

Additionally, it is also possible to retrieve printer information without using PowerShell. If only a few workstations are being configured, staff can retrieve the printer names by viewing the list of configured printers available for selection when printing any file from their workstation as they normally would.

In cases where a large number of workstations across locations need to be configured, staff may want to use an SQL query in the Report processor Queries tab to pull the information from the system configuration stored in the database for each of the workstations. Please see the following example query:

SELECT w.poortid AS 'Workstation',
w.poortoms AS 'Workstation Name',
w.poortvest AS 'Branch',
c.waarde AS 'Receipt Printer',
p.waarde AS 'Additional Printer',
p.sleutel AS 'Style Sheet'

/*Primary port table to get workstation names and branch*/
FROM poorten AS w
/*Join porten_config to get printer names*/
LEFT JOIN poorten_config AS c
ON c.id = w.id
/*Join poorten_printers to see additional printers used for other configured style sheets*/
LEFT JOIN poorten_printers AS p
ON p.id = w.id

/*Only show config for receipt printer names*/
WHERE c.sleutel = 'receiptprinter.name'

LIMIT 999;

 Note: This SQL option will only work with workstations that have already been using the Wise Client - any new workstations being used only with the Console will need to use one of the other workflows outlined above.

Optional cash drawer configuration

Optionally, when a printer is connected to a cash drawer, you can configure a cash drawer too. The cash-drawer property takes either a preset or a command, not both. Use preset when the printer is manufactured by EPSON or STAR. Use command in other cases. A command is a non-empty semicolon-separated sequence of bytes, where each byte is represented by two hexadecimal characters.

Configuration with Cash Drawers

devices:
    - id: ticketprinter
      name: Epson TM-T88IV Receipt
      cash-drawer:
        preset: EPSON
    - id: alternativeticketprinter
      name: Brother X-5567l5
      cash-drawer:
        command: 27;AB;00;27

Console configuration

When the Local Device Connector is first recognized in the Console a pop-up will appear with the message "The Local Device Connector has been installed, but needs to be set up before use". Click OK on the message pop-up to proceed with enabling the Connector and configuring your settings.

To enable or disable the Local Device Connector, use the toggle and click Save changes at the bottom right of the screen.  Disabling the Local Device Connector will revert your printing settings to browser printing and any further output for printing will be via .pdf.

Once you have enabled the Connector two pop-up messages will appear. The first confirms that the configuration settings were saved to the database and the second that a connection has been established between Wise and the Connector. Click OK on both messages to dismiss them.