CIB barcode technischer Leitfaden

1. Lieferumfang

2. Einführung

CIB barcode ist ein vielfältiges und leistungsfähiges Modul (des CIB format) zur Erstellung von Barcodes innerhalb von Dokumenten. Es genügen der Barcodetyp und die im Barcode zu enthaltene Zeichenfolge, schon wird der Barcode erstellt. Unterstützt werden die gängigsten Barcodetypen, z.B. ITF,OMR und Code 39.

Der Barcode oder Strichcode ist eine einfache und kostengünstige Möglichkeit, z.B. Waren für die Erfassung und Auswertung durch einen Computer direkt zu identifizieren. Die Identifikationsdaten können als Barcode codiert und auf Tickets, Verpackungen usw. gedruckt werden. Je nach Verwendungszweck werden die Barcodes mit z.B. unterschiedlichen Scannern gelesen und von einem Computer übertragen. Die ständige und papierlose Verfügbarkeit von Bestandsdaten stellt eines der vielen Vorteile der automatischen Ablesung der Barcode-Informationen dar.

Der Aufdruck von Barcodes auf Druckstücke oder die Einbettung von Barcodes in Dokumente kann auf verschiedene Weisen gelöst werden. In der Regel sind dabei dynamische Barcode gefordert, das heißt solche, deren Darstellung erst zur Laufzeit ermittelt wird. Beispiel:

Die dynamische Erzeugung des Strichmusters oder der Symbolcodes kann dabei während der Datenbereitstellung, beim Rendern der Druckausgabe, während dem Erzeugen der Ausgabedatei oder sogar erst zwischen dem Erzeugen des Druckerdatenstroms und dem eigentlichen Ausdruck gefordert sein.

Hieraus ergeben sich folgende konkrete Fragestellungen:

• Was sind Barcodes, welche gibt es?
• Wie können sie dynamisiert werden?
• Wie erfolgt die Erzeugung des Strichmusters/Symbolcodes zum geforderten Zeitpunkt?
• Wie muss CIB format/barcode dafür benutzt werden?

Der vorliegende Leitfaden beschreibt kurz die erforderlichen Eigenschaften für CIB merge und CIB format/output.

Beim Leser werden Kenntnisse über den Gebrauch von CIB merge und CIB format sowie über das RTF-Format vorausgesetzt.

3. Zusammenfassung

Zunächst wird erläutert, wie die Einbettung von dynamischen und statischen Barcodes in Dokumente aus Anwendersicht funktioniert und welche Voraussetzungen beim Gebrauch erfüllt sein müssen.

Anschließend wird der Begriff Barcode eingeführt und abgegrenzt sowie die relevanten Standards dargestellt. Es wird beschrieben, wie die Barcodes im RTF abgelegt sein können.

Zuletzt folgt ein Entwurf der an CIB merge und CIB format/output erforderlichen Änderungen und Erweiterungen.

4. Gebrauch

Dieser Abschnitt beschreibt die Erzeugung von Dokumenten, die dynamische Barcodes enthalten mit CIB format/output (Komponente innerhalb der CIB docgen Module). Nach der Kurzdarstellung des prinzipiellen Ablaufs werden zu jedem Schritt die Barcodethemen beschrieben.

4.1. Begriffe

4.2. Ablauf

Zunächst werden Rohtexte (Textbausteine, Formulare und Textschablonen) mit einem RTF-fähigen Textverarbeitungssystem erstellt.

Die in den Rohtexten einzufüllenden dynamischen Daten werden von der Anwendung bereitgestellt. Alternativen zum dynamischen oder statischen Barcode:

• Unter den bereitgestellten Daten ist auch der Barcodewert.
• Die Anwendung stellt eine eigens generierte Barcodegrafik als Grafikdatei bereit, die an der entsprechenden Stelle im Dokument verknüpft ist.
• Die Anwendung nutzt eine CIB format Schnittstelle um den Barcode von außen auf das Dokument aufzubringen. Spezielle Platzhalter im Dokument sind dann überhaupt nicht erforderlich.
• CIB merge mischt pro Auftrag einen Rohtext (Wurzelbaustein) mit davon aufgerufenen weiteren Textbausteinen und den dynamischen Daten zu einem Ergebnisdokument.
• Der Barcodewert wird über ein REF-Feld in das Dokument eingesetzt. In diesem Fall ist das REF-Feld mit einem Barcodefont formatiert. Dies hat den Nachteil, dass das REF-Feld nicht mehr als REF-Feld erkannt wird. Der Vorteil ist, dass hierdurch gleich eine Art Beispielstrichcode sichtbar wird.
• Der Dateiname der Barcodegrafik wird in das Dokument eingesetzt.
• Es wird ein dynamisch generierter Barcode von CIB format angefordert, indem eine spezielle Anweisung (siehe Abschnitt CIB format) im Rohtext hinterlegt wird. CIB merge ignoriert diese Anweisung und setzt den Barcodewert ein.
• CIB format liest das Ergebnisdokument, positioniert den Barcode geeignet und führt den Zeilen- und Seitenumbruch durch (interne Dokumentstruktur).
• Ist der Barcodewert mit einem Barcodefont formatiert, so fügt Format die entsprechenden "Zeichen" in die Dokumentstruktur ein.
• Eine referenzierte Barcodegrafik wird als Bild in die Dokumentstruktur aufgenommen.
• Die im Dokument enthaltene spezielle Anweisung (siehe Abschnitt CIB format) fordert CIB format auf, eine Barcodegrafik dynamisch im Speicher zu erzeugen und zu positionieren.
• CIB output (PDF, PCL, Postscript, Tiff, usw.) erzeugt aus der internen Dokumentstruktur ein Ergebnisdokument im Ausgabeformat bzw. erzeugt den Ausdruck.
• Die benötigten Zeichen des Barcodefont werden ggf. in die Ausgabedatei eingebettet.
• Die Barcodegrafik wird in das Ausgabedokument eingefügt.
• Die dynamisch generierte Barcodegrafik wird ausgegeben.

5. Barcodes und OMR Strichcodes

Dieser Abschnitt enthält die relevanten Fakten zu Barcodes.

Barcode ist eine Abfolge von dicken und dünnen Linien und spezifizierten Abständen dazwischen, die zusammen eine numerische oder alphanumerische Information beinhalten.

