Data Entry Forms

Data Entry Forms allow users to enter values and control label workflows before printing. You can create custom forms directly in the Label Designer, using input fields, dropdowns, checkboxes, buttons, etc.

Forms can be used to collect values such as batch numbers, dates, quantities, or any other data that is not stored in your data source. They can also be used to select printers, choose label templates, and control how printing is performed.

In addition, forms can be used to prepare or generate print data using scripts — for example, by reading external sources such as Excel files or other data inputs.

Depending on your workflow, Data Entry Forms can run independently, appear automatically before printing, or be used for auxiliary tasks such as automation and data processing.

Built-in form

The built-in data entry form is used automatically when no custom form is defined in the label. It provides a simple way to enter values required for printing without creating a custom interface.

You can control which fields are displayed in the form. It can show all fields used in the label, only fields without values, or a user-defined set of fields.

The form can also include a print quantity field, allow setting a default quantity, and optionally repeat the data entry process after each print.

The built-in data entry form is shown before Preview or Print depending on the Data Entry Form setting in the label properties. It can be displayed always or only when required — for example, when some fields used in the label have no values.

The form is displayed as a simple key–value table. The set of fields depends on the label and its settings, and some fields may already contain default values defined in those settings.

Setup

To set up the form, open Label Properties and go to the Print Data Setup → Data Entry tab.

• Field Display Mode. Select which fields the form should display.

  • All fields used in the label. Displays all fields used in the label.
  • Only fields with no value. Displays fields used in the label that have no values.

  • User-defined field list. Displays only the fields defined here. You can also set default values for these fields.

    

• Show Print Quantity Field. Enables a field in the form to specify the number of labels to print.

• Default Print Quantity. Sets the default number of labels to print if no Print Quantity value is provided in the print data.

• Repeat Data Entry after each print. Repeats the data entry form after each print until canceled.

When the form is shown

To configure when the form is shown, go to the Print Data Setup → General tab.

Use the Data Entry Form dropdown to control the form display behavior.

• Auto (show if needed). The form is shown only if print data is not already available.

  A label can receive print data from multiple sources, in the following priority order: Embedded Print Data, Import Data, and Data Entry Form. If print data is already provided by a higher-priority source, the form is not shown.

  When using the REST API, the enableUI flag must be enabled for the form to appear.

• Force (always show). The form is always shown before Preview or Print.

• Deny (never show). The form is never shown.

Custom forms

Custom forms allow you to create fully tailored data entry interfaces using the Label Designer. You can add input fields, dropdowns, checkboxes, buttons, and other controls, and define how they interact with label data and scripts.

Custom forms are part of the label template and can be configured to collect input, modify print data, or trigger actions during label workflows.

Detailed instructions on creating and configuring custom forms will be added in this section.

Using custom forms as standalone

Custom forms can be used as standalone tools, running independently of the main application window. In this mode, a form can be used to collect input, select label templates, prepare print data, and trigger printing or other actions.

Standalone forms are typically launched via Tasks, command-line interface (CLI), or other automation methods.

Detailed instructions and examples will be added in this section.