QRCode

1. Overview

The Qrcode tool is a powerful utility for generating various types of QR codes and one-dimensional barcodes directly within your workflows. It allows you to convert text, URLs, or product codes into standard image formats like SVG or PNG.

With the GoInsight Qrcode node, you can dynamically create machine-readable codes for a wide range of applications, from product tracking and inventory management to marketing and event ticketing. This includes:

• Generate QR Codes: Create standard QR codes from any text or URL.
• Generate Barcodes: Produce a wide variety of industry-standard barcodes, such as Code 128, EAN-13, ISBN, UPC-A, and more.

2. Prerequisites

Before using this node, you do not need any special accounts or credentials. This is a built-in utility that is ready to use out of the box.

3. Credentials

For detailed instructions on how to configure and manage credentials, please refer to our official documentation: Credentials Configuration Guide.

4. Supported Operations

This node provides operations for generating both QR codes and various types of barcodes.

Summary

Operation Details

QRCode Generate

Generate a QR code from the provided text and return it as an SVG string or Base64-encoded PNG data.

Input Parameters:

• Text: The URL or text content to encode into the QR code.

Options:

• ecl: Error correction level: one of "L","M","Q","H".
• MinVersion: Minimum QR code version (1–40).
• MaxVersion: Maximum QR code version (1–40), must be ≥ MinVersion.
• Mask: Mask pattern: -1 for auto, or 0–7.
• Format: Output format: "svg" or "png".
• Scale: Pixel size of each module, ≥ 1.
• Border: Number of modules for the border, ≥ 0.
• DarkColor: The CSS color value for dark modules in SVG output.
• LightColor: The CSS color value for light modules in SVG output.

Output:

• Data (string): The QR code content: SVG markup or Base64-encoded PNG data.
• Success (bool): Indicates if QR code generation was successful.
• ErrorMessage (string): Error message if generation failed; empty otherwise.

Code 128 Generator

Generate a Code 128 barcode from the provided text and return it as an SVG string or Base64-encoded PNG data.

Input Parameters:

• Data: The string to encode; supports ASCII 32–127.
• Format: Output format, either "svg" or "png".

Options:

• ModulePx: Width of each barcode module in pixels.
• HeightPx: Barcode height in pixels.
• Quiet: Quiet zone width in modules.
• DarkColor: Color for dark bars in SVG output (CSS value)
• LightColor: Color for light areas in SVG output (CSS value).
• AsDataUri: When format is "png", whether to return PNG as Data URI.

Output:

• Data (string): The generated SVG markup or Base64/Data URI PNG data.
• Success (bool): Indicates if barcode generation was successful.
• ErrorMessage (string): Error message if generation failed; empty otherwise.

Code 39 Generator

Generate a Code 39 barcode from the provided text and return it as an SVG string or Base64-encoded PNG data.

Input Parameters:

• Data: The text to encode into the Code 39 barcode.
• Format: Output format, either "svg" or "png".

Options:

• ModulePx: Width of each barcode module in pixels.
• HeightPx: Barcode height in pixels.
• Quiet: Quiet zone width in modules.
• DarkColor: Color for dark bars in SVG output (CSS value)
• LightColor: Color for light areas in SVG output (CSS value).
• AsDataUri: When format is "png", whether to return PNG as Data URI.

Output:

• Data (string): The generated SVG markup or Base64/Data URI PNG data.
• Success (bool): Indicates if barcode generation was successful.
• ErrorMessage (string): Error message if generation failed; empty otherwise.

EAN-13 Generator

Generate an EAN-13 barcode from the provided numeric data and return it as an SVG string or Base64-encoded PNG data.

Input Parameters:

• Data: 12- or 13-digit numeric string; if 12 digits, checksum digit is auto-appended.
• Format: Output format, either "svg" or "png".

Options:

• ModulePx: Width of each barcode module in pixels.
• HeightPx: Barcode height in pixels.
• Quiet: Quiet zone width in modules.
• DarkColor: Color for dark bars in SVG output (CSS value)
• LightColor: Color for light areas in SVG output (CSS value).
• AsDataUri: When format is "png", whether to return PNG as Data URI.

Output:

• Data (string): The generated SVG markup or Base64/Data URI PNG data.
• Success (bool): Indicates if barcode generation was successful.
• ErrorMessage (string): Error message if generation failed; empty otherwise.

GS1-128 Generator

Generate a GS1-128 barcode from the provided text and return it as an SVG string or Base64-encoded PNG data.

Input Parameters:

• Data: GS1-128 AI format input string to encode.
• Format: Output format, either "svg" or "png".

Options:

• ModulePx: Width of each barcode module in pixels.
• HeightPx: Barcode height in pixels.
• Quiet: Quiet zone width in modules.
• DarkColor: Color for dark bars in SVG output (CSS value)
• LightColor: Color for light areas in SVG output (CSS value).
• AsDataUri: When format is "png", whether to return PNG as Data URI.

Output:

• Data (string): The generated SVG markup or Base64/Data URI PNG data.
• Success (bool): Indicates if barcode generation was successful.
• ErrorMessage (string): Error message if generation failed; empty otherwise.

ISBN Generator

Generate an ISBN barcode from the provided numeric data and return it as an SVG string or Base64-encoded PNG data.

Input Parameters:

• Data: ISBN-10 or ISBN-13 string; hyphens and spaces are allowed and will be stripped before encoding.
• Format: Output format, either "svg" or "png".

Options:

• ModulePx: Width of each barcode module in pixels.
• HeightPx: Barcode height in pixels.
• Quiet: Quiet zone width in modules.
• DarkColor: Color for dark bars in SVG output (CSS value)
• LightColor: Color for light areas in SVG output (CSS value).
• AsDataUri: When format is "png", whether to return PNG as Data URI.

