Device Class Object Property Condition (deprecated)

A condition that listens for changes of the value of a device class object property on a specific device.

Managing Device Class Object Property Condition

The type of the condition is stored in the CONDITION_TYPE constant of the com.prosyst.mbs.services.hdm.ham.condition.DCOPropertyCondition interface.

Via Java API

To configure the condition, use the following methods from the DCOPropertyCondition class:

Target Device

setDeviceUID - The UID of the Home Device

Property

setDCOProperty - The name of the property you want to listen for.
setDeviceClass - The Device Class Interface that contains it.

When the value of this property changes the condition will be triggered.

After you configure your condition, call the save method. The Condition Provider will save the condition in Config Tree.

Via ConfigTree

To configure the condition, use the following methods from the DCOPropertyCondition class:

You can create a condition directly from ConfigTree by writing/generating an XML file, according to the following schema definitions:

Download Device Class Object Property Condition Schema Definition

Download Common Datatypes Schema Definition

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:include schemaLocation="HAMCommonTypes.xsd"/>

<xs:complexType name="dcoPropertyCondition">

<xs:complexContent>

<xs:extension base="configNode">

<xs:sequence>

<xs:element name="property" type="propertyType" minOccurs="3" maxOccurs="unbounded">

<xs:alternative test="@key eq 'uid' and @type eq 'string'" type="valueString"/>

<xs:alternative test="@key eq 'device_class' and @type eq 'string'" type="valueString"/>

<xs:alternative test="@key eq 'property' and @type eq 'string'" type="valueString"/>

<xs:alternative test="@key eq 'comparison_operation' and @type eq 'string'" type="comparisonOperation"/>

<xs:alternative test="@key eq 'constraint' and @type eq 'int'" type="valueInt"/>

<xs:alternative test="@key eq 'constraint' and @type eq 'char'" type="valueChar"/>

<xs:alternative test="@key eq 'constraint' and @type eq 'byte'" type="valueByte"/>

<xs:alternative test="@key eq 'constraint' and @type eq 'boolean'" type="valueBoolean"/>

<xs:alternative test="@key eq 'constraint' and @type eq 'float'" type="valueFloat"/>

<xs:alternative test="@key eq 'constraint' and @type eq 'double'" type="valueDouble"/>

<xs:alternative test="@key eq 'constraint' and @type eq 'short'" type="valueShort"/>

<xs:alternative test="@key eq 'constraint' and @type eq 'long'" type="valueLong"/>

<xs:alternative test="@key eq 'constraint' and @type eq 'map'" type="valueMap"/>

<xs:alternative test="@key eq 'constraint'" type="valueString"/>

<xs:alternative test="@key eq 'state' and @type eq 'int'" type="valueSceneState"/>

<xs:alternative test="@key eq 'usedInScenes' and @type eq 'string[]'" type="valueString"/>

<xs:alternative test="@key eq 'usedInRules' and @type eq 'string[]'" type="valueString"/>

<xs:alternative test="@key eq 'command_count' and @type eq 'int'" type="valuePositiveInt"/>

<xs:alternative test="@key eq 'condition_id' and @type eq 'string'" type="valueString"/>

<xs:alternative test="@key eq 'condition_type' and @type eq 'string'" type="valueString"/>

<xs:alternative test="@key eq 'name' and @type eq 'string'" type="valueString"/>

<xs:alternative test="@key eq 'application' and @type eq 'string'" type="valueString"/>

<xs:alternative test="@key eq 'internal' and @type eq 'boolean'" type="valueBoolean"/>

<xs:alternative type="xs:error"/>

<xs:unique ref="uniqueProperties"/>

<xs:unique ref="uniqueConfigNodes"/>

</xs:element>

</xs:sequence>

<xs:assert test="count(property[@key='uid']) eq 1"/>

<xs:assert test="count(property[@key='device_class']) eq 1"/>

<xs:assert test="count(property[@key='property']) eq 1"/>

</xs:extension>

</xs:complexContent>

</xs:complexType>

<xs:complexType name="attributeDCOPropertyCondition">

<xs:attribute name="name" use="required">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:enumeration value="DCOPropertyCondition"/>

</xs:restriction>

</xs:simpleType>

</xs:attribute>

</xs:complexType>

<xs:complexType name="dcoPropertyConditions">

<xs:complexContent>

<xs:extension base="attributeDCOPropertyCondition">

<xs:all>

<xs:element name="property" type="valueString" minOccurs="0" maxOccurs="unbounded"/>

<xs:element name="config" type="dcoPropertyCondition" minOccurs="0" maxOccurs="unbounded">

<xs:unique ref="uniqueProperties"/>

</xs:element>

</xs:all>

</xs:extension>

</xs:complexContent>

</xs:complexType>

<xs:element name="config" type="dcoPropertyConditions">

<xs:unique name="uniqueProperties">

<xs:selector xpath="property"/>

<xs:field xpath="@key"/>

</xs:unique>

<xs:unique name="uniqueConfigNodes">

<xs:selector xpath="config"/>

<xs:field xpath="@name"/>

</xs:unique>

</xs:element>

</xs:schema>

The following example contains a Device Class Object Property Condition that listens for the NetworkControllerExt Device Class Object of a device with an ID hdm:ZigBee:000d6f0001b57a6e and is triggered when its mode is changed.

</config>