Wertanzeige
Benötigt: Symcon >= 8.0
Parameter
Informationen zu den visuellen Eigenschaften und Bedeutungen der Parameter sind in der Objekt-Darstellung zu finden.
| Name |
Type |
Parameter |
Beschreibung |
| PRESENTATION |
String |
Die ID der Darstellung |
VARIABLE_PRESENTATION_VALUE_PRESENTATION {3319437D-7CDE-699D-750A-3C6A3841FA75} |
| ICON |
String |
Standardicon |
Icons |
| COLOR |
Integer |
Standardfarbe |
|
| PREFIX |
String |
Präfix |
|
| SUFFIX |
String |
Suffix |
|
Float und Integer
| Name |
Type |
Parameter |
Beschreibung |
| USAGE_TYPE |
Integer |
Verwendung der Variable |
0: Keine hiervon, 1: Temperatur |
| PERCENTAGE |
Boolean |
Anzeigetyp |
true: Prozent, false: Absolut |
| MIN |
Integer/Float |
Minimaler Wert |
|
| MAX |
Integer/Float |
Maximaler Wert |
|
| THOUSANDS_SEPARATOR |
String |
Tausendertrennzeichen |
Client: Standard vom Nutzer, sonst direkt der Wert |
| DIGITS |
Integer |
Nachkommastellen |
|
| DECIMAL_SEPARATOR |
String |
Dezimaltrennzeichen |
Client: Standard vom Nutzer, sonst direkt der Wert |
| INTERVALS_ACTIVE |
Boolean |
Verwende aktualisierte Parameter für spezifische Intervalle |
|
| INTERVALS |
String |
Intervalle |
JSON-kodierte Liste von Objekten, die genauen Parameter sind unter Intervalle beschrieben |
Intervalle
| Name |
Typ |
Parameter |
Beschreibung |
| IntervalMinValue |
Integer/Float |
Anfang des Intervalls |
|
| IntervalMaxValue |
Integer/Float |
Ende des Intervalls |
|
| ConstantActive |
Boolean |
Anzeige |
false: Formatierter Wert, true: Konstante |
| ConstantValue |
String |
Konstante |
|
| ConversionFactor |
Integer/Float |
Umrechnungsfaktor |
|
| PrefixActive |
Boolean |
Überschreibe Präfix |
|
| PrefixValue |
String |
Präfix |
|
| SuffixActive |
Boolean |
Überschreibe Suffix |
|
| SuffixValue |
String |
Suffix |
|
| DigitsActive |
Boolean |
Überschreibe Nachkommastellen |
|
| DigitsValue |
Integer |
Nachkommastellen |
|
| IconActive |
Boolean |
Überschreibe Icon |
|
| IconValue |
String |
Icon |
|
| ColorActive |
Boolean |
Überschreibe Farbe |
|
| Color |
Integer |
Farbe |
|
Boolean und String
| Name |
Type |
Parameter |
Beschreibung |
| MULTILINE |
Boolean |
Mehrere Zeilen |
|
| OPTIONS |
String |
Optionen |
JSON-kodierte Liste von Objekten, die genauen Parameter sind unter Optionen beschrieben |
Optionen
| Name |
Typ |
Parameter |
Beschreibung |
| Value |
Boolean/String |
Wert |
Abhängig vom Typ der Variable |
| Caption |
String |
Beschriftung |
|
| IconActive |
Boolean |
Überschreibe Icon |
|
| IconValue |
String |
Icon |
Icons |
| ColorActive |
Boolean |
Farbe überschreiben |
|
| ColorValue |
Integer |
Farbe |
|
Vorlagen
// Registriert eine Variable mit einer Temperatur Vorlage.
$this->RegisterVariableFloat('Temperature', 'Raumtemperatur', [
'PRESENTATION' => VARIABLE_PRESENTATION_VALUE_PRESENTATION,
'TEMPLATE' => VARIABLE_TEMPLATE_VALUE_PRESENTATION_ROOM_TEMPERATURE,
]);
| Name |
Konstante |
GUID |
| Raumtemperatur |
VARIABLE_TEMPLATE_VALUE_PRESENTATION_ROOM_TEMPERATURE |
{90AF8F8F-183F-BBFD-E078-35FAB6DCFE4F} |
| Leistung |
VARIABLE_TEMPLATE_VALUE_PRESENTATION_POWER |
{2FED3D39-073D-6037-901B-2586A1AB5569} |
| Energie |
VARIABLE_TEMPLATE_VALUE_PRESENTATION_ENERGY |
{C899FCFA-063E-897E-9DA4-28ADD278EED5} |
| Batterie |
VARIABLE_TEMPLATE_VALUE_PRESENTATION_BATTERY |
{7BD38CF5-07F2-5B5B-8F7F-15398B823BFC} |
| Batterie (Farbe) |
VARIABLE_TEMPLATE_VALUE_PRESENTATION_BATTERY_COLOR |
{C90EF36A-165E-D0B0-032C-F468F483D42B} |
Beispiele
// Beim Registrieren einer Variable für PHP-Module
// Eine Alarm Variable mit Icon und Hintergrundfarbe
$this->RegisterVariableBoolean('Alarm', 'Alarm', [
'PRESENTATION' => VARIABLE_PRESENTATION_VALUE_PRESENTATION,
'OPTIONS' => json_encode([
['Value' => false, 'Caption' => 'OK', 'IconActive' => true, 'IconValue' => 'siren'],
['Value' => true, 'Caption' => 'Alarm', 'IconActive' => true, 'IconValue' => 'siren-on', 'ColorValue' => 16711680, 'ColorActive' => true],
])
]);
// Leistung in Watt mit Darstellung von Werten über 1000 als Kilowatt
$this->RegisterVariableInteger('Leistung', 'Leistung', [
'PRESENTATION' => VARIABLE_PRESENTATION_VALUE_PRESENTATION,
'ICON' => 'bolt',
'SUFFIX' => ' W',
'INTERVALS_ACTIVE' => true,
'INTERVALS' => json_encode([
[
'IntervalMinValue' => 1000,
'IntervalMaxValue' => 999999,
'ConversionFactor' => 1000,
'SuffixActive' => true,
'SuffixValue' => ' kW',
'DigitsActive' => true,
'DigitsValue' => 2,
'ConstantActive' => false,
'PrefixActive' => false,
]
])
]);
// Für bestehende Variablen via Skript
// Es werden nur Icons angezeigt. Eine Option ist farblich hervorgehoben.
IPS_SetVariableCustomPresentation(12345, [
'PRESENTATION' => VARIABLE_PRESENTATION_VALUE_PRESENTATION,
'OPTIONS' => json_encode([
['Value' => false, 'Caption' => 'OK', 'IconActive' => true, 'IconValue' => 'siren'],
['Value' => true, 'Caption' => 'Alarm', 'IconActive' => true, 'IconValue' => 'siren-on', 'ColorValue' => 16711680, 'ColorActive' => true],
])
]);
// Leistung in Watt mit Darstellung von Werten über 1000 als Kilowatt
IPS_SetVariableCustomPresentation(12345, [
'PRESENTATION' => VARIABLE_PRESENTATION_VALUE_PRESENTATION,
'ICON' => 'bolt',
'SUFFIX' => ' W',
'INTERVALS_ACTIVE' => true,
'INTERVALS' => json_encode([
[
'IntervalMinValue' => 1000,
'IntervalMaxValue' => 999999,
'ConversionFactor' => 1000,
'SuffixActive' => true,
'SuffixValue' => ' kW',
'DigitsActive' => true,
'DigitsValue' => 2,
'ConstantActive' => false,
'PrefixActive' => false,
]
])
]);