Platzhalter

Viele Texteingabefelder können ES2015 wie Vorlagenliterale verwenden, um Teile des Textes dynamisch durch bestimmte Werte zu ersetzen. Innerhalb dieser Template-Literale können vordefinierte Platzhalter verwendet werden.

zB Hello ${params.world}

Um einen Platzhalter innerhalb einer URL zu verwenden (z. B. ein Link href im Text-Widget), verwenden $$ , um den Wert mit URL-Escapezeichen zu versehen (z. B. $${property.customer_name} ).

In Textfeldern, die normalerweise eine URL enthalten (z. B. HREF in der Spalte des Tabellen-Widgets), ist das Maskieren mit $$ nicht erforderlich. Dort wird automatisch entgangen.

Global

Die folgenden globalen Platzhalter sind verfügbar:

  1. ${sessionId}

  2. ${params.<urlParam>}
    Dieser Platzhalter liest die URL in der Adressleiste des Browsers und sucht nach URL-Parametern, zB #/dashboards/details?closeOnBackgroundClick=true

  3. ${now}
    Druckt das aktuelle Datum und die Uhrzeit gemäß dem vom Browser definierten Gebietsschema
    benutzerdefiniertes Format gemäß http://momentjs.com/docs/#/displaying/
    zB ${now.format('DD.MM.YYYY HH:mm')}

  4. ${today}
    Druckt den aktuellen Tag gemäß dem vom Browser definierten Gebietsschema
    benutzerdefiniertes Format gemäß http://momentjs.com/docs/#/displaying/
    zB ${today.format('DD.MM.YYYY')}

Aktuelles Objekt / Zeile

Wenn ein SKOOR-Objekt vorhanden ist (z. B. in einer Tabellenzeile), können die folgenden Platzhalter verwendet werden:

  • ${object.id}

  • ${object.deviceId}

  • ${object.name}

  • ${object.type}

  • ${object.subType}

  • ${object.state} / ${object.state.lightbulb(<size>)} / ${object.state.format()}
    Größe in px

  • ${object.properties[<propertyId>]} / ${object.properties.<propertyKey>}
    Property-Enum-Index statt Wert kann mit enumIndex werden (z. B. ${object.properties.foo.enumIndex})

  • ${object.parameters.<parameterKey>}

  • ${object.values.<valueKey>}
    Wertschlüssel finden Sie hier

Es ist auch möglich, auf Spalten einer externen Datenquelle zuzugreifen:

  • ${columns[index]}
    Index beginnend bei 0

  • ${columns.<columnName>} / ${columns ['<columnName>']}

Intervallparam

Intervallparameter können mit MomentJS-Formaten formatiert werden ( http://momentjs.com/docs/#/displaying/ ).

  • ${interval(params.<name>).begin.format(<format>)}

  • ${interval(params.<name>).end.format(<format>)}

Beispiele:

  1. #/dashboards/123?interval=2018-11

    • ${interval(params.interval) → 01.11.2018 - 30.11.2018 (Ausgabe abhängig vom aktuellen Gebietsschema)

    • ${interval(params.interval).begin -> 01.11.2018 (Ausgabe abhängig vom aktuellen Gebietsschema)

    • ${interval(params.interval).end -> 30.11.2018 (Ausgabe abhängig vom aktuellen Gebietsschema)

    • ${interval(params.interval).begin.format('DD.MM.YYYY') -> 01.11.2018

    • ${interval(params.interval).end.format('DD.MM.YYYY')} -> 30.11.2018

    • ${interval(params.interval).begin.format('YYYY')} -> 2018

  2. #/dashboards/123?interval=2018-W5

    • ${interval(params.interval).begin.format('DD.MM.YYYY')} -> 29.01.2018

    • ${interval(params.interval).end.format('DD.MM.YYYY')} -> 04.02.2018

Standardwerte

Wenn kein Platzhalterwert definiert ist (z. B. ein erforderlicher URL-Parameter fehlt), kann man mit dem logischen oder Operator || einen Standardwert setzen .

Beispiele:

  • ${param.name || 'no name given'} -> Kein Name angegeben

  • ${interval(params.interval || '2019-01')} -> 01.11.2018 - 30.11.2018 (Ausgabe abhängig vom aktuellen Gebietsschema)

  • $(time(params.time || moment())} -> 22.01.2020 13:31

Ausdrücke

In den Diagramm- und Tabellen-Widgets können Werte mithilfe von Ausdrücken berechnet werden.

Beispiele:

  • ${(object.values.Temperature - 25)}

  • ${(columns["Incidents"] / columns["Transactions"]).toFixed(3)} -> .toFixed(3) rundet das Ergebnis auf 3 Nachkommastellen

Inhaltsabhängiges Tabellenzellen-Styling

Platzhalter können verwendet werden, um das Klassenattribut basierend auf dem Wert der Zelle festzulegen.

Dadurch wird der CSS-Klassenname abhängig vom Zellenwert entweder auf negativ oder positiv gesetzt. Dies kann dann im Dashboard-Formular verwendet werden, um den Wert entsprechend zu formatieren: