Automatic printing via the Ongoing Printer Service

Table of contents

Introduction

If you want Ongoing to be able to trigger automatic printouts on printers in your warehouse, the Ongoing Printer Service needs to be installed on one of your servers. The Ongoing Printer Service is a small service which polls your Ongoing system for files to print. Once a file to be printed is retrieved it will be sent to the specified printer.

This guide covers the installation of the Ongoing Printer Service and provides a brief description of how it works. To read more about how printing in Ongoing works generally, please see this guide.

Description

The Ongoing Printer Service uses the SOAP API of Ongoing. The service will poll the API, checking if there are any files to print. Once handling the result it the service will wait for 50 milliseconds before polling again, ensuring that all created to be printed are printed as fast as possible.

When the API returns a list of files to be printed, the service will loop through all the files and add them to the print queue. The print queue sends each file to the printer specified by rules set in Ongoing. This information is retrieved together with the files to be printed then polling the API.

The service writes errors to the Windows Event Log (EVT). If an error occurs the service thread will pause for one minute before resuming.

Note that the only time the file that is retrieved for printing is saved to the server is when the service configuration is set up to log printed files to disk. The default behavior is not to log printed files to disk.

Prerequisites

The server needs to fulfill the following:

Installation

Ask your contact at Ongoing to send the installation files and credentials to you. Run the installer and follow the instructions. Make sure that “Launch the program” is checked.

The configuration application (WMS.ClientInstaller.exe) will start and you can enter print service credentials and URL which you got from your contact at Ongoing. You can start the application to reconfigure or remove the service at any time.

When you press save you will see a popup asking for Service Login if the service is being installed for the first time or was previously removed.

Enter your computer login credentials here:

The application will close if the installation succeeded.

In the Event Viewer you can see that the service has started:

You can also see if any errors are reported:

The printers which you intend to use must be installed on the computer where the service is installed, even if it is as network printer. The printers are identified by name. Which printer is used for which report is configured in Ongoing WMS. If no configuration is made for a report, then the default printer will be used.

Printer Settings

Find connected printers

Before you start the set up you should make sure your printer service is connected and that it has access to all the printers you want to use. Go to “Connected printer services” from Settings ⇒ Printer settings.

You will find all connected printer services. If you press select you can see what printers the service has access too. The Printer Name will be used as the printer path in the next step.

Add printers in Ongoing

If you want to use printer types, e.g. for separating you have to create them before you add your printer. To add a printer, press “Printers” and fill in a name you want to call the printer in Ongoing and the printer path (you find this as the printer name from connected printers in the last step)

Add computers

Computers can be selected when a user logs in to Ongoing. To activate this function, contact your contact person at Ongoing. Add the computers that should be available to select at log in under “Computers”. Once you have added computers you can use this as a parameter when setting up the printer settings. Computers do not have to be set up to match a specific physical device, you can also use them as a group. You can e.g. set up a computer called Computer Group A and all users in zone A should log in as Computer Group A. You can then have a setting to set all devise logging in as Computer Group A to print at printer A.

Create a setting

You will create at least one setting per printer that you want to use. The setting parameters are set to specify when that printer should be used. You can set up multiple settings for a printer to cover all cases when the printer should be used. You might want to set up a default setting, valid for all printer types, users, computers and reports so that if none of your settings will suit a specific case the report will be printed on that printer, see example below.

If a user has not selected a computer when logging in, setting id 4 will be used and the report will be printed on Printer A. Setting id 4 will be valid for all cases, but since it has the highest priority number it will only be used if there is no other setting matching the setting criteria.

Users logged in as Computer A will be printed on Printer A (setting id 1) and users logged in on Computer B will be printed on Printer B (setting id 2) for all report except “Inbound Note”: This scenario fits in to both setting id 2 (Computer B, all reports) and Setting id 3(Computer B, report “Inbound Note”). Since setting id 3 has a lower priority number, this setting will be selected, and the report will be printed on printer A.

Test your settings

You can run a test to se what printer will be used for a specific case by using the “Printer name per report test.” You will fill in a specific case/ specific cases and you will see what printer that will be used for each case. Make it a habit to run a test whenever adding a new setting.