Typ 4: PowerShell nach der Verarbeitung
Nach dem Speichern einer Ausgabedatei startet BarcodeOCR ein PowerShell-Skript. Das Skript erhält eine umfangreiche Datenstruktur mit Informationen zum Erkennungsvorgang. Im Vergleich zu Typ 1 bietet diese Schnittstelle weitere Optionen und mehr Informationen für die Weiterverarbeitung pro Ausgabedatei.
Sie richten die Schnittstelle im Schritt Erweitert der Arbeitsanweisung ein, im Bereich Starten eines PowerShell-Skriptes mit der Option Nach jedem Speicherprozess folgendes PowerShell-Skript ausführen. Vorher müssen Sie PowerShell vorbereiten.
Einen guten Einstieg bietet das Beispielskript External Application - Powershell write all parameters to file.ps1. Es schreibt alle übergebenen Informationen in eine Textdatei, siehe Beispielskripte.
Allgemeines
- BarcodeOCR ruft die Schnittstelle nach dem Speichern einer Ausgabedatei auf.
- Die Parameter werden als Datenobjekt übergeben.
- BarcodeOCR wartet, bis das Skript beendet ist, und wertet die zurückgegebenen Werte aus. Sind die Werte nicht leer, verwendet BarcodeOCR sie für die weitere Speicherung.
- Umbenennungen und die Behandlung von Duplikaten, die Sie in der Benutzeroberfläche festgelegt haben, wendet BarcodeOCR trotzdem an.
- Beim Warten auf das Skript gibt es kein Zeitlimit (Timeout).
Parameter
Die Schnittstelle übergibt ein Datenobjekt. Es kann auch Arrays und umfangreiche Texte enthalten.
Allgemeine Parameter
| Parameter | Bedeutung | Beispielwerte |
|---|---|---|
ConfigurationName | Name der Arbeitsanweisung | "Test" |
ConfigurationGuid | Eindeutige ID (Unique Identifier) der Arbeitsanweisung | cbfc4771-7f73-481e-b1ca-e4b95eb3d605 |
ConfigurationFilePath | Dateipfad zur Konfigurationsdatei | "C:\ProgramData\Keil IT\BarcodeOCR\AnalyserConfig.xml" |
UsedBarcode | Erkannter Barcode, der für die Trennung und Umbenennung verwendet wird | Inhalt des Barcodes, bei Fehlerdateien leer |
Result | Wurde die Datei im Ausgabeordner abgelegt? | True = Datei im Ausgabeordner gespeichert, False = Datei im Fehlerordner gespeichert |
ErrorReason | Grund, warum das Dokument in den Fehlerordner gelegt wurde | NoBarcode, CorruptedFile, Unknown, Duplicate, NameError |
FileProcessStartTime | Zeitpunkt, zu dem die Verarbeitung der Datei gestartet wurde | – |
SourceFilePath | Vollständiger Pfad zur Eingangsdatei | C:\Config\dec24748\Tour\Sample.pdf |
BackupFilePath | Vollständiger Pfad zur Datei im Sicherungsordner (sofern aktiv) | C:\Config\dec24748\Tour\Backup\Sample_eb3d605.pdf |
DestinationFilePath | Vollständiger Pfad zur Ausgabedatei | C:\Config\dec24748\Tour\Error\No_Barcode_1.pdf |
Subfolder | Unterordnerstruktur, sofern vorher festgelegt | Subfolder\Sub-Subfolder |
NumberOfPages | Anzahl der Seiten des Dokuments | 4 |
NumberOfRemovedPages | Anzahl der Seiten, die die Leerseitenerkennung entfernt hat | 0 |
StartPage | Seitenzahl der ersten Seite im ursprünglichen Stapel | 1 |
EndPage | Seitenzahl der letzten Seite im ursprünglichen Stapel | 4 |
Parameter pro Seite
Die folgenden Informationen werden als Array übergeben, mit einem Eintrag pro Seite des Ausgabedokuments.
| Parameter | Bedeutung | Beispielwerte |
|---|---|---|
Number | Seitenzahl | 4 |
RecognizedText | Erkannter Text auf dieser Seite (Modul Texterkennung) | "Lorem ipsum ...." |
Barcodes | Liste der erkannten Barcodes auf dieser Seite | Pro Barcode: Typ, Text und X/Y-Koordinaten |