Anschlussbeschreibung
Unify OpenScape Voice V5
Stand: 13.05.2014

Anker
_GoBack _GoBack

Inhaltsverzeichnis
1 Vorwort
2 Einstellung an der OpenScape Voice
2.1 Aktivierung der CDR
2.2 CDR Format
2.3 CDR Erstellung
3 Anschaltung von AlwinPro/Anna4 über FTP (Push)
3.1 Installation der Software AlwinPro/Anna4
3.2 Auswahl des Telefonsystems
3.3 Einstellen der Parameter
4 Einstellen der Datenaufnahme über die Konfigurationsoberfläche
4.1 Registerkarte „Allgemein"
4.2 Registerkarte „Telefonsystem"
4.3 Registerkarte „Zeitfenster"
4.4 Registerkarte „OpenScape Voice" Karte 1
4.5 Registerkarte „OpenScape Voice" Karte 2
4.6 Registerkarte „Skript"
4.7 Registerkarte „Verzeichnis scannen"
5 Test der Installation

Anker
_Toc122326949 _Toc122326949

Anker
_Toc122339664 _Toc122339664

Anker
_Toc122341127 _Toc122341127

Anker
_Toc122326950 _Toc122326950

Anker
_Toc370809368 _Toc370809368

Vorwort

Das Kommunikationssystem Unify OpenScape Voice (OSV) bietet den Abruf von Gesprächsinformationen und Gebührendaten zur Übermittlung an AlwinPro/Anna4 an. Die Daten werden von der Betriebstechnik der OpenScape Voice erstellt und per FTP zur Verfügung gestellt.
Vor einer Übertragung müssen die OSV und AlwinPro/Anna4 entsprechend vorbereitet werden. Dazu ist es notwendig einige Einstellungen vorzunehmen, welche die OSV veranlassen, Gesprächsinformationen an AlwinPro/Anna4 zu senden bzw. den Zugriff zu ermöglichen. Ebenso müssen an AlwinPro/Anna4 Konfigurationen durchgeführt werden, um die Gesprächsdaten entgegenzunehmen und zu verarbeiten.
Das vorliegende Dokument beschreibt den Datenaustausch über eine LAN-Verbindung zwischen der OSV und dem AlwinPro PC nach der Push Methode. Dazu müssen OSV und PC so an ein konfiguriertes LAN angeschlossen werden, dass ein Austausch der Daten zwischen beiden Systemen per FTP oder SFTP möglich ist. Die CDR werden von der OSV im vordefinierten FTP Verzeichnis abgelegt und können dort vom AlwinPro abgerufen werden.
AlwinPro/Anna4 kann für einzelne OpenScape Voice Konfigurationen ohne Einschränkungen eingesetzt werden. Bei komplexen Kommunikationsszenarien, z. B. Vernetzung mehrerer OpenScape Voice oder HiPath 4000 Systemen, ist eine Abklärung der Konfiguration mit der Aurenz GmbH erforderlich. Ggf. erforderlich ist die Bereitstellung von Gebührendatensätzen, die die typischen Gesprächssituationen in der zu betreibenden Umgebung wiedergeben.

Anker
_Toc370809369 _Toc370809369

Einstellung an der OpenScape Voice

Die hier beschriebenen Einstellungen sind als Hilfestellung gedacht und können von der tatsächlichen Konfiguration abweichen. Mit diesen Einstellungen funktioniert die Anbindung zwischen einer OpenScape Voice V5 und dem AlwinPro/Anna4 ab Version 6.
Für weitere detaillierte Informationen zu den Konfigurationsmöglichkeiten und den Schnittstellen an OpenScape Voice verweisen wir auf die Dokumentation des Herstellers (z. B. OpenScape Voice V5.0, CDR Interface Description).

Anker
_Toc370809370 _Toc370809370

Aktivierung der CDR

Starten sie über einen Browser das Common Management Portal (CMP) ihrer OpenScape Voice. Aktivieren sie die Gebührendatenerfassung gemäß der OSV Dokumentation.






