Barcode-Leser
Baustein zum erkennen von Barcodes
Ereignisaktion - Kurzfassung
Zweck: Erkennt aus einem Eingabedokument die enthaltenen Barcodes.
Die Ereignisaktion Barcode Lesen erkennt Barcodes aus einem Dokument und fasst diese unter einem oder mehreren Dokumenten zusammen. Die erkannten Barcodes werden in einer Liste unter Temporäre Werte gespeichert. Jeder Listeneintrag enthält ein Barcode- Ergebnis- Objekt unter welchem der Barcode, das Format und die Seite, auf dem der Barcode gefunden worden ist, gespeichert wird.
Siehe auch: Barcode Erkennung (in Dokumente)
Konfiguration
Dokumenteninhalt
Der Parameter Dokumenteninhalt muss das Dokument über einen Wertauflöser bereitstellen.
Ergebnis
Über einen Wertauflöser muss eine Variable definiert werden, unter dieser werden die Dokumente abgelegt.
Barcode-Filter
Der Barcode-Filter wird durch einen Wertauflöser definiert. Es wird ein Liste von Barcode-Filtern erwartet. Barcode-Filter entscheiden, welche der in einer Datei erkannten Barcodes überhaupt weiter verarbeitet werden sollen. Ohne Filter werden alle gefundenen Barcodes berücksichtigt. Jeder Barcode-Filter kann eine Vorgabe für das Format des Barcodes mit einem regulären Ausdruck (RegEx) enthalten. Beide Kriterien sind optional. Sie werden innerhalb desselben Filters UND-verknüpft. Sind mehrere Barcode-Filter definiert, werden diese ODER-verknüpft. Ein erkannter Barcode wird also weiterverarbeitet, wenn er für mindestens einen Filter alle angegebenen Kriterien erfüllt.
Barcode-Muster
Das Barcode-Muster wird durch einen Wertauflöser def iniert. Ein Barcode-Muster definiert ein erweitertes Interpretationsschema für die Zeichenfolge aus dem Barcode durch eine Kombination von Klartext (z. B. Trennzeichen) und Platzhaltern für Abschnitte, die in Eigenschaften des Dokuments übernommen werden sollen.
Siehe auch: Barcode Erkennung (in Dokumente)
Barcodes in einem Dokument zusammenfassen?
Diese Option muss über einen Wertauflöser definierte werden. Sollen die Barcodes in einem Dokument zusammengefasst werden, werden alle erkannten Barcodes in einer Liste, benannt nach der in Ergebnis definierten Variablen, als Temporäre Werte unter dem Dokument gespeichert.
In Kombination mit "Dokument aufteilen" werden für die gespeicherten Dokumente jeweils die erkannten Barcodes als Liste unter Temporären Werte gespeichert.
Dokument aufteilen?
Diese Option muss über einen Wertauflöser definierte werden. Für jeden Barcode wird nur ein Abschnitt(in dem der Barcode erkannt wurde) aus dem Gesamtdokument als (Teil-)Dokument gespeichert und zugewiesen.
Siehe auch: Barcode Erkennung (in Dokumente)
Überspringe Barcode Seite?
Diese Option muss über einen Wertauflöser definierte werden. Die Option Überspringe Barcode Seite? wirkt nur in Verbindung mit der Option Dokument aufteilen?. Diese Option regelt, welche Seiten als Teildokument erscheinen.
Siehe auch: Barcode Erkennung (in Dokumente)
Beispiel
Konfiguration:
Für Auslösenden Ereignisse sowie für die Prüfende Regel wurden keine Ereignisse oder Regeln definiert. Aktionen bei bestandener Regel:
|
|
Ergebnis :
Im Testmodus unter dem Tab Variablen wird folgender Ausschnitt angezeigt:
<entry>
<key xsi:type=
"xsd:string"
> result</key>
<value xsi:type=
"list"
>
<entry name=
"BarcodeExamples.pdf"
description=
"Detected Barcodes:CODE39;123ABCabc"
size=
"0"
reference=
""
xsi:type=
"doc:Document"
>
<temporaryValues>
<data>
<entry>
<key xsi:type=
"xsd:string"
>barcodeResults</key>
<value xsi:type=
"list"
>
<entry barcode=
"CODE39"
format=
"CODE_39"
page=
"0"
xsi:type=
"doc:BarcodeResult"
/>
<entry barcode=
"123ABCabc"
format=
"CODE_128"
page=
"1"
xsi:type=
"doc:BarcodeResult"
/>
</value>
</entry>
</data>
</temporaryValues>
<documentContent>JVBERi0xLjcKCjQgMCBvYmoKKElkZW50aXR5KQplbmRvYmoKNSAwIG9iagooQWRvYmUpCmVuZG9iago4IDAgb2JqCjw8Ci9GaWx0ZXIgL0ZsYXRlRGVjb2RlCi9MZW5ndGggMTc4MzIwCi9MZW5ndGgx...=</documentContent>
<attributes/>
</entry>
</value>
</entry>
→ Auswertung:
In dem Beispiel- Dokument sind auf mehreren Seiten Barcodes gespeichert, teilweise ein oder mehrere Barcodes pro Seite. Es wird ein Dokument angelegt und unter Temporären Werten die gefundenen Barcodeinformationen abgelegt. Dass nur ein Dokument angelegt wurde, wird durch die ausgewählten Option "Barcodes in einem Dokument zusammenfassen" verursacht. Dass nur zwei Barcodes in der Liste sind, liegt an den angelegten Barcode-Filtern. Wäre hier zusätzlich die Option "Dokument aufteilen" ausgewählt worden, wäre für Seiten mit mehreren Barcodes ein Dokument angelegt worden und unter Temporären Werten in der Liste ein Eintrag, pro erkannten Barcode, eingetragen worden. Sonst wird wenn nur "Dokument aufteilen" ausgewählt wird, ein Dokument pro erkannten Barcode angelegt.