Solche Barcodes werden als eindimensional bezeichnet. Es gibt auch zweidimensionale Barcodes, wo Informationen über Matrixpunkte codiert sind.

Der OMR-Strichcode ist eine Menge von kurzen horizontalen Linien, die auf der rechten oder linken oberen Papierhälfte einer DIN A4 Seite ausgegeben werden. Sie werden von Kuvertiermaschinen ausgewertet.

OMR-Strichcodes beeinflussen das Verhalten von Kuvertiermaschinen. Die Maschinen selektieren hierüber mehrere verschiedene Dokumente für einen Adressaten und kuvertieren sie. Jeder einzelne OMR-Strichcode kontrolliert eine Funktion der Maschine.

Die Bedeutung von OMR Strichcodes sind auch sehr stark Hersteller- bzw. Hardwareabhängig.

CIB format behandelt den OMR-Strichcode wie einen Barcode.

5.1. Einführung

"Menschenschriften" können von Computern nur sehr schwer gelesen werden. OCR Schriften können von Menschen und Computern nur schwer gelesen werden. Deshalb wurde der Barcode entwickelt. Barcodes sind eine einfache Reihe von dünnen und breiten Linien die alphanumerische Informationen darstellen. Der Computer "sieht" eine Art "Morse-Zeichen" von lang und kurz.

Über die letzten Jahre wurden diverse Barcode Schriften entwickelt die alle bestimmte Vorteile und Nachteile haben. Bei der Wahl der richtigen Schrift ist es wichtig darauf zu achten eine standardisierte Schrift zu wählen, die sowohl vom Drucker als auch vom Leser unterstützt wird.

5.2. Barcode Typen

Es sind zahlreiche Barcode Typen definiert. Diese sind entstanden aufgrund unterschiedlicher Anforderungen. Entsprechend den speziellen Erfordernissen kann also für jede Anwendung der am besten geeignete Barcode Typ ausgewählt werden. In diesem Abschnitt werden nur die derzeit geforderten kurz beschrieben.

Code ITF (Code 2/5 Interleaved)

Interleaved Two of Five / Code 2/5 Interleaved.

Der Code 2/5 Interleaved (interleaved = überlappt) ist ein Zweibreitencode mit einem Zeichenvorrat von 10 Ziffern (numerischer Code). Er beinhaltet somit nur die Ziffern 0 bis 9. Die Stellenzahl kann beliebig lang sein, muss aber geradzahlig sein. Die Verwendung von Prüfziffern ist nicht vorgeschrieben. Der Urtyp des Codes verwendet keine Prüfsumme. Er bietet, ähnlich dem Code 39 den Vorteil der Selbstprüfung. Es werden ein Start- und ein Stopp-Zeichen verwendet. Die Länge ist variabel. Er ist eine Variante des Code 25.

Dieser Code ist aufgebaut aus 2 breiten und 3 schmalen Strichen, bzw. 2 breiten und 3 schmalen Lücken. Druckverhältnis V: schmales Element : breites Element V = 1 : 2 bis 1 : 3. Ist das schmale Element kleiner als 0,5mm, dann gilt: schmales Element : breites Element V = 1 : 2,25, bis max. V = 1 : 3. Zwei Ziffern bilden immer ein Paar. Die erste Ziffer wird dargestellt mit 5 Strichen, die 2. Ziffer mit den unmittelbar den Strichen der 1. Ziffer folgenden Lücken. Fünf Striche und Lücken stellen ein Ziffernpaar dar. Zielsetzung ist es durch eine paarweise Darstellung der zu codierenden Ziffern eine Platzersparnis zu erhalten. Hieraus ergibt sich eine hohe Informationsdichte z.B. 2,7 mm/Ziffer bei einer Modulbreite X = 0,3 mm und Verhältnis V = 1 : 3.

Vorteil: Hohe Informationsdichte, selbstprüfbar.

Nachteil: Alle Lücken tragen Information, deshalb kleine Toleranz (gute Druckqualität erforderlich); sowie die paarweise Darstellung der Nutzzeichen (kann jedoch umgangen werden indem man dem Code eine Null voranstellt).

Achtung:
Wenn der Barcode-Wert aus einer ungeraden Anzahl von Zeichen besteht, wird durch den Modul CIB barcode die Zeichenzahl durch Voranstellen einer „0“ geradzahlig gemacht. Es erfolgt kein Fehlerhinweis an den Benutzer.

Code 2/5 Industrie

Dieser Barcode ist ein Zweibreitencode, mit dem die Ziffern 0 bis 9 dargestellt werden können. Die Anzahl der Zeichen ist variabel, die Verwendung von Prüfziffern ist nicht vorgeschrieben. Vom Urtyp des Codes werden keine Prüfsummen genutzt. Es werden jeweils ein Start- und ein Stoppzeichen verwendet.

Der Code findet seine Hauptanwendung in der Industrie und ist auch als Code 2 aus 5 bekannt. Der Code ist mittlerweile recht alt und primitiv, dies äußert sich negativ in seinem Platzverbrauch. Deshalb findet der Code heutzutage kaum noch Verwendung.

