Mit dem Virtuellen HTTP Eingang können Werte von einer Webseite ausgelesen werden. Damit wird die Datenabfrage von Geräten mit Weboberfläche erleichtert.
Aus der Loxone Library können passende Vorlagen zur Einbindung von Geräten importiert werden.
Es wird nur das Basic Authentication-Schema unterstützt.
|
Das automatisierte Abrufen von Daten von Websites (Web Scraping) und die anschließende Nutzung dieser Daten sollten gemäß den Nutzungsbedingungen der Website, den lokalen Vorschriften und geltenden Standards erfolgen. Loxone übernimmt keine Haftung für etwaige Konsequenzen bei Nichteinhaltung. |
Inhaltsverzeichnis
Eigenschaften↑
| Kurzbeschreibung | Beschreibung | Einheit | Wertebereich | Standardwert |
|---|---|---|---|---|
| URL | URL für HTTP(S) Abfrage z.B.: http://192.168.1.7:80/request.php https://192.168.1.7:443/request.php |
- | - | - |
| Abfragezyklus | Abfragezyklus in Sekunden (Minimum 10s) | s | 10...604800 | - |
| Timeout | Zeit, die der Miniserver nach einem Lese- oder Schreibbefehl auf eine Antwort vom Gerät wartet, bevor der Vorgang als gescheitert gilt. Bei langsamen Geräten oder schlechter Verbindung erhöhen. |
ms | 10...8000 | - |
| Anzahl erlaubte Timeouts | Anzahl fehlgeschlagene Abfragen bevor eine Systemmeldung angezeigt wird. Wert 0 deaktiviert die Überwachung. | - | 0...100 | - |
Beispielprogrammierung↑
Zuerst wird unter Virtuelle Eingänge ein "Virtueller HTTP Eingang" erstellt:
Im Eigenschaftenfenster werden die Webadresse, ein geeigneter Abfragezyklus, Timeout und die Anzahl der erlaubten Timeouts festgelegt.
In diesem Beispiel wird mittels eines Webservice Befehls der Wert am Eingang "Temperature" vom Miniserver abgerufen.
Wenn eine Benutzerauthentifizierung notwendig ist, können Benutzername und Passwort wie folgt mitgegeben werden: http://Benutzer:Passwort@IP-Adresse
Virtueller HTTP Eingang Befehl
Um nun Werte von dieser Seite auslesen zu können, wird ein "Virtueller HTTP Eingangs Befehl" benötigt.
Dabei können beliebig viele Befehle erstellt werden, um Werte abzufragen.
In den Einstellungen wird das Suchmuster definiert. Dazu kann ein Bearbeitungsfenster geöffnet werden, hier wird der Quellcode der Webseite angezeigt, um das Navigieren zum gewünschten Wert zu erleichtern.
Dieser Eingang kann dann per Drag & Drop auf die Programmierseite gezogen werden.
Befehlserkennung↑
Mit der Befehlserkennung kann in einem Text bzw. Quelltext navigiert und Werte ausgelesen werden.
Im folgenden Beispiel möchten wir immer den aktuellen Erdgaspreis herausfiltern:
Da die Angabe "Natural Gas" immer gleich ist, hüpfen wir an diese Stelle im Text. Um die Zeitangabe zu überspringen um den Preis auslesen zu lassen, gibt es verschiedene Möglichkeiten:
Variante 1 via \d\a
Mit \d können einzelne Ziffern und mit \a einzelne Zeichen übersprungen werden:
Variante 2 via \#\w
Mit \# kann eine Zahl und mit \w kann ein beliebiges Wort übersprungen werden:
Variante 3 via \s8
Da in diesem Beispiel die Zeitangabe immer gleich viele Ziffern und Zeichen haben wird, können diese mit \s8 übersprungen werden:
