BIRT Barcode GS1 128 / EAN 128 Generator Introduction

Top
BIRT Barcode is an Eclipse BIRT Custom Extended Report Item which helps you easily generate and print high quality 1D (linear) and 2D (matrix) barcodes in your BIRT reports.
EAN-128 / GS1-128 Introduction
GS1-128 is an application standard of the GS1 implementation using the Code 128 barcode specification. The former correct name was UCC/EAN-128. Other no longer used names have included UCC-128 and EAN-128. GS1-128 uses a series of Application Identifiers to include additional data such as best before dates, batch numbers, quantities, weights and many other attributes needed by the user.
BIRT EAN 128/GS1 128 Generator - Valid Data Scope
- All 128 characters of ASCII: A-Z, a-z, 0-9, etc
- Values 128-255 in accordance with ISO 8859-1. There are referred to as extended ASCII.
GS1 128 Generators
How to Generate EAN-128 in BIRT Report

Top
Here is a sample to print EAN-128 / GS1-128 in BIRT Report. For more details, view here:
BIRT Barcode Generator - Developer Guide
- Copy com.onbarcode.barcode.birt_2.2.1.jar to your Eclipse plugins directory "\eclipse\plugins\"
- Create a new empty report in BIRT Report barcoding project
- Create a new empty report in BIRT Report barcoding project
- Right click the report item you have added, and select "Properties" menu item to edit barcode parameters
- You will find all barcode properties in the "General" tab. Please note that the values for "Data" and "UPC/EAN Supplement Data" should be arounded by """, unless you are inputting expression
- Change Barcode Type into GS1-128/ EAN-128 in the general tab. Preview the report and an EAN-128 image is printed on your BIRT report
- If you want to encode barcode data from BIRT report data set, you need to input expression to "Data" property like "row["CUSTOMERNUMBER"]"
BIRT Barcode Code 128 Generator - Property Settings

Top
| Category |
Properties |
Value |
Comments |
| Basic
|
Property: Data
|
Type: expression
Default: ""
- If you encode the barcode data text directly, the text string should be around by " " ", such as "12345"
- If you encode the barcode data from dataset, input the expression, such as row["CUSTOMERNUMBER"]
|
Barcode value to encode.
GS1 128 / EAN 128 Valid Data Char Set:
- all 128 characters of ASCII
- values 128-255 in accordance with ISO 8859-1. There are referred to as extended ASCII.
|
|
Property: Add CheckSum Char
|
Type: boolean
Default: false
|
Add CheckSum Char property is not applied here. |
| |
GS1 128 EAN 128 Special |
Property: Process Tilde
|
Type: boolean
Default: false
|
Set the Process Tilde property to true, if you want use the tilde character "~"
to specify special characters in the input data.
|
| |
Barcode Size Related |
Property: Unit of Measure
|
Type: int
Default: 0 (pixel)
|
Unit of meature for all size related settings in the library.
Valid values: 0: pixel; 1: inch; 2: cm.
|
|
Property: X
|
Type: float
Default: 1
|
Width of barcode bar module (narrow bar), default is 1 pixel |
|
Property: Y
|
Type: float
Default: 30
|
Height of barcode bar module, default is 30 pixel |
|
Property: Left Margin
|
Type: float
Default: 0
|
Barcode image left margin size. |
|
Property: Right Margin
|
Type: float
Default: 0
|
Barcode image right margin size. |
|
Property: Top Margin
|
Type: float
Default: 0
|
Barcode image top margin size. |
|
Property: Bottom
|
Type: float
Default: 0
|
Barcode image bottom margin size. |
|
Property: Resolution (in dpi)
|
Type: int
Default: 72
|
Barcode image resolution in DPI (Dots per inch). |
|
Property: Rotate
|
Type: int
Default: 0 (rotate angle in 0 degree)
|
Valid values:
- 0 (rotate angle in 0 degree)
- 90 (rotate angle in 90 degree)
- 180 (rotate angle in 180 degree)
- 270 (rotate angle in 270 degree)
|
| |
Font Style |
Property: Show Text
|
Type: boolean
Default: true
|
If true, display barcode data text under the barcode, otherwise do not display. |
|
Property: Text Font Size
|
Type: int
Default: 11
|
Barcode text font size.
|
|
Property: Text Margin
|
Type: float
Default: 6
|
Space between barcode and barcode data text, default is 6 pixels |
GS1-128 Barcode Basic Characteristics
Encodable Character Set
- Use the ISO/IEC 646 character subset defined in GS1 specifications.
- ASCII characters from 128 to 255 are supported.
- Four function characters: FNC1, FNC2, FNC3, FNC4.
- FNC2 and FNC4 are NOT used in GS1-128.
- Four code set selection characters are supported.
- Three start characters and one stop character are included.
All structural characters are added automatically by the BIRT barcode library.
You only need to provide valid GS1 AI data in the Data property.
GS1-128 Check Digit Character
- GS1-128 uses one mandatory MOD 103 check digit, same as Code 128.
- The check digit is NOT displayed in HRI (human readable interpretation).
- The AddCheckSum property is not applicable for GS1-128.
- The BIRT Report barcode library automatically adds the check digit before the stop character.
GS1-128 Barcode Dimension Size Settings
Configure all size values in the Report Item Property view, aligned with your Master Page rules:
- UOM (Unit of Measure): Choose PIXEL, CM, or INCH.
- X: Width of the narrow bar module (minimum defined by application standards).
- Y: Height of the bar module.
- LeftMargin and RightMargin: Quiet zone (minimum width = 10X).