p-tags_v2
TypeScript icon, indicating that this package has built-in type declarations

0.1.0 • Public • Published

Parametric GmbH

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> 

Ausgabe auf Website

Aktuelle Auslastung

Aktuell befinden sich 50 Personen in der Anlage.

Letztes Update: Freitag, 16. Juli 2020, 11:00 Uhr

Readme

Keywords

none

Package Sidebar

Install

npm i p-tags_v2

Weekly Downloads

9

Version

0.1.0

License

MIT

Unpacked Size

785 kB

Total Files

88

Last publish

Collaborators

  • aw_parametric