Zum Hauptinhalt springen
CloudStudio

DataPoint

Das DataPoint-Objekt repräsentiert einen Wert, der typischerweise verwendet wird, um den Zustand eines Endpunkts zu einem bestimmten Zeitpunkt darzustellen.

Eigenschaften

value (number) Die Eigenschaft value repräsentiert den Endpunkt-Wert als Zahl. Siehe die Tabelle am Ende dieses Abschnitts für die Endpunkt-Typen, auf die diese Eigenschaft anwendbar ist, und ihre Bedeutung.

Beispiele

Dieses Beispiel zeigt den aktuellen Wert des ersten Endpunkts eines Geräts über die Log-Konsole.

env.log('Endoint value: ', myDevice.endpoints.byIndex(0).getCurrentValue().value);

isOn (boolean) Die Eigenschaft isOn gibt an, ob der Endpunkt derzeit eingeschaltet ist. Siehe die Tabelle am Ende dieses Abschnitts für die Endpunkt-Typen, auf die diese Eigenschaft anwendbar ist, und ihre Bedeutung.

Beispiele

Dieses Beispiel zeigt den aktuellen Zustand des ersten Endpunkts eines Geräts über die Log-Konsole.

env.log('Endoint state: ', myDevice.endpoints.byIndex(0).getCurrentValue().isOn);

state (number) Die Eigenschaft state gibt den aktuellen Zustand des Endpunkts an. Diese Eigenschaft gilt für Endpunkte vom Typ IAS Sensor.

Beispiele

Dieses Beispiel zeigt den aktuellen Zustand des ersten Endpunkts eines Geräts über die Log-Konsole.

env.log('Endoint state: ', myDevice.endpoints.byIndex(0).getCurrentValue().state);

position (number) Die Eigenschaft position gibt die aktuelle Position für Endpunkte vom Typ Closure an.

Beispiele

Dieses Beispiel zeigt die aktuelle Position des ersten Endpunkts eines Geräts über die Log-Konsole.

env.log('Endoint position: ', myDevice.endpoints.byIndex(0).getCurrentValue().position);

mode (number) Die Eigenschaft mode gibt den aktuellen Modus eines Endpunkts vom Typ Thermostat an.

Beispiele

Dieses Beispiel zeigt den aktuellen Modus des ersten Endpunkts eines Geräts über die Log-Konsole.

env.log('Thermostat mode: ', myDevice.endpoints.byIndex(0).getCurrentValue().mode);

fanMode (number) Die Eigenschaft fanMode gibt den aktuellen Lüfter-Modus eines Endpunkts vom Typ Thermostat an.

Beispiele

Dieses Beispiel zeigt den aktuellen Lüfter-Modus des ersten Endpunkts eines Geräts über die Log-Konsole.

env.log('Fan mode: ', myDevice.endpoints.byIndex(0).getCurrentValue().fanMode);

setpoint (number) Die Eigenschaft setpoint gibt die gewünschte Temperatur für einen Endpunkt vom Typ Thermostat an.

Beispiele

Dieses Beispiel zeigt die gewünschte Temperatur des ersten Endpunkts eines Geräts über die Log-Konsole.

env.log('Setpoint: ', myDevice.endpoints.byIndex(0).getCurrentValue().setpoint);

ambientTemperature (number) Die Eigenschaft ambientTemperature gibt die aktuelle Umgebungstemperatur eines Endpunkts vom Typ Thermostat an.

Beispiele

Dieses Beispiel zeigt die aktuelle Umgebungstemperatur des ersten Endpunkts eines Geräts über die Log-Konsole.

env.log('Ambient temperature: ', myDevice.endpoints.byIndex(0).getCurrentValue().ambientTemperature);

latitude (number) Die Eigenschaft latitude gibt den Breitengrad für einen Endpunkt vom Typ Location Tracker an.

Beispiele

Dieses Beispiel zeigt die aktuellen Koordinaten des ersten Endpunkts eines Geräts über die Log-Konsole.

var v = myDevice.endpoints.byIndex(0).getCurrentValue();
env.log('Coordinates: ', v.latitude, ' - ', v.longitude);

longitude (number) Die Eigenschaft longitude gibt den Längengrad für einen Endpunkt vom Typ Location Tracker an.

Beispiele

Dieses Beispiel zeigt die aktuellen Koordinaten des ersten Endpunkts eines Geräts über die Log-Konsole.

var v = myDevice.endpoints.byIndex(0).getCurrentValue();
env.log('Coordinates: ', v.latitude, ' - ', v.longitude);

flags (number) Die Eigenschaft flags gibt die besonderen Bedingungen eines Endpunkts vom Typ Location Tracker an.

Beispiele

Dieses Beispiel zeigt die Flags des ersten Endpunkts eines Geräts über die Log-Konsole.

env.log('Flags: ', myDevice.endpoints.byIndex(0).getCurrentValue().flags);

activeEnergy (number) Die Eigenschaft activeEnergy gibt die Wirkenergie eines Endpunkts vom Typ Energy Meter an.

Beispiele

Dieses Beispiel zeigt die Wirk-, Blind- und Scheinenergie des ersten Endpunkts eines Geräts über die Log-Konsole.

var v = myDevice.endpoints.byIndex(0).getCurrentValue();
env.log('Energy (active / reactive / apparent): ', v.activeEnergy, '/', v.reactiveEnergy, '/', v.apparentEnergy);

reactiveEnergy (number) Die Eigenschaft reactiveEnergy gibt die Blindenergie eines Endpunkts vom Typ Energy Meter an.

Beispiele

Dieses Beispiel zeigt die Wirk-, Blind- und Scheinenergie des ersten Endpunkts eines Geräts über die Log-Konsole.

var v = myDevice.endpoints.byIndex(0).getCurrentValue();
env.log('Energy (active / reactive / apparent): ', v.activeEnergy, '/', v.reactiveEnergy, '/', v.apparentEnergy);

apparentEnergy (number) Die Eigenschaft apparentEnergy gibt die Scheinenergie eines Endpunkts vom Typ Energy Meter an.

Beispiele

Dieses Beispiel zeigt die Wirk-, Blind- und Scheinenergie des ersten Endpunkts eines Geräts über die Log-Konsole.

var v = myDevice.endpoints.byIndex(0).getCurrentValue();
env.log('Energy (active / reactive / apparent): ', v.activeEnergy, '/', v.reactiveEnergy, '/', v.apparentEnergy);

text (string) Die Eigenschaft text gibt den Text an, der einem Endpunkt vom Typ Text Container zugeordnet ist.

Beispiele

Dieses Beispiel zeigt den Text, der dem ersten Endpunkt eines Geräts zugeordnet ist, über die Log-Konsole.

env.log('Text: ', myDevice.endpoints.byIndex(0).getCurrentValue().text);

DataPoint-Objekt-Eigenschaften für jeden Endpunkt-Typ

PropertyEndpoint typeMeaning
valueNumeric endpoints (scalar, discrete, etc.)Current value
ApplianceOff: 0On: 1
DimmerOff: 0On: current level
ClosureCurrent position
IAS SensorCurrent state
isOnAppliance / Dimmer / ThermostatOff: falseOn: true
ClosureStopped: falseMoving: true
stateIAS SensorCurrent state
positionClosureCurrent position
modeThermostatCurrent mode
fanModeThermostatCurrent fan mode
setpointThermostatDesired temperature
ambientTemperatureThermostatAmbient temperature
latitudeLocation trackerLatitude
longitudeLocation trackerLongitude
flagsLocation trackerLocation flags
activeEnergyEnergy MeterActive energy
reactiveEnergyEnergy MeterReactive energy
apparentEnergyEnergy MeterApparent energy
textText containerCurrent text

Zuletzt aktualisiert am

Auf dieser Seite

Eigenschaftenvalue (number) Die Eigenschaft value repräsentiert den Endpunkt-Wert als Zahl. Siehe die Tabelle am Ende dieses Abschnitts für die Endpunkt-Typen, auf die diese Eigenschaft anwendbar ist, und ihre Bedeutung.isOn (boolean) Die Eigenschaft isOn gibt an, ob der Endpunkt derzeit eingeschaltet ist. Siehe die Tabelle am Ende dieses Abschnitts für die Endpunkt-Typen, auf die diese Eigenschaft anwendbar ist, und ihre Bedeutung.state (number) Die Eigenschaft state gibt den aktuellen Zustand des Endpunkts an. Diese Eigenschaft gilt für Endpunkte vom Typ IAS Sensor.position (number) Die Eigenschaft position gibt die aktuelle Position für Endpunkte vom Typ Closure an.mode (number) Die Eigenschaft mode gibt den aktuellen Modus eines Endpunkts vom Typ Thermostat an.fanMode (number) Die Eigenschaft fanMode gibt den aktuellen Lüfter-Modus eines Endpunkts vom Typ Thermostat an.setpoint (number) Die Eigenschaft setpoint gibt die gewünschte Temperatur für einen Endpunkt vom Typ Thermostat an.ambientTemperature (number) Die Eigenschaft ambientTemperature gibt die aktuelle Umgebungstemperatur eines Endpunkts vom Typ Thermostat an.latitude (number) Die Eigenschaft latitude gibt den Breitengrad für einen Endpunkt vom Typ Location Tracker an.longitude (number) Die Eigenschaft longitude gibt den Längengrad für einen Endpunkt vom Typ Location Tracker an.flags (number) Die Eigenschaft flags gibt die besonderen Bedingungen eines Endpunkts vom Typ Location Tracker an.activeEnergy (number) Die Eigenschaft activeEnergy gibt die Wirkenergie eines Endpunkts vom Typ Energy Meter an.reactiveEnergy (number) Die Eigenschaft reactiveEnergy gibt die Blindenergie eines Endpunkts vom Typ Energy Meter an.apparentEnergy (number) Die Eigenschaft apparentEnergy gibt die Scheinenergie eines Endpunkts vom Typ Energy Meter an.text (string) Die Eigenschaft text gibt den Text an, der einem Endpunkt vom Typ Text Container zugeordnet ist.DataPoint-Objekt-Eigenschaften für jeden Endpunkt-Typ