CATweasel Toolkit v4.0.3

Mit Version 4.0.3 wird das CATweasel Toolkit an mehreren Stellen weiter verbessert. Der Schwerpunkt liegt diesmal auf einer übersichtlicheren Darstellung der PDF-Ergebnisse, einem komfortableren Windows-Installer sowie der Unterstützung von Entwicklungs- und Testversionen.

Verbesserte Darstellung der PDF-Ergebnisse

Der PDFParser zeichnet die erkannten Elemente im Ergebnis-PDF nun in einer festen Reihenfolge. Dadurch ist unabhängig von der Reihenfolge der Erkennung sichergestellt, dass die einzelnen Elemente korrekt sichtbar bleiben.

Die zusammengeführte Anschlussfläche eines Betriebsmittels wird dabei im Hintergrund dargestellt, einzelne Anschlüsse darüber und die Betriebsmittelkennzeichen schließlich im Vordergrund. Zuvor konnte es vorkommen, dass die zusammengeführte Anschlussfläche andere Erkennungsergebnisse teilweise überdeckte.

An der eigentlichen Erkennung oder an den Konfigurationseinstellungen ändert sich dadurch nichts. Es wurde ausschließlich die Darstellung des erzeugten Ergebnis-PDFs verbessert.

Verbesserungen am Windows-Installer

Der CATweasel-Uninstaller wird nun korrekt in der Windows-Liste der installierten Anwendungen registriert. Zusätzlich ist er direkt über den CATweasel-Ordner im Startmenü erreichbar.

Für Test- und Präsentationsversionen steht außerdem eine Verknüpfung zu den mitgelieferten Beispieldateien zur Verfügung. Diese wird bei entsprechenden Entwicklungsbuilds bereits standardmäßig zur Installation ausgewählt. Auch reguläre Release-Versionen können die Verknüpfung anlegen, wobei sie dort optional während der Installation ausgewählt werden kann.

Neue Vereinbarung für Test- und Präsentationsversionen

Mit den Entwicklungsbuilds wird eine neue Test- und Präsentationsvereinbarung eingeführt. Damit können aktuelle Entwicklungsstände des dev-Branches beispielsweise für Tests oder Präsentationen bereitgestellt werden.

Diese sogenannten Nightly Builds sind zeitlich auf einen Zeitraum von bis zu vier Wochen ausgelegt und werden ausdrücklich als Entwicklungsstände ohne Garantie, Support oder Sicherheitsupdates bereitgestellt. Rückmeldungen und Fehlerberichte sind selbstverständlich willkommen, begründen jedoch keinen Anspruch auf eine Bearbeitung oder Fehlerbehebung.

Angepasste Lizenzierung von Entwicklungsbuilds

Entwicklungsbuilds werden nicht mehr unter der ASL ausgeliefert. Der Installer weist bei diesen Versionen stattdessen auf die geltenden Bedingungen für Test- und Entwicklungsbuilds hin und installiert den entsprechenden Hinweis.

Die regulären Releases bleiben davon unberührt.

Vereinheitlichte Lizenzhinweise

Die Lizenzhinweise im Quellcode wurden vereinheitlicht. Sie verweisen nun einheitlich auf die LICENSE-Datei, die Bestandteil jeder Distribution ist. Dadurch wird vermieden, dass unterschiedliche oder veraltete Lizenztexte innerhalb des Quellcodes gepflegt werden müssen.

Fazit

Mit v4.0.3 werden vor allem bestehende Funktionen und Abläufe weiter abgerundet. Die Verbesserungen reichen von einer zuverlässigeren Darstellung der PDF-Ergebnisse über einen komfortableren Windows-Installer bis hin zu klar definierten Rahmenbedingungen für Entwicklungs- und Testversionen.

CATweasel Toolkit v4.0.2

Mit Version 4.0.2 wird die Filterverarbeitung des CATweasel Toolkits grundlegend flexibler. Die bisher fest implementierte Filterkonfiguration wurde durch die neuen CATweasel-Filterdefinitionen ersetzt.

