Anbindung an das Hotelmanagementsystem (PMS)

Wichtig

Betaversion 2.1. Das hier Beschriebene gibt es nur in der Betaversion 2.1: Sie wird aus dem Beta-Repository und nur mit einer Lizenz installiert; die stabile Version 2.0.2 und die Demoversion enthalten es nicht. Die Betaversion wird ohne Gewähr ausgeliefert, Support gibt es nach Möglichkeit (Betatestprogramm).

Seit Version 2.1.0.471 nimmt der Knoten Ereignisse des Hotelmanagementsystems (PMS) an: Check-in, Check-out, Zimmerwechsel und Abgleich. Der Check-in gibt den Fernsehern eines Zimmers die Kanäle bis zum Check-out-Zeitpunkt frei, der Check-out sperrt sie und beendet laufende Sitzungen. Die Anbindung an das PMS läuft üblicherweise über die Schnittstelle seines Anbieters (auf PMS-Seite über das Protokoll FIAS); diese Schnittstelle ruft den Knoten auf. In der Demoversion gibt es diese Funktion nicht.

Zimmer sind Logins

Ein Hotelzimmer besteht aus lokalen Logins mit demselben Feld „Zimmer“ im Login-Editor (Benutzer: hinzufügen und bearbeiten). Varianten:

  • ein Login pro Fernseher — ein Login nach der IP-Adresse des Fernsehers;

  • ein Login für einen Adressbereich pro Zimmer, wenn die Fernseher des Zimmers in einem eigenen Subnetz liegen.

Bei einem Login mit leerem „Zimmer“ ändert das PMS nichts. Bei den Logins eines Zimmers setzt es das „Ablaufdatum“ (Check-out-Zeitpunkt), den Gastnamen und, wenn Pakete eingerichtet sind, die „Erlaubten Streams“. Den Gastnamen sieht nur die Rolle Admin; ins Protokoll wird er nicht geschrieben.

Was die Ereignisse bewirken

  • Check-in gibt die Logins des Zimmers bis zum Check-out-Zeitpunkt frei, speichert den Gastnamen und, wenn das PMS ein Paket genannt hat, die Streams dieses Pakets. Mit demselben Ereignis verlängert oder verkürzt das PMS den Aufenthalt.

  • Check-out sperrt die Logins des Zimmers, löscht den Gastnamen und beendet innerhalb weniger Sekunden ihre PS1-, SRT- und HTTP/HLS-Sitzungen.

  • Zimmerwechsel — Check-out aus einem Zimmer und Check-in in ein anderes mit demselben Check-out-Zeitpunkt, Gast und denselben Streams.

  • Abgleich — das PMS sendet die Liste aller belegten Zimmer: Die aufgeführten werden belegt, die übrigen belegten Zimmer mit dem Feld „Zimmer“ werden freigegeben.

Übermittelt das PMS ein Check-out-Datum ohne Uhrzeit, wird das Zimmer zur „Check-out-Stunde“ gesperrt (nach der Zeitzone des Knotens, standardmäßig 12).

In der Konsole

Die Hotelfunktionen arbeiten, solange auf dem Knoten „Hotel-TV“ eingeschaltet ist (Hotel-TV). Auf einem Knoten ohne Hoteldaten ist es ausgeschaltet: Schalten Sie es ein, bevor Sie die Verbindung zum PMS einrichten.

  • Registerkarte „Zimmer“ der Ansicht „Benutzer / Logins“ (Benutzer / Logins) — die Zimmer, ihr Zustand („Belegt“, „Frei“, „Pausiert“), der Check-out-Zeitpunkt, die Logins des Zimmers, die Verbindung zum PMS (letztes Ereignis, letzter Abgleich, Fehler, unbekannte Zimmer) und Warnungen zu Logins, über die ein gesperrtes Zimmer trotzdem schauen kann;

  • Ansicht „Verwaltung ▸ Hotel-TV“ — „PMS-Ereignisse annehmen“, „API-Token“, „Erlaubte Adressen“, „Check-out-Stunde“ und Pakete. Vor Version 2.1.0.477 lagen diese Einstellungen auf der Registerkarte „PMS“ der Login-Ansicht.

Ein Paket verknüpft einen PMS-Paketcode (TV-Berechtigung) mit den Streams, die das Zimmer erhält. Der Code wird genau so angegeben, wie das PMS ihn sendet. Das Paket mit dem Code default gilt, wenn das PMS kein Paket nennt; ohne dieses ändert der Check-in die Streams der Logins nicht.

Zugang der PMS-Schnittstelle

Die PMS-Schnittstelle meldet sich nicht mit einem Konto der Weboberfläche an, sondern über Token und Adresse:

  • „API-Token“ — ein gemeinsames Geheimnis, das die Schnittstelle im Header X-PMS-Token übergibt. Ohne Token wird jede Anfrage abgelehnt. Teilen Sie es nur dem Anbieter der Schnittstelle mit; die Schaltfläche „Token erzeugen“ erzeugt ein neues.

  • „Erlaubte Adressen“ — IPv4-Adressen oder -Bereiche, von denen aus die Schnittstelle auf den Knoten zugreift. Leer — nur der Host selbst.

  • Es wird empfohlen, über HTTPS auf den Knoten zuzugreifen.

Für den Anbieter der Schnittstelle: Der Knoten nimmt Ereignisse mit der Anfrage POST /pms/v1/events an (mit ?dry-run=1 — Prüfung ohne Änderungen) und liefert den Zustand der Zimmer mit der Anfrage GET /pms/v1/status. Das Format der Ereignisse und Antworten steht in der HTTP-API-Referenz (Steuerung über die HTTP API).

Einschränkungen

  • Andere Logins können ein gesperrtes Zimmer freigeben. Ein aktives anonymes Login oder ein breiteres Login für einen Adressbereich, das die Fernseher des Zimmers abdeckt, bedient sie weiter. Schränken Sie solche Logins ein oder pausieren Sie sie; die Registerkarte „Zimmer“ zeigt die gefundenen an.

  • Ein eigener Ereignisstrom für jeden Knoten. Logins werden nicht über Meshwork übertragen: Jeder Knoten braucht einen eigenen Strom von PMS-Ereignissen.

  • Nicht für Präfix-Logins und RIST. Weisen Sie einem Präfix-Login kein Zimmer zu: Beim Check-out wird es nicht getrennt. RIST-Sitzungen werden beim Check-out nicht beendet.

  • In der Demoversion gibt es keine Anbindung an das PMS.