| Inhalt |
|---|
Allgemeine Informationen
Mit den Barcode Definitionen lassen sich individuelle Barcodes definieren, die in Formulare, welche auf der BIRT-Technologie beruhen, integriert werden können. Dadurch lassen sich z.B. Arbeitsaufträge mit individuellem Inhalt generieren.
...
Eine Anleitung wie auch Barcodes im Format "Code 39" generiert werden könne ist weiter unten beschrieben.
Systemvoraussetzungen
IPD - Integrierter PDF Druck muss
Formulare mit BIRT-Technologie
Prozessbeschreibung
Die Funktion findet sich im Menüpunkt 10.10.11.9 - Barcode Definitionen und führt zur Übersicht:
...
In der Übersicht stehen die nachfolgende Funktionen zur Verfügung:
...
Zum Hinzufügen einer neuen Barcode Definition sind folgende Schritte durchzuführen:
Auswahl des Buttons "Hinzufügen". Hiermit werden die Felder "Code" und "XPath" für die Anlage freigeschalten.
"Code" vergeben.
Der "Code" muss eindeutig sein, d.h. ein Schlüssel darf nicht mehrmals verwendet werden. Das System gibt in diesem Fall eine Warnung aus und verhindert das Hinzufügen.
Die Länge des Codes ist auf maximal 20 Stellen begrenzt.
Der Code dient dazu in den Formularen den gewünschten Barcode aufzurufen.
Inhalt mittels XPath definieren.
XPath ist eine Abfragesprache, um Teile eines XML-Dokumentes zu adressieren und auszuwerten.
Bei Formulare in BIRT-Technologie liegt als Datenquelle ein XML vor.
Inhalte/Felder dieses XMLs können mit XPath abgefragt und weiter bearbeitet werden.
z.B. ist das aneinanderhängen mehrere Felder möglich wie im obigen Beispiel gezeigt: der Ausdruck /Document/SourceId & "-" & /Document/Vehicle/VIN ergibt den Inhalt Auftragsnummer-Fahrgestellnummer, z.B. 645123-WVWZZZ1JZ2W057177.
Die Länge des XPath-Ausdrucks ist auf maximal 100 Stellen begrenzt.
Auswahl des Buttons "Speichern". Hiermit wird die neue Barcode Definition der Datenbank hinzugefügt und steht zum Einbetten in Formularen zur Verfügung.
Interne Parameter
Interne Parameter können verwendet werden um dem Barcode bzw. QR-Code Informationen hinzuzufügen, welche im entsprechenden brt.xml nicht vorhanden sind und dadurch nicht wie gewöhnlich mittels XPath abgefragt werden können.
...
Folgende interne Parameter stehen aktuell zur Verfügung:
Name | Inhalt | Beispiel |
|---|---|---|
$CDP_COMPID | Die Betriebsnummer so wie sie im BusinessData Objekt enthalten ist. | Betriebsnummer "103" bei Kunden mit Betriebsnummer länger als zwei Stellen |
$CDP_DAT | Das Datum zum Zeitpunkt der Generierung des Dokuments im Format "yyyyMMdd". | Datum zum Zeitpunkt der Generierung ist 16.12.2021 → Der Parameter gibt den Wert "20211216" zurück. |
$CDP_QRSEPA | Der Inhalt des SEPA QR-Code, der in CDP erzeugt wird und auch im IPD Request XML File enthalten ist. | BCD 002 1 SCT BKAUATWW Vector Software DV GmbH CH86 3076 9016 1101 6608 2 306.7 267221 / 00008816 |
Barcode Definition adaptieren
...
Zum Adaptieren einer bestehenden Barcode Definition sind folgende Schritte durchzuführen:
Die gewünschte Barcode Definition in der Übersicht auswählen.
Den Xpath-Ausdruck entsprechend adaptieren.
Auswahl des Buttons "Speichern". Hiermit wird die Barcode Definition der Datenbank aktualisiert.
Barcode Definition löschen
...
Zum Löschen einer bestehenden Barcode Definition sind folgende Schritte durchzuführen:
Die gewünschte Barcode Definition in der Übersicht auswählen.
Auswahl des Buttons "Löschen".
Es erscheint ein Fenster, in welchem das Löschen mit Auswahl des Buttons "Ja" bestätigt werden muss.
| Hinweis |
|---|
...
Diese Funktion ist sorgsam einzusetzen. Wird eine Barcode Definition gelöscht, so können auf Formularen, welche sich auf diese Barcode Definition beziehen, die entsprechenden Barcodes nicht angedruckt werden. Daher ist es ratsam Barcode Definitionen nicht zu löschen solange nicht sichergestellt ist, das kein im Einsatz befindliches Formular diese Barcode Definition verwendet. |
Barcode im Format "Code 39" hinzufügen
Die Barcodes werden standardmäßig im Format "Code 128" generiert. Um beim gewünschten Code jedoch einen Barcode im Format "Code 39" zu erhalten muss lediglich der definierte Code mit "_39" enden.
...
QR Code hinzufügen
Die Barcodes werden standardmäßig im Format "Code 128" generiert. Um beim gewünschten Code jedoch einen QR Code zu erhalten muss lediglich der definierte Code mit "_QR" enden.
...
Barcode Definition in BIRT-Formular einbinden
Damit die definierten Barcodes auf einem Beleg erscheinen müssen diese im entsprechenden BIRT-Formular eingebunden werden. Folgende Schritte zeigen das Einbinden:
BIRT-Formular (.rptdesign-File) in Eclipse öffnen
An der gewünschten Stelle ein Image-Element einfügen. Hierzu gibt es zwei Möglichkeiten:
Drag-and-Drop aus der Palette
Rechte Maustaste in den Bereich, wo der Barcode eingefügt werden soll → Insert → Image
Es öffnet sich ein Dialog "Edit Image Item". Hier ist der Radio-Button "Dynamic image" auszuwählen.
Button "Select Image Data..."
...
Es öffnet sich ein weiterer Dialog "Select Data Binding". Hier ist der Button "Add.." auszuwählen
...
Es öffnet sich ein weiterer Dialog "New Data Binding". Hier sind folgende Einstellungen zu machen:
Column Binding Name → Code der gewünschten Barcode Definition eintragen
Display Name → Code der gewünschten Barcode Definition eintragen
Data Type → "Java Object" auswählen
Expression → f_x Button anklicken → es öffnet sich ein weiterer Dialog "Expression Builder"
...
Im "Expression Builder" ist folgender Ausdruck einzutragen: reportContext.getAppContext().get("Code der Barcode Definition"); → "Code der Barcode Definition" ist hierbei durch den echten Code aus den Barcode Definitionen zu ersetzen. Für das obige Beispiel lautet der Ausdruck reportContext.getAppContext().get("BARCODE_Test");
...
Bestätigen mit "OK"
Dialog "New Data Binding" bestätigen mit "OK"
Im Dialog "Select Data Binding" den neuen Eintrag selektieren (Checkbox links anklicken)
...
Bestätigen mit "OK"
Dialog "Edit Image Item" bestätigen mit "Insert"
...
| Hinweis |
|---|
Anschließend muss in der IPD Druckdefinition in JIPDUI auch der Variantenname QRSEPA angelegt werden wie unter QR Code Integration (IPD - PDF Druck/Datenpflege: Administration, Stammdaten/Dokumentation/CDP/DE) beschrieben. |