TechDocs

Erweiterte Wahlparameter-Einstellungen für UM

Das Tool Wahlparameter Unified Messaging Gateways wird für Unified Messaging verwendet. Mit diesem Tool können ankommende, ausgehende und MWI Rufnummern manipuliert werden.

Hinweis

Um Wahlregeln für CTI-Rufnummern (basierend auf CTI-Wahlparametern) zu erstellen, müssen Sie das Tool Wahlparameter Sonderkonfiguration verwenden.

Eingerichtete Wahlregeln können über ein eingebautes Test-Tool geprüft werden.

Um das Eingangsformat der Rufnummern zu sehen, prüfen Sie die signalisierten Rufnummern der jeweiligen UM-Log-Dateien, z.B. für Fax2Mail (Faxempfang) oder Voicemail etc. Die Logs können Sie im XPhone Connect Server über Systemeinstellungen > UM > Dienste öffnen, indem Sie auf Logging unterhalb des gewünschten Dienstes klicken.

Um das Tool zu starten, rufen Sie den XPhone Connect Server Manager auf und starten über Tools die Wahlparameter Unified Messaging Gateways.

Wahlregeln

Klicken Sie nun auf den Reiter NUMBERING > Button ADVANCED FILTERS.

Hier gibt es vier Tabs, die verschiedene Bereiche steuern.

Display incoming calls

Alle ankommenden Rufnummern bzw. Faxnummern können in diesem Bereich manipuliert werden, um so z.B. Knotennummern zu filtern und durch die Langnummer zu ersetzen. Alle hier angelegten Wahlregeln werden der Reihe nach abgearbeitet. Beim ersten Match werden keine nachfolgenden Regeln mehr verwendet.

Display outgoing calls

Hier können Rufnummern bzw. Faxnummern modifiziert werden, die vom TK-System gehend signalisiert werden. Diese Nummer kann u.U. von der Nummer, die der Anlage übergeben und gewählt wird, abweichen. Alle hier angelegten Wahlregeln werden der Reihe nach abgearbeitet. Beim ersten Match werden keine nachfolgenden Regeln mehr verwendet.

Dialing

Nummern die gewählt werden, können hier manipuliert werden. Alle hier angelegten Wahlregeln werden der Reihe nach abgearbeitet. Beim ersten Match werden keine nachfolgenden Regeln mehr verwendet.

MWI

Bei manchen TK-Systemen wird die Signalisierung der MWI-Nummer in einem bestimmten Format erwartet, dies kann hier konfiguriert werden. Alle hier angelegten Wahlregeln werden der Reihe nach abgearbeitet. Beim ersten Match werden keine nachfolgenden Regeln mehr verwendet.

Map From / Map To

Match (Map From)

Wird eine neue Regel in der Wahlparameter Sonderkonfiguration erstellt, so enthält das Feld Map From den Match, d.h. die Wahlregel wird nur angewendet, wenn der Wert im Feld Map From auf die jeweilige Nummer zutrifft. Um Map From zu definieren, wird mit nachfolgenden regulären Ausdrücken gearbeitet:

Symbol	Beschreibung	Beispiel
^	Kennzeichnet den Anfang des Strings (bzw. der Nummer)	^123 = Nummer beginnt mit 123
$	Das Dollarzeichen kennzeichnet das Ende des Ausdrucks	^110$ = genau die Nummer 110
[]	Zeichen in eckigen Klammern sind Aufzählungen oder Bereiche	[129] = 1 oder 2 oder 9 [2-5] = 2, 3, 4 oder 5
.	Jeder Punkt steht für ein beliebiges Zeichen	^123[0-9]?$ = 123 mit optional einstelliger Zahl
+	Das Plus-Zeichen steht für ein bis beliebig viele Zeichen	^123[1-9]+$ = 123 gefolgt von ein bis viele Zahlen
*	Ein Stern steht für null bis beliebig viele Zeichen	^123[0-9]*$ = 123 gefolgt von null bis viele Zahlen
?	Ein Zeichen, das von einem Fragezeichen gefolgt wird, entspricht null bis ein Zeichen	^123[2-5]?$ = 123 mit optional einer Zahl 2-5
()	Die runden Klammern teilen den Match in Ersetzungsgruppen auf	^(08912345)(..?)$ = zwei Gruppen (Nummer und Durchwahl)
|	Die Pipe kennzeichnet „oder“	^(123|987)$ = 123 oder 987

Replace (Map To)

Das Feld Map to (Replace) ist nur verfügbar, wenn ein Match-Parameter definiert wird. Der Map to (Replace) bestimmt, in welcher Form der Wert (die Nummer) des Map from (Match) umgeformt wird. In der Regel werden einzelne Ersetzungsgruppen aus Map from (Match) entfernt und ggf. Nummern vorangestellt oder angehängt.

