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
Technologie-Stack
Dokumentation & Wiki
Schnellstart

✨ 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

Unterstützt durch KI-Assistenten für den Gebrauch im Unternehmen

2.9 KiB Raw Permalink Blame History