Der Systemadministrator muss über das CMP die gewünschte CDR-Übermittlungsmethode explizit auswählen: Push muss für die Anschaltung an AlwinPro/Anna4 eingestellt werden. Sollte eine Freigabe für SPush (SFTP) von Unify erteilt werden, so wird dies ebenfalls von AlwinPro/Anna4 unterstützt.
An der OSV können über konfigurierbare Parameter z. B. die Aufbewahrungsfrist (in Tagen) für CDR-Dateien oder auch der Erstellungszeitpunkt für CDR in der OpenScape Voice definiert werden. Diese Parameter sind direkt auf dem Betriebssystem der OSV zu administrieren und können nicht über das CMP eingestellt werden. Genaue Informationen hierzu sind aus der Dokumentation des Herstellers zu beziehen.




Bitte beachten sie, dass alle Zeitinformationen in den CDR in UTC + Zeitzonenkorrektur ausgegeben werden. AlwinPro/Anna4 stellt in den Auswertungen dann die korrekte Zeit, entsprechend der eingestellten Zeitzone, dar.
Notieren sie sich Ihre Eingaben, da sie sie später bei der Konfiguration der AlwinPro Datenaufnahme noch benötigen.

Anker
_Toc370809371 _Toc370809371

CDR Format

Das Format der CDR in der OpenScape Voice ist fest vorgegeben. Die Datenaufnahme des AlwinPro wurde für dieses Format angepasst. Stellen sie in Ihrer Systemkonfiguration sicher, dass die unten genannten CDR Felder mit den beschriebenen Informationen gefüllt werden, damit die Leistungsmerkmale Privatgesprächs-kennzeichnung bzw. PIN/Projektgesprächszuordnung im AlwinPro genutzt werden können.

Anker
_Toc370809372 _Toc370809372

Anker
_Toc122326954 _Toc122326954

CDR Erstellung

Die CDR werden von der OpenScape Voice nicht sofort nach der Beendigung eines Gesprächs erstellt sondern vom jeweiligen Knoten eines Clusters gepuffert. Die CDR Dateien werden erst geschrieben, wenn einer der folgenden Schwellwerte erreicht ist:

• Es ist eine konfigurierbare Zeitschwelle verstrichen (normalerweise 5 Minuten).
• Die Anzahl der gepufferten CDRs hat einen konfigurierbaren Anzahl erreicht (normalerweise, 2500 CDRs).

Anker
_Toc370809373 _Toc370809373

Anschaltung von AlwinPro/Anna4 über FTP (Push)

Anker
_Toc122326955 _Toc122326955

Anker
_Toc370809374 _Toc370809374

Installation der Software AlwinPro/Anna4

• Es ist wichtig, dass die entsprechenden Treiber für den LPT1 Port oder des USB Ports (abhängig von der Art des Dongles) auf dem AlwinPro/Anna4-PC installiert sind.
• Für Standardinstallationen können Default Einstellungen des Installationsassistenten übernommen werden. Folgen sie den Anweisungen des Assistenten.
• Die Installation kann über die Installations-CD mit setup.exe gestartet werden, falls die Installationsroutine nicht automatisch nach einlegen der CD startet.

Starten Sie das Setup von der AlwinPro/Anna4 CD und folgen Sie den angezeigten Hinweisen der Installationsroutine. Nach der Installation werden sie gefragt ob Sie die Anbindung an das Telefonsystem sofort oder später installieren möchten. Wählen sie „Jetzt installieren" und führen sie die folgenden Schritte aus. Alle Einstellungen lassen sich auch später über die Konfigurationsoberfläche abändern oder ergänzen.

Falls sie das Telefonsystem später installieren wollen (über Später installieren), erscheint der folgende Hinweis, mit dem der Installationsvorgang abgeschlossen wird. Ansonsten wird das TK-System Installations-Wizard gestartet.

Anker
_Toc122326956 _Toc122326956

Anker
_Toc122339671 _Toc122339671

Anker
_Toc122341134 _Toc122341134

Anker
_Toc122326957 _Toc122326957

Anker
_Toc122339672 _Toc122339672

Anker
_Toc122341135 _Toc122341135

Anker
_Toc122326958 _Toc122326958

Anker
_Toc122339673 _Toc122339673

