Plugin download (requires login)

The Barcode plugin allows users to create barcodes (from form data). This plugin is subject to additional charge.

A plugin installation guide can be found here.

Plugin parameters

• Format (Mandatory)
  Selction of the desired barcode format. The following formats are available: UPC-A, UPC-E, EAN-8, EAN-13, CODE 39, CODE 93, CODE 128, ITF, CODABAR, DATAMATRIX, PDF417, QR Code and AZTEC.
• Content (Mandatory)
  The content that should be encoded. It can be generated with placeholders as seen in the figure. The content has to:
  • be non-empty
  • conform to the selected format
  • be the right size. It can not be too big (the max size depends on the format)
• If this is not the case an error will occur during plugin execution.
• Name of output file (optional)
  Name of the image file to be generated. The file extension has to be given. The following file extensions are possible: .png, .jpg, .jpeg, .bmp and .gif. If nothing is defined, "code.jpg" is used as the file name.
• Name of output variable (optional)
  The variable allows access to the image data (Base64 data) of the barcode. The variable name can not contain whitespaces. Other actions can access the image data via this variable, e.g.  Fill Word document or Fill PDF document for including the barcode in documents. The syntax for including the image data for example qr_codeis as follows:
  • Word (Fill): qr_code.b64img()
  • PDF (Fill): qr_code-b64img
• Width (Mandatory)
  Width of the barcode
• Height (Mandatory)
  Height of the barcode

Application examples

Printing a QR code in a PDF document

The procedure here is as shown in the images above. The following actions are required:

1. Execute the Barcode generation action to define the corresponding content and specify the format for the barcode. One option is QR code. The content of the QR code can be an input element, system placeholder such as a form URL or freely assigned text such as a URL.
2. Insert the action Fill Word document or Fill PDF document to create the document. If you have specified a value in the barcode action under "Name of output variable", this must then be used in the print template. As the placeholder returns a base-64 string, the function .b64img() must be executed. An example definition is described above under Name of the output variable.
3. The following action depends on the use case. The file could be sent by e-mail or delivered directly as in the example above.

Display of a QR code in an email

Once again, the Barcode generation action in the workflow must be executed first in order to generate the QR code. Further necessary actions:

1. Execute the Decode Base64 action, as the result returned by the Barcode generation action is a Base64 string. To do this, the RESULT placeholder of the Barcode generation action is copied to the Base64 field.
   The placeholder [%$Barcode generation.RESULT.barcode%] can be selected via the placeholder selection under Workflow (action). The output name can be specified as desired and is barcode.jpeg in this example.
   
2. Insert email action to send the barcode as an attachment. To do this, select Decode Base64 as the file action. To insert this directly as an image, call up the source code view at Contents of the email and insert the following at the chosen position:

   <p><img alt="QR code image from attachment" src="barcode.jpeg" /></p>

   If you switch back to the normal view, the alternative text "QR code image from attachment" appears. In the email itself, the QR code is displayed as an image.