doc:BarcodeDocument (Präprozessor)
Siehe auch: Barcode-Erkennung, Dokumente importieren, Dokumentenimport via Lobster_data
Der BarcodeDocument-Präprozessors ermöglicht die Barcode Erkennung für Dokumente beim Import.
Er beinhaltet als template-Unterknoten eine Strukturvorlage, die dem Dokument-Objekt entspricht. Über diese Struktur werden die Eingangsdaten - wie Inhalt, Name und Typ des zu importierendes Dokuments - per Mapping zugeordnet (s. a. Dokumentenimport via Lobster_data).
Der Präprozessor erzeugt ausgehend von den Zuweisungen für die Vorlage und der Auswertung des Dokumentinhalts unter Berücksichtigung der Parameter für die Barcode-Erkennung ein einzelnes oder mehrere Dokumentobjekte. Beim Import dieser Dokumente greifen die unter Dokumente zuweisen beschriebenen Mechanismen unter Berücksichtigung der aus der Barcode-Erkennung gewonnenen Daten.
Die folgende Struktur kann ausgehend von der Vorlage preProcessor:BarcodeDocument (s. Lobster_pro Vorlagen) direkt in die Import-Struktur eingebunden werden:
|
Parameter |
Typ |
Bedeutung |
Inhalt (Fixwert/Beispiel) |
xsi:type |
String-Attribut |
Typ des Präprozessors |
doc:BarcodeDocument |
splitDocument |
Boolean-Attribut |
Kennzeichen "Dokument aufteilen?" (s. Barcode-Erkennung); entscheidet ob Teildokumente je Barcode erstellt werden |
true / false |
skipBarcodePage |
Boolean-Attribut |
Kennzeichen "Überspringe Barcode-Seite?" (s. Barcode-Erkennung); entscheidet ob die Barcodeseite im Teildokument übersprungen wird |
true / false |
template |
Dokument-Struktur |
repräsentiert die Datenstruktur eines Dokumentobjekts (für Mapping und andere Zuweisungen) |
|
|
barcodeFilters |
Unterknoten |
Aufzählung aller relevanten Barcode-Filter (s. Barcode-Erkennung) zur Definition von "akzeptierten" Barcodes |
|
barcodePattern |
Text-Element |
Definition für das "Barcode-Muster", das ein Interpretationsschema für erkannte Barcodes definiert (s. Barcode-Erkennung) |
Beispiel:
Der folgende Batch-Import importiert das im template idenfizierte Dokument, anstelle von dessen Inhalt im documentContent-Element hier die Zeichenfolge "base64-String" eingesetzt wurde.
Das template spezifiziert hier außerdem den Dokumententyp "UPLOAD" und legt fest, dass versucht werden soll über den Referenztyp "Manifest" eine Referenz auf eine Entität vom Typ Manifest zu etablieren.
Die Basis für die Referenz soll ein Barcode liefern, der laut dem einzigen filter dem Format nach CODE_128 und inhaltlich einem angegebenen Regulären Ausdruck (regex) entsprechen soll.
<?xml version="1.0" encoding="UTF-8"?><core:BatchImport ... trxControl="SINGLE"> <batch action="CREATE"> <preProcessor xsi:type="doc:BarcodeDocument" splitDocument="false" skipBarcodePage="false"> <template name="doc00500720191129131002.pdf" referenceType="Manifest" referencedEntity="mfst:Manifest" documentType="UPLOAD"> <documentContent>"base64-String"</documentContent> </template> <barcodeFilters> <filter format="CODE_128" regex="^15[0-9]{8,}$"></filter> </barcodeFilters> </preProcessor> </batch></core:BatchImport>