Anschlussbeschreibung Hotel/Care für Mitel MiVoice Business
- 1 Vorwort
- 1.1 Berechtigungsumschaltung
- 1.2 Name
- 1.3 Rufnummernmitnahme
- 2 Mitel MiVoice Business konfigurieren
- 3 Konfiguration der Datenquelle
- 4 Funktionalität
- 4.1 Beispielkonfiguration
- 4.1.1 AlwinPro
- 4.1.2 Mitel MiVoice Business
- 4.2 Ohne Rufnummernmitnahme
- 4.2.1 Check-IN
- 4.2.2 Berechtigungsumschaltung
- 4.2.3 Check-OUT
- 4.3 Mit Rufnummernmitnahme
- 4.3.1 Check-IN
- 4.3.2 Berechtigungsumschaltung
- 4.3.3 Umzug
- 4.3.4 Check-OUT
- 4.1 Beispielkonfiguration
- 5 Monitore
- 6 Logs
- 7 Fehleranalyse
Vorwort
Die Hotel/Care-Funktionalität (Berechtigungsumschaltung, …) wird mittels der MiXML-Schnittstelle durchgeführt.
Hinweis: Die eigentlich Kommunikation mit der Mitel MiVoice Business wird mit einem Hilfsprogramm (“MitelMiVoiceBusinessMiXML.exe“) durchgeführt. Dieses Programm ist jedoch nicht sichtbar und damit interagiert der Anwender auch nicht. Dies wird hier nur der Vollständigkeit halber aufgeführt.
Es wird nun kurz beschrieben, was in der Mitel für die unterschiedlichen Funktionalitäten verwendet wird. Genaueres bitte im Kapitel “Funktionalität” (weiter unten) anschauen:
Berechtigungsumschaltung
Dazu wird die “Class of Restriction” umgeschaltet (siehe auch Abschnitt “Class of Restriction” weiter unten).
Name
Wird ein Check-OUT auf ein Zimmer durchgeführt, so wird:
Im “User Profile” der “Last Name” mit dem Name aus “Service Profile - Service Label” gefüllt und “First Name” geleert.
Im “Service Profile” der “Directory Name” mit dem Name aus “Service Profile - Service Label” genommen.
Wird ein Check-IN durchgeführt, so wird:
Im “User Profile” der “Last Name” und “First Name” mit dem Gast-/Patienten-Name gefüllt.
Im “Service Profile” der “Directory Name” mit dem Gast-/Patienten-Name gefüllt.
Rufnummernmitnahme
Die Rufnummernmitnahme wird mittels “DID Service Number” realisiert. D.h. die AlwinPro-Durchwahl wird bei dem Mitel User/Nebenstelle im Feld “DID Service Number” eingetragen.
Optional (Default: Aktiv) kann eingestellt werden, ob in der Mitel die Option “Use DID for Outgoing Calls” gesetzt werden soll.
Mitel MiVoice Business konfigurieren
MiXML User anlegen
Für den Zugriff auf die Mitel mittels der MiXML-Schnittstelle wird ein User benötigt. Dieser wird unter “System Properties → System Administration → User Authorization Profiles” angelegt.
Mittels “Add” kann nun ein neuer User angelegt werden.
Beispielhaft wird ein User “aurenz” angelegt, welcher die entsprechenden Berechtigungen hat. Dieser ist wie folgt zu konfigurieren:
Class of Restriction
Die Berechtigungsumschaltung ändert bei den Usern/Nebenstellen die “Class of Restriction”, wodurch geregelt wird, ob ein Gast/Patient nach extern telefonieren darf.
Es wird dabei zwischen 2 “Class of Restriction” umgeschaltet. D.h. in der Mitel müssen 2 “Class of Restriction” entsprechend konfiguriert werden.
Anmerkung: Eine Beschreibung, wie diese “Class of Restriction” konfiguriert werden, wird hier nicht gegeben. Ziehen Sie hierzu die Mitel-Dokumentation heran.
Konfiguration der Datenquelle
In der Datenquelle wird der Zugriff auf die Mitel MiVoice Business MiXML-Schnittstelle im Reiter "Hotel/Care" konfiguriert. Hier müssen die Zugangsdaten zur MiXML-Schnittstelle eingetragen werden.
Parameter:
Server-IP/Name: IP-Adresse oder DNS-Name der Mitel MiVoice Business.
Username: Der angelegte User, welcher Zugriff auf die MiXML-Schnittstelle hat (User, welcher im Abschnitt “MiXML User anlegen” beschrieben wurde).
Passwort: Passwort des angelegten User.
Timeout (Sekunden): Da es bei TCP/IP-Verbindungen auch mal zu “Störungen” kommen kann, wird dieses Timeout verwendet. D.h. nach diesem Timeout wird die ausgeführte Aktion abgebrochen und als “fehlerhaft” behandelt. Der Wert sollte nur nach Rücksprache mit Aurenz verändert werden.
Externe Gespräche zulassen: “Class of Restriction”, welche Gespräche nach extern zulässt.
Externe Gespräche sperren: “Class of Restriction”, welche Gespräche nach extern NICHT zulässt.
Durchwahl nach extern signalisieren: Setzt in der Mitel die Option “Use DID for Outgoing Calls” (nur verfügbar, wenn in den Grundeinstellungen die Rufnummernmitnahme aktiviert ist).
Mittels “Zugand testen” kann geprüft werden, ob mit den eingetragenen Parametern eine Verbindung zur Mitel mittels der MiXML-Schnittstelle aufgebaut werden kann. Ist die Verbindung erfolgreich, so sollte die Meldung unten erscheinen, ansonsten eine entsprechende Fehlermeldung.
Funktionalität
Im Folgenden wird die Funktionalität (Berechtigungsumschaltung, Rufnummernmitnahme, …) anhand von Beispielen dargestellt.
Wir gehen dabei von folgender einfachen Beispielkonfiguration aus:
Beispielkonfiguration
AlwinPro
Es werden 2 Zimmer verwendet:
“Zimmer 1000” mit Nebenstelle 1000
“Zimmer 2000” mit Nebenstelle 2000
Für die Rufnummernmitnahme ist der Bereich 3000-3005 konfiguriert.
In der Datenquelle ist die “Class of Restriction” so konfiguriert:
Mitel MiVoice Business
In der Mitel ist die analog konfiguriert:
“Zimmer 1000” mit der Nebenstelle 1000
“Zimmer 2000” mit der Nebenstelle 2000
Ohne Rufnummernmitnahme
Im folgenden wird die Funktionalität beschrieben, wenn KEINE Rufnummernmitnahme verwendet wird. D.h. in AlwinPro ist in den Grundeinstellungen der Punkt “Rufnummernmitnahme” deaktiviert.
Check-IN
Der Patient “Alina Solo” wird auf das Zimmer 1000 eingecheckt.
In der Mitel werden dabei nun folgende Dinge geändert:
User Profile - Last Name: Solo
User Profile - First Name: Alina
Service Profile - Directory Name: Solo,Alina
Service Details - Class of Restriction: 1 (für alle 3 Bereiche - Day, Night1, Night2)
Berechtigungsumschaltung
Findet eine Berechtigungsumschaltung statt (z.B.: weil der Schwellwert/das Limit erreicht ist), so wird die “Class of Restriction” umgeschaltet.
Check-OUT
Der Patient “Alina Solo” wird wieder ausgecheckt.
In der Mitel werden dabei nun folgende Dinge geändert:
User Profile - Last Name: Zimmer 1000 (hier wird der Wert aus “Service Profile - Service Label” genommen)
User Profile - First Name: leer
Service Profile - Directory Name: Zimmer 1000 (hier wird der Wert aus “Service Profile - Service Label” genommen)
Service Details - Class of Restriction: 2 (für alle 3 Bereiche - Day, Night1, Night2)
Mit Rufnummernmitnahme
Im folgenden wird die Funktionalität beschrieben, wenn Rufnummernmitnahme verwendet wird. D.h. in AlwinPro ist in den Grundeinstellungen der Punkt “Rufnummernmitnahme” aktiviert.
Check-IN
Der Patient “Alina Solo” wird auf das Zimmer 1000 eingecheckt.
In der Mitel werden dabei nun folgende Dinge geändert:
User Profile - Last Name: Solo
User Profile - First Name: Alina
Service Profile - Directory Name: Solo,Alina
Service Details - Class of Restriction: 1 (für alle 3 Bereiche - Day, Night1, Night2)
Service Details - DID Service Number: 3000
Service Details - Use DID for Outgoing Calls: (Optional) gesetzt, falls in der Datenquelle “Durchwahl nach extern signalisieren” aktiviert ist.
D.h. hier wird zusätzlich noch die “Durchwahl” als DID gesetzt.
Berechtigungsumschaltung
Findet eine Berechtigungsumschaltung statt (z.B.: weil der Schwellwert/das Limit erreicht ist), so wird die “Class of Restriction” umgeschaltet.
Umzug
Der Patient zieht nun vom “Zimmer 1000” auf das “Zimmer 2000”.
Im “Zimmer 1000” wurde ein “Check-OUT durchgeführt (d.h. die Felder wieder zurückgesetzt - auch die “DID Service Number” entfernt) und im “Zimmer 2000” ein Check-IN durchgeführt. Damit hat nun “Zimmer 2000” die “DID Service Number” 3000.
Check-OUT
Der Patient “Alina Solo” wird wieder ausgecheckt.
In der Mitel werden dabei nun folgende Dinge geändert:
User Profile - Last Name: Zimmer 1000 (hier wird der Wert aus “Service Profile - Service Label” genommen)
User Profile - First Name: leer
Service Profile - Directory Name: Zimmer 1000 (hier wird der Wert aus “Service Profile - Service Label” genommen)
Service Details - Class of Restriction: 2 (für alle 3 Bereiche - Day, Night1, Night2)
Service Details - DID Service Number: leer
Service Details - Use DID for Outgoing Calls: (Optional) deaktiviert, falls in der Datenquelle “Durchwahl nach extern signalisieren” aktiviert ist.
Monitore
Die Kommandos für die Hotel/Care-Funktionalität sind im Monitor “Skript Interpreter” zu sehen.
Logs
Es werden im Verzeichnis “Logs” entsprechende Logs geschrieben:
Programm | Log | ZusatzoInfo |
---|---|---|
Datenaufnahme-Dienst | MitelMiXMLLogDAService | Maximal 10 Dateien a 1 MB |
Datenaufnahme | MitelMiXMLLogDA | Maximal 1 Datei a 1 MB |
AlwinPro | MitelMiXMLLog | Maximal 1 Datei a 1 MB |
Fehleranalyse
Falsche IP-Adresse
Wird z.B.: eine falsche IP-Adresse für die Mitel angegeben, so erscheint beim “Zugang testen”:
Falscher Username/Passwort
Es wird die folgende Meldung ausgegeben:
© aurenz GmbH 2022