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

Beispiel: Hello ${params.world}

Global

Die folgenden globalen Platzhalter sind verfügbar:

• ${sessionId}

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

• ${now}
  Gibt das aktuelle Datum und die aktuelle Uhrzeit gemäß dem vom Browser definierten benutzerdefinierten Format
  für die Ländereinstellung gemäß http://momentjs.com/docs/#/displaying/
  aus, z. B. ${now.format('DD.MM.YYYY HH:mm')}

• ${today}
  Gibt den aktuellen Tag gemäß dem vom Browser definierten benutzerdefinierten Format
  für die Ländereinstellung gemäß http://momentjs.com/docs/#/displaying/
  aus, z. B. ${today.format('DD.MM.YYYY')}

• ${filterMatrix.<column>} /${filterMatrix.<propertyId>}
  Gibt eine durch Kommas getrennte Liste der ausgewählten Werte aus der Filtermatrix aus.
  z. B.
  ${filterMatrix.department}-> Development,Management
  ${filterMatrix[76]}-> Genf,Zürich
  
  Mit Leerzeichen nach dem Komma:
  ${filterMatrix.department.replaceAll(',', ', ')}-> Development, Management

• ${params.widget12345filter}
  Druckt den aktuellen Filterwert der Tabelle mit der ID 12345.

• ${language} , ${locale} ,${languages}
  Derzeit verwendete Sprache, Ländereinstellung oder verfügbare Sprachen.

Aktuelles Objekt / Zeile

Wenn ein SKOOR-Objekt verfügbar 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>} Anstelle des Werts
  kann der Index der Eigenschaftsaufzählung mit enumIndex ausgegeben werden (z. B. ${object.properties.foo.enumIndex})

• ${object.parameters.<parameterKey>}

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

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

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

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

Intervallparameter

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:

• #/dashboards/123?interval=2018-11

  • ${interval(params.interval) → 01.11.2018 - 30.11.2018 (Ausgabe hängt von der aktuellen Ländereinstellung ab)

  • ${interval(params.interval).begin} -> 01.11.2018 (Ausgabe hängt von der aktuellen Ländereinstellung ab)

  • ${interval(params.interval).end} -> 30.11.2018 (Ausgabe hängt von der aktuellen Ländereinstellung ab)

  • ${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

• #/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

Mehr zu Intervallen

• ${interval(params.interval).begin.weekday(0).format('')} -> Ermittelt den ersten Wochentag des Intervallbeginns

• ${interval(params.interval).begin.subtract(12, 'm').format('')} -> 12 Monate vom Beginn des Intervalls abziehen

Standardwerte

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

Beispiele:

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

• ${interval(params.interval || '2019-01')} -> 01.11.2018 - 30.11.2018 (Ausgabe hängt von der aktuellen Ländereinstellung ab)

• ${params.interval || 'BETWEEN(2021,2025)'} → 2021 – 2025 (wenn Bereiche in einem Datumswähler zulässig sind)

• $(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:

• Table widget: Subtract 25 from a SKOOR object value as ${utils.formatNumber(object.values.Temperature - 25)}

• Chart widget: Divide two values using their column names as ${utils.formatNumber(columns["Incidents"] / columns["Transactions"], 3)}
  -> rundet das Ergebnis auf 3 Stellen nach dem Komma

Inhaltsabhängige Gestaltung von Tabellenzellen

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

Dadurch wird der CSS-Klassenname je nach Zellenwert entweder auf „negativ” oder „positiv” gesetzt. Dies kann dann im Dashboard-Formular verwendet werden, um den Wert entsprechend zu formatieren: