Table of Contents

Boltrics Print Service

Introduction

The Boltrics print service is a powerful service that can help streamline your printing and communication processes like never before. By installing this service on a local server within your network, you'll gain access to a range of benefits that will help your business operate more efficiently and effectively. One of the key advantages of the print service is that it doesn't require any open incoming ports in your firewall. This means you can use it to print and communicate with printers, scale devices, and SQL databases without having to worry about security issues. Additionally, the print service can retrieve the installed printers directly from Business Central, eliminating the need for time-consuming manual configuration.

With the print service, ZPLs are no longer sent directly to the printer. Instead, they are processed through the standard print queue that is visible in Windows. This ensures that your printing process is more reliable and efficient. And with the printing order managed through a queue in Business Central, you'll be able to prioritize your print jobs more easily than ever before.

Finally, the print service also makes it possible to establish SQL connections with local SQL databases. This feature can be a game-changer for businesses that rely heavily on data analytics and reporting.

In short, if you're looking for a powerful and flexible solution to help improve your printing and communication processes, the print service is the way to go. Below, you'll find more information about the setup process.

Boltrics print service infrastructure

3PL Dynamics Release Management

Minimum Hardware Requirements

  • Windows server 2012 or later
  • Internet connection
  • There are no additional CPU/RAM requirements, this can be very simple.

Minimum Software Requirements

  • Powershell 5.1
  • .NET Runtime 8

Technical Installation

The installation of the print service

Important
  • Run Powershell as Administrator

This PowerShell script installs the latest available version of print service

[System.Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$Url = "https://bpbcdownloads.blob.core.windows.net/software/PowerShellScripts/Install-OnPremAgent.ps1"
Invoke-Expression "$(Invoke-WebRequest -Uri $Url -UseBasicParsing)"

During the script execution, you will encounter several prompts:

  1. You will be asked whether you want to install (clean install), upgrade (only the service itself will be updated), or delete the service.
  2. You will receive a prompt regarding the connection type. The options are Hybrid Connection (Azure Relay) or Kestrel (direct connection). Azure Relay is used for Microsoft Cloud and Boltrics Cloud environments, while Kestrel is used for On-Premise environments.
  3. You will be prompted about updating .NET Core. Please be aware that updating .NET may cause .NET-dependent applications to crash or produce errors.
Note

You will need a Connection String to be able to complete the setup. You will receive the connection string after the initial setup of the Business Central installation.

Update

You can use the installation script

Actual setup when Technical installation is executed

Configuring an agent

First we need to configure the print service. Within Business central search for "OnPrem Agents".

OnPrem Agents

The Code and Description fields can be filled with any values that suit your needs, as long as the Code field remains unique. The Connection String field should resemble a connection string to either an Azure Relay or the service, depending on whether a direct connection is set up. If an Azure Relay is used, Boltrics will provide or fill in the connection string.

If you are using the Azure Relay, you must also fill in the Storage Account field.

Configuring printers

To configure a print server open the view "Print Servers"

Print Servers (OnPrem Agent)

Click on the "New"-button. This will open up the card page for the new print server: OnPrem Agent Print Server Card

  • Fill in a name. Be aware this name will be added to the printer name in "User Printer Selection" later on so maybe keep it short.
  • Fill in a convenient description.
  • Select the onprem agent from the dropdown. Probably the agent created in the previous paragraph.
  • Click on the refresh button. This might take a minute. The service on the local server is queried for the printer installed on that machine.
  • In the list created select the appropriate "Printer Usage". When "None", the default option, is selected the printer can not be selected in "User Printer Selection". For ordinary printing choose the option "PDF". For ZPL label printing select "ZPL" as option for that printer.

Configuring User Printer Selection

In "User Printer Selection" the options for a printer should be setup like a printer using the boltrics print service, but select the printer name from the dropdown. This is also how to setup a ZPL printer. Type should be Web-Service, and maybe fill in the Code if this were used before. This is setup this way to make migration from the Boltrics (Print) Service as convenient as possible.

Scale setup

Open the view "Indicator List":

Indicator List

Creating a new line would take some testing on the settings. For this to work with the onprem agent two fields need to be set correctly. "Communication Protocol" should be set to the option "OnPrem Agent". "Boltrics Service URL" should be filled with the value in the Code field of the OnPrem Agent.

Edit this page