• \ Der Backslash im Feld Replace wird einer Ersetzungsgruppe vorangestellt, um diese zu wiederholen. Beachten Sie, dass hier im Gegensatz zur Wahlparameter Sonderkonfiguration das $-Zeichen nicht verwendet werden kann.

  • Beispiel 1: Würde man im Map from (Match) den Wert: ^(08912345)(..?)$ eintragen, so kann im Map to (Replace) durch den Eintrag 55\2 die erste Ersetzungsgruppe (08912345) entfernt werden und die (Knoten-) Nummer 55 vorangestellt werden.

  • Beispiel 2: Der Eintrag \0 wiederholt alle Ersetzungsgruppen aus dem Map from (Match).

• LDA kennzeichnet die Amtsholung, wenn vor einer Nummer die Amtsholung, die für den jeweiligen User verwendet wird, gesetzt werden soll, so kennzeichnet man dies mit einem führenden LDA. Beachten Sie, dass im XPhone Connect Server in den Einstellungen für „Fax“ des jeweiligen Standorts bzw. der Konfigurationsgruppe eine eigene „Vorwahl für Amt“ konfiguriert werden kann.

  Beispiel: LDA\0 wählt die Amtsholung und danach den Eingangswert des Matches (Map From)

Bemerkung

Beachten Sie, dass für Unified Messaging eine andere Klasse von Regular Expressions verwendet wird und nicht alle Ausdrücke, die im Kapitel Syntax für Regeln beschrieben sind, hier angewendet werden können, z.B. können keine geschweiften Klammern verwendet werden.

---

Rufnummernmanipulation für angerufene Fax-Nummern

Wahlregeln für „Display Incoming Calls“ werden im Standard bei eingehenden Fax-Anrufen nur auf die Anrufernummer angewendet, jedoch nicht auf die angerufene Nummer. Wenn (auch) die angerufene Faxnummer (also die Faxnummer des XPhone Users) über eine „Display Incoming Calls“-Wahlregel manipuliert werden soll, muss ein Parameter gesetzt werden.

Hinterlegen Sie dazu im XPhone Server unter Systemeinstellungen > UM > Fax > Allgemein im Bereich Erweiterte Einstellungen einen neuen Parameter über den Button Hinzufügen mit dem Namen Fax2Mail\ApplyFilterForCalledNumber und setzen Sie den Wert auf 1.

Übernehmen Sie die diese Einstellung und speichern Sie dann die Änderung auf der Hauptseite Systemeinstellungen > UM > Fax > Allgemein. Starten Sie abschließend die UM Dienste im Bereich Systemeinstellungen > UM > Dienste neu.

Vernetzte TK-Systeme - Userzuordnung

Im XPhone Connect Server kann nur ein Wahlparameter unter Systemeinstellungen > UM > Gateway im Bereich Wahlparameter hinterlegt werden. Verwenden Sie hier bei mehreren Lokationen den Wahlparameter an dem die meisten User Fax, Voicemail und/oder SMS nutzen.

Wenn ein Fax für einen User ankommt, so muss die Empfänger-Faxnummer einem User im XPhone Connect Server zugeordnet werden können. Zur Identifizierung des Users wird der Eintrag im Feld „Fax Firma“ verwendet. Wenn ein User seine Voicemails abfragen will, oder er auf die Voicemail-Nummer umleitet, so wird für die Identifizierung des anrufenden Users bzw. der umgeleiteten Rufnummer der Eintrag im Feld „Tel. Firma“ verwendet.

Unsere Dienste, z.B. für Faxempfang (Fax2Mail) bzw. Voicemail verwenden vier Rufnummernformate, um den Teilnehmer zu identifizieren, diese sind:

• National: 089840798123

• International mit 00: 004989840798123

• International mit +: +4989840798123

• Intern: 123

Aus diesem Grund spielt es keine Rolle in welchem Format die Rufnummern beim User eingetragen sind. Sonderzeichen wie Klammern, Schrägstriche, Bindestriche etc., die bei User eingetragen wurden, werden generell ignoriert.

Wenn die Rufnummer vom TK-System intern signalisiert wird, werden die nationalen und internationalen Rufnummernformate aus den Wahlparameter-Einstellungen unter über Systemeinstellungen > UM > Gateway verwendet. Hier kann jedoch nur ein Wahlparameter eingetragen werden, d.h. in vernetzten Standorten kann es zu Problemen führen, wenn die Rufnummer intern als Durchwahl signalisiert wird und diese nicht zum Wahlparameter gehört, der unter Systemeinstellungen > UM > Gateway konfiguriert ist.

Lösungsmöglichkeit 1

Sie konfigurieren das eingesetzte TK-System so, dass die Rufnummern vollständig national oder international signalisiert werden, damit die Rufnummer dem User eindeutig zugeordnet werden kann. In diesem Fall muss am XPhone Connect Server nichts geändert werden.

Lösungsmöglichkeit 2

Öffnen Sie die Eigenschaften der User und dort den Unterbereich Voicemail bzw. Fax und tragen Sie dort die Rufnummer ein, wie Sie an der CAPI-Schnittstelle signalisiert wird. Prüfen Sie dazu ggf. die Logs für Fax2Mail (Faxempfang) und Voicemail, um das signalisierte Rufnummernformat zu prüfen.

