Label printer integration AE046

General description #

The extension allows you to use templates to define, view, and print labels.

Templates #

Labels can be defined through templates.

You must specify the code and label definition on the template. You can mark a template as the default. The default template is pre-selected automatically when you print the table. To use values from a table, you must specify a table ID and then define its parameters.

Properties #

You can define the network path to the printer directly in the template or in the settings of the user who is printing. The default number of labels is determined by the pre-selected number, which can be changed before printing.

Preview #

The label can be displayed via the "Label Preview" action - for labels with a defined table number, you can then preview a specific record through the "Preview Data Label" action. The action downloads the png label file and allows you to save the image to the label infobox on the right. The image is then visible in the label list. To display the preview correctly, you must specify the width, length, and DPMM according to the printer.

Parameters #

You can define parameters for labels to get data from a table, constants, or the current date and time.

Parameter is specified in the definition with a defined separator on both sides - for example, %TIME%, %DATE%, %TEXT%. An empty resource type allows you to define constant text. The record is to fill in the values from the table selected in the template, the joined table to fill in the values from any other table according to the relationship. The relationship does not necessarily specify only one record, the first record corresponding to the filters is used.

The QR Code type parameter generates a command to display QR code of different sizes depending on the length of the content, it is needed to only place a block in front of it to determine the position, for example ^FO535,15%QRCODE%. The QR code is always generated with an M-level ECC. Set up in a fromat Size_for_version_1[, Size_for_version_2, ..., Size_for_version_10]^CODE_CONTENT. For example: 10,10,9,8,7,6,5,5,5,4^CODE CONTENT. All 10 do not have to have the size filled, if there are fewer of them, the last specified size is used for larger sizes. In Within the content of the code you can refer to other parameters (which are not the type QR Code). For example: 10,10,9,8,7^%ITEMNO%;%SERIALNO%. You can place a check mark in the Allow editing field in the parameter list. You can change the value of a parameter with this checked field when you print. Diacritics options: - Keep as is: Keeps the value unchanged. - Convert: Converts the characters with diacritics to their code representation. - Trim: Removes the diacritics ("¿Qué hora es?" -> "?Que hora es?").

Table relationship #

The relationship must be defined separately.

You can use a constant filter or a value from the source table for filtering.

Print #

You can print table-independent labels by searching for "Print Labels". For dependent labels, you must use an action on the selected pages - such as fixed assets.

When printing, it is possible to select a template, change the number of copies, and select a printer.

The action Mass Print Export on the Label template card page exports the label parameters and their values into an excel sheet. The first row contains the label parameters' codes, the second contains their values. The only parameters being exported are the ones where value of the field Value source is either Record, Linked table or empty. Once exported, the sheet can be modified by adding rows with parameter values.

Action Mass print runs the report Print Label from Excel, on which the user can specify number of copies and printer path. After the sheet is imported, a question displaying the total number of copies is shown and can be confirmed.

Import Export #

Users can import and export selected labels. Importing and exporting labels is possible via the Import export action on Label Template List and Label Template Card.

Setup #

Users can set up a printer to use to print labels (Set up label printers and users). Printers can be added to the system on the Label Printer List page. A printer set up in this way becomes the default printer for label print.

Printer Type #

For Cloud Business Central instances it is necessary to use a printing proxy service. The service runs in the local network and handles print requests. The service is authenticated using OAuth 2.0. For Zebra printers the service can also handle printing using API requests - Cloud Printer Type must be set to API, Printer Path must contain the url where the printer is accessible. For OnPrem instances it is possible to select the OnPrem type and print to any network printer.

Predefined labels by class FA/subclass FA/FA #

Label template can be defined on asset card, list of FA classes, and a list of subclasses.