Autor: Levi Ackermann

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.

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.

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.

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 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.

Unser neues Nummernschema für Software-Versionen folgt einer klar definierten Struktur, die sowohl semantische Versionierung als auch branchspezifische Informationen umfasst. Hier erklären wir die Details dieser Struktur und wie Sie die Versionsnummern interpretieren können.

Allgemeiner Aufbau der Versionsnummer

Eine typische Versionsnummer sieht wie folgt aus:

v0.1.2-dev-87f8955

Bestandteile

Semantische Versionierung (v0.1.2)

• MAJOR: Erhöht sich bei inkompatiblen Änderungen.
• MINOR: Erhöht sich bei neuen Funktionen, die kompatibel bleiben.
• PATCH: Erhöht sich bei Fehlerbehebungen und kleinen Anpassungen. Bei einem offiziellen Release ist nur diese Nummer vorhanden (z. B. v1.0.0).

Branchname (dev)

• dev: Hauptentwicklungszweig.
• feature.: Feature-Entwicklungszweige für neue Funktionen.
• bug.: Fehlerbehebungszweige.
• custom.: Individuelle Anpassungen, z. B. Filtertechniken von Nutzern.

Commit-Hash (87f8955)

• Ein eindeutiger Identifier des Commits, der diese Version beschreibt. Dies ist nützlich, um genau nachzuverfolgen, welche Änderungen in der Version enthalten sind.

Branches und ihre Bedeutung

Hauptentwicklungsbranch (dev)

• Beinhaltet den aktuellsten Stand der Weiterentwicklung.
• Wird für neue Features, Verbesserungen und Tests genutzt.

Feature-Branches (feature.)

• Entsprechen spezifischen neuen Funktionen.
• Beispiele: feature.filter-optimization, feature.ui-redesign.

Bugfix-Branches (bug.)

• Dienen der Behebung von Fehlern in der Software.
• Beispiele: bug.login-issue, bug.data-corruption.

Custom-Branches (custom.)

• Ermöglichen nutzerspezifische Anpassungen, insbesondere bei Filtertechniken.
• Beispiele: custom.special-filter, custom.client-specific.
• Filter sind ein zentrales Feature der Software und können individuell hinzugefügt werden.

Beispielinterpretation

v0.1.2-dev-87f8955

• v0.1.2:
  – Major-Version 0: Noch in der frühen Entwicklungsphase.
  – Minor-Version 1: Neue Funktionalitäten seit der letzten Minor-Version.
  – Patch-Version 2: Kleinere Fehlerbehebungen oder Optimierungen.
• dev:
  – Entwicklungszweig ist der Hauptentwicklungsbranch.
• 87f8955:
  – Eindeutige Commit-ID zur Nachverfolgung.

v1.3.0-feature.filter-improvements-4ac12d8

• v1.3.0:
  – Major-Version 1: Stabile Hauptversion.
  – Minor-Version 3: Neue Funktionen seit der letzten stabilen Version.
  – Patch-Version 0: Keine Fehlerbehebungen seit dem letzten Minor-Release.
• feature.filter-improvements:
  – Branch für die Verbesserung von Filtertechniken.
• 4ac12d8:
  – Commit-ID der spezifischen Änderung.

v1.3.0-feature.filter-improvements-4ac12d8

• v1.3.0:
  – Major-Version 1: Stabile Hauptversion.
  – Minor-Version 3: Neue Funktionen seit der letzten stabilen Version.
  – Patch-Version 0: Keine Fehlerbehebungen seit dem letzten Minor-Release.
• feature.filter-improvements:
  – Branch für die Verbesserung von Filtertechniken.
• 4ac12d8:
  – Commit-ID der spezifischen Änderung.

v2.0.1-custom.client-request-bcdef12

• v2.0.1:
  – Major-Version 2: Größere, nicht abwärtskompatible Änderungen.
  – Minor-Version 0: Erste Version dieses Releases.
  – Patch-Version 1: Fehlerbehebung.
• custom.client-request:
  – Nutzerdefinierter Branch mit spezifischen Anpassungen.
• bcdef12:
  – Commit-ID der Änderung.

Fazit

Die Versionssemantik der Software bietet Ihnen eine transparente und strukturierte Möglichkeit, den Entwicklungsstand und die Branch-Herkunft einer Version nachzuvollziehen. Dank dieser Systematik können Sie als Nutzer ebenso wie alle Entwickler effizient auf spezifische Versionen und Anpassungen zugreifen.

Aufgrund der zeitweisen Stilllegung der Microsoft Downloadseite für die Windows 11 development downloads, haben wir die komplette Entwicklung, inklusive der Generierung des Windows nativen Installers auf Linux umgesetzt! 🎇

Für weitere Informationen zu den Windows 11 development downloads siehe auch den Beitrag Get a Windows 11 development environment.