Der Code 2/5 Industrie ist aus 2 breiten und 3 schmalen Strichen aufgebaut. Nur die Striche sind codiert, die Lücken tragen keine Information. Druckverhältnis V: schmaler Strich : breitem Strich  V = 1 : 2 bis 1 : 3; (Verhältnis: 3:1 (empfohlen), (auch 5:2 oder 2:1 (High Density) möglich.)
Codeaufbau: Ruhezone, Startzeichen, Nutzziffern, (Prüfziffer,) Stoppzeichen, Ruhezone; Prüfziffernverfahren: Standard (Modulo 10 mit der Gewichtung 3)

Vorteil: besteht nur aus Strichen, Lücken tragen keine Information. Grosse Drucktoleranz (+/- 15%), deshalb auch mit den einfachsten Druckverfahren herstellbar, selbstüberprüfend

Nachteil: Kleine Informationsdichte

Code 2/5 Matrix

Dieser Code ist mit der Ausnahme der überbreiten Balken ein Zweibreitencode, mit dem die Ziffern 0 bis 9 dargestellt werden können. Die Anzahl der Zeichen ist variabel. Im Start- und Stoppzeichen befindet sich ein überbreiter Balken. Die Verwendung von Prüfziffern ist nicht vorgeschrieben.

Code 39

Alphanumerischer Code. Darstellbar 0 bis 9, 26 Buchstaben (Großbuchstaben!), 7 Sonderzeichen. Der Zeichenvorrat ist somit 0123456789[Space]ABCDEFGHIJKLMNOPQRSTUVWXYZ-.$/+%. Der Code besitzt keine feste Länge.

Die Prüfziffernberechnung erfolgt nach Modulo 43. Alle Zeichen eines Codes werden Referenzzahlen zugeordnet, welche zu einer Summe addiert werden. Diese wird durch 43 dividiert. Der Rest der Division entspricht der Prüfsumme.

Jedes Zeichen besteht aus 9 Elementen (5 Strichen und 4 Lücken). 3 der Elemente sind breit und 6 schmal, mit Ausnahme der Darstellung der Sonderzeichen. Dies erlaubt die Selbstprüfung des Codes. Die Lücke zwischen den Zeichen (als Trennung) ist ohne Information. Druckverhältnis V: schmales Element : breitem Element V = 1 : 2 bis 1 : 3. Ist das schmale Element kleiner als 0,5mm, dann gilt schmales Element : breites Element V = 1 : 2,25, bis max. V = 1 : 3. Die erste Ziffer wird dargestellt mit 5 Strichen, die 2. Ziffer mit den unmittelbar den Strichen der 1. Ziffer folgenden Lücken. Niedrige Informationsdichte, z.B. 4,8 mm/Ziffer bei einer Modulbreite X = 0,3 mm und Verhältnis V = 1 : 3

Vorteil: Alphanumerische Darstellung, großer Zeichenvorrat

Nachteil: Niedrige Informationsdichte, z.B. 4,8 mm/Ziffer bei einer Modulbreite X = 0,3 mm und Verhältnis V = 1 : 3. Kleine Toleranz.

Code 39 erweitert

Der Code 39 erweitert ist eine erweiterte Version des Code 39. Mit Code 39 erweitert sind auch die 26 Kleinbuchstaben (a-z) sowie die Sonderzeichen der Tastatur darstellbar (alphanumerischer Code). Besitzt ebenfalls keine feste Länge.

Die zusätzlichen Zeichen (z.B. die Kleinbuchstaben) werden durch Kombination von jeweils zwei Zeichen (der bereits von Code 39 existierenden Zeichen) dargestellt. Der Decoder des Lesegerätes interpretiert ein Sonderzeichen gefolgt von einem Großbuchstaben entsprechend der Referenztabelle des Code 39 extended.

Code 39 erweitert kann je nach Anwendungsfall mit oder auch ohne Prüfsumme verwendet werden. Die Prüfsumme wird ebenfalls nach Modulo 43 berechnet.

Nachteil: sehr kleine Informationsdichte, kleine Toleranz

Code 128

Der Code 128 Auto ermöglicht den vollen ASCII-Zeichensatz darzustellen. Hierzu wird automatisch zwischen den 3 Zeichensätzen A, B und C hin- und her geschaltet um damit alphanumerische Daten in der kürzest möglichen Form zu verschlüsseln. Wegen der hohen Informationsdichte und der Fähigkeit, den vollen ASCII-Zeichensatz darstellen zu können, hat sich der Code 128 weit verbreitet.

Ein Zeichen des Codes 128 setzt sich aus 11 Modulen, nämlich drei Strichen und drei Lücken, zusammen. Ausnahme ist das Stoppzeichen, das sich aus 13 Modulen zusammensetzt. Die Codelänge ist variabel.

Die drei Zeichensätze im Einzelnen:

Code 128A: Er enthält Ziffern, Großbuchstaben, Sonderzeichen und ASCII-Steuerzeichen.

Code 128B: Er enthält Ziffern und alle Groß- und Kleinbuchstaben, sowie Sonderzeichen und Umschaltzeichen.

Code 128C: Dieser Zeichensatz ordnet speziell für numerische Erfordernisse den Barcodemustern 100 Wertepaare von „00“ bis „99“ zu (plus Sonderzeichen FNC1).

Der Barcodewert muss aus einer geraden Anzahl von Zeichen bestehen. Wenn der Barcodewert aus einer ungeraden Anzahl von Zeichen besteht, wird der Barcode nicht erzeugt, sondern eine Fehlermeldung ausgegeben.

 Diese 3 eigenständigen Zeichensätze sind nur Bestandteil des Code128 Auto und werden daher kaum als eigenständiger Typ verwendet. In der Regel ist eine Nutzung eines speziellen Zeichensatzes unnötig, da der Haupttyp Code128 Auto die Zeichensätze automatisch optimiert auswählt. 

Prüfsumme Bei dem Code 128 wird intern eine Prüfsumme gebildet. Sie berechnet sich aus Modulo 103. Sie ist jedoch nicht Teil des Barcodes und wird deshalb in der Klarschriftzeile nicht dargestellt.

Der Code 128 ermöglicht ohne Zeichenkombinationen den vollen ASCII-Zeichensatz darzustellen. Jedoch darf nicht angenommen werden, dass der Code 128 mit seinem Zeichensatz alle ASCII-Zeichen direkt darstellen kann. Es wird zwischen 3 Zeichensätzen A, B und C unterschieden, die je nach Problemstellung zu verwenden sind. Ebenso ist auch  eine Vermischung dieser Zeichensätze möglich. Um den vollen ASCII-Zeichensatz darstellen zu können, benötigt man das Startzeichen A oder B in Verbindung mit einem Sonderzeichen des Code 128. Jedes Zeichen besteht aus 11 Modulen, aufgeteilt in 3 Striche und 3 Lücken. Die Striche bestehen immer aus einer gerad zahligen Anzahl von Modulen (gerade Parität) und die Lücken aus einer ungerad zahligen Anzahl von Modulen. Das Stoppzeichen ist die Ausnahme und besitzt 13 Module, bestehend aus 11 Modulen und einem Begrenzungsstrich mit 2 Modulen.

Vorteil. Voller ASCII-Zeichensatz, Hohe Informationsdichte

Nachteil: Kleine Toleranz, Vierbreiten Code, ASCII-Zeichen­satz nicht vollständig mit einem Zeichensatz darstellbar

EAN 8

Hier gibt es zwei Zeichensätze A und C mit jeweils 10 Ziffern. Die Länge ist auf acht Stellen festgelegt. Dieser Barcode ist besonders für Artikel gedacht, die wenig Platz zum Aufdruck von Barcodes bereitstellen. Da diese Nummern nur begrenzt verfügbar sind, werden sie nur auf Antrag vergeben. Ein Zeichen setzt sich - wie auch beim EAN 13 - aus sieben Elementen zusammen. Es besteht aus einem 3-stelligen Präfix (Kennzahlorganisation von der EAN zugeordnet) und einer 4-stellige Artikel Identifikation. Die Verwendung von Prüfziffern ist vorgeschrieben. Sie berechnen sich nach Modulo 10. Auch hier werden ein Start-, ein Stopp- und ein Trennzeichen verwendet.

Vorteil: Hohe Informationsdichte in 10 verschiedenen Größen.

Nachteil: Sehr kleine Toleranzen +/- 10%

(Von CIB format nicht unterstützt)

EAN 13

Er dient der Auszeichnung von Gebrauchs- und Verbrauchsgütern. Es stehen drei verschiedene Zeichensätze zur Verfügung mit einem Zeichenvorrat von je zehn Ziffern. Die Zeichen setzen sich aus vier unterschiedlich breiten Elementen zusammen. Prüfziffern sind vorgeschrieben (Modulo 10), die Barcodelänge ist auf dreizehn Stellen begrenzt. Es werden ein Start-, ein Stop- und ein Trennzeichen verwendet. Als Start- und Stopzeichen dienen hier sogenannte Randzeichen.

Vorteil: Hohe Informationsdichte in 10 verschiedenen Größen.

Nachteil: Sehr kleine Toleranzen +/- 10%

(Von CIB format nicht unterstützt)

EAN 128

Entspricht dem Code 128, jedoch wird als Startzeichen die Kombination von Start A, Start B oder Start C mit dem Zeichen FNC1 (der s.g. Function Code 1) verwendet. Diese direkte Aufeinanderfolge von Startzeichen und FNC1 am Anfang ist ein eindeutiges Kennzeichen des EAN 128. Obwohl die Länge des Codes variabel ist sollten 165 mm nicht überschritten werden. Maximal sind 48 Nutzzeichen (inklusive Datenbezeichner/AIs und eventueller FNC1 Trennzeichen) und 35 Symbolzeichen (incl. Hilfszeichen und Prüfzeichen) erlaubt.

Es können mehrere Daten gleichzeitig codiert werden. Üblich ist z.B. Lebensmittelpaletten neben dem Produktcode zusätzlich mit Gewichtsangaben und dem Haltbarkeitsdatum im Barcode auszuzeichnen.

(Von CIB format nicht unterstützt)

DataMatrix

Es wird der gesamte ASCII-Zeichensatz unterstützt. Die Länge ist variabel. Die Prüfziffer wird berechnet nach der Reed-Solomon-Fehlerkorrektur/Interne Fehlerkorrektur.

Dieser Code stellt einer der bekanntesten 2D Codes dar. Er besteht aus 4 Hauptkomponenten. Der Datenbereich enthält die Daten in der codierten Form. Die feste Begrenzungslinie ist die Ecke, die bei normaler Ausrichtung links und unten des Datenbereichs mit einer ununterbrochenen Linie dargestellt wird. Er wird benötigt um die Lage des Codes beim Scannen zu erkennen. Die „offene Begrenzungslinie“ liegt in der gegenüberliegenden Ecke der „festen Begrenzungslinie“. Diese Linien (oben und rechts) bestehen abwechselnd aus schwarzen und weißen Punkten. Sie stellen somit offene Linien dar. Beim Scannen werden diese zum Bestimmen der Zeilen und Spalten verwendet. Die Ruhelinie umgibt den Code. Dieser Bereich muss mindestens so breit sein, wie eine Spalte/Zeile bzw. ein Punkt des Codes.

Es ist möglich 3116 Ziffern oder 2335 Zeichen zu codieren. Je nach Datenmenge ist dies abhängig von einer unterschiedlichen Symbolgröße.

Vorteil: Er ist ein sehr kompakter und sicherer Code.

Nachteil: Er ist nur mit Bildverarbeitungssystemen lesbar und nicht mit linearen Barcodelesern.

QR-Code

(ab CIB format 5.3.237)

Der QR-Code (Quick Response) ist ein 2D-Code, der von der  Firma Denso im Jahr 1994 entwickelt und zur Markierung von Baugruppen und Komponenten in der japanischen Automobilproduktion eingesetzt wurde.

Der japanische Standard für QR-Codes "Japan Industrial Standard" X 0510, wurde im Januar 1999 veröffentlicht und entspricht seit dem Jahr 2000 dem Standard ISO/IEC18004.

Der QR-Code besteht aus einer quadratischen Matrix aus schwarzen und weißen Punkten, die die kodierten Daten binär darstellen. Zur Feldbegrenzung enthält er in drei seiner Ecken ein bestimmtes Muster. Über das fehlende Muster in der vierten Ecke erkennt das Lesegerät die Orientierung. Bei zunehmender Größe des Codes werden weitere Muster hinzugefügt, um die Ausrichtung des Codes besser erkennbar zu machen. Zwischen den drei Hauptpositions-Markierungen befindet sich eine Linie aus einer Folge streng abwechselnder Bits, worüber sich die Matrix definiert. Im Code enthalten sind Versionsinformationen und das benutzte Datenformat. Diese Informationen sind neben den Mustern in den Ecken angeordnet. Der restliche Bereich des Quadrats ist der Datenteil, der die kodierten Daten in redundanter Form enthält.

Die Matrixgröße des QR-Codes beträgt mindestens 21×21 und maximal 177×177. Dadurch ergeben sich folgende Darstellungs-Kapazitäten:

• Numerisch: maximal 7.089 Zeichen
• Alphanumerisch: maximal 4.296 Zeichen
• Binär: maximal 2.953 Bytes

Die Randzone (quiet zone) sollte mindestens 4 Elemente breit sein. Größere Inhalte lassen sich auf bis zu 16 einzelne Codes aufteilen.

Es existieren vier Fehlerkorrektur-Levels, die eine Rekonstruktion von 7 % (Level L) bis zu 30 % (Level H) beschädigter Daten zulassen. Dabei kommt die Fehlerkorrektur der Reed-Solomon-Code zum Einsatz.

PDF417

(ab CIB format 5.3.225)

Dieser 2D-Code besitzt eine variable Länge. Es wird der gesamte ASCII-Zeichensatz unterstützt. Er basiert auf gestapelte Strichcodes (Stapelcodes).

Ein PDF417 Barcode besteht aus 3 bis 90 Zeilen, von denen jede ein Strichcode ist. Jede Zeile besteht aus:

• Einer “quiet zone”, d.h. eine vorgegebene Anzahl Leerstellen vor dem Barcode.
• Ein  “Startmuster”, das den Barcode-Typ identifiziert (z.B. PDF417). Jeder Barcode-Typ hat sein spezielles “Start-/Stopmuster”.
• Ein "Zeilen-Codewort-links”, das Informationen über diese Zeile enthält (wie z.B. Zeilennummer, Fehler-Korrektur-Rate)
• 1 - 30 Daten-Codewörter: Ein Codewort ist eine Gruppe von Strichen und Lücken, die jeweils eine Zahl, einen Buchstaben oder ein anderes Zeichen repräsentieren.
• Jede Zeile besteht aus der gleichen Anzahl von Codewörtern.
• Jedes Codewort besteht aus vier Strichen und vier Lücken. Daher kommt die „4“ im Namen des Barcodes.
• Die Gesamtbreite eines Codewortes ist das 17fache der Breite des schmalsten erlaubten Striches (berechnet sich aus der x-Dimension=Anzahl Spalten). Daraus resultiert die „17“, die im Namen des Barcodes enthalten ist.
• Jedes Codewort beginnt und endet mit einem Leerzeichen.
• Es gibt insgesamt 926 mögliche Codewörter, 900 für Daten, 26 für Spezialfunktionen.
• Jedes Codewort wird aus einem von drei verschiedenen „Clustern“ geholt:
• Jedes Cluster enthält ein bestimmtes Strich-/Lücken-Muster für jedes der 926 Codewörter.
• Innerhalb der Cluster kommt jedes Strich-/Lücken-Muster nur einmal vor.
• Die Zeilennummer (mod 3) legt fest, welches Cluster zu verwenden ist.
• Dadurch wird für alle Codewörter einer Zeile das gleiche Cluster verwendet.
• Der Zweck des Clusters ist, eine feste Beziehung zwischen Codewort und Zeile herzustellen. Dadurch kann der Scanner auch waagrecht über den Barcode bewegt werden.
• Ein  „Zeilen-Codewort-rechts” mit weiteren Informationen zu der Zeile.
• Ein “Stopmuster”
• Eine “quietzone”.
  
  

Die Korrektur-Rate ist von „0“ bis „8“ einstellbar. Bei „8“ können ca. 50% der Zeichen rekonstruiert werden, der Barcode wird dann allerdings sehr groß.

Vorteil: Sehr kompakter und flexibler Code mit variabler Länge. Er hat sehr gute Fehlerkorrektur-Möglichkeiten.

Code 93

Dieser Code umfasst eine variable Länge. Es sind keine Prüfziffern vorgesehen. Er ist ein alphanumerischer Code vergleichbar dem Code 39. Sein Zeichenvorrat beinhaltet die Ziffern 0 bis 9, 26 Großbuchstaben (A–Z), das Leerzeichen sowie die Sonderzeichen Minus, Punkt, Dollarzeichen, Schrägstrich, Plus und das Prozentzeichen.

(Von CIB format nicht unterstützt)

Code 93 Extended

Er stellt eine erweiterte Version des Code 93 dar. Er kann den einfachen ASCII-Zeichensatz darstellen. Es sind die 26 Kleinbuchstaben (a-z) sowie die Sonderzeichen der Tastatur darstellbar. Die Breite des Codes kann hierdurch jedoch erheblich erhöht werden, da einige Zeichen aus zwei Zeichen im Strichcode gebildet werden.

(Von CIB format nicht unterstützt)

5.3. Schriftarten

Sogenannte Barcodefonts enthalten für die einzelnen Zeichen (bzw. Zeichenpaare bei 2/5 interleaved) des Barcodewerts je eine Strichfolge.

5.4. OMR Strichcodes

Enthalten Hinweise für Kuvertiermaschinen.

Ein OMR Strichcode ist für jede Kuvertierungsmaschine speziell definiert und muss angepasst werden.

6. Handhabung von Barcodes mit CoMod

Die CIB office Module unterstützen folgendes Vorgehen um zu einer Barcode- und/oder Strichcodeausgabe innerhalb eines Dokumentes zu kommen:

• Unterstützung von Barcodefonts die der Anwender selbstständig zur Formatierung benutzt.
• Unterstützung von statischen Barcodegrafiken die der Anwender in sein Dokument integriert.
• Erstellung und Einbindung dynamischer Barcode- und Strichcodes, die nachfolgend in Details beschrieben sind.
  Zur besseren Übersicht ist an der jeweiligen Stelle auch das Vorgehen für Barcodefonts und statische Barcodegrafiken dokumentiert.

6.1. CIB merge

Eingabe

CIB merge liest Rohtexte korrekt, die mit einem Barcodefont formatierten Text oder mit einem Barcodefont formatierte REF-Feldanweisungen enthalten. Im Dokument eingebettete oder referenzierte Barcodegrafiken werden von CIB merge wie normale Grafiken korrekt behandelt. CIB merge akzeptiert ebenso die speziellen Barcodeanweisungen, die für das CIB format/barcode Modul verfügbar sind. (siehe Abschnitt CIB format).

6.2. CSV/XML-Datendateien

Ausgabe

Feldinhalte, die in eine mit einem Barcodefont formatierte REF-Feldanweisung eingesetzt werden, werden normal behandelt. Das heißt wenn der Schalter \*Zeichenformat in der Feldanweisung angegeben war, ist der Feldinhalt im Ausgabedokument mit der gleichen Schriftart formatiert, wie die Feldanweisung.

In der speziellen Anweisung (siehe Abschnitt CIB format) eingebettete Felder werden aufgelöst, die dadurch eventuell veränderte Anweisung selbst dann wieder ins Ausgabedokument
übernommen.

6.3. CIB format

Eingabe

CIB format verarbeitet mit Barcodefonts formatierte Texte wie alle anderen formatierten Texte. Das heißt, die Buchstabenbreiten werden aus der Schriftart ermittelt und beim Zeilen- und Seitenumbruch berücksichtigt.

Im Dokument eingebettete oder referenzierte Barcodegrafiken werden wie andere Grafiken positioniert und berücksichtigt.

Im Dokument enthaltene spezielle Anweisungen zur dynamischen Generierung einer Barcodegrafik werden ausgewertet, und eine zum dort angegebenen Barcodewert gehörige Barcodegrafik im entsprechenden Barcodetyp generiert.

Dynamisches Generieren der Barcodegrafik in einem Platzhalter im Dokument

Mit einer speziellen Form des INCLUDEPICTURE-Feldes (EinfügenGrafik) wird die dynamische Generierung einer Barcodegrafik angefordert.

{ INCLUDEPICTURE "BARCODE:<Typ>;<Wert>;<Orientierung>;<Breite>;<Höhe>;<Prüfziffer>" }

Das Feld enthält dazu folgende Informationen:

Die spezielle Anweisung hat in der Eingabe für CIB format folgendes Aussehen:

mit Prüfziffer:

{ INCLUDEPICTURE "BARCODE:Code39;1234567890;horizontalleft;0.5mm;7.5mm;" }

ohne Prüfziffer:

{ INCLUDEPICTURE "BARCODE:Code39;1234567890;horizontalleft;0.5mm;7.5mm;nochecksum" }

Der Barcodewert kann auch über die Datenversorgung variabel eingesteuert werden. Die Eingabe für CIB merge kann wie folgt aussehen, damit der Barcodewert an der richtigen Stelle eingesetzt wird:

Variante a:

Durch die CSV Variable wird die komplette Barcodevorgabe angeliefert:

{ INCLUDEPICTURE "{ REF barcode \* Zeichenformat}" }

Variante b:

Durch die CSV Variable wird nur der Barcodewert angeliefert:

{ INCLUDEPICTURE "BARCODE:Code39;{ REF barcodeWert };horizontalleft;0.5mm;15mm;" }

Nachteil: In WORD2007 wird dieser Befehl nach dem ersten Abspeichern aus dem RTF entfernt und durch einen Grafik-Platzhalter ersetzt und damit nicht mehr bearbeitet werden.

Variante c:

{ SET Barcodeanweisung "BARCODE:DataMatrix;ECC200;{REF Text};horizontalleft;20;20;;ansi" }
 { INCLUDEPICTURE "{REF Barcodeanweisung}" }

Diese Variante ist eine Kombination aus a und b, sie vermeidet den Nachteil von Variante b. 

Es wird die Verwendung der Variante c empfohlen.

Aus diesen Informationen baut CIB format im Speicher dynamisch das Strichmuster auf der Barcodegrafik auf und positioniert diese entsprechende der INCLUDEPICTURE-Anweisung.

Hinweis:

Wenn es in Variante a durch den Mischvorgang zu einem leeren Inhalt (= nicht versorgter Barcode) kommt, so wird diese INCLUDEPICTURE Vorgabe von CIB format überlesen, als ob keine Anweisung vorhanden ist. Bei Variante b hingegen wird an Stelle der Barcodegrafik ein Platzhalter dargestellt.

Dynamisches Generieren der Barcodegrafik über die CIB format Eigenschaft „BarcodeFilename“

Alternativ zu einem Barcode-Platzhalter im Dokument kann man auch direkt eine Property des CIB format Modules als Aufrufparameter für Barcodeparameter benutzen.

Bei der Ausgabe eines Dokumentes werden dann diese Vorgaben berücksichtigt und auf den gewünschten Seiten an den gewünschten Stellen, die vorgegebenen Barcodes ausgegeben.

Die Property „BarcodeFilename“ enthält dazu folgende Informationen

Die Seitenangaben besitzen verschiedene Prioritäten:

All, Odd, Even, NoFirst, NoLast             Priorität: keine

First, Last, Wert                                       Priorität: DIRECT

Wert1-Wert2                                            Priorität: RANGE

Dabei gilt folgende Rangfolge: Keine Priorität < RANGE < DIRECT

Besitzen zwei Angaben gleiche Priorität, so gelten beide, ansonsten gilt die mit der höheren Priorität.

Die Angabe „All;Barcode1;Last;Barcode2“ bewirkt also, dass auf allen Seiten bis auf der letzten, Barcode1 platziert wird und auf der letzten Seite stattdessen Barcode 2 (da Last > All).

Möchte man hingegen auf allen Seiten Barcode1 platzieren und zusätzlich auf der letzten Seite Barcode2, ist dies möglich, wenn man die Angaben durch geschweifte Klammern trennt.

{All;Barcode1}{Last;Barcode2}

Alles, was innerhalb der geschweiften Klammern steht ist durch oben genannte Prioritäten geregelt, zwischen den geschweiften Klammern gilt jedoch keine Priorisierung.

1.   cibRsh.exe BarcodeFilename=" {POS:6.0mm;211.0mm;All;BARCODE:OMR;1;verticalleft;9.0mm;0.75mm;5.5mm;;
POS:6.0mm;215.8mm;All;BARCODE:Code39;000161;verticalright;0.31mm;9.0mm;nochecksum;
POS:6.0mm;255.0mm;Last;BARCODE:OMR;1;verticalleft;9.0mm;0.75mm;5.5mm;}
" -f Test.rtf
Im Ergebnis-PDF sind auf allen Seiten, außer der letzten, der erste OMR-Barcode und der Code39 aufgebracht, auf der letzten Seite nur der 2. OMR-Barcode.

