FTUI Widget - XPath

  Tester gesucht! Herunterladen, entpacken, testen, berichten, wünschen.

Hier mein FTUI Widget um XML, HTML oder auch andere Dateien auszulesen, welche auf der DOM-Struktur basieren.

Dieses Widget ist entstanden, weil moerte aus dem FHEM-Forum eine Möglichkeit gesucht hat, um die Vertretungspläne seiner Kinder in FTUI darstellen zu können. Natürlich nur die Klasse des Kindes betreffend.
Es basiert auf der Xpath-Syntax und stellt die Ergebnisse in einer frei formatierbaren Tabelle dar.

Es kann immer nur in einer "data-node" nach "data-find" gesucht werden, in denen "data-filter" vorkommt. Es werden aber alle "data-nodes", in denen "data-filter" vorkommt, ausgelesen und "data-find" angezeigt. Lässt man "data-filter" leer werden alle "data-find" aus allen "data-node" im Dokument angezeigt.
Diese Erklärung ist vielleicht etwas kompliziert. Besser erkennt man es an den Beispielen wie es funktioniert.

  Für dieses Widget ist ein eingerichtetes und Funktionierendes HTTPMOD-Device erfolderlich. Das Attribut "showBody" muss gesetzt sein!
Der Grund hierfür: Die XML-Dateien der Vertretungspläne, welche den Anlass zur Entstehung des Widgets gegeben haben, sind nicht über HTTPS abrufbar. Da viele FHEM-Installationen aber mit HTTPS abgesichert sind und in den meisten Browsern die Sicherheitseinstellungen es nicht zulassen HTTP-Inhalte nach HTTPS zu importieren, gehe ich den Umweg über HTTPMOD. Außerdem können so Aktualisierungen auch manuell angeschoben werden und es gibt einen einstellbaren Intervall zur automatischen Aktualisierung. Das spart Zeit und Code im Widget.

define <name> HTTPMOD <url-zur-datei> <interval>
attr <device> showBody 1

  Es empfiehlt sich zudem ein userReading anzulegen, welches das Internal "httpbody" wiederspiegelt. Tut man dies nicht, werden die Daten in FTUI nur bei einem "shortpoll" (verzögert) aktualisiert.

attr <device> userReading <ReadingName> { InternalVal('<device>','httpbody','') }

Beispele:

Gegeben ist folgende XML-Datei als Reading im HTTPMOD-Device:

Wir wollen uns nun alle Bücher und alle Informationen anzeigen lassen (einfachste Variante).

<div data-type="xpath"
     data-device="HTTPMOD-Device"
     data-get="data"
     data-node="//book"  <!--Hier ist XPath-Syntax für nodes anzuwenden.-->
     data-filter=""  <!--leer-->
     data-find='["title","author","year","price"]'  <!--Das ist ein FTUI-Array.-->
     data-table-header='["Titel","Author","Jahr","Preis"]'>  <!--Das ist ein FTUI-Array.-->
</div>

Die Ausgabe sollte in etwa wie folgt aussehen:

Im nächsten Beispiel wollen wir nur Bücher des Author's "J. R. R. Tolkien" angezeigt bekommen.

<div data-type="xpath"
     data-device="HTTPMOD-Device"
     data-get="data"
     data-node="//book"
     data-filter="[author, 'J. R. R. Tolkien']"  <!--Das ist kein FTUI-Array. Das ist XPath-Syntax-->
     data-find='["title","author","year","price"]'  <!--Das ist ein FTUI-Array.-->
     data-table-header='["Titel","Author","Jahr","Preis"]'>  <!--Das ist ein FTUI-Array-->
</div>

Die Ausgabe sollte in etwa wie folgt aussehen:

In diesem Beispiel wollen wir das Buch von J K. Rowling. Wir suchen aber nur nach "Rowling" und wollen nur das Jahr und Preis anzeigen:

<div data-type="xpath"
     data-device="HTTPMOD-Device"
     data-get="data"
     data-node="//book"  <!--Hier ist XPath-Syntax für nodes anzuwenden.-->
     data-filter="[contains(author, 'Rowling')]"  <!--Das ist kein FTUI-Array. Das ist XPath-Syntax-->
     data-find='["year","price"]'  <!--Das ist ein FTUI-Array.-->
     data-table-header='["Jahr","Preis"]'>  <!--Das ist ein FTUI-Array-->
</div>

  Bei den Parametern immer auf die Groß- und Kleinschreibung achten!

Die Ausgabe sollte in etwa wie folgt aussehen:

Weitere Beispiele werden folgen...

Tabellenformatierung:

Die Tabelle wird so aufgebaut, dass jede Zelle eindeutig identifiziert werden kann.
Wenn man dem umgebenden div-Element eine ID gibt (<div data-type="xpath"... id="xpathid"></div>), kann auch die Tabelle selbst klar identifiziert werden.

<table>

</table>

Download: 

Grüße^^