{"id":762,"date":"2026-11-19T02:13:53","date_gmt":"2026-11-19T01:13:53","guid":{"rendered":"https:\/\/alx-development.de\/?p=762"},"modified":"2026-11-19T02:18:34","modified_gmt":"2026-11-19T01:18:34","slug":"catweasel-toolkit-4-0-5","status":"publish","type":"post","link":"https:\/\/alx-development.de\/?p=762","title":{"rendered":"CATweasel Toolkit v4.0.5"},"content":{"rendered":"\n<h1 class=\"wp-block-heading\">Einheitliche Befehle, aussagekr\u00e4ftige Exit-Codes und eigenes Branding im PDFParser<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">Mit der Version 4.0.5 erh\u00e4lt das CATweasel Toolkit zahlreiche Verbesserungen bei der Einbindung in bestehende Arbeitsabl\u00e4ufe, bei der Konfiguration und bei der Zuverl\u00e4ssigkeit der Auswertungsergebnisse. Damit l\u00e4sst sich das Toolkit noch besser aus Skripten und anderen Programmen heraus steuern.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Im Mittelpunkt stehen die einheitliche Benennung der Befehle, Exit-Codes nach einer etablierten Konvention, ein eigenes Branding f\u00fcr die Ergebnis-PDFs sowie eine stabile, reproduzierbare Sortierung von Klemmen und Betriebsmitteln.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Einheitliche Befehle und bessere Integration<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Befehle mit dem Pr\u00e4fix ctw-<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Die Befehle des Toolkits beginnen jetzt mit ctw-. Dadurch werden Konflikte mit gleichnamigen Befehlen anderer Programme vermieden. Der PDFParser wird zum Beispiel so aufgerufen:<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">ctw-pdfparser Schaltplan.pdf<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Der bisherige Befehl pdfparser funktioniert vorerst weiter, gibt jedoch einen Hinweis aus und entf\u00e4llt in einer sp\u00e4teren Version. Skripte, die ihn verwenden, sollten daher angepasst werden. Verkn\u00fcpfungen, das Men\u00fc \u201eSenden an\u201c und der Eintrag \u201e\u00d6ffnen mit\u201c werden vom Installer automatisch aktualisiert.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Exit-Codes f\u00fcr aufrufende Programme<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Die Anwendungen melden jetzt mit ihrem Exit-Code, was schiefgegangen ist. Aufrufende Programme und Skripte k\u00f6nnen so gezielt auf die Art des Fehlers reagieren, statt nur zwischen \u201eerfolgreich\u201c und \u201efehlgeschlagen\u201c zu unterscheiden. Die Codes folgen der verbreiteten sysexits.h-Konvention, zum Beispiel:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>64 fehlerhafter Aufruf<\/li>\n\n\n\n<li>66 Eingabedatei nicht gefunden<\/li>\n\n\n\n<li>73 Ausgabedatei kann nicht geschrieben werden<\/li>\n\n\n\n<li>78 Konfigurationsfehler<\/li>\n\n\n\n<li>130 Abbruch durch den Benutzer<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Die vollst\u00e4ndige Liste enth\u00e4lt das Handbuch jeder Anwendung (&#8211;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\u00dferdem nur noch einmal angezeigt.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Parser f\u00fcr einzelne Aufrufe festlegen<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Der Parser des PDFParsers kann f\u00fcr einen einzelnen Aufruf vorgegeben werden, etwa wenn der PDFParser von einem anderen Programm gestartet wird. Die Parserauswahl wird dann nicht angezeigt:<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">ctw-pdfparser &#8211;DefaultParser=SignedPageDeviceCounter Schaltplan.pdf<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Alternativ ist die Umgebungsvariable CATWEASEL_DefaultParser m\u00f6glich. Ein unbekannter Name wird mit einer Liste der konfigurierten Parser abgewiesen.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Strengere Pr\u00fcfung der Kommandozeile<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Optionen m\u00fcssen jetzt vollst\u00e4ndig ausgeschrieben werden. Abk\u00fcrzungen wie &#8211;log f\u00fcr &#8211;log-level werden nicht mehr akzeptiert. Der PDFParser erwartet genau eine PDF-Datei. Dateinamen mit Leerzeichen sind beim direkten Aufruf in Anf\u00fchrungszeichen zu setzen. Der Aufruf per Drag-and-Drop oder \u00fcber \u201eSenden an\u201c ist davon nicht betroffen.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Eigenes Branding im Ergebnis-PDF<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">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:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>var\/custom\/branding\/watermark.pdf wird auf die Seitengr\u00f6\u00dfe skaliert und halbtransparent dargestellt.<\/li>\n\n\n\n<li>var\/custom\/branding\/stamp.pdf beh\u00e4lt seine Gr\u00f6\u00dfe und wird in einer Ecke plat<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Sind die Dateien vorhanden, werden sie automatisch verwendet. Andere Dateien, s Stempels lassen sich im neuen Block der pdfparser.cfg einstellen.<br>Die Testversion enth\u00e4lt ein Wasserzeichen und einen Stempel mit QR-Code zur Anforderung der Vollversion. Der Installer der Vollversion entfernt diese wieder, eigene Dateien bleiben<br>erhalten.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Zuverl\u00e4ssigere Konfiguration<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Relative Pfade und Umgebungsvariablen<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Relative Pfade in der Konfiguration, etwa bei FilterConfig oder einem immer auf das Installationsverzeichnis, unabh\u00e4ngig davon, von wo aus der<br>PDFParser gestartet wird. Au\u00dferdem k\u00f6nnen Umgebungsvariablen in Pfaden verwendet werden:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;Target \"$PUBLIC\\Documents\\CATweasel\"&gt;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Eine fehlende Filterdatei wird als Konfigurationsfehler mit vollst\u00e4ndigem Pfad gemeldet.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Neu benannte und zus\u00e4tzliche Parser<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Die vorinstallierten Parser sind jetzt nach dem benannt, was sie erkennen. Aus \u201eStandardfilter IEC81346\u201c wird SignedPageDeviceCounter, aus \u201eSonderfilter EXAMPLE\u201c wird PageDeviceCounter.<br>Die Filterregeln selbst bleiben unver\u00e4ndert. Bei einem Update passt der Instalbewahrt die bisherigen Dateien als .old auf, damit eigene Anpassungen<br>\u00fcbernommen werden k\u00f6nnen. Hinzu kommt der neue Parser SignedDeviceCounter f\u00fcr Betriebsmittelkennzeichen wie -K1 ohne Seitenangabe. Die Kommentare der Parser-Konfigurationen wurden<br>\u00fcberarbeitet, alle Parameter sind zentral in _example.cfg.tmpl dokumentiert.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Stabile und nachvollziehbare Sortierung<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">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<br>abweichen. Damit liefert derselbe Schaltplan jetzt stets dasselbe Ergebnis.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Au\u00dferdem 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<br>Betriebsmitteln gleicher Kennbuchstaben (-K, -K1, -K2) statt in einem eigenen<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Fehlerbehebungen<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Der PDFParser pr\u00fcft vor der Auswertung, ob Ergebnis-PDF und Exportdateien geeine Datei noch ge\u00f6ffnet, etwa im PDF-Viewer oder in Excel, bricht er sofort<br>mit einem Hinweis auf die Datei ab, statt erst nach der vollst\u00e4ndigen Auswertung zu scheitern.<\/li>\n\n\n\n<li>In der Parserauswahl fehlten Parser mit gleichem SortCriteria. Jetzt werden<\/li>\n\n\n\n<li>Ist nur ein Parser konfiguriert, wird er direkt verwendet, statt zu einem internen Fehler zu f\u00fchren.<\/li>\n\n\n\n<li>Das Verlassen der Parserauswahl ohne Auswahl wird als Abbruch durch den Benu<\/li>\n\n\n\n<li>PDF-Dateien mit einem Ausrufezeichen im Namen werden per Drag-and-Drop und \u201eSenden an\u201c wieder gefunden.<\/li>\n\n\n\n<li>Ein Start ohne Datei, etwa \u00fcber das Startmen\u00fc, schlie\u00dft das Fenster nicht meFehlermeldung an.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Ausblick<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Die Anwendungen unterst\u00fctzen jetzt Unterbefehle mit eigenen Optionen und eigener Hilfe. Diese Struktur bildet die Grundlage f\u00fcr das neu entwickelte Modul Lagerist zur Verwaltung von<br>Materialdaten und St\u00fccklisten, das in einer kommenden Version vorgestellt wird<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Zusammenfassung<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Die Version 4.0.5 macht das CATweasel Toolkit robuster und erleichtert die Ein\u00e4ufe:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Einheitliche Befehle mit dem Pr\u00e4fix ctw- vermeiden Konflikte mit anderen Pro<\/li>\n\n\n\n<li>Aussagekr\u00e4ftige Exit-Codes erm\u00f6glichen aufrufenden Programmen eine gezielte Fehlerbehandlung.<\/li>\n\n\n\n<li>Eigenes Branding mit Wasserzeichen und Stempel im Ergebnis-PDF.<\/li>\n\n\n\n<li>Zuverl\u00e4ssigere Konfiguration durch einheitliche relative Pfade und Umgebungsvariablen.<\/li>\n\n\n\n<li>Reproduzierbare Ergebnisse dank stabiler Sortierung von Klemmen und Betriebs<\/li>\n\n\n\n<li>Fr\u00fchzeitige Fehlererkennung, wenn Ergebnisdateien noch ge\u00f6ffnet sind.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Wer pdfparser in eigenen Skripten aufruft, sollte diese auf ctw-pdfparser umstellen und dabei die neuen Exit-Codes ber\u00fccksichtigen.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Einheitliche Befehle, aussagekr\u00e4ftige Exit-Codes und eigenes Branding im PDFParser Mit der Version 4.0.5 erh\u00e4lt das CATweasel Toolkit zahlreiche Verbesserungen bei der Einbindung in bestehende Arbeitsabl\u00e4ufe, bei der Konfiguration und bei der Zuverl\u00e4ssigkeit der Auswertungsergebnisse. Damit l\u00e4sst sich das Toolkit noch besser aus Skripten und anderen Programmen heraus steuern. Im Mittelpunkt stehen die einheitliche Benennung der &hellip; <\/p>\n<p class=\"link-more\"><a href=\"https:\/\/alx-development.de\/?p=762\" class=\"read-more\">Read More<span class=\"screen-reader-text\"> &#8222;CATweasel Toolkit v4.0.5&#8220;<\/span><\/a><\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[7],"tags":[],"class_list":["post-762","post","type-post","status-publish","format-standard","hentry","category-software"],"_links":{"self":[{"href":"https:\/\/alx-development.de\/index.php?rest_route=\/wp\/v2\/posts\/762","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/alx-development.de\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/alx-development.de\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/alx-development.de\/index.php?rest_route=\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/alx-development.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=762"}],"version-history":[{"count":3,"href":"https:\/\/alx-development.de\/index.php?rest_route=\/wp\/v2\/posts\/762\/revisions"}],"predecessor-version":[{"id":766,"href":"https:\/\/alx-development.de\/index.php?rest_route=\/wp\/v2\/posts\/762\/revisions\/766"}],"wp:attachment":[{"href":"https:\/\/alx-development.de\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=762"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/alx-development.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=762"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/alx-development.de\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=762"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}