p-tags_v2
v0.1.0
Published
P-Tags
Downloads
92
Readme
P-Tags von Parametric GmbH
Dank den P-Tags ist es einfach Livedaten von Parametric IOT-Geräten in eine Website einzubinden. Erfahren Sie mehr über Parametric GmbH und die Produkte.
Konfiguration
Damit die P-TAGS verwendet werden können, muss im HTML innerhalb von den <head>
-Tags folgender Code hinzugefügt werden.
Die Einbindung der Skripte bei einer WordPress-Seite ist hier dokumentiert.
<head>
<script type="module" src="https://unpkg.com/p-tags_v2@latest/dist/p-tags/p-tags.esm.js"></script>
<script nomodule="" src="https://unpkg.com/p-tags_v2@latest/dist/p-tags/p-tags.js"></script>
</head>
Hinweis: Bei gewissen Einstellungen funktioniert die Einbindung der Skripts nicht. Dann müssen diese hier heruntergeladen werden und anschliessend der Ordner "dist" auf den Server geladen werden. Anschliessend kann bei der Einbindung der Skripte der Pfad entsprechend angepasst werden.
pt-root Tag
Als äusserster Tag muss immer der Tag pt-root verwendet werden. Der Tag verlangt zwingend nach dem "eui"-Attribut, um die korrekten Daten von der Schnittstelle abfragen zu können. Bei der Auslieferung der Geräte wird der jeweils zugehörige Attributwert (DeviceID) für das Attribut "eui" mitgelifert. Anschliessend können innerhalb dieses Tags die spezifischen Tags verwendet werden. Bei mehreren Geräten müssen alles DeviceID's angegeben werden, wobei zwischen zwei ID's jeweils ein Leerschlag sein muss. Die Verwendung des Tags funktioniert wie folgt:
<pt-root eui="DeviceID">
<!--Verwendung der einzelnen P-TAGS-->
</pt-root>
Hinweis: Ersetzten Sie den Attributwert vom Attribut "eui" mit dem bei der Lieferung erhaltenen Wert
Liste vorhandener P-Tags
Die p-tags können wie normale HTML-Tags innerhalb des Tags pt-root verwendet werden. Bei manchen Tags ist zusätzlich ein spezifisches Attribut notwendig. Jedoch ist bei allen Tags, wie bereits beim root-tag, das "eui"-Attribut zwingend verlangt. In der Tabelle ist eine Übersicht über die aktuell verfügbaren Tags ersichtlich. Nachfolgend werden die einzelnen Tags genauer erläutert.
| Name | Beschreibung | Rückgabewert | Notwendige Attribute | Beispiel |
|----------|----------------------------------------|--------------|----------------------|-----------------------------------------------|
| pt-counter-diff | Aktuelle Anzahl Personen in der Anlage | Integer | eui (DeviceID) | <pt-counter-diff eui="DeviceID"></pt-counter-diff>
|
| pt-counter-sum-ltr | Summe Anzahl Personen (links nach rechts) | Integer | eui (DeviceID) | <pt-counter-sum-ltr eui="DeviceID"></pt-counter-sum-ltr>
|
| pt-counter-sum-rtl | Summe Anzahl Personen (rechts nach links) | Integer | eui (DeviceID) | <pt-counter-sum-rtl eui="DeviceID"></pt-counter-sum-rtl>
|
| pt-counter-last-update | Zeitpunkt letzte Aktualisierung | String | eui (DeviceID) | <pt-counter-last-update eui="DeviceID"></pt-counter-last-update>
|
pt-counter-diff
Der pt-counter-diff Tag gibt die aktuelle Anzahl Personen zurück, die sich ein einer Anlage oder in einem Raum befinden. Das System berechnet die Summe automatisch. Der Tag verlangt zwingend nach dem "eui"-Attribut, um die korrekten Daten von der Schnittstelle abfragen zu können. Bei der Auslieferung der Geräte wird der jeweils zugehörige Attributwert (DeviceID) für das Attribut "eui" mitgelifert. Die Verwendung des Tags funktioniert wie folgt:
<pt-counter-diff eui="DeviceID"></pt-counter-diff>
Hinweis: Ersetzten Sie den Attributwert vom Attribut "eui" mit dem bei der Lieferung erhaltenen Wert
pt-counter-sum-ltr
Der pt-counter-sum-ltr Tag gibt die Anzahl Personen zurück, die in der Richtung links nach rechts vorbeigelaufen sind. Der Tag verlangt zwingend nach dem "eui"-Attribut, um die korrekten Daten von der Schnittstelle abfragen zu können. Bei der Auslieferung der Geräte wird der jeweils zugehörige Attributwert (DeviceID) für das Attribut "eui" mitgelifert. Die Verwendung des Tags funktioniert wie folgt:
<pt-counter-sum-ltr eui="DeviceID"></pt-counter-sum-ltr>
Hinweis: Ersetzten Sie den Attributwert vom Attribut "eui" mit dem bei der Lieferung erhaltenen Wert
pt-counter-sum-rtl
Der pt-counter-sum-rtl Tag gibt die Anzahl Personen zurück, die in der Richtung rechts nach links vorbeigelaufen sind. Der Tag verlangt zwingend nach dem "eui"-Attribut, um die korrekten Daten von der Schnittstelle abfragen zu können. Bei der Auslieferung der Geräte wird der jeweils zugehörige Attributwert (DeviceID) für das Attribut "eui" mitgelifert. Die Verwendung des Tags funktioniert wie folgt:
<pt-counter-sum-rtl eui="DeviceID"></pt-counter-sum-rtl>
Hinweis: Ersetzten Sie den Attributwert vom Attribut "eui" mit dem bei der Lieferung erhaltenen Wert
pt-counter-last-update
Der pt-counter-last-update Tag gibt das Datum und die Zeit der letzten Aktualisierung der Daten zurück. Der Tag verlangt zwingend nach dem "eui"-Attribut, um die korrekten Daten von der Schnittstelle abfragen zu können. Bei der Auslieferung der Geräte wird der jeweils zugehörige Attributwert(DeviceID) für das Attribut "eui" mitgelifert. Der Tag hat die Möglichkeit ebenfalls ein "date-format"-Attribut anzugeben, um das Datum und die Zeit entsprechend zu formatieren. Als Attributwert stehen folgende Optionen zur Verfügung:
| Attributwert für date-format | Format | Beispiel |
|----------|----------------------------------------|-----------------------------------------------|
| dayDateTime | Freitag, 12. November 2020, 15:00 | <pt-counter-last-update eui="DeviceID" date-format="dayDateTime"></pt-counter-last-update>
|
| dayDateTimeShort | Fr., 12. Nov. 2020, 15:00 | <pt-counter-last-update eui="DeviceID" date-format="dayDateTimeShort"></pt-counter-last-update>
|
| dateTime | 12. November 2020, 15:00 | <pt-counter-last-update eui="DeviceID" date-format="dateTime"></pt-counter-last-update>
|
| dateTimeShort | 12. Nov. 2020, 15:00 | <pt-counter-last-update eui="DeviceID" date-format="dateTimeShort"></pt-counter-last-update>
|
| time | 15:00 | <pt-counter-last-update eui="DeviceID" date-format="time"></pt-counter-last-update>
|
Hinweise: Falls ein falscher oder kein Wert für das "date-format"-Attribut angegeben wird, kommt automatisch das "dayDateTime"-Format. Ersetzten Sie zudem den Attributwert vom Attribut "eui" mit dem bei der Lieferung erhaltenen Wert
Vollständiges Beispiel
Code
<html>
<head>
<script type="module" src="https://unpkg.com/p-tags_v2@latest/dist/p-tags/p-tags.esm.js"></script>
<script nomodule="" src="https://unpkg.com/p-tags_v2@latest/dist/p-tags/p-tags.js"></script>
<title>p-tags Beispiel</title>
</head>
<body>
<pt-root eui="DeviceID">
<h1>Aktuelle Auslastung</h1>
<p>Aktuell befinden sich <b><pt-counter-diff eui="DeviceID"/></b> Personen in der Anlage.</p>
<p>Letztes Update: <p><b><pt-counter-last-update eui="DeviceID" date-format="dayDateTime" /> Uhr</b> </p>
</pt-root>
</body>
</html>