dataSet

The dataSet element is the parent element for a collection of item elements, which are processed sequentially and used to assign a value to the parent data group element. The dataSet element and its item children are required as components in one of several reference operation structures. For example, a dataSet is required if the opMax operation is used. The data set can define the total number of values from which only one must be returned to the parent data group element, or the data set can define a subset of values that are compared to other values outside of that data set.

This element is:

To learn about how this element relates to other elements in a CygNet device template file, see Device Template File Hierarchy.

See also Reference Methods – Arithmetic Examples.

Example

<MaxValDEID desc="Maximum value of data group element" readOnly="true" type="ui2" isRef="1">

<ref prec="0" refOp="opAssignId" deid="raw2"/>

<ref prec="1" refOp="opScaleFactor" scaleFactor="10"/>

<ref prec="2" refOp="opMax">

<dataSet>

<item value="50"/>

<item deid="raw1"/>

<item deid="raw10"/>

</dataSet>

</ref>

</MaxValDEID>

Supporting Elements

The following table lists and describes special child elements used within a dataSet element.

Attribute Description

item

item defines a value as one in a list or data set that can be acted upon by a parent refOp value. item values can derive from a constant (value) or from a variable (deid). At least one item element must be in the dataSet element. item values must be numeric.

Attributes

The following table lists and describes attributes generally applicable to this element. However, not all of the attributes listed here are applicable to all EIEs. Additionally, some attributes are required for use in every device template file of a certain EIE, but others may be used on a case-by-case or device-by-device basis, depending on your specific needs. All attributes in templates are case sensitive; but the case sensitivity of attribute values is based on context.

Note: Occasionally, device template files for different EIEs use attributes of the same name that do different things. Efforts are made in this document to highlight cases where an attribute by one name does different things in different EIEs.

Attribute Description

deid

deid specifies the data group ID (DEID) of a referenced DataGroupElement element from which to use a value.

Value:
  • Any name of a valid source DataGroupElement element within the same data group as deid.
  • The deid value cannot be recursive; that is, it cannot reference the DataGroupElement element of which it is a part.
  • The source DataGroupElement element cannot itself be a reference DataGroupElement element.

value

value specifies a constant value. The value used must be relevant to the context in which value is used.

Value:
  • Depends on context. Often numeric, but may be string in the appropriate circumstance.

Back to top