Skip to content

Home

Jump to bottom
bhuertgen edited this page Mar 17, 2026 · 5 revisions

os4k2excel Wiki

Willkommen im Wiki für os4k2excel — Ein PowerShell ETL-Tool für OpenScape 4000 Export.

Schnelleinstieg

os4k2excel extrahiert Port-, Lizenz- und Rufumleitungsdaten aus dem Unify/Mitel OpenScape 4000 Telefonsystem und exportiert sie als formatierter Excel-Report.

Version: M26.20260310.1239

Installation

Siehe Installation für detaillierte Schritt-für-Schritt Anleitung:

  1. Voraussetzungen überprüfen
  2. ImportExcel Modul installieren
  3. Zugriffsrechtegruppe im OS4K Manager erstellen (mit neuen Tabellen PICKUPGRP/PICKUP_SUB)
  4. Script ausführen

Schnell gestartet:

.\getall_cfw.ps1 -ApiHost "10.10.206.18" -ApiUser "engr" -ApiPassword "geheim"

Hauptfunktionen

📊 Automatische Extraktion

  • 10+ Tabellen aus OpenScape 4000 (DOMAIN, SWITCH, PORT, CFW, HUNTGRP, PICKUPGRP, etc.)
  • Kein Datenbank-Zugriff notwendig, nur XIE-API über api2hipath.exe
  • Automatische Domain/Switch-Erkennung (keine manuelle Konfiguration)

📈 Lizenzberechnung

  • Automatische Berechnung von Flex- vs. TDM-Lizenzen
  • Basis-Werte je Gerätetyp (BASEST=4, SET600=2, etc.)
  • Dashborad mit Lizenzsummen pro Standort

🌐 Web-Interface

  • os4k2excel-server.ps1 stellt Webinterface bereit
  • Start, Fortschritt, Download im Browser (Port 8080)
  • Integrierter Zeitplaner für automatische Ausführung
  • Email-Versand der Excel-Dateien

📝 Diagnose-Modus

  • Neuer -Debug Parameter für detaillierte Log-Ausgaben
  • CSV-Größen, Hashtable-Einträge, API Exit-Codes
  • Perfekt zum Debugging und Performance-Analyse

Neue Features (M26)

  • ✅ PICKUPGRP & PICKUP_SUB Tabellen-Extraktion
  • ✅ Strukturiertes Logging mit Phasen-Headern
  • ✅ -Debug Parameter für erweiterte Diagnose
  • ✅ Verbesserte Fehlerbehandlung und Exit-Code-Überprüfung

Dokumentation

  • API-Parameter — Alle verfügbaren Parameter und Funktionen (NEU)
  • Webserver — Konfiguration und Bedienung des Web-Interfaces

Häufig verwendete Befehle

# Einfacher Export
.\getall_cfw.ps1 -ApiHost "10.10.206.18" -ApiUser "engr" -ApiPassword "geheim"

# Mit Debug-Modus
.\getall_cfw.ps1 -ApiHost "10.10.206.18" -ApiUser "engr" -ApiPassword "geheim" -Debug

# Mit Duplikat-Markierung
.\getall_cfw.ps1 -ApiHost "10.10.206.18" -ApiUser "engr" -ApiPassword "geheim" -MarkDuplicate

# Webserver (Browser: http://localhost:8080)
.\os4k2excel-server.ps1 -ApiHost "10.10.206.18" -ApiUser "engr" -ApiPassword "geheim" -WebPassword "team2024"

Anforderungen

  • Windows: 10, 11, Server 2016+
  • PowerShell: 5.1+
  • Module: ImportExcel (kostenlos)
  • Software: api2hipath.exe (von OpenScape 4000 Manager/Assistant V11)
  • Zugriff: XIE-API Credentials und Netzwerkzugriff zum OS4K Server

Output

Alle Dateien werden mit Datum im Namen erstellt:

  • OS4K-PORT-2026-03-10.xlsx — Hauptreport (mehrere Sheets pro Standort)
  • OS4K-PORT-2026-03-10.log — Ausführungsprotokoll
  • OS4K-{TABLE}-2026-03-10.csv — Rohexporte der einzelnen Tabellen

Sicherheit

  • ✅ Keine Passwörter in Dateien
  • ✅ SIP-Secrets optional maskiert
  • ✅ Session-basierte Web-Authentifizierung
  • ✅ Nur lokal empfohlen oder in sicheren Netzwerken

Letzte Änderung: 2026-03-10 (Version M26) Dokumentation: README.md

os4k2excel Wiki

Clone this wiki locally