Initial Project

README_User_Guide.md

@@ -0,0 +1,51 @@
+# Kurzanleitung: Kabel-Konsolidierungs Add-In
+
+Willkommen beim Kabel-Konsolidierungs Tool! Mit diesem Add-In kannst du schnell und effizient hunderte von Kabel-Einträgen aus verschiedenen Arbeitsblättern zu einer einzigen "Kabelliste" zusammenfassen.
+
+## So startest du das Tool
+
+1. Öffne Excel.
+2. Wechsle im oberen Menüband (Ribbon) auf den Reiter **Start**.
+3. Klicke ganz rechts auf den neuen Button **Start Konsolidierung** (mit dem Kabel-Symbol).
+4. Das Add-In öffnet sich daraufhin am rechten Bildschirmrand.
+
+---
+
+## 1. Blätter auswählen & Dateien hochladen
+
+Im ersten Schritt sagst du dem Add-In, *woher* es die Kabeldaten nehmen soll:
+
+* **Interne Blätter:** Hier ist eine Liste aller sichtbaren Arbeitsblätter deines aktuell geöffneten Excel-Dokuments. Hake einfach alle Blätter an, die Kabeldaten enthalten.
+* **Externe Excel-Dateien hinzufügen:** Wenn deine Kollegen dir weitere Excel-Listen (als `.xlsx`, `.xlsm` oder `.csv`) geschickt haben, musst du diese **nicht** manuell in deine aktuelle Mappe kopieren! Klicke einfach auf den Durchsuchen-Button und lade die Dateien direkt hoch. Das Add-In liest sie im Hintergrund aus und fügt auch diese Arbeitsblätter der Checkliste hinzu.
+
+Klicke auf `Weiter`, wenn du alle gewünschten Blätter markiert hast.
+
+---
+
+## 2. Spalten-Mapping (Das Herzstück!)
+
+Nun liest das Tool automatisch die ersten 50 Zeilen der gewählten Blätter aus und sucht nach den Kopfzeilen (Spaltennamen), die Kabel-Informationen beinhalten.
+
+Das Add-In ist "schlau" und erkennt auch Abweichungen (es weiß z.B., dass "Kabelnummer" und "Nr." dasselbe meinen wie "K-Nr.").
+
+* **Ein grünes "OK":** Das Tool hat alle nötigen Spalten für dieses Arbeitsblatt automatisch gefunden. Du musst hier nichts mehr tun.
+* **Eine rote Warnung "X Lücken":** Für dieses Blatt konnten nicht alle Spalten automatisch gefunden werden.
+    * Klicke auf das Blatt, um die Details auszuklappen.
+    * Stelle sicher, dass unter **"Kopfzeile (Index 0-basiert)"** die korrekte Zeile angegeben ist, in der die Spaltenüberschriften stehen. Wenn deine Überschriften in Zeile 5 stehen, trage hier die "4" ein (da die Zählung bei 0 beginnt).
+    * Weise dann über das Dropdown-Menü manuell zu, welche Spalte im Dokument unserer Zielspalte (z.B. "von Raum") entspricht.
+    * Wenn ein Blatt komplett leer ist oder versehentlich ausgewählt wurde, lass die Spalten auf "--- Nicht gefunden ---". Das Tool überspringt diese Einträge am Ende ganz einfach, anstatt kaputtzugehen.
+
+---
+
+## 3. Konsolidierung
+
+Sobald du zufrieden bist, klicke unten auf den blauen Button **"Konsolidieren"**.
+
+Das Add-In wird nun:
+1. Eine komplett neue Tabelle namens **"Kabelliste"** in deiner Arbeitsmappe erzeugen (bzw. eine alte überschreiben).
+2. Alle Daten aus den internen UND externen Blättern in diese Tabelle schütten.
+3. Die Tabelle schön und übersichtlich formatieren (inkl. Filter-Buttons).
+4. Leere Zeilen automatisch überspringen und leere Spalten sauber auffüllen.
+
+Fertig! Dir wird am Ende rechts angezeigt, wie viele Zeilen erfolgreich aus den Blättern konsolidiert wurden.
+Du kannst das Add-In nun schließen oder einen neuen Durchlauf starten.