Anker
_Toc122341136 _Toc122341136

Anker
_Toc122326959 _Toc122326959

Anker
_Toc122339674 _Toc122339674

Anker
_Toc122341137 _Toc122341137

Anker
_Toc122326960 _Toc122326960

Anker
_Toc122339675 _Toc122339675

Anker
_Toc122341138 _Toc122341138

Anker
_Toc122326961 _Toc122326961

Anker
_Toc122339676 _Toc122339676

Anker
_Toc122341139 _Toc122341139

Anker
_Toc122326962 _Toc122326962

Anker
_Toc122339677 _Toc122339677

Anker
_Toc122341140 _Toc122341140

Anker
_Toc122326963 _Toc122326963

Anker
_Toc122339678 _Toc122339678

Anker
_Toc122341141 _Toc122341141

Anker
_Toc122326964 _Toc122326964

Anker
_Toc122339679 _Toc122339679

Anker
_Toc122341142 _Toc122341142

Anker
_Toc122326965 _Toc122326965

Anker
_Toc122339680 _Toc122339680

Anker
_Toc122341143 _Toc122341143

Anker
_Toc122326966 _Toc122326966

Anker
_Toc122339681 _Toc122339681

Anker
_Toc122341144 _Toc122341144

Anker
_Toc122326967 _Toc122326967

Anker
_Toc122339682 _Toc122339682

Anker
_Toc122341145 _Toc122341145

Anker
_Toc122326968 _Toc122326968

Anker
_Toc122339683 _Toc122339683

Anker
_Toc122341146 _Toc122341146

Anker
_Toc122326969 _Toc122326969

Anker
_Toc370809375 _Toc370809375

Auswahl des Telefonsystems

Wählen sie im Dialog das gewünschte Telefonsystem (VoIP-System) aus. Als Anschlussart muss „Anschluss über FTP (Push)" eingestellt werden.

Anker
_Toc122326970 _Toc122326970

Anker
_Toc122339685 _Toc122339685

Anker
_Toc122341148 _Toc122341148

Anker
_Toc122326971 _Toc122326971

Anker
_Toc122339686 _Toc122339686

Anker
_Toc122341149 _Toc122341149

Anker
_Toc122326972 _Toc122326972

Anker
_Toc122339687 _Toc122339687

Anker
_Toc122341150 _Toc122341150

Anker
_Toc122326973 _Toc122326973

Anker
_Toc122339688 _Toc122339688

Anker
_Toc122341151 _Toc122341151

Anker
_Toc122326974 _Toc122326974

Anker
_Toc122339689 _Toc122339689

Anker
_Toc122341152 _Toc122341152

Anker
_Toc122326975 _Toc122326975

Anker
_Toc122339690 _Toc122339690

Anker
_Toc122341153 _Toc122341153

Anker
_Toc122326976 _Toc122326976

Anker
_Toc122339691 _Toc122339691

Anker
_Toc122341154 _Toc122341154

Anker
_Toc122326977 _Toc122326977

Anker
_Toc122339692 _Toc122339692

Anker
_Toc122341155 _Toc122341155

Anker
_Toc122326978 _Toc122326978

Anker
_Toc122339693 _Toc122339693

Anker
_Toc122341156 _Toc122341156

Anker
_Toc122326979 _Toc122326979

Anker
_Toc122339694 _Toc122339694

Anker
_Toc122341157 _Toc122341157

Anker
_Toc122326980 _Toc122326980

Anker
_Toc122339695 _Toc122339695

Anker
_Toc122341158 _Toc122341158

Anker
_Toc122326981 _Toc122326981

Anker
_Toc122339696 _Toc122339696

Anker
_Toc122341159 _Toc122341159

Anker
_Toc122326982 _Toc122326982

Anker
_Toc122339697 _Toc122339697

Anker
_Toc122341160 _Toc122341160

Anker
_Toc122326983 _Toc122326983

Anker
_Toc122339698 _Toc122339698

Anker
_Toc122341161 _Toc122341161

Anker
_Toc122326984 _Toc122326984

Anker
_Toc122339699 _Toc122339699

Anker
_Toc122341162 _Toc122341162

