Table of contents
- Printer settings
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.
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.
The server needs to fulfill the following:
- It needs to run Windows and have the .NET framework installed.
- It needs access to the printers which you intend to use.
- It needs internet access. In particular it needs to be able to establish connections to ports 80 and 8084.
You need to create a (free) user with Permission level "Printer service", in your Ongoing WMS. You can do this under Settings ⇒ Users.
There is a download link for the installation file under Settings ⇒ Printer Settings in your Ongoing WMS. 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 the previously created print service credentials and the URL to your Ongoing WMS. 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, the same ones you use to log in to Windows. If you are unsure about what username to use it is displayed at the bottom of the window in the previous step after "Current user: ". In the example above the username should be "O8\Ongoing".
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.
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)
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.
- Printer: Select the printer you want to set up a setting for.
- Priority: Priority is used to select which setting should be used if more than one setting is setup for a specific case. The setting with the lowest priority will be used.
- Printer type: select if the setting should be used for all or some specific printer type.
- Users: select if the setting should be used for all or some specific users.
- Computers: select if the setting should be used for all or some specific computers.
- Reports: select if the setting should be used for all or some specific reports, e.g. to printet labels on label printers.
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.