diff --git a/README_Deployment_Guide.md b/README_Deployment_Guide.md deleted file mode 100644 index 75792da..0000000 --- a/README_Deployment_Guide.md +++ /dev/null @@ -1,130 +0,0 @@ -# Deployment Guide: Ubuntu Server (Nginx + SSL) - -Diese Anleitung beschreibt, wie du das fertig gebaute Excel Add-in auf deinem privaten Ubuntu-Server unter der Domain `https://kabel.casademm.de` hosten kannst. - -## Voraussetzung -1. Ein Linux-Server (Ubuntu) mit Root/Sudo-Zugriff. -2. Die Domain `kabel.casademm.de` muss im DNS-Manager deines Domain-Anbieters auf die IP-Adresse (A-Record) dieses Servers zeigen. -3. Du hast lokal auf deinem Entwicklungsrechner den Befehl `npm run build` ausgeführt. Dadurch wurde ein Ordner namens `dist` in deinem Projektverzeichnis (`C:\EWSL_Add_in\CableConsolidation\dist`) erstellt. - ---- - -## Schritt 1: Nginx installieren -Verbinde dich per SSH mit deinem Ubuntu-Server und aktualisiere die Paketquellen, um danach den Nginx Webserver zu installieren: - -```bash -sudo apt update -sudo apt install nginx -y -``` - -Stelle sicher, dass Nginx läuft und beim Systemstart automatisch mitstartet: -```bash -sudo systemctl enable nginx -sudo systemctl start nginx -``` - -Falls du die `ufw` Firewall nutzt, erlaube den Nginx-Traffic: -```bash -sudo ufw allow 'Nginx Full' -``` - ---- - -## Schritt 2: Dateien auf den Server kopieren - -1. Erstelle auf dem Server ein Verzeichnis für deine Domain: -```bash -sudo mkdir -p /var/www/kabel.casademm.de/html -``` - -2. Passe die Rechte an, damit Nginx (und dein User) darauf zugreifen können: -```bash -sudo chown -R $USER:$USER /var/www/kabel.casademm.de/html -sudo chmod -R 755 /var/www/kabel.casademm.de -``` - -3. Übertrage nun den Inhalt deines lokalen `dist`-Ordners in dieses Verzeichnis auf dem Server. Das kannst du z.B. über ein SFTP-Programm wie WinSCP oder FileZilla machen. - * **Quelle:** `C:\EWSL_Add_in\CableConsolidation\dist\*` - * **Ziel (Server):** `/var/www/kabel.casademm.de/html/` - -*(Tipp: Vergewissere dich, dass die Datei `taskpane.html` und der `assets`-Ordner direkt im `/html/`-Verzeichnis liegen!)* - ---- - -## Schritt 3: Nginx für die Domain konfigurieren - -Erstelle eine neue Server-Block Konfigurationsdatei für Nginx: - -```bash -sudo nano /etc/nginx/sites-available/kabel.casademm.de -``` - -Kopiere folgenden Inhalt hinein (dies lauscht erstmal nur auf Port 80): - -```nginx -server { - listen 80; - listen [::]:80; - - root /var/www/kabel.casademm.de/html; - index taskpane.html index.html index.htm; - - server_name kabel.casademm.de; - - location / { - try_files $uri $uri/ =404; - # Erlaubt CORS, was für Web-Add-Ins nützlich ist - add_header Access-Control-Allow-Origin *; - } -} -``` - -Speichere die Datei (in Nano: `Strg+O`, `Enter`, `Strg+X`). - -Aktiviere die Konfiguration, indem du einen Symlink erstellst: -```bash -sudo ln -s /etc/nginx/sites-available/kabel.casademm.de /etc/nginx/sites-enabled/ -``` - -Prüfe, ob Nginx meckert, und starte neu: -```bash -sudo nginx -t -sudo systemctl reload nginx -``` - ---- - -## Schritt 4: SSL-Zertifikat sichern (WICHTIG!) -Microsoft Office weigert sich strikt, Add-ins ohne gültiges HTTPS-Zertifikat zu laden. Wir nutzen Certbot für ein kostenloses Let's Encrypt Zertifikat. - -1. Installiere Certbot: -```bash -sudo apt install certbot python3-certbot-nginx -y -``` - -2. Generiere das Zertifikat: -```bash -sudo certbot --nginx -d kabel.casademm.de -``` - -Certbot wird dich nach deiner E-Mail-Adresse fragen und dir anbieten, den Traffic automatisch auf HTTPS umzuleiten (wähle Option "2: Redirect"). - -Sobald Certbot fertig ist, läuft dein Server sicher unter `https://kabel.casademm.de`. - ---- - -## Schritt 5: In Excel einbinden / ausrollen - -Jetzt wo dein Server online ist, benötigst du (und deine Firma) nur noch eine einzige Datei: Die `manifest.xml`. - -In der `manifest.xml` (welche du ebenfalls in deinem Projekt-Root hast) stehen bereits alle Verweise auf `https://kabel.casademm.de`. - -**Wie lade ich es im Office 365 Admin Center hoch?** -1. Die IT geht auf `admin.microsoft.com`. -2. Gehe zu **Einstellungen > Integrierte Apps**. -3. Klicke auf **Benutzerdefinierte Apps hochladen**. -4. Lade die finale `manifest.xml` hoch. -5. Weise die App den entsprechenden Benutzern (oder allen) zu. -6. Sobald Excel von den Mitarbeitern neugestartet wird, erscheint der neue Button im Menüband! - -*(Für lokale Tests kannst du das Add-In in Excel auch einfach über "Meine Add-ins" > "Zusatz-Add-In hochladen" nutzen.)* diff --git a/README_User_Guide.md b/README_User_Guide.md deleted file mode 100644 index b0ceb16..0000000 --- a/README_User_Guide.md +++ /dev/null @@ -1,51 +0,0 @@ -# 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.