Diesen Lösungsansatz empfehlen wir nur, wenn die Anzahl an angelegten Usern im XPhone Connect Server überschaubar ist. Weiterhin sollten hier keine „falschen“ Rufnummernformate eingetragen werden, z.B. fehlende führende 0. hierfür empfehlen wir die Signalisierung seitens TK-System zu prüfen und zu korrigieren. Alternativ können Sie auch Wahlregeln einsetzen, um z.B. eine fehlende führende 0 zu ergänzen.

Der zuvor beschriebene Lösungsansatz nur i.d.R. nur angewendet, wenn die Rufnummern für alle Standorte intern signalisiert werden:

Prüfen Sie in jedem Fall, ob es nicht sinnvoller wäre, Lösungsmöglichkeit 1, 3 oder 4 anzuwenden.

Lösungsmöglichkeit 3

Unter der Voraussetzung, dass jede Nebenstelle standortübergreifend nur einmalig existiert, können Sie wie folgt vorgehen:

Öffnen Sie Systemeinstellungen > UM > Allgemein. Dort finden Sie bei Erweiterten Einstellungen den Parameter NumberSearchFormats. Die Werte des Eintrags i,+can,0an,00can haben folgende Bedeutung:

• i: interne Rufnummer (Durchwahl)

• +can = internationales Format beginnend mit +

• c = country / Landeskennzahl

• a = area code / Vorwahl

• n = number / Hauptrufnummer

• 0an = nationales Format

• 00can = internationales Format beginnend mit 00

Wenn nun ein zweiter Standort existiert mit dem Wahlparameter +49(30)987654-Durchwahl, so können Sie den Parameter NumberSearchFormats wie folgt konfigurieren:

i,+can,0an,00can,+4930987654i,004930987654i,030987654i

Lösungsmöglichkeit 4

Unter der Voraussetzung, dass an der CAPI-Schnittstelle für alle Standorte Durchwahlnummern intern signalisiert werden und die Durchwahlnummern Bereichen zugeordnet werden können, können Sie diese über Wahlregeln komplettieren.

Beispiel 1 für Voicemail für umleitende Nummer (Ermittlung der Sprachbox des Teilnehmers) und Anrufernummer (Abfrage Voicemail durch User)

Standort	Rufnummer	Nebenstelle
München	+49(89)840798-XXX	100 bis 199
Berlin	+49(30)987654-XXX	200 bis 499
Wien, Österreich	+43(1)11223344-XXX	500 bis 799

Rufen Sie den XPhone Connect Server Manager auf und starten über Tools die Wahlparameter Unified Messaging Gateways…

Klicken Sie nun auf den Reiter NUMBERING > Button ADVANCED FILTERS und wählen Sie dort den Tab DISPLAY INCOMING CALLS

Parameter	Berlin	Wien
Map from	^[2-4][0-9][0-9]$	^[5-7][0-9][0-9]$
Map to	+4930987654\0	+4311223344\0

Für München muss keine Wahlregel angelegt werden, da die Durchwahlen automatisch durch die unter Systemeinstellungen > UM > Gateway eingetragenen Wahlparameter ergänzt werden.

Speichern Sie die Einstellungen und öffnen Sie anschließend im XPhone Connect Server den Bereich Systemeinstellungen > UM > Dienste. Starten Sie die Dienste neu, indem Sie auf den Button „Alle beenden“ und anschließen „Alle starten“ klicken.

Beispiel 2 für angerufene Faxnummer

• Für alle Standorte gilt, dass der Präfix 13 vor der eigentlichen Durchwahl für die Faxnummer verwendet wird, d.h. der User mit der Durchwahl 111 besitzt die Faxnummer 13111.

  Standort	Rufnummer	Nebenstelle
  München	+49(89)840798-XXX	100 bis 199
  Berlin	+49(30)987654-XXX	200 bis 499
  Wien, Österreich	+43(1)11223344-XXX	500 bis 799

Rufen Sie den XPhone Connect Server Manager auf und starten über Tools die Wahlparameter Unified Messaging Gateways.

Klicken Sie nun auf den Reiter NUMBERING > Button ADVANCED FILTERS und wählen Sie dort den Tab DISPLAY INCOMING CALLS.

Parameter	Berlin	Wien
Map from	^13[2-4][0-9][0-9]$	^13[5-7][0-9][0-9]$
Map to	+4930987654\0	+4311223344\0

Für München muss keine Wahlregel angelegt werden, da die Durchwahlen automatisch durch die unter Systemeinstellungen > UM > Gateway eingetragenen Wahlparameter ergänzt werden.

Speichern Sie die Einstellungen.

Öffnen Sie nun im XPhone Connect Server den Bereich Systemeinstellungen > UM > Fax > Allgemein und fügen Sie dort unter „Erweiterte Einstellungen“ einen neuen Parameter durch manuelle Eingabe hinzu: Fax2Mail\ApplyFilterForCalledNumber und setzen Sie den Wert auf 1

Speichern Sie die Einstellungen und öffnen Sie anschließend im XPhone Connect Server den Bereich Systemeinstellungen > UM > Dienste. Dort müssen die Dienste zum Neustart markiert sein. Starten Sie die Dienste neu, indem Sie auf den Button „Neu starten“ klicken.