2.   cibRsh.exe BarcodeFilename=" {POS:6.0mm;211.0mm;All;BARCODE:OMR;1;verticalleft;9.0mm;0.75mm;5.5mm;;
POS:6.0mm;215.8mm;All;BARCODE:Code39;000161;verticalright;0.31mm;9.0mm;nochecksum };
{POS:6.0mm;255.0mm;Last;BARCODE:OMR;1;verticalleft;9.0mm;0.75mm;5.5mm;}
" -f Test.rtf
Durch das verwenden von Klammern ändert sich das aufbringen der Barcodes, so das auf allen Seiten der erste OMR-Barcode und der Code39, jedoch auf der letzten ZUSÄTZLICH der 2. OMR-Barcode enthalten ist.

3.   cibRsh.exe BarcodeFilename=" {POS:6.0mm;211.0mm;All;BARCODE:OMR;1;verticalleft;9.0mm;0.75mm;5.5mm;;
POS:6.0mm;215.8mm;All;BARCODE:Code39;000161;verticalright;0.31mm;9.0mm;nochecksum;
POS:6.0mm;255.0mm;NoLast;BARCODE:OMR;1;verticalleft;9.0mm;0.75mm;5.5mm;}
" -f Test.rtf
In diesem Beispiel werden auf allen Seiten alle drei Barcodes aufgebracht, auf der letzten aber nur die ersten beiden.