Damit entsteht eine wesentlich bessere Grundlage für komplexere Filterregeln und zukünftige Erweiterungen der Erkennung.

Neue Filterarchitektur

Die bisher verwendeten Filtermodule wurden durch eine neue Filterarchitektur ersetzt. Anstelle der bisherigen ECAD::PDF::Filter::*-Module kommen nun die entsprechenden CTW::PDF::Filter::*-Module zum Einsatz.

Dabei handelt es sich nicht lediglich um eine Umbenennung. Die neue Struktur bildet eine technische Weiterentwicklung der Filterverarbeitung und schafft die Grundlage für künftig leistungsfähigere Filterdefinitionen.

Die bisherigen Modulnamen werden aus Gründen der Kompatibilität vorerst weiterhin akzeptiert. Ihre Verwendung wird jedoch im Log als Warnung protokolliert und ist nur als Übergangslösung vorgesehen. Bestehende Konfigurationen sollten daher auf die neuen CTW-Modulnamen umgestellt werden.

Einfachere Filterkonfiguration

Die Angabe eines Filters ist ab dieser Version optional.

Wird kein Filter explizit angegeben, wählt der PDFParser automatisch die passende Standardkonfiguration: Ist eine eigene FilterConfig vorhanden, wird der Custom-Filter verwendet. Andernfalls kommt der Standardfilter zum Einsatz.

Wird ein Filter ausdrücklich angegeben, hat diese Einstellung weiterhin Vorrang.

Dadurch können einfache Konfigurationen kompakter gehalten werden, während für komplexere Anwendungen weiterhin die vollständige Kontrolle über die Filterverarbeitung erhalten bleibt.

Aktualisierte Beispiele und Dokumentation

Die neue Filterarchitektur wurde auch in der Dokumentation und den mitgelieferten Beispielkonfigurationen berücksichtigt. Damit stehen die Beispiele unmittelbar mit der aktuellen technischen Struktur im Einklang.

Gerade bei bestehenden Installationen empfiehlt sich ein Blick auf die aktualisierte Dokumentation, um ältere Filterdefinitionen auf die neue Struktur umzustellen.

Angepasster XLSX-Export

Im XLSX-Export wurde das bisherige Tabellenblatt BMK in Devices umbenannt.

Die neue Bezeichnung entspricht damit der Benennung der zugehörigen Konfigurationsoptionen und sorgt für eine konsistentere Terminologie innerhalb des Exports.

Technische Bereinigung

Neben den funktionalen Änderungen wurden verschiedene binäre Dateien und Bestandteile der Distribution bereinigt. Dadurch konnten Größe und Komplexität der Distribution reduziert werden.

Auch diese Arbeiten tragen dazu bei, die technische Basis des CATweasel Toolkits übersichtlicher und besser wartbar zu halten.

Aktualisierte Lizenz

Mit Version 4.0.2 wurde außerdem die Lizenz auf ASL 1.1 aktualisiert.

Die neue Fassung stellt insbesondere die Rahmenbedingungen für die Nutzung in Container- und Hosting-Umgebungen klarer dar und berücksichtigt den Zugriff auf den Quellcode im Rahmen von Wartungsvereinbarungen.

Weitere Neuerung: Changelog

Mit dieser Version wird erstmals ein zentraler CHANGELOG.md Bestandteil der Distribution. Damit werden Änderungen und Neuerungen künftig versionsbezogen dokumentiert und können auch unabhängig von der ausführlichen technischen Dokumentation nachvollzogen werden.

Version 4.0.2 legt damit vor allem bei der Filterverarbeitung die Grundlage für weitere funktionale Erweiterungen und eine flexiblere Konfiguration des PDFParsers.

CATweasel Toolkit v4.0.1

Mit Version 4.0.1 wird die mit Version 4.0 eingeführte technische Basis weiter ausgebaut. Der Schwerpunkt liegt insbesondere auf den Exportfunktionen des PDFParsers, der Windows-Integration sowie einer weiteren Überarbeitung der Dokumentation und Konfiguration.

Neuer CSV-Export

