Связь с системой управления гостиницей (PMS)¶
Важно
Бета-версия 2.1. Описанное здесь есть только в бета-версии 2.1: она ставится из бета-репозитория и только с лицензией, в стабильной версии 2.0.2 и в демоверсии этого нет. Бета-версия поставляется без гарантий, поддержка — по возможности (Программа бета-тестирования).
С версии 2.1.0.471 узел принимает события системы управления гостиницей (PMS): заселение, выезд, переезд и сверку. Заселение открывает телевизорам номера каналы до времени выезда, выезд блокирует их и завершает идущие сеансы. Связь с PMS обычно идёт через интерфейс её поставщика (по протоколу FIAS на стороне PMS); этот интерфейс и вызывает узел. В демоверсии этой возможности нет.
Номера — это логины¶
Гостиничный номер — это локальные логины с одинаковым полем «Номер» в редакторе логина (Пользователь: добавление и изменение). Варианты:
по логину на телевизор — логин по IP-адресу телевизора;
один логин-диапазон адресов на номер, если телевизоры номера в своей подсети.
У логина с пустым «Номером» PMS ничего не меняет. У логинов номера она задаёт «Дату окончания» (время выезда), имя гостя и, если настроены пакеты, «Разрешённые потоки». Имя гостя видит только роль Admin, в журнал оно не пишется.
Что делают события¶
Заселение открывает логины номера до времени выезда, записывает имя гостя и, если PMS назвала пакет, потоки этого пакета. Тем же событием PMS продлевает или сокращает проживание.
Выезд блокирует логины номера, стирает имя гостя и в течение нескольких секунд завершает их сеансы PS1, SRT и HTTP/HLS.
Переезд — выезд из одного номера и заселение другого с тем же временем выезда, гостем и потоками.
Сверка — PMS присылает список всех заселённых номеров: перечисленные заселяются, а остальные заселённые номера с полем «Номер» освобождаются.
Если PMS передаёт дату выезда без времени, номер блокируется в «Час выезда» (по часовому поясу узла, по умолчанию 12).
В консоли¶
Гостиничные функции работают, пока на узле включено «Гостиничное ТВ» (Гостиничное ТВ). На узле, где гостиничных данных ещё нет, оно выключено: включите его, прежде чем настраивать связь с PMS.
Вкладка «Номера» экрана «Пользователи / Логины» (Пользователи / Логины) — номера, их состояние («Заселён», «Свободен», «На паузе»), время выезда, логины номера, связь с PMS (последнее событие, последняя сверка, ошибки, неизвестные номера) и предупреждения о логинах, через которые заблокированный номер всё равно сможет смотреть;
экран «Администрирование ▸ Гостиничное ТВ» — «Принимать события PMS», «Токен API», «Разрешённые адреса», «Час выезда» и пакеты. До версии 2.1.0.477 эти настройки были на вкладке «PMS» экрана логинов.
Пакет связывает код пакета PMS (права на ТВ) с потоками, которые получает номер. Код
задаётся в точности как его присылает PMS. Пакет с кодом default применяется, когда
PMS пакет не называет; без него заселение потоков логинов не меняет.
Доступ интерфейса PMS¶
Интерфейс PMS входит не по учётной записи веб-интерфейса, а по токену и адресу:
«Токен API» — общий секрет, который интерфейс передаёт в заголовке
X-PMS-Token. Без токена любой запрос отклоняется. Сообщайте его только поставщику интерфейса; кнопка «Создать токен» создаёт новый.«Разрешённые адреса» — адреса или диапазоны IPv4, с которых интерфейс обращается к узлу. Пусто — только сам хост.
Рекомендуется обращаться к узлу по HTTPS.
Для поставщика интерфейса: узел принимает события запросом POST /pms/v1/events
(с ?dry-run=1 — проверка без изменений) и отдаёт состояние номеров запросом
GET /pms/v1/status. Формат событий и ответов — в справочнике HTTP API
(Управление через HTTP API).
Ограничения¶
Другие логины могут открыть заблокированный номер. Активный анонимный логин или более широкий логин-диапазон адресов, который покрывает телевизоры номера, продолжает их обслуживать. Ограничьте такие логины или поставьте на паузу; вкладка «Номера» показывает найденные.
Свой поток событий на каждый узел. Логины не передаются по Meshwork: каждому узлу нужен свой поток событий PMS.
Не для префиксных логинов и RIST. Префиксному логину номер не назначайте: при выезде он не отключается. Сеансы RIST при выезде не завершаются.
В демоверсии связи с PMS нет.