4.   cibRsh.exe BarcodeFilename=" {POS:6.0mm;211.0mm;AUSF1,1,AUSF2,1;BARCODE:OMR;1;verticalleft;9.0mm;0.75mm;5.5mm;}
" -f Test.rtf
Der Barcode wird nur auf die erste Seite der Ausfertigungen AUSF1 und AUSF2 aufgebracht.

Dynamisches Generieren der Barcodegrafik über eine CIB format Callbackfunktion

Als weitere Alternative zu einem Barcode-Platzhalter im Dokument kann man dem CIB format Module auch eine Callbackfunktion setzen, die dann bei jeder generierten Ausgabeseite durchlaufen wird.

Man kann auf diese Weise seitenabhängig dynamische Barcodes mit der unter „Dynamisches Generieren der Barcodegrafik über die CIB format Eigenschaft“ beschriebenen Property setzen.

Bei der Ausgabe eines Dokumentes werden dann diese Vorgaben berücksichtigt und auf den gewünschten Seiten an den gewünschten Stellen, die vorgegebenen Barcodes ausgegeben.

Dynamisches Generieren einer OMR Strichcodegrafik

Die in den Kapiteln „Dynamisches Generieren der Barcodegrafik in einem Platzhalter im Dokument“ bis „Dynamisches Generieren der Barcodegrafik über eine CIB format Callbackfunktion“ beschriebenen Verfahren können auch zum Einfügen von OMR Strichcodes genutzt werden. Diese enthalten folgende Information:

Spezielle OMR Strichcodegrafik

Der Subtyp beschreibt die Funktionen, die die spezielle Kuvertiermaschine unterstützt.

<Subtyp> := [<Subtyp_E>][ <Subtyp_S> ][<Subtyp_N>][ <Subtyp_P>]

Die spezielle Anweisung hat in der Eingabe für CIB format folgendesAussehen:

{ INCLUDEPICTURE "BARCODE:OMR:ES3;E,S,2;verticalleft;10mm;0.5mm;0.16in" }

Offene OMR Strichcodegrafik

Da jede Kuvertiermaschine ihre speziellen Strichfolgen für die einzelnen Funktionen hat, kann man hier direkt die Daten eingeben.

Beispiel in einem vertikalen Barcode:

Die spezielle Anweisung hat in der Eingabe für CIB format folgendes Aussehen:

{ INCLUDEPICTURE "BARCODE:OMR;101011;verticalleft;10mm;0.5mm;0.16in;" }

Dynamisches Generieren eines DataMatrix ECC 2D Barcodes

Die in den Kapiteln „Dynamisches Generieren der Barcodegrafik in einem Platzhalter im Dokument“ bis „Dynamisches Generieren der Barcodegrafik über eine CIB format Callbackfunktion“ beschriebenen Verfahren können auch zum Einfügen von Datamatrix Barcodes genutzt werden. Diese enthalten folgende Information:

Spezielle DataMatrix ECC 2D Barcodes

{ INCLUDEPICTURE "BARCODE:DataMatrix;ECC200;ABC123456789Z;horizontalleft;28mm;28mm;22x22;ansi;;;" }

1) no MM size (no width and no height), no matrix size (no NxN)
   a) matrix - first smallest suitable matrix size
   b) cell size - 1x1 mm
2) no MM size, largest matrix size
   a) matrix - largest matrix size
   b) cell size - 1x1 mm
3) no MM size, too small matrix size
   a) matrix - first smallest suitable matrix size
   b) cell size - 1x1 mm
4) no MM size, wrong matrix size
   a) matrix - first smallest suitable matrix size
   b) cell size - 1x1 mm 
5) MM size (width is set, no height), matrix size (all cases 1-4)
   a) matrix - according to case 1-4
   b) cell size = [width / matrix.cx, width / matrix.cx] (mode which allow to scale the whole barcode by x-axis) 
6) MM size (no width, height is set), matrix size (all cases 1-4)
   a) matrix - according to case 1-4
   b) cell size = [height / matrix.cy, height / matrix.cy] (mode which allow to scale the whole barcode by y-axis) 
7) MM size (width is set, height is set), matrix size (all cases 1-4)
   a) width / matrix.cx == height / matrix.cy (i.e. correct proportion was set)
   b) matrix - according to case 1-4
   c) cell size = [width / matrix.cx, height / matrix.cy]
   d) width / matrix.cx != height / matrix.cy (i.e. incorrect proportion was set)
   e) matrix - according to case 1-4
   f) cell size = [width / matrix.cx, width / matrix.cx]

Dynamisches Generieren eines QR-Barcodes

Die in den Kapiteln „Dynamisches Generieren der Barcodegrafik in einem Platzhalter im Dokument“ bis „Dynamisches Generieren der Barcodegrafik über eine CIB format Callbackfunktion“ beschriebenen Verfahren können auch zum Einfügen von QR-Barcodes genutzt werden. Diese enthalten folgende Information:

QR-Barcode

(ab CIB format Version 5.3.237, bzw. 6.0.14)

{ INCLUDEPICTURE "BARCODE:QR;Test QR-Code;horizontalleft;20;20;;ansi;ECL1;" }

Dynamisches Generieren eines PDF417-Barcodes

Die in den Kapiteln „Dynamisches Generieren der Barcodegrafik in einem Platzhalter im Dokument“ bis „Dynamisches Generieren der Barcodegrafik über eine CIB format Callbackfunktion“ beschriebenen Verfahren können auch zum Einfügen von PDF417-Barcodes genutzt werden. Diese enthalten folgende Information:

PDF417-Barcode

(ab CIB format Version 5.3.225, bzw. 6.0.6)

Beispiel für einen PDF417-Barcode:

{ INCLUDEPICTURE "BARCODE:PDF417;;ABC123456789Z;horizontalleft;20;40;;;ECL2" }

6.4. CIB format/output

Das CIB format/output Modul setzt die bisher beschriebenen Verfahren intern zu einem dynamischen Grafik- bzw. einzelnen Linienobjekten um und gibt diese entsprechend der Vorgaben aus.