Eine der wichtigsten Neuerungen ist die überarbeitete Implementierung des CSV-Exports.

Der CSV-Export bietet nun Konfigurationsmöglichkeiten, die sich an den bereits vorhandenen Optionen des XLSX-Exports orientieren. Zusätzlich stehen CSV-spezifische Einstellungen zur Verfügung.

Damit lassen sich die erzeugten CSV-Dateien wesentlich flexibler an die jeweiligen Anforderungen der Weiterverarbeitung anpassen.

Verbesserte Verarbeitung von PDF-Anhängen

Die Verarbeitung eingebetteter PDF-Dateien wurde verbessert. Ein Fehler bei der Erzeugung mehrerer Exporte, durch den PDF-Anhänge nicht in allen Fällen korrekt behandelt wurden, wurde behoben.

Damit ist die Kombination mehrerer Exporte und eingebetteter Dateien zuverlässiger geworden.

Verbesserte Verwaltung temporärer Dateien

Auch die Handhabung temporärer Dateien wurde überarbeitet. Die Erstellung, Verwendung und anschließende Bereinigung temporärer Dateien erfolgt nun kontrollierter.

Dies verbessert insbesondere die Zuverlässigkeit bei der Verarbeitung komplexerer Exportvorgänge und reduziert unnötig zurückbleibende temporäre Dateien.

Bessere Windows-Integration

Der PDFParser wird unter Windows nun für „Öffnen mit…“ registriert. PDF-Dateien können dadurch direkt über die Windows-Dateizuordnung mit dem PDFParser geöffnet werden.

Damit fügt sich der PDFParser besser in die gewohnte Arbeitsweise unter Windows ein.

Überarbeitete Konfiguration und Dokumentation

Die Konfigurationsmöglichkeiten des PDFParsers wurden weiter ausgebaut und entsprechend dokumentiert. Dies betrifft unter anderem Einstellungen für Parser, Exporte und Logging.

Gleichzeitig wurde die technische Dokumentation deutlich erweitert und überarbeitet. Neben der Konfiguration werden nun auch Aspekte der Sicherheit und Cyber-Resilienz ausführlicher beschrieben.

Weitere Verbesserungen

Zusätzlich wurden verschiedene Probleme im Installer und im Setup behoben. Auch der Build-Prozess wurde an mehreren Stellen verbessert und bereinigt.

Version 4.0.1 entwickelt damit insbesondere die Exportfunktionen und die Integration in die Windows-Umgebung weiter und ergänzt die umfangreiche technische Grundlage von Version 4.0 um zahlreiche praktische Verbesserungen.

CATweasel Toolkit v4.0.0

Mit Version 4.0.0 erhält das CATweasel Toolkit eine umfassende technische Überarbeitung. Neben einer neuen Grundlage für die PDF-Verarbeitung wurde insbesondere die Installation und Bereitstellung des Systems deutlich vereinfacht.

Die neue Version schafft damit eine kompaktere und besser wartbare Basis für die weitere Entwicklung des CATweasel Toolkits.

Vereinfachte Installation und weniger Abhängigkeiten

Ein wesentlicher Schwerpunkt der neuen Version ist die Reduzierung externer Abhängigkeiten. Komponenten mit restriktiven Lizenzbedingungen wurden aus der Distribution entfernt. Insbesondere ist für die PDF-Verarbeitung keine separate Installation von pdftk Server oder Ghostscript mehr erforderlich.

Die bisher von diesen Komponenten übernommenen Aufgaben werden nun durch qpdf sowie durch native Funktionen des PDFParsers erledigt. Die benötigten Komponenten werden bei der Windows-Distribution entsprechend bereitgestellt.

Dadurch wird die Installation deutlich übersichtlicher und das CATweasel Toolkit kann einfacher auf Zielsystemen eingerichtet und betrieben werden.

Neuer Installer und überarbeitetes Deployment

Auch der Windows-Installer wurde grundlegend überarbeitet und an den neuen Build- und Release-Prozess angepasst.

