Actabl Alice

Die Schnittstelle kommuniziert mit einem Actabl Alice Server via REST-API.

Funktionsweise

Die Schnittstelle übermittelt nur die Raumdaten und nicht die Ereignisse. Sollte dies erforderlich sein, wenden Sie sich an den Support von Antcas.

Hinweis: Die Schnittstelle ist sehr langsam beim Senden. Es kann einen Moment dauern, bis der Wert im Monitor erscheint.

Es werden einzelne Polls vom Antcas Server via HTTPS auf das Actabl-Portal getätigt. Das API-URL ist dabei fix festgelegt und kann nicht geändert werden. Dabei werden die Räume, die zuvor in der Actabl-Applikation und im Antcas Config definiert wurden, abgefragt. Die Poll-Limite beträgt Standardmässig 30 Abfragen pro Minute. Der Antcas Server hält sich strikt an die eingestellte Richtlinie, um die Auslastung der Gegenseite und des Netzwerkes zu verringern. Dies bedeutet, dass es einige Minuten dauern kann, bis eine Änderung beim Antcas Server ankommt.

Hinweis: Es wird empfohlen, jeden Wert einmal pro Tag zu übermitteln. Die Schnittstelle kann nur Senden und die Werte nicht auslesen.

Tritt ein Verbindungsfehler auf, so wird die Abfrage nach dem Erreichen des Timeouts automatisch wiederholt. Die Fehlermeldung erscheint dabei nur einmal im Monitor. Kommt keine Verbindung innerhalb des eingestellten Verbindungs-Timeouts zustande, so wird zudem die Schnittstelle als offline deklariert.

Konfiguration

Die Zieladresse ist die Adresse des Servers ohne URI und https://-Präfix.

Hinweis: Beim Verwenden eines Proxy-Servers ist darauf zu achten, dass sich der URI-Pfad nicht ändert.

Monitor

Der Monitor kann verschiedene Quellen anzeigen. In der folgenden Tabellen werden alle Möglichkeiten erläutert.

Quelle	Beschreibung
Client	Von der Actabl-Gegenstelle kommender Wert.
Server	Von Antcas Control gesendeter oder gelesener Wert.
System	Allgemeine Systemmeldung.

Variablen

Name	Datentyp	Beschreibung
id	string	Setzt den Raumnamen entsprechend der Schnittstelle.
make_up	bool	Zimmer reinigen anfordern.
dnd	bool	Do Not Disturb senden.