Opqo 24.11.0 adds support for printing labels from an Asset Collection inspection to a Zebra Bluetooth printer that is connected to the mobile device.


To enable Asset Collection label printing, you will need:

  • A supported Bluetooth printer
  • An Asset Collection label configuration



Note: For more information on supported printers, see the support article here.




Asset Collection Label Configuration


Opqo labels are defined in the STAUTOSCRIPT.ZEBRALABEL.LABELCFG automation script.


Note: For more information label configuration in the STAUTOSCRIPT.ZEBRALABEL.LABELCFG automation script, see the support article here.



Asset Collection inspection labels are identified as labels with the following usewith:

  • ASSET: These labels can be made available in Maximo for label printing.  However, these labels are restricted to ASSET attributes only.  Specification attribute values cannot be included in these labels.
  • STAC: These labels will only be available in Opqo.  However, these labels may include Specification attribute values.



Note: The media value for labels printed to Bluetooth printers is not considered when identifying available labels.  It is assumed the user will ensure the appropriate label media is loaded in the printer before printing.



Label Availability


The attributes that are available to the labels are those that are defined in the Asset Collection inspection form.  As these may vary depending on the asset details being collected, Opqo filters the available labels to those where the defined fields in the label exist in the inspection form.


Note that it is only required that the fields exist on the Asset Collection inspection form.  If the user has not entered a value for a field at the time of printing, it will be replaced with an empty value.




Defining Asset Collection Label ZPL


Asset collection labels follow the same approach as other Zebra labels.  The ZPL for the label includes bind variables for Maximo attributes, that are replaced with the corresponding Asset Collection fields at the time of printing.


In order to include values from Asset Specification attributes, the label must be defined with a usewith of STAC.  The values for the specification attributes are included using bind variables with a prefix of SPEC.


For example, the bind variable :SPEC.SIZE would reference the value of an asset specification field with a prefix of STAC:S:SIZE:



Example: ASSET label


The following ZPL defines a label that displays the ASSET.DESCRIPTION attribute above a barcode containing the ASSET.SERIALNUM attribute.

^XA

^FX Description
^CFA,20
^FO50,50^FD:DESCRIPTION^FS
^FO50,120^GB700,3,3^FS

^FX Section with bar code.
^BY3,2,120
^FO50,170^BC^FD:SERIALNUM^FS

^XZ


The above label could be defined with a usewith of either ASSET or STAC, as desired.


This would be included in the STAUTOSCRIPT.ZEBRALABEL.LABELCFG automation script as follows::

var labels = [
  {
    "label": "ASSETLABEL",
    "description": "Asset",
    "media": "3x1.75",
    "usewith": "ASSET",
    "zpl":
      "^XA^FX Description^CFA,20^FO50,50 ^FD:DESCRIPTION^FS^FO50,120^GB700,3,3^FS^FX Section with bar code.^BY3,2,120^FO50,170^BC^FD:SERIALNUM^FS^XZ",
    "default": true
  }
  ...
];



Note: This label will only be available for printing from Asset Collection inspections using forms containing fields with the following prefixes:
  • STAC:A:DESCRIPTION:
  • STAC:A:SERIALNUM:




Example: STAC Label with Specification Attribute Values


In order to include values from Asset Specification attributes, the label must be defined with a usewith of STAC.  The values for the specification attributes are included using bind variables with a prefix of SPEC.


For example, the following ZPL defines a label that displays the values of three specification attributes named:

  • STAGE
  • SIZE
  • CAPACITY


As before, this also includes a barcode with the ASSET.SERIALNUM attribute.

^XA

^FX Asset Specs
^CFA,20^FO50,50 ^FD:SPEC.STAGE / :SPEC.SIZE / :SPEC.CAPACITY^FS
^FO50,120^GB700,3,3^FS^

FX Section with bar code.
^BY3,2,120^
FO50,170^BC^FD:SERIALNUM^FS

^XZ


The above label must be defined with a usewith of STAC.


This would be included in the STAUTOSCRIPT.ZEBRALABEL.LABELCFG automation script as follows:


var labels = [
  {
    "label": "STACCP",
    "description": "Centrifugal Pump",
    "media": "3x1.75",
    "usewith": "STAC",
    "zpl":
        "^XA^FX Asset Specs^CFA,20^FO50,50 ^FD:SPEC.STAGE / :SPEC.SIZE / :SPEC.CAPACITY^FS^FO50,120^GB700,3,3^FS^FX Section with bar code.^BY3,2,120^FO50,170^BC^FD:SERIALNUM^FS^XZ",
    "default": true
  }
  ...
];



Note: This label will only be available  for printing from Asset Collection inspections using forms forms containing fields with the following prefixes:

  • STAC:S:STAGE:
  • STAC:S:SIZE:
  • STAC:S:CAPACITY:
  • STAC:A:SERIALNUM:







If you have questions please do not hesitate to contact us or create a support ticket for more assistance.