Die bisher erforderlichen zusätzlichen Installationsschritte für die PDF-Verarbeitung entfallen. Gleichzeitig wurde die Installationsdokumentation an die neue Struktur angepasst, sodass Installation und Konfiguration klarer voneinander getrennt sind.

Neue Konfigurationsstruktur

Die Konfiguration des CATweasel Toolkits wurde neu strukturiert. Insbesondere werden die Einstellungen des PDFParsers und der Exporte nun klar voneinander getrennt.

Darüber hinaus wurden neue Konfigurationsmöglichkeiten für Logging, die Verarbeitung temporärer Dateien und die Exportverarbeitung geschaffen. Damit lassen sich die Abläufe des PDFParsers besser an unterschiedliche Einsatzszenarien anpassen.

Deutlich erweiterte Dokumentation

Mit Version 4.0.0 wurde auch die technische Dokumentation erheblich erweitert.

Neben einer ausführlichen Dokumentation zur Konfiguration des PDFParsers enthält die neue Dokumentation unter anderem Informationen zu:

  • technischen Grundlagen der PDF-Verarbeitung,
  • Filterdefinitionen und deren Konfiguration,
  • relevanten Normen für Texte und Benennungen in Schaltplänen,
  • Sicherheit und Cyber-Resilienz,
  • Installation und Bereitstellung des CATweasel Toolkits.

Damit steht neben der Software selbst auch eine deutlich umfassendere Grundlage für deren Konfiguration und Betrieb zur Verfügung.

Weitere technische Verbesserungen

Neben den größeren Änderungen enthält Version 4.0.0 zahlreiche kleinere Verbesserungen am Build-System, Installer, der Konfigurationsverarbeitung und der PDF-Verarbeitung.

Die Version bildet damit die technische Grundlage für die weitere Entwicklung des CATweasel Toolkits und schafft insbesondere bei Installation, Konfiguration und Wartung eine deutlich klarere Struktur.

CATweasel Toolkit v3.0.2

Ich freue mich euch mitteilen zu können, dass ab sofort das Release v3.0.2 unseres CATweazle Toolkit zur Verfügung steht.

In diesem Release haben wir uns vor allem darauf konzentriert unsere neue Struktur weiter zu festigen und daher einige Änderungen an der Dateistruktur vorgenommen und Links, die durch die Umstellungen nicht mehr funktionsfähig waren wieder korrigiert.

Auf neue Funktionen haben wir in diesem Release bewusst verzichtet. Neue Funktionen sind bereits in Entwicklung und werden mit dem kommenden Update dann zur Verfügung stehen.

Der aktualisierte Toolkit steht für euch wie gewohnt im Download-Bereich bereit.

CATweasel Toolkit v3.0.1

Nachdem die getrennte Installation von Interpreter und Anwendung auf aktuellen Windows 11 Versionen fehlgeschlagen ist, haben wir uns entschieden mit dem Patch zu Version 3.0.1 den Interpreter jetzt voll integriert mitzuliefern. Es gibt daher ab sofort nur noch eine Installer-Datei, die alles enthält.

Der aktualisierte Toolkit steht für euch wie gewohnt im Download-Bereich bereit.

PDFParser ist jetzt Teil des CATweasel Toolkit

Seit Version 3.0.0 unseres CATweasel Toolkit ist nun der PDFParser Teil des Toolkit und wartet auch mit einer Menge neuer Features auf. Wenn sie auf den CATweasel Toolkit umsteigen möchten und dabei ihre Einstellungen und Custom-Filter beibehalten wollen, dann ist die Kenntnis über die neue Datenstruktur erforderlich.

Wir haben hier einige Verbesserungen vorgenommen, die Benutzereinstellungen vereinfachen sollen. So sind alle Einstellungsdateien aus den Unterstrukturen (perl/site/bin) auf die oberste Ebene in das Verzeichnis etc gewandert. Das bringt eine klarere Trennung zwischen den eigentlichen Programmdaten und der Konfigurationsdateien mit sich. Insbesondere bei komplexeren und verteilten Konfigurationen bringt diese Struktur eine bessere Übersicht.

