Anschlussbeschreibung Hotel/Care für Mitel MiVoice Business

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:

  1. Im “User Profile” der “Last Name” mit dem Name aus “Service Profile - Service Label” gefüllt und “First Name” geleert.

  2. Im “Service Profile” der “Directory Name” mit dem Name aus “Service Profile - Service Label” genommen.


Wird ein Check-IN durchgeführt, so wird:

  1. Im “User Profile” der “Last Name” und “First Name” mit dem Gast-/Patienten-Name gefüllt.

  2. 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.

grafik-20240124-073850.png

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:

grafik-20240124-074018.png

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

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