Native ASPX Barcode Generator Script User Manual

Buy License Support Download Demo Release Log

Installation Tutorial

The ASPX Barcode Generator is a server-side VB ASPX script that adds barcode generation capability to any ASPX-compatible website or hosting provider. After the script file is copied to the host, barcode images may be generated simply by calling the ASPX file. This script also enables barcodes to be easily added to report-generating applications. Legacy VB.ASP files are also provided for Code 128, Code 39, and ITF.

  1. Unzip the downloaded product file and copy the needed files to an ASPX-enabled webserver. Each file contains the name of the supported barcode symbology. When unsure which barcode file to use, consider idautomation-code128.aspx which allows Code 128 and GS1-128 ASPX barcode generation.
  2. Open the file in a browser window and verify that a default barcode appears. If it does not, verify that the files are installed in the proper folder on the server and confirm that ASPX script processing is active in the folder where the file resides.
  3. Integrate the resulting URL into your web application as a dynamic IMG tag and add the D= parameter for the data that is being encoded. IDAutomation offers several Streaming Integration Guides for several types of applications. 
  4. Refer to the barcode script parameters to modify the barcode to include additional parameters. For example, the following parameters encode the text "123456", enable the optional check digit in Code 39, and set the bar height to 30 pixels:
    https://www.bcgen.com/aspxscripts/idautomation-code39.aspx?D=123456&CC=T&BH=30

The purchased version of this product does not contain a watermark. If it is desired to have a watermark in the purchased version, the demo portion of the code may be edited to enable this feature with a text message. For example:

Const Demo as Boolean = True
Const DemoText as String = "My Message"

Encoding GS1 DataBar

Four types of GS1 DataBar symbologies are provided: GS1 DataBar Omnidirectional, GS1 DataBar Stacked Omnidirectional, GS1 DataBar Expanded Omnidirectional, and GS1 DataBar Expanded Stacked Omnidirectional. These are also referred to as the DataBar POS symbols.

  • idautomation-databar.aspx and idautomation-databar-stacked.aspx
    The DataToEncode is 14 digits. The last digit in the DataToEncode is the check digit. If unknown, enter 0 for the check digit. If 14 digits are not entered, zeros will be added to the beginning of the data.
  • idautomation-databar-expanded.aspx
    The DataToEncode for this barcode type prefers parentheses around each AI in the barcode. For example: "(01)" & ({DataTable.GTIN}) & "(3202)00750(15)441231". GS1 DataBar Expanded (not stacked) symbols are created by setting the segments (SG) property to 22. GS1 DataBar Expanded Stacked symbols are created and sized by setting the segments (SG) property to a low even number such as 4, 6, or 8.

Parameters

Unless specific requirements dictate otherwise, consider using default values for all properties.  Each symbology has an individual ASPX script. The Linear package includes files for Code 128 (with character sets A, B, and C), GS1-128, GS1 DataBar, Interleaved 2 of 5, MSI, and USPS IMb. The Linear Plus 2D package also includes QR Code, Data Matrix, and PDF417.

Purpose Parameter Default Description
Apply Tilde PT F When True in Code 128 with the Auto character set, the format ~??? may be used to specify the ASCII code of the character to be encoded and several other ApplyTilde Options are enabled including encoding of GS1-128 AIs.

*Valid in idautomation-code128.aspx only
Bar Height BH 40 The barcode height in pixels. The default value of 40 generates a symbol that is about 0.4" tall.
Check Character CC T* Automatically adds the check digit to the barcode when equal to "T".

*The default in Code-39 is F. To create a LOGMARS barcode, this must be set to True.
Check Character in Text CT T Automatically adds the check digit that is encoded in the barcode to the human-readable text that is displayed when equal to "T".
Data Encoded D na The data that is to be encoded in the barcode.
Font Size FS 12 The font size used for human-readable text.

*Only values of 10 and 12 are applicable. Any other values must be implemented manually by displaying a text field below the barcode.
Image Type I BMP The image type streamed. Valid values are BMP, PNG, JPG, and JPEG. The BMP image type has a 1-bit depth and is usually smaller in size than PNG or JPEG images. Only available in version 2019 and greater.
Narrow to Wide Ratio N 2 The narrow-to-wide ratio of symbologies that only contain narrow and wide bars such as Code 39, Interleaved 2 of 5, and MSI. Valid values are 2 and 3.
Orientation O 0 The orientation of the barcode. Valid values are 0, 90, 180, and 270.
Quiet Zone Q 1 The margin around the symbol.
ShowText ST T If set to F, the human-readable text interpretation will not be displayed with the barcode.
XDimension in pixels X 1 The number of pixels to define the overall barcode width. Default = 1 which is 1/96 of an inch and about 12 MILS. Valid values are 1-8.
GS1 DataBar Specific Parameter Default Property Description
Segments SG 6 Common values are 4, 6, 8, and 22. The setting of 22 disables the stacked capability.
Data Matrix Specific Parameter Default Property Description
Process Tilde PT T When set to "F", the tilde "~" functionality will not be processed. As explained in the Data Matrix FAQ, the tilde is used for GS1-DataMatrix and encoding ASCII codes.
Encoding Mode MODE -1 The Encoding Mode for data being encoded. Valid parameters are -1=Automatic, 0=BASE256, 1=C40, 2=TEXT and 3=ASCII. To encode GS1-DataMatrix, ensure MODE is set to -1 or 3.
Preferred Format PFMT 0 Sets the preferred format represented by a number; valid values are from 1 (10X10) to 24 (144X144) and from 25 (8X18) to 29 (16X48); the default value of '0' is used for automatic formatting. If the component needs more space to create the symbol, this property will be ignored.
PDF417 Specific Parameter Default Property Description
Apply Tilde PT T When true, the format ~??? may be used to specify the ASCII code of the character to be encoded.
Columns COL 0 The number of data columns in the symbol. 0 = automatic.
Error Correction Level ECL 0 The amount of error correction in the symbol. The default setting of 0 performs an automatic selection.
Mode MODE B The mode of compaction used to encode data in the symbol. Valid values are "B" for Binary or "T" for TEXT.
Truncation TRN F A truncated PDF417 symbol is more area-efficient.
X to Y Ratio XYR 3 The X multiple height of individual cells.
QR-Code Specific Parameter Default Description
Process Tilde PT T When set to "F", the tilde "~" functionality will not be processed. As explained in the QR-Code FAQ, the tilde is used for GS1-QRCode and encoding ASCII codes.
Error Correction Level ECL M The level of error correction. Valid values are L, M, Q & H.
Encoding Mode MODE B The Encoding Mode. Valid values are B (binary), A (alphanumeric), and N (numeric).
Process Mask PM T When set to F the mask is not optimized, which will improve processing time when generating many barcodes at the same time.
Version V 1 The version of the symbol. Setting this value to -3 can generate a Micro QR Code symbol.

Only commonly used parameters are included in the ASPX Barcode Generator Script files to ensure quick and efficient barcode generation. If additional properties or symbologies are needed, such as DataBar, Aztec, or Maxicode, consider one of IDAutomation's other Streaming Barcode Generators that contain more functionality.

Technical Support Issues

Free product support may be obtained by reviewing the knowledgebase articles documented below and by searching the resolved public forum threads or the stream-barcode tag. Priority phone, email, and forum support are also provided via several contact methods within 30 days of purchase. Support after this complimentary period may be received with an active Level 2 Support & Upgrade Subscription.

Common Solutions