Cable Consolidation (Excel Add-In)
Ein Microsoft Excel Web-Add-In, entwickelt von der SAT Elektrotechnik GmbH, zur intelligenten und effizienten Zusammenführung von Kabeldaten aus verschiedenen Tabellenblättern in eine formatierte "Kabelliste".
📖 Inhaltsverzeichnis
✨ Features
Das Add-In optimiert den Planungsprozess durch folgende Funktionen:
- Interne & Externe Quellen: Konsolidiert Tabellenblätter aus der aktuell geöffneten Arbeitsmappe sowie aus extern hochgeladenen Excel-Dateien (
.xlsx,.xlsm,.csv). - Intelligentes Mapping (Smart Aliasing): Erkennt selbstständig die benötigten Spalten (z.B. "K-Nr.", "von", "nach Raum", etc.), auch wenn alternative Bezeichnungen (wie "Kabelnummer" oder "Nr.") verwendet werden.
- Fehlertoleranz: Leere Blätter, versteckte Blätter oder fehlende Kopfzeilen bringen das Add-In nicht zum Absturz. Der Benutzer kann fehlende Zuweisungen manuell vornehmen.
- Saubere Ausgabe: Die konsolidierten Daten werden automatisch als ansprechende, filterbare Excel-Tabelle generiert.
💻 Technologie-Stack
Das Projekt nutzt modernste Web-Technologien in Kombination mit Microsofts Add-In Architektur:
- React (v18) für die dynamische Benutzeroberfläche (Task Pane).
- TypeScript für typsichere Geschäftslogik.
- Fluent UI (v9) für ein nahtloses, Microsoft-natives Design.
- Office.js API zum direkten Lesen und Schreiben im Excel-Dokument.
- SheetJS (xlsx) zum clientseitigen Parsen von externen Dateien direkt im Browser-Speicher.
- Webpack als Build-Tool.
📚 Dokumentation & Wiki
Alle ausführlichen Leitfäden und Dokumentationen findest du im Ordner /docs:
- Architektur & Logik: Erklärungen zur Code-Basis, den React-Komponenten und der Office.js Integration.
- Entwickler-Setup: Wie setze ich das Projekt lokal auf und entwickle weiter?
- Benutzerhandbuch: Die Schritt-für-Schritt Anleitung für die Endnutzer.
- Deployment & Hosting: Wie kommt das Tool auf den Ubuntu-Server und in das M365 Admin Center?
- Lokales Prod-Add-In (Sideloading): Wie lade ich das Produktions-Add-in in meiner lokalen Excel-App, wenn der Dev-Server nicht läuft?
🚀 Schnellstart
Wenn du direkt in den Code einsteigen willst:
# Abhängigkeiten installieren
npm install
# Lokalen Entwicklungs-Server starten & Excel Add-In Sideloaden
npm start
# Produktions-Build erstellen
npm run build
Entwickelt mit ❤️ für eine effizientere Kabelplanung.