Installation

Installation

Systemvoraussetzungen

Komponente	Version	Beschreibung
Windows	10 / 11 / Server 2016+	Betriebssystem
PowerShell	5.1+	Windows PowerShell (in Windows enthalten)
.NET Framework	4.5+	Wird von PowerShell 5.1 und ImportExcel vorausgesetzt (in Windows enthalten)

PowerShell-Modul: ImportExcel

Erzeugt Excel-Dateien ohne installiertes Microsoft Office (basiert auf EPPlus/OfficeOpenXml).

# Erstinstallation
Install-Module -Name ImportExcel -Scope CurrentUser

# Pruefen ob installiert
Get-Module -ListAvailable ImportExcel

# Aktualisieren auf neueste Version
Update-Module -Name ImportExcel

Hinweis: Bei der ersten Installation wird ggf. nach der Berechtigung gefragt, das NuGet-Paket zu installieren und dem PSGallery-Repository zu vertrauen. Beides mit Y bestaetigen.

Externe Software: api2hipath.exe

Kommandozeilen-Tool von Unify/Mitel zum Zugriff auf die OpenScape 4000 Datenbank via XIE (Import/Export) API.

Eigenschaft	Details
Hersteller	Unify / Mitel
Bestandteil von	OpenScape 4000 Assistant / Manager V11
Standardpfad	C:\Program Files (x86)\Unify\OpenScape 4000 Export Table\api2hipath.exe
Installation	Wird mit dem OpenScape 4000 Assistant/Manager installiert. Nicht separat verfuegbar.
Dokumentation	OpenScape 4000 Assistant/Manager V11, Import/Export (XIE) API, Service Documentation (P31003-H34B0-S102-02-0020, 08/2024) — Mitel Document Center: DE | EN

Das Tool muss auf dem Rechner installiert sein, auf dem das Skript ausgefuehrt wird, und Netzwerkzugriff auf den OpenScape 4000 Server haben.

Export Table Client installieren

Die api2hipath.exe wird ueber den Export Table Client bereitgestellt. Die Installation erfolgt direkt ueber den OpenScape 4000 Assistant:

1. Im Assistant navigieren zu: Dienstprogramme > Export Table Client installieren
2. Voraussetzung: Microsoft Visual C++ 2010 Redistributable Package x86 muss installiert sein (auch auf 64-Bit-Systemen)
3. Die Export Table Installationsdatei herunterladen und ExTable.exe ausfuehren

Nach der Installation befindet sich api2hipath.exe im Standardpfad C:\Program Files (x86)\Unify\OpenScape 4000 Export Table\.

API-Benutzer einrichten

Fuer den Zugriff auf die OpenScape 4000 Datenbank wird ein dedizierter API-Benutzer benoetigt. Die Einrichtung erfolgt im OpenScape 4000 Assistant unter Zugangsverwaltung > Kennungsverwaltung > Benutzerkennungsverwaltung.

Schritt 1: Benutzer anlegen

1. + Benutzer hinzufuegen klicken
2. Neue Kennung: z.B. xieapi
3. Beschreibung: z.B. Powershell Script
4. Sicherheitsprofil: Kunden-Benutzer (cust) (minimale Berechtigung)
5. Benutzer hinzufuegen klicken

Schritt 2: Passwort und Eigenschaften konfigurieren

1. Den neu angelegten Benutzer auswaehlen und Benutzer bearbeiten klicken
2. Neues Passwort setzen und wiederholen
3. Unter Eigenschaften:
   • Passwort ist unbegrenzt gueltig aktivieren (Checkbox)
4. Unter Automatisch sperren:
   • Kennung automatisch sperren: nie
5. Speichern klicken

Zugriffsrechte zuweisen (minimal)

Der API-Benutzer benoetigt ausschliesslich Lesezugriff auf die vom Skript abgefragten Tabellen ueber die Import/Export API (XIE).

Schritt 3: Zugriffsrechtegruppe erstellen

In der Zugangsverwaltung > Zugriffsrechtegruppen-Konfiguration:

1. Neue Gruppe anlegen, z.B. XIEAPI
2. Unter Import/Export API (XIE) folgende Tabellen freigeben:
   • CFW
   • DEVCONST
   • DOMAIN
   • HUNTGRP
   • HUNTGRP_SERVICE
   • NUMBERING_PLAN
   • PORT
   • PERSPORT
   • SWITCH

Schritt 4: Zugriffsrechtegruppe dem Benutzer zuweisen

In der Zugangsverwaltung > Zugriffsrechtekonfiguration:

1. Benutzer xieapi auswaehlen
2. Die Zugriffsrechtegruppe XIEAPI zuweisen (blau markiert)
3. Im unteren Bereich wird die Zusammenfassung der Rechte angezeigt: Import/Export API (XIE): CFW, DEVCONST, DOMAIN, HUNTGRP, HUNTGRP_SERVICE, NUMBERING_PLAN, PORT, PERSPORT, SWITCH

Hinweis: Es werden bewusst nur die minimal notwendigen Tabellen freigegeben. Die Tabelle PORT wird pro Domain/Switch dynamisch abgefragt und muss daher ebenfalls in der Zugriffsrechtegruppe enthalten sein.