Darüber hinaus werden alternative Verfahren wie die Verwendung von Barcodefonts zur Formatierung spezieller Zeichenketten oder vom Anwender im Dokument eingebundene selbsterzeugte Barcodegrafiken unterstützt.

Die Glyphen eines mit einem Barcodefont formatierten Textes werden wie andere Buchstaben und Symbole ausgegeben.

Dynamische und statische Barcodegrafiken werden wie normale Grafiken ausgegeben.

7. Schneller Einstieg

Dieses Kapitel zeigt Ihnen in einem Kurzüberblick eine mögliche Nutzung des dynamischen Barcodes mit CIB format/output in einer Kundenapplikation.

Hinweis:

Mit CIB output ist es möglich eine MultiRTF Eingabedatei in verschiedene Ausgabeformate überzuführen. Eine MultiRTF Datei ist EINE physikalische Datei, die intern aber mehrere RTF-Dokumente beinhaltet.

Sie kann z.B. über CIB merge unter Verwendung des –o+ Parameters über mehrere Mischläufe aneinandergehängt werden.

Herkömmliche RTF-Verarbeitungsprogramme (z.B. MS-Office) können MultiRTFs i.d.R. zwar einlesen, zeigen aber dann nur den Inhalt der allerersten RTF Datei.

CIB view/output sind in der Lage den kompletten Inhalt auszugeben.

Bei einer MultiRTF-Umsetzung in andere Zielformate kann man unterscheiden ob die Ausgabe in lauter einzelne Zieldateien erfolgen soll, oder ob eine Zieldatei den gesamten Inhalt wiedergeben soll.

Ein C- Beispiel mit MultiRTF und dynamischen Barcodes

Nachfolgendes Beispiel konvertiert eine MultiRTF Datei nach PDF und setzt auf jede Dokumentseite einen Barcode eigenen Inhalts.

#include "cibprt.h"
BOOL DoMultiRTFToPdfWithBarcode()
{
     BOOL t_fSingleOutput = TRUE; /*Es soll nur eine Zieldatei entstehen*/
     CibPrSetProperty(COMOD_PROP_MULTIRTF_SINGLEOUTPUT, &t_fSingleOutput, sizeof(BOOL));
     BOOL t_MultirtfPropertiesSupported = FALSE; /*Abwärtskompatibilität*/
     BOOL t_MultiRtfPending = FALSE; /*default ist kein MultiRTF*/
     /*Eingabedatei setzen "InputFilename"*/
     CibPrSetProperty(COMOD_PROP_INPUT_FILENAME, "MultiTest.rtf");
     /*Ausgabedatei setzen "OutputFilename"*/
     CibPrSetProperty(COMOD_PROP_OUTPUT_FILENAME, "BarcodeAusgabe.pdf");
     /*Ausgabeformat setzen "OutputFormat" "FormatPdf"*/
     CibPrSetProperty(COMOD_PROP_OUTPUT_FORMAT, COMOD_OPT_FORMAT_PDF);
     do {
          if(!CibPrLoad())
          {
               /*Fehlerbehandlung einbauen*/
               return FALSE;
          }
          char* t_PageCount[15]; /*StringProperty*/
          memset(t_PageCount,0,15); /*initialisieren*/
          /*Anzahl Seiten des aktiven Einzeldokumentes abholen "PageCount"*/
          CibPrGetProperty(COMOD_PROP_PAGECOUNT,&t_PageCount,14);
          /*abhängig von der Seitenzahl jetzt einen beliebigen String*/
          long t_nPageCount = atol(t_PageCount,10);
          /*mit mehreren Bacrodeinfo's zusammenbauen*/
          char t_MultiBarcodeString[4096];         
          memset(t_MultiBarcodeString,0,4096);
          for(int i=0; i < t_nPageCount; i++)
          {
               char t_PageBarcode;
               /*hier kann jetzt dynamisch abhängig von der Seitenangabe etc.*/
               /*eine Barcodevorgabe generiert werden*/
               strcpy(t_PageBarcode,"POS:x;y;<PageNr>;BARCODE:Code39;1234567890;                    
               horizontalleft;0.5mm;7.5mm;nochecksum");
               if(i > 0)
                    strcat(t_MultiBarcodeString,";"); /*Trenner dazwischen*/
           strcat(t_MultiBarcodeString,t_PageBarcode);
          }
          /*Barcodeinfo für dieses Dokument absetzen "BarcodeFilename"*/
          CibPrSetProperty(COMOD_PROP_BARCODE_FILENAME,&t_MultiBarcodeString);
          if(!CibPrSave())
          {
               /*Fehlerbehandlung einbauen*/
               return FALSE;
          }
     /* ACHTUNG: Ältere CIB Dlls können das nicht*/
     t_MultirtfPropertiesSupported = CibPrGetProperty(COMOD_PROP_MULTIRTF_PENDING, &t_MultiRtfPending, sizeof(BOOL));
     }
     while (t_MultirtfPropertiesSupported && t_MultiRtfPending);
     /* Anzahl der enthaltenen Dokumente ausgeben*/
     long t_MultiRtfIndex = 0;
     CibPrGetProperty(COMOD_PROP_MULTIRTF_INDEX, &t_MultiRtfIndex, sizeof(long));
     if (t_MultirtfPropertiesSupported && (t_MultiRtfIndex > 1))
     printf("%ld Dokumente.\n", t_MultiRtfIndex);
}/* DoMultiRTFToPdfWithBarcode*/

8. Übersicht Barcodetypen

Die Unterstützung der folgenden Barcodetypen ist für den CIB format in Planung:

9. Fehlerbehandlung

CIB format/barcode liefert beim Ausführen von Funktionen einen Rückgabewert FALSE(=0) wenn ein Fehler aufgetreten ist.

Die Barcodevorgaben selbst führen zu keinem Fehlerausgang, sondern erzeugen ggf. ein Kreuz aus zwei 45Grad Linien im Falle einer nicht möglichen Umsetzung. Details können dann über einen Trace ausgewertet werden.

10. Trace

Für unklare Fehlersituationen haben Sie mehrere Möglichkeiten eine zusätzliche Protokolldatei zu erzeugen:

• Sie setzen die Umgebungsvariable CIB_PRTRACE auf einen Dateinamen und führen den Vorgang aus
• Sie setzen die Property Tracefilename und vollziehen den Vorgang