Output:

• Data (string): The generated SVG markup or Base64/Data URI PNG data.
• Success (bool): Indicates if barcode generation was successful.
• ErrorMessage (string): Error message if generation failed; empty otherwise.

ISSN Generator

Generate an ISSN barcode from the provided numeric data and return it as an SVG string or Base64-encoded PNG data.

Input Parameters:

• Data: ISSN-8 string to encode; hyphens and spaces are supported.
• Format: Output format, either "svg" or "png".

Options:

• IssueCode: Two-digit issue code
• ModulePx: Width of each barcode module in pixels.
• HeightPx: Barcode height in pixels.
• Quiet: Quiet zone width in modules.
• DarkColor: Color for dark bars in SVG output (CSS value)
• LightColor: Color for light areas in SVG output (CSS value).
• AsDataUri: When format is "png", whether to return PNG as Data URI.

Output:

• Data (string): The generated SVG markup or Base64/Data URI PNG data.
• Success (bool): Indicates if barcode generation was successful.
• ErrorMessage (string): Error message if generation failed; empty otherwise.

ITF-14 Generator

Generate an ITF-14 barcode from the provided numeric data and return it as an SVG string or Base64-encoded PNG data.

Input Parameters:

• Data: 13- or 14-digit numeric string; if 13 digits, checksum digit is auto-appended.
• Format: Output format, either "svg" or "png".

Options:

• ModulePx: Width of each barcode module in pixels.
• HeightPx: Barcode height in pixels.
• Quiet: Quiet zone width in modules.
• DarkColor: Color for dark bars in SVG output (CSS value)
• LightColor: Color for light areas in SVG output (CSS value).
• AsDataUri: When format is "png", whether to return PNG as Data URI.

Output:

• Data (string): The generated SVG markup or Base64/Data URI PNG data.
• Success (bool): Indicates if barcode generation was successful.
• ErrorMessage (string): Error message if generation failed; empty otherwise.

UPC-A Generator

Generate an UPC-A barcode from the provided numeric data and return it as an SVG string or Base64-encoded PNG data.

Input Parameters:

• Data: 11- or 12-digit numeric string; if 11 digits, checksum digit is auto-appended.
• Format: Output format, either "svg" or "png".

Options:

• ModulePx: Width of each barcode module in pixels.
• HeightPx: Barcode height in pixels.
• Quiet: Quiet zone width in modules.
• DarkColor: Color for dark bars in SVG output (CSS value)
• LightColor: Color for light areas in SVG output (CSS value).
• AsDataUri: When format is "png", whether to return PNG as Data URI.

Output:

• Data (string): The generated SVG markup or Base64/Data URI PNG data.
• Success (bool): Indicates if barcode generation was successful.
• ErrorMessage (string): Error message if generation failed; empty otherwise.

5. Example Usage

This section will guide you through creating a simple workflow to generate a QR code for a website URL.

The workflow will consist of three nodes: Start -> QRCode Generate -> Answer.

Step-by-Step Guide

1. Add the Qrcode Node
   • In the workflow canvas, click the + button to add a new node.
   • In the panel that appears, select the "Tools" tab.
   • Find and select "Qrcode" from the list of tools.
   • From the list of supported operations for Qrcode, click on "QRCode Generate" to add the node to your canvas.
2. Configure the Node
   • Click on the newly added "QRCode Generate" node to open its configuration panel on the right.
   • Credentials: This tool is a built-in utility and does not require any credentials. You can skip this step.
   • Parameters: Fill in the required input parameters.
   • Text: Enter the URL you want to encode. For this example, type https://www.goinsight.com.
   • Format (Optional): You can leave this as the default png or select svg.
   • Scale (Optional): To make the QR code larger, you can increase the scale from the default value of 8 to 10.
3. Run and Validate
   • Once all required parameters are filled, any error indicators on the workflow canvas will disappear.
   • Click the "Run" button in the top-right corner of the canvas to execute the workflow.
   • After a successful run, you can click the logs icon in the top-right corner to view the detailed input and output of the node. The Data field in the output will contain the Base64-encoded PNG image of your QR code.

After completing these steps, your workflow is fully configured. When you run it, it will generate a QR code for the specified URL, which you can then use in subsequent steps, such as sending it in an email or saving it to a file.

6. FAQs

Q: Why is the PNG output a long string of text instead of an image?

A: The node returns PNG images as a Base64-encoded string. This is a standard way to represent binary data as text. You can use this string directly in web pages or other applications that support Data URIs. For example, in HTML, you can display the image like this: .

Q: I'm getting an error when generating a specific barcode type. What should I check?

A: Each barcode type has strict rules for the data it can encode. Please check the following:

• Data Format: Ensure the input data matches the required format. For example, EAN-13 and UPC-A require numeric strings of a specific length.
• Character Set: Some barcodes, like Code 128, have limitations on the character sets they support. Make sure your input text is compatible.
• Checksums: For barcodes like EAN-13 or UPC-A, the node can automatically calculate the final checksum digit if you provide the base number. Ensure the length of your input is correct.

Q: What is the difference between the SVG and PNG formats?

A:

• SVG (Scalable Vector Graphics) is a vector format. The image is described using mathematical shapes. This means it can be scaled to any size without losing quality, making it ideal for web use and high-resolution printing. The output is a text-based XML markup.
• PNG (Portable Network Graphics) is a raster format. The image is made up of pixels. While it offers good compression, scaling it up can result in a loss of quality (pixelation). The output is a Base64-encoded string representing the binary image data.

7. Official Documentation

This is a built-in GoInsight utility. For more information on the standards and specifications of different barcode types, you can refer to general resources like the GS1 official website or other barcode information portals.