Language: Deutsch · English

DataMatrix

GS1 DataMatrix in reports – ZXing, classpath parameter, application identifier and server extension.

HOW-TO APPLICATION DEVELOPER UPDATED: JUL 2026 APPLIES TO NUCLOS 4.2026.X

On this page

DataMatrix per GS1

The goal is a machine-readable java.awt.Image of a valid DataMatrix via ZXing. The bundled DataMatrixWriter suffices for simple cases; for a valid GS1 code small changes to the ZXing source are needed (codeword FNC1 before each variable-length codeword).

Application Identifier

Each data field starts with a 2–3-digit Application Identifier (e.g. (01)) indicating which GS1 data follows.

Classpath parameter

To use it via Jasper, create the parameter nuclos.jasper.reports.compile.classpath.jars.byclasses with this value:

net.sf.jasperreports.engine.JasperReport org.nuclos.server.report.api.JRNuclosDataSource com.google.zxing.BarcodeFormat com.google.zxing.WriterException com.google.zxing.client.j2se.MatrixToImageWriter com.google.zxing.common.BitMatrix com.datamatrixnuc.DataMatrixClass

Data source (application identifier)

The AIs are composed in SQL (example):

'(01)'||t2.intgtin13||'(17)'||to_char(t5.dathaltbarkeitsdatum,'YYmm00')||'(10)'||t5."strchargencode"||'(240)'||t2.strartikelnummer "strnummer"

Embedding the extension

Place the required JARs in <Nuclos>/extensions/server/, run the installer again (or copy the JARs manually to webapp/WEB-INF/lib) and restart the server. Details: Jasper extensions.