Bevor sie auf den CATweasel Toolkit umsteigen, sollten sie eine Sicherheitskopie der Datei perl\site\bin\pdfparser.cfg anlegen. Der Inhalt dieser Datei muss später gegebenenfalls auf mehrere Einstellungsdateien in der neuen Struktur eingebunden werden.

Danach empfehlen wir alle CATweasel Tools komplett zu deinstallieren und etwaige „Überbleibsel“ manuell aus dem Installationspfad zu löschen. Hierzu den kompletten Ordner CATweasel nach der Deinstallation löschen. Dies verhindert, dass ggf. obsolete Einstellungen oder Bibliotheken, die im Dateisystem nicht gelöscht wurden bei der Installation des Toolkits zu Problemen führen.

Die Einstellungen zum Parser direkt sind weiterhin in der Datei pdfparser.cfg in der neuen Struktur abgelegt. Hier können sie ihre bisherigen Einstellungen übernehmen.

Im einfachsten Fall, ohne individuelle Änderungen, können sie einfach ihre bestehende pdfparser.cfg nehmen und damit die installierte Datei im Ordner `etc` überschreiben.

Da globale Einstellungen wie das „Logging“ jetzt in der zentralen Einstellungsdatei catweasel.cfg geführt werden, sollte dieser Abschnitt aus der alten Einstellungsdatei des PDFParser pdfparser.cfg entfernt werden.

Ich hoffe, diese Informationen helfen euch weiter bei eurem Umstieg auf unseren neuen CATweasel Toolkit und wünsche euch viel Spaß damit.

Euer Niklas

P.S.: Achtet bitte auch darauf, dass sich die Konfigurationsebene für den Parser geändert hat. Die Zwischenebene <ParserList> ist aus den Einstellungen entfallen!

Noch ein wichtiger Hinweis für alle, die ein bestehendes Profil des PDFParser auf den neuen Toolkit umziehen wollen: In der Konfigurationsstruktur ist die Ebene <ParserList> entfallen. Die Parser werden jetzt direkt auf der Ebene <PDFParser> angelegt. Für bestehende Konfigurationen bedeutet das, dass die Parser eine ebene nach oben verlegt werden müssen.

Siehe auch Kommentar: https://alx-development.de/?p=397#comment-3

CATweasel Toolkit v3.0.0

CATweasel Toolkit Version 3.0.0 veröffentlicht

Nach intensiver Entwicklungszeit freuen wir uns, die erste Version unseres neuen CATweasel Toolkits vorstellen zu können. Mit der Version 3.0.0 beginnt eine neue Ära unserer Softwarefamilie rund um die Datenverarbeitung im Schaltanlagenbau.

Die Versionsnummer 3.0.0 ist bewusst gewählt: Alle bisherigen CATweasel-Tools lagen maximal in Version 2 vor. Mit dem Toolkit führen wir die bisher getrennten Anwendungen in einer gemeinsamen Plattform zusammen und möchten so von Beginn an eine klare Abgrenzung zu den älteren Einzellösungen schaffen.

Alles in einem Toolkit vereint

Das CATweasel Toolkit vereint erstmals alle bisherigen Werkzeuge unter einer einheitlichen Oberfläche. In der aktuellen Version sind folgende Module enthalten:

  • PDFParser – zum Extrahieren, Analysieren und Filtern von PDF-Dokumenten
  • Lagerist – für die Verwaltung von Stücklisten, Artikeln und Logistikprozessen
  • Terminal – die leistungsstarke Kommandozeilenumgebung mit zahlreichen nützlichen Funktionen

Damit steht erstmals eine zentrale Plattform zur Verfügung, die die Arbeitsabläufe im Schaltanlagenbau effizienter und konsistenter macht. Einzelne Komponenten müssen nicht mehr separat installiert und aktualisiert werden – alles läuft integriert über das Toolkit.

Ältere Einzelversionen laufen aus

