Einheitliche Befehle, aussagekräftige Exit-Codes und eigenes Branding im PDFParser
Mit der Version 4.0.5 erhält das CATweasel Toolkit zahlreiche Verbesserungen bei der Einbindung in bestehende Arbeitsabläufe, bei der Konfiguration und bei der Zuverlässigkeit der Auswertungsergebnisse. Damit lässt sich das Toolkit noch besser aus Skripten und anderen Programmen heraus steuern.
Im Mittelpunkt stehen die einheitliche Benennung der Befehle, Exit-Codes nach einer etablierten Konvention, ein eigenes Branding für die Ergebnis-PDFs sowie eine stabile, reproduzierbare Sortierung von Klemmen und Betriebsmitteln.
Einheitliche Befehle und bessere Integration
Befehle mit dem Präfix ctw-
Die Befehle des Toolkits beginnen jetzt mit ctw-. Dadurch werden Konflikte mit gleichnamigen Befehlen anderer Programme vermieden. Der PDFParser wird zum Beispiel so aufgerufen:
ctw-pdfparser Schaltplan.pdf
Der bisherige Befehl pdfparser funktioniert vorerst weiter, gibt jedoch einen Hinweis aus und entfällt in einer späteren Version. Skripte, die ihn verwenden, sollten daher angepasst werden. Verknüpfungen, das Menü „Senden an“ und der Eintrag „Öffnen mit“ werden vom Installer automatisch aktualisiert.
Exit-Codes für aufrufende Programme
Die Anwendungen melden jetzt mit ihrem Exit-Code, was schiefgegangen ist. Aufrufende Programme und Skripte können so gezielt auf die Art des Fehlers reagieren, statt nur zwischen „erfolgreich“ und „fehlgeschlagen“ zu unterscheiden. Die Codes folgen der verbreiteten sysexits.h-Konvention, zum Beispiel:
- 64 fehlerhafter Aufruf
- 66 Eingabedatei nicht gefunden
- 73 Ausgabedatei kann nicht geschrieben werden
- 78 Konfigurationsfehler
- 130 Abbruch durch den Benutzer
Die vollständige Liste enthält das Handbuch jeder Anwendung (–man). Auch die Startskripte wie ctw-pdfparser.cmd und catweasel.cmd geben den Exit-Code jetzt an den Aufrufer weiter. Bisher lieferten sie immer 0. Fehlermeldungen werden außerdem nur noch einmal angezeigt.
Parser für einzelne Aufrufe festlegen
Der Parser des PDFParsers kann für einen einzelnen Aufruf vorgegeben werden, etwa wenn der PDFParser von einem anderen Programm gestartet wird. Die Parserauswahl wird dann nicht angezeigt:
ctw-pdfparser –DefaultParser=SignedPageDeviceCounter Schaltplan.pdf
Alternativ ist die Umgebungsvariable CATWEASEL_DefaultParser möglich. Ein unbekannter Name wird mit einer Liste der konfigurierten Parser abgewiesen.
Strengere Prüfung der Kommandozeile
Optionen müssen jetzt vollständig ausgeschrieben werden. Abkürzungen wie –log für –log-level werden nicht mehr akzeptiert. Der PDFParser erwartet genau eine PDF-Datei. Dateinamen mit Leerzeichen sind beim direkten Aufruf in Anführungszeichen zu setzen. Der Aufruf per Drag-and-Drop oder über „Senden an“ ist davon nicht betroffen.
Eigenes Branding im Ergebnis-PDF
Der PDFParser kann auf jeder Seite des Ergebnis-PDFs ein Wasserzeichen und einen Stempel anbringen, beispielsweise das eigene Firmenlogo. Beide werden als PDF-Datei hinterlegt:
- var/custom/branding/watermark.pdf wird auf die Seitengröße skaliert und halbtransparent dargestellt.
- var/custom/branding/stamp.pdf behält seine Größe und wird in einer Ecke plat
Sind die Dateien vorhanden, werden sie automatisch verwendet. Andere Dateien, s Stempels lassen sich im neuen Block der pdfparser.cfg einstellen.
Die Testversion enthält ein Wasserzeichen und einen Stempel mit QR-Code zur Anforderung der Vollversion. Der Installer der Vollversion entfernt diese wieder, eigene Dateien bleiben
erhalten.
Zuverlässigere Konfiguration
Relative Pfade und Umgebungsvariablen
Relative Pfade in der Konfiguration, etwa bei FilterConfig oder einem immer auf das Installationsverzeichnis, unabhängig davon, von wo aus der
PDFParser gestartet wird. Außerdem können Umgebungsvariablen in Pfaden verwendet werden:
<Target "$PUBLIC\Documents\CATweasel">
Eine fehlende Filterdatei wird als Konfigurationsfehler mit vollständigem Pfad gemeldet.
Neu benannte und zusätzliche Parser
Die vorinstallierten Parser sind jetzt nach dem benannt, was sie erkennen. Aus „Standardfilter IEC81346“ wird SignedPageDeviceCounter, aus „Sonderfilter EXAMPLE“ wird PageDeviceCounter.
Die Filterregeln selbst bleiben unverändert. Bei einem Update passt der Instalbewahrt die bisherigen Dateien als .old auf, damit eigene Anpassungen
übernommen werden können. Hinzu kommt der neue Parser SignedDeviceCounter für Betriebsmittelkennzeichen wie -K1 ohne Seitenangabe. Die Kommentare der Parser-Konfigurationen wurden
überarbeitet, alle Parameter sind zentral in _example.cfg.tmpl dokumentiert.
Stabile und nachvollziehbare Sortierung
Klemmen, die Ziffern und Buchstaben kombinieren, etwa 1A, 11C oder 24VDC, werdzum Beispiel 1A, 1B, 4A, 11A. Bisher konnte ihre Reihenfolge von Lauf zu Lauf
abweichen. Damit liefert derselbe Schaltplan jetzt stets dasselbe Ergebnis.
Außerdem werden PA- und SH-Klemmen wie im Handbuch beschrieben am Ende der Klemmleiste hinter PE eingeordnet. Betriebsmittel ohne Nummer wie -K erscheinen direkt vor den nummerierten
Betriebsmitteln gleicher Kennbuchstaben (-K, -K1, -K2) statt in einem eigenen
Fehlerbehebungen
- Der PDFParser prüft vor der Auswertung, ob Ergebnis-PDF und Exportdateien geeine Datei noch geöffnet, etwa im PDF-Viewer oder in Excel, bricht er sofort
mit einem Hinweis auf die Datei ab, statt erst nach der vollständigen Auswertung zu scheitern. - In der Parserauswahl fehlten Parser mit gleichem SortCriteria. Jetzt werden
- Ist nur ein Parser konfiguriert, wird er direkt verwendet, statt zu einem internen Fehler zu führen.
- Das Verlassen der Parserauswahl ohne Auswahl wird als Abbruch durch den Benu
- PDF-Dateien mit einem Ausrufezeichen im Namen werden per Drag-and-Drop und „Senden an“ wieder gefunden.
- Ein Start ohne Datei, etwa über das Startmenü, schließt das Fenster nicht meFehlermeldung an.
Ausblick
Die Anwendungen unterstützen jetzt Unterbefehle mit eigenen Optionen und eigener Hilfe. Diese Struktur bildet die Grundlage für das neu entwickelte Modul Lagerist zur Verwaltung von
Materialdaten und Stücklisten, das in einer kommenden Version vorgestellt wird
Zusammenfassung
Die Version 4.0.5 macht das CATweasel Toolkit robuster und erleichtert die Einäufe:
- Einheitliche Befehle mit dem Präfix ctw- vermeiden Konflikte mit anderen Pro
- Aussagekräftige Exit-Codes ermöglichen aufrufenden Programmen eine gezielte Fehlerbehandlung.
- Eigenes Branding mit Wasserzeichen und Stempel im Ergebnis-PDF.
- Zuverlässigere Konfiguration durch einheitliche relative Pfade und Umgebungsvariablen.
- Reproduzierbare Ergebnisse dank stabiler Sortierung von Klemmen und Betriebs
- Frühzeitige Fehlererkennung, wenn Ergebnisdateien noch geöffnet sind.
Wer pdfparser in eigenen Skripten aufruft, sollte diese auf ctw-pdfparser umstellen und dabei die neuen Exit-Codes berücksichtigen.