eigene Doku für iocnonvertert gebaut

This commit is contained in:
2026-06-18 12:01:03 +02:00
parent 046bcf7290
commit eca5a82644
4 changed files with 182 additions and 56 deletions
+11 -18
View File
@@ -9,10 +9,10 @@
- [Excel-Datei: *dxfdatei*\_BOM.xlsx](#excel-datei-dxfdatei_bomxlsx)
- [Fehlerfälle und Fehlerbehandlung](#fehlerfälle-und-fehlerbehandlung)
- [Übersicht](#übersicht)
- [Zwei Haupt-Workflows](#zwei-haupt-workflows)
- [Programmablauf](#programmablauf)
- [Fehler- und Warnungskategorien](#fehler--und-warnungskategorien)
- [Fehlerausgabe](#fehlerausgabe)
- [Allgemeine Fehler und Warnungen (beide Workflows)](#allgemeine-fehler-und-warnungen-beide-workflows)
- [Allgemeine Fehler und Warnungen](#allgemeine-fehler-und-warnungen)
- [Struktur der Error-JSON-Datei](#struktur-der-error-json-datei)
- [Arbeiten mit Fehlerfällen](#arbeiten-mit-fehlerfällen)
- [Beispiele aus Testdaten](#beispiele-aus-testdaten)
@@ -187,20 +187,14 @@ Hinweis: Diese Ansicht ist besonders nützlich zur **vorbereitenden Bestellplanu
Das Programm führt während der Verarbeitung umfassende Validierungen durch und erkennt verschiedene Arten von Fehlern im Layout. Die Fehlerbehandlung unterscheidet sich je nach Anwendungsfall:
### Zwei Haupt-Workflows
### Programmablauf
Das Kabeltool unterstützt zwei verschiedene Workflows:
Das Kabeltool (`getexdraw.bat`) arbeitet in drei Schritten:
1. **Cable Routing Workflow** (`getexdraw.bat`):
- Schritt 1: `getpositions.py` - Extrahiert Positionen und validiert Layout
- Schritt 2: `routing.py` - Berechnet Kabelwege über Graph-Algorithmen
- Schritt 3: `drawdxf.py` - Erzeugt DXF mit Kabelwegen und Excel-Listen
- **Ausgabe**: `*_cables.dxf`, `*_cables.xlsx`, `*_BOM.xlsx`
2. **I/O Conversion Workflow** (`ioconverter.bat`):
- Schritt 1: `getpositions.py` - Extrahiert Positionen und validiert Layout
- Schritt 2: `portalexport.py` - Konvertiert zu Excel-Formaten (TIA, WSCAD, EA)
- **Ausgabe**: `*_TIA.xlsx`, `*_WSCAD.xlsx`, `*_EA.xlsx`
1. `getpositions.py` - Extrahiert Positionen und validiert Layout
2. `routing.py` - Berechnet Kabelwege über Graph-Algorithmen
3. `drawdxf.py` - Erzeugt DXF mit Kabelwegen und Excel-Listen
- **Ausgabe**: `*_cables.dxf`, `*_cables.xlsx`, `*_BOM.xlsx`
### Fehler- und Warnungskategorien
@@ -211,15 +205,14 @@ Die Fehlerbehandlung unterscheidet zwischen zwei Kategorien:
### Fehlerausgabe
**Für beide Workflows gilt:**
- Falls Fehler oder Warnungen auftreten, schreibt `getpositions.py` **automatisch** eine JSON-Datei `*_errors.json` in den `work`-Ordner
- Im **Cable Routing Workflow** werden zusätzliche Fehler in der Excel-Datei `*_cables.xlsx` als separate Worksheets ausgegeben (siehe [ERR-Worksheets](#erweiterte-ausgabe-im-fehlerfall))
- Zusätzliche Fehler werden in der Excel-Datei `*_cables.xlsx` als separate Worksheets ausgegeben (siehe [ERR-Worksheets](#erweiterte-ausgabe-im-fehlerfall))
Im Ordner [testdata/](testdata/) finden sich Beispiel-DXF-Dateien, die gezielt bestimmte Fehlerfälle demonstrieren (z.B. [easy_3tunnels_errors.json](testdata/easy_3tunnels_errors.json), [easy_tunnelerror1.json](testdata/easy_tunnelerror1.json)).
## Allgemeine Fehler und Warnungen (beide Workflows)
## Allgemeine Fehler und Warnungen
Die folgende Tabelle zeigt alle möglichen Fehler- und Warnungstypen, die von `getpositions.py` erkannt werden. Diese gelten **für beide Workflows** (Cable Routing und I/O Conversion):
Die folgende Tabelle zeigt alle möglichen Fehler- und Warnungstypen, die von `getpositions.py` erkannt werden:
| Fehlertyp | Kategorie | Beschreibung | Ursache | Behebung |
|-----------|-----------|--------------|---------|----------|