Die bisherigen Einzelversionen der Tools bleiben vorerst im Downloadbereich verfügbar, werden jedoch nicht mehr weiterentwickelt. Alle zukünftigen Erweiterungen und Verbesserungen erfolgen ausschließlich im Rahmen des CATweasel Toolkits.

Bitte beachtet: Ein einfaches Update von den Einzelversionen auf das Toolkit ist nicht möglich. Die alten Programme müssen zunächst vollständig deinstalliert werden, bevor das Toolkit installiert werden kann.

Bereits vorhandene Konfigurationen und Filterdefinitionen (z. B. aus dem PDFParser) bleiben weiterhin lauffähig und können in der neuen Umgebung weiterverwendet werden.

Abkündigung älterer Versionen

Die bisherigen Einzelversionen werden mittelfristig vollständig abgekündigt, sobald dort sicherheitsrelevante Änderungen notwendig würden. Diese alten Versionen werden dann aus dem Downloadbereich entfernt, da alle Wartung und Weiterentwicklung künftig nur noch für das Toolkit erfolgt.

Wir empfehlen daher allen Anwenderinnen und Anwendern, frühzeitig auf das neue CATweasel Toolkit 3.0.0 umzusteigen, um auch in Zukunft von allen Verbesserungen und Sicherheitsupdates profitieren zu können.

Ausblick

Mit dem Toolkit legen wir den Grundstein für die zukünftige Weiterentwicklung der CATweasel-Plattform. Geplant sind unter anderem neue Schnittstellen, verbesserte Automatisierungsfunktionen und eine engere Integration zwischen den Modulen.

Wir bedanken uns bei allen, die in den letzten Monaten Feedback gegeben und die Entwicklung begleitet haben. Das CATweasel Toolkit ist ein großer Schritt in Richtung einer modernen, einheitlichen und datenschutzfreundlichen Softwarebasis – und das Fundament für viele weitere spannende Funktionen in der Zukunft.

Download: Das neue CATweasel Toolkit 3.0.0 steht ab sofort im Downloadbereich zur Verfügung.

Neue Betriebsmittelsortierung

In der neusten Version gibt es jetzt einen ganz neuen Sortieralgorithmus für Betriebsmittelkennzeichen. Hier wird nicht mehr nur die Alphanumerische Sortierung, die zum Beispiel auch bei Excel eingesetzt wird, verwendet. Ein speziell entwickelter Sortieralgorithmus sortiert die Betriebsmittel sowohl nummerisch als auch alphabetisch, je nach Element des Betriebsmittelkennzeichens.

DeviceSorter = DevicePageAlphaNum

Seitennummern werden zum Beispiel nummerisch sortiert, die Kennbuchstaben dann alphabetisch, usw.

Wichtiges Sicherheitsupdate!

Bitte aktualisieren Sie den CATweasel PDFParser auf die aktuelle Version 2.0.2. Hier wurden einige Fehler im Installer behoben, als auch eine Sicherheitslücke beim Aufrufprozess behoben.

Es ist in den älteren Versionen zwar sehr unwahrscheinlich, aber dennoch möglich, dass durch eine Manipulation des Dateinamens der PDF-Datei mittels des Ampersand (&) Code neben dem Parser ausgeführt werden kann.

Da die Dateien manuell dem Parser per Drag’n Drop zugeführt werden ist es extrem unwahrscheinlich, dass eine solche „Code-Injection“ nicht auffällt, jedoch nicht gänzlich ausgeschlossen. Bisher ist dieser Bug nur dadurch aufgefallen, dass PDF-Dateien mit dem Ampersand im Dateinamen nicht bearbeitet wurden und das System mit einem Fehler abbricht.

Dieses Fehlverhalten ist mit dem Bugfix auch korrigiert. Dateien mit dem Ampersand im Datei- bzw. Pfadnamen werden jetzt korrekt bearbeitet.

Sollten Ihnen auch Fehler auffallen, die eine mögliche Sicherheitslücke darstellen könnten, melden Sie diese bitte umgehend an info@alx-development.de. Wir werden uns umgehend um derartige Meldungen kümmern und schnellstmöglich entsprechende Bugfixes bereitstellen.