In der oberen Zeile können sie, zur besseren Unterscheidung, Ihrer Konfiguration einen aussagekräftigen Namen geben. Darunter ist der Standort des zu konfigurierten Systems anzugeben (Tarifierung).

Anker
_Toc370809376 _Toc370809376

Einstellen der Parameter

Das nächste Fenster öffnet diesen Dialog. Sie können sich die vorliegende Dokumentation anzeigen lassen.



Mit dem folgenden Fenster schließen sie die Grundeinrichtung für OpenScape Voice ab.

Damit ist die Anbindung von AlwinPro/Anna4 an die OpenScape Voice schon fast erledigt. Weitere kundenindividuelle Einstellungen können in der Datenquellenübersicht unter Telefonsystem / Einstellen vorgenommen werden und sind unter Punkt 3 beschrieben.
Zur Sicherheit empfiehlt sich das Testen der Installation nach der vollständigen Konfiguration. Beachten sie dazu den Punkt 4 dieser Anleitung.
Die einzelnen Programme können nun gestartet werden.

Anker
_Toc370809377 _Toc370809377

Einstellen der Datenaufnahme über die Konfigurationsoberfläche

Durch die Auswahl des Systems OpenScape Voice während der Installation von AlwinPro/Anna4 wurden bereits alle wichtigen Einstellungen vorbelegt. Sie haben jedoch die Möglichkeit, weitere Änderungen oder kundenspezifische Anpassungen vorzunehmen.
Starten sie hierzu die AlwinPro/Anna4 Datenaufnahme und öffnen sie den Menüpunkt Telefonsystem / Einstellen den Bearbeitungsdialog. Wählen sie in der linken Auswahlbox „Unify OpenScape Voice (Anschluss über FTP (Push))" aus.
Die verschiedenen Einstellungen sind nun über die entsprechenden Registerkarten zugänglich.

Anker
_Toc370809378 _Toc370809378

Registerkarte „Allgemein"

Unter Allgemein können sie eine kundenspezifischen Bezeichnung für die Konfiguration der OpenScape Voice angeben. Die zugeordnete Datenaufnahme ist vorbelegt und muss nicht geändert werden.

Anker
_Toc122341166 _Toc122341166

Anker
_Toc122341167 _Toc122341167

Anker
_Toc122341168 _Toc122341168

Anker
_Toc122341169 _Toc122341169

Anker
_Toc122341170 _Toc122341170

Anker
_Toc122341171 _Toc122341171

Anker
_Toc122341172 _Toc122341172

Anker
_Toc122341173 _Toc122341173

Anker
_Toc122341174 _Toc122341174

Anker
_Toc122341175 _Toc122341175

Anker
_Toc122341176 _Toc122341176

Anker
_Toc122341177 _Toc122341177

Anker
_Toc370809379 _Toc370809379

Registerkarte „Telefonsystem"

Diese Registerkarte dient unter anderem zur Festlegung des Standortes des Telefonsystems sowie des genutzten Netzanbieters, welcher zur Preisberechnung der einzelnen Telefonate herangezogen wird.
Bei mehreren zu erfassenden Standorten (AlwinPro Vernetzungsversion erforderlich), sind hier die einzelnen OSV Systeme anzulegen. Im Feld Knotennummer wird die Knotennummer des Systems eingetragen, die aus dem SIP Endpoint Name abgeleitet wird. Die Zuordnung SIP Endpoint Name zu Knotennummer wird in der zweiten OpenScape Voice Karte festgelegt. Über die Knotennummer wird gewährleistet, dass für jedes Gespräch die richtige Tarifzone zur Gebührenberechnung herangezogen wird.

ACHTUNG
Die Einstellungen des genutzten Netzanbieters erfolgt in der AlwinPro Auswertung unter Datei / Programm einrichten / Netzanbieter. Weiterführende Beschreibungen finden Sie im Handbuch von AlwinPro/Anna4.

Anker
_Toc370809380 _Toc370809380

Registerkarte „Zeitfenster"

Über das Zeitfenster legen sie fest, an welchen Wochentagen und zu welchen Zeiten die Daten aus dem System in AlwinPro/Anna4 übertragen werden sollen.

Anker
_Toc370809381 _Toc370809381

Registerkarte „OpenScape Voice" Karte 1

Im Register OpenScape Voice (1) werden die systemweiten Einstellungen der OpenScape Voice konfiguriert.
Die einzelnen Felder haben die folgende Bedeutung und Funktion:
Nebenstellen-Prefix: Die OpenScape Voice gibt in den CDRs die Nebenstellenrufnummern vollqualifiziert im E.164 Format aus, d. h. mit Vorwahlen, Amtskopf und Nebenstelle. Im AlwinPro wird die Rufnummer ebenfalls vollqualifiziert erfasst. Wird dies nicht gewünscht, so können sie im Feld Prefix den Teil der Rufnummer angeben, der von der kompletten Rufnummer linksbündig abgeschnitten wird. Mit dem im Beispiel angegebenen Eintrag würde aus der vollqualifizierten Rufnummer „493038634656" die Rufnummer „34656" werden.
Amtsanlassung: In diesem Feld sind alle im System verwendeten Amtsanlassungen, durch Semikolon getrennt, einzutragen (auch Privatkennziffer und Projektkennziffer). Dadurch wird erreicht, dass die Amtsholungskennziffern aus den CDRs herausgefiltert werden können und die Gespräche korrekt tarifiert werden.




FAX-Prefix: Ist an der OSV ein Faxserver angeschlossen, so kann bei Konfiguration der Parameter FAX-Prefix erreicht werden, dass die über den Faxserver geführten Verbindungen dem korrespondierenden Teilnehmer zugeordnet werden und keine eigene Nebenstelle für die Faxrufnummer angelegt wird. Die Unterscheidung zwischen normalen Telefonat und FAX erfolgt über die Dienstkennung einer Verbindung (Sprache/FAX3). Damit die Zuordnung gelingt, muss unter FAX-Prefix (mit FAX-Kennung) der Prefix mit Faxkennziffer eingetragen und unter FAX-Prefix (ohne-FAX-Kennung) der Prefix ohne die Faxkennung eingetragen werden. Anhand der im Screenshot abgebildeten Konfiguration würde aus der, über einen Faxserver geführten, Verbindung mit der Rufnummer 4930 386 13 4656 die Zuordnung zum Teilnehmer mit der Rufnummer 4930 386 4656 und dem Dienst FAX3 erfolgen.
Mediaserver (SIP-Endpoint Name): Wenn an der OSV ein Mediaserver angeschaltet ist, so sollten hier die SIP-Endpoints eingetragen werden, die vom Mediaserver genutzt werden. Durch diesen Konfigurationspunkt werden die CDR eines Mediaserver sicher erkannt und eine erweiterte Verarbeitung der CDR im AlwinPro vorgenommen. Ist dieser Punkt nicht korrekt konfiguriert, würden Datensätze, (z. B. Konferenzen) die über einen solchen Server geführt werden, verworfen, da für AlwinPro nicht ersichtlich ist, dass es sich bei den Gesprächen um eine interne Dienstleistung handelt.
SIP-Trunk (SIP-Endpoint Name): Werden von SIP Trunks Rufnummern ohne führende „0" oder Amtskennziffer ausgewiesen, so kann in den meisten Fällen keine korrekte Tarifierung durchgeführt werden. Für diesen Fall können unter diesem Punkt die relevanten SIP-Trunks eingetragen werden. Im Feld SIP-Trunk Prefix kann dann der fehlende Teil der Rufnummer hinzugefügt werden. Somit können z. B. fehlenden „00" für die korrekte Tarifierung der Rufnummer zugefügt werden.

Anker
_Toc370809382 _Toc370809382

Registerkarte „OpenScape Voice" Karte 2

Im Register OpenScape Voice (2) werden weitere systemweiten Einstellungen der OpenScape Voice konfiguriert.
Für die Tarifierung von Gesprächen ist es erforderlich, dass AlwinPro Kenntnis über den Standort eines Systems bzw. eines Gateways hat. Über welchen Gateway ein Gespräch geführt wurde, wird in den CDR im Feld SIP Endpoint Name festgehalten. Der SIP Endpoint Name muss für die weitere Verarbeitung in eine Knotennummer umgewandelt werden, damit die Zuordnung zum korrekten System erfolgen kann. Die Festlegung von Knotennummer zum System wird im Register Telefonanlage (s. o.) durchgeführt.
In der untenstehenden Tabelle wird die Verknüpfung von SIP Endpoint Name und Knotennummer hergestellt bzw. per Dateiimport angelegt.

Anker
_Toc370809383 _Toc370809383

Registerkarte „Skript"

Hier können sie das für die Interpretation der Datensätze benötigte Skript auswählen. Im Normalfall ist das vordefinierte Skript zu verwenden. Sollte im Rahmen einer Sonderanpassung ein Skript zur Verfügung gestellt worden sein, so muss hier der Pfad für die Skriptdatei eingestellt werden.
Im Feld Kennung für Amt-Privat muss die Amtsanlassung für Privatgespräche eingetragen werden.

Anker
_Toc370809384 _Toc370809384

Registerkarte „Verzeichnis scannen"

Über das Register kann das Verzeichnis, in welchem die CDR von der OpenScape Voice abgelegt werden, bestimmt werden. Die Standardeinstellung des AlwinPro sieht vor, die CDR's aus dem Verzeichnis FTP des Installationsverzeichnisses zu beziehen.

Anker
_Toc122339713 _Toc122339713

Anker
_Toc122341188 _Toc122341188

Anker
_Toc122339714 _Toc122339714

Anker
_Toc122341189 _Toc122341189

Anker
_Toc122339715 _Toc122339715

Anker
_Toc122341190 _Toc122341190

Anker
_Toc122339716 _Toc122339716

Anker
_Toc122341191 _Toc122341191

Anker
_Toc122339717 _Toc122339717

Anker
_Toc122341192 _Toc122341192

Anker
_Toc122339718 _Toc122339718

Anker
_Toc122341193 _Toc122341193

Anker
_Toc122339719 _Toc122339719

Anker
_Toc122341194 _Toc122341194

Anker
_Toc122339720 _Toc122339720

Anker
_Toc122341195 _Toc122341195

Anker
_Toc122339721 _Toc122339721

Anker
_Toc122341196 _Toc122341196

Anker
_Toc122339722 _Toc122339722

Anker
_Toc122341197 _Toc122341197

Anker
_Toc122339723 _Toc122339723

Anker
_Toc122341198 _Toc122341198

Anker
_Registerkarte_„Swyx“ _Registerkarte_„Swyx“

Die Übertragungsrichtung der CDR hat sich mit der Version 3.1 der OpenScape Voice geändert. Die Daten werden nicht länger abgeholt sondern werden von der OSV per FTP oder SFTP an den AlwinPro Server übermittelt. Auf dem AlwinPro Server ist zu diesem Zweck ein FTP/SFTP Server installiert. Die Einstellungen des FTP/SFTP Servers können hier vorgenommen werden.

In der Maske für den FTP/SFTP Server werden folgende Punkte eingestellt:

...

Zur Private-Key Erstellung geben sie die Ausgabedatei an und drücken dann PrivateKey erzeugen ….
Nach Fertigstellung wird der „Fingerprint" angezeigt.

Anker
_Toc370809385 _Toc370809385

Test der Installation

Starten sie die AlwinPro/Anna4 Datenaufnahme und schalten den Datensatzmonitor wie folgt ein.
Öffnen sie über den Menüpunkt Telefonanlagen / Übersicht das Datenquellen übersichtsfenster. Markieren sie Ihr Telefonsystem und wählen sie nun den Menüpunkt Telefonsystem / Datensatzmonitor. Klicken sie in das Fenster Datenquellenübersicht um dieses Fenster zu aktivieren und prüfen sie, ob die Datenquelle freigegeben und aktiv (Warte auf Verbindung) ist.
Führen sie nun einige Testgespräche über die Unify OpenScape Voice.
AlwinPro/Anna4 protokolliert jetzt die verfügbaren Gesprächsdaten und zeigt deren Interpretation im Datensatzmonitor an.