Business Integration Solutions documentation

How to: Set up the label printing element

Solution Center contains the Label Printer Setup pages described in the previous sections.

In Business Integration Solutions, use the LABELPRINTING activity to invoke the APIs of label printing software (Bartender or Loftware) to print labels using data from Microsoft Dynamics NAV.

Select the LABELPRINTING element from the elements list.

Print Label Activity Element

Configure the following settings in the Label Printing element:

Print Label Activity Settings

Field Description
Document No. Document providing the data to use.
Automation Level Select Drop-file Exchange or Automation Interface.
Folder Name Folder to store the file.
File Name File name.
Method Available options: GETLABEL, GETPRINTER, PRINT.
Use Report Override label template with a report.
Report Report number.
Printer Name Printer name or source from document.
Label Name Default label template or source from document.
No. of Copies Number of printed copies or source from document.

Document settings

For printing labels, always set Method to PRINT.

Document No. is of type External and requires the following XML format for the label software (XML is case-sensitive):

<LabelPrinting>
    <LabelData>
        <[field a]>123456789</[field a]>
        <[field b]>12345</[field b]>
        <[field c]>TextTextText</[field c]>
    </LabelData>
</LabelPrinting>

Replace [field a..n] with the field names from the label template configured in the label software.

Label Printing External Document

Label Printing LoftWare Label Loftware label property for ItemNo.

Label Printing BarTender Label Bartender label property for ItemDescription.

You can also include printer settings in the external document (Printer Name, Label Name, and No. of Copies) by selecting a document node in the Printer Settings section.

Override with report

You can print the label using a report instead of the label software. Enable Use Report and enter the report number in the Report field.

Label Printing Override with Report

Notes When using this setting, the label does not print via the label software.

Printer settings

Printing a label requires three settings:

  • Printer Name
  • Label Name
  • No. of Copies

Label Printing Printer Settings

Printer Name determines the target printer. Only printers available on the Label Printers page are valid.

Label Name selects the applicable label layout created in the label software. Only labels available on the Print Label page are selectable.

No. of Copies lets you print several copies in one label print request.

Set these values using Document Node or Default Value. The document node refers to the document selected in this activity and lets you set these values dynamically during the label print call.

Label Printing Document Nodes

Alternatively, set the default value using the available printers and labels from the dropdown.

Notes Default values are always overridden by the document node if the document node contains a value.