Amadeus HotSOS

このインターフェースは、Amadeus HotSOS サーバーと REST-API を介して通信します。

動作

このインターフェースは、イベントではなく部屋のデータのみを同期します。必要な場合は、Antcas のサポートにお問い合わせください。

注意: このインターフェースは送信が非常に遅いです。値がモニターに表示されるまで少し時間がかかることがあります。

Antcas サーバーから HTTPS を介して HotSOS ポータルへ個別のポーリングが行われます。API URL は固定されており変更できません。この際、HotSOS アプリケーションおよび Antcas Config で事前に定義された部屋が照会されます。ポーリング制限は標準で 30 件/分です。Antcas サーバーは設定された方針を厳格に遵守し、相手側およびネットワークの負荷を軽減します。これは Antcas サーバーへ変更が反映されるまで数分かかることを意味します。

サーバーを起動すると、最初にメッセージが取得され、その後すべてのステータスメッセージが転送されます。HotSOS 側で途中に変更があった場合は、ステータスがまず PLC に到着し、その後再度送信されることになります。

接続エラーが発生した場合、タイムアウトに達すると自動的に照会が繰り返されます。エラーメッセージはモニターに一度だけ表示されます。設定された接続タイムアウト内に接続できない場合、インターフェースはオフラインと宣言されます。

構成

ターゲットアドレスは、URI と https:// プレフィックスを除いたサーバーのアドレスです。

注意: プロキシサーバーを使用する場合は、URI パスが変更されないようにしてください。

モニター

モニターにはさまざまなソースを表示できます。以下の表にすべてのオプションを説明します。

ソース	説明
クライアント	HotSOS 対応側から受信した値。
サーバー	Antcas Control から送信または読み取られた値。
システム	一般的なシステムメッセージ。

変数

名前	データ型	説明
id	string	インターフェースに応じて部屋番号を設定します。
make_up	bool	部屋の掃除を要求します。
service_status	string	部屋の現在のサービスステータス。
status	string	部屋のステータス。
name	string	受信した部屋名。
dnd	bool	Do Not Disturb を受信します。
occupied	bool	部屋が占有されています。

注意: 送信できるのは次の値のみです。その他の値は送信されず、モニターで赤色でマークされます。

status

値	説明
CLEAN	部屋はきれいです。
DIRTY	部屋は汚れています。
OUT_OF_ORDER	部屋が損傷しています。
OUT_OF_SERVICE	部屋は運用停止です。
INSPECTED	部屋が検査されました。
PICKUP	部屋はピックアップステータスです。

service_status

注意: 送信できるのは AWAITING_SERVICE と DO_NOT_DISTURB の値のみです。

値	説明
AWAITING_SERVICE	部屋は掃除を待機しています。
DO_NOT_DISTURB	ゲストは邪魔されたくありません。
VACANT_CLEANED	部屋が掃除されて空いています。
OCCUPIED_CLEANED	部屋は掃除されて占有されています。
CLEANING_STARTED	部屋の掃除が開始されました。
SERVICE_REFUSED	ゲストはサービスを拒否しました。
STOPPED	掃除が停止されました。
TO_BE_INSPECTED	部屋は検査が必要です。
INSPECTED	部屋が検査されました。
LATE_SERVICE	ゲストは遅いサービスを希望しています。
RETURN_LATER	ゲストは後で戻るように依頼しました。