Condition

Supertype: Observation

Definition: Observation that provides the conditionability of a piece of equipment or Component to function to specification. of a piece of equipment or a Componentengineered system part of a Device composed of zero or more Components.

Version Info

Introduced	Deprecated	Updated
1.1

Documentation

Description

It provides the information and data reported from a piece of equipment with DataItem::category as CONDITION in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..

Figure Condition Example shows Condition type examples for various Condition::state: Normal (dataItemId = path_system) and Warning (dataItemId = logic_cond). It also shows an example for when the Condition::state is not available (dataItemId = cont_system).

Note: See condition-example for the XML representation of the same example.

The following Section Value Properties of Condition lists the additional and/or updated attributes for Condition.

Inherited Properties

Name	Type	Int	Dep	Multiplicity	Description
compositionId	ID	1.4		0..1	identifier of the Composition entity defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request. associated with the data reported for the Observation.
dataItemId	ID	1.1		1	unique identifier of the DataItem associated with this Observation. Observation::dataItemId MUST match the associated DataItem::id defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..
name	string	1.1		0..1	name of the DataItem associated with this Observation. Observation::name MUST match the associated DataItem::name defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..
sequence	integer	1.1		1	number representing the sequential position of an occurrence of an observationobserved value of a property at a point in time. in the data buffer of an agentsoftware that collects data published from one or more piece(s) of equipment, organizes that data in a structured manner, and responds to requests for data from client software systems by providing a structured response in the form of a response document that is constructed using the semantic data model of a Standard. . Observation::sequence MUST have a value represented as an unsigned 64-bit value from 1 to \(2^{64}-1\).
subType	DataItemSubTypeEnum	1.2		0..1	subtype of the DataItem associated with this Observation. Observation::subType MUST match the associated DataItem::subType defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..
timestamp	datetime	1.1		1	most accurate time available to a piece of equipment that represents the point in time that the data reported was measured.
type	DataItemTypeEnum	1.1		1	type of the DataItem associated with this Observation. Observation::type MUST match the associated DataItem::type defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..
units	UnitEnum	1.1		0..1	units of the DataItem associated with this Observation. Observation::units MUST match the associated DataItem::units defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..
isUnavailable	boolean (Default: true)	1.1		1	when true, Observation::result is indeterminate. Note 1 to entry: In XML, when isUnavailable is true, the XML CDATA of the Observation MUST be UNAVAILABLE. ```xml <Execution dataItemId=”…” …>UNAVAILABLE</Execution> > Note 2 to entry: In *JSON*, when `isUnavailable` is `true`, the *JSON* `value` of the `Observation` **MUST** be `UNAVAILABLE`. ```json "Execution" : [ { "dataItemId": "..." ..., "value": "UNAVAILABLE" } ]
result	string	1.1		0..1	observationobserved value of a property at a point in time. of the Observation entity. The default value type for Observation::result is string. Note 1 to entry: in XML the Observation::result is the CDATA of the Observation elementconstituent part or a basic unit of identifiable and definable data.. <Execution dataItemId="..." ...>READY</Execution> Note 2 to entry: in JSON the Observation::result is the member value of the Observation object. "Execution" : [ { "dataItemId": "..." ..., "value": "READY" } ]

Inherited Relations

Name	Type	Int	Dep	Multiplicity	Description
isObservationOf	Component	1.1		0..*
isObservationOf	Agent	1.1		0..*
isObservationOf	DataItem	1.1		0..*

Properties

Name	Type	Int	Dep	Multiplicity	Description
nativeCode	string	1.1		0..1	native code is the proprietary identifier designating a specific alarm, fault or warning code provided by the piece of equipment.
nativeSeverity	string	1.1		0..1	severity information to a client software application if the piece of equipment designates a severity level to a fault.
qualifier	QualifierEnum	1.1		0..1	additional information regarding a condition stateindicator of the condition. associated with the measured value of a process variable. Condition::qualifier defines whether the condition stateindicator of the condition. represented indicates a measured value that is above or below an expected value of a process variable.
statistic	StatisticEnum	1.2		0..1	Condition::statistic provides additional information describing the meaning of the Condition entity. Condition::statistic MUST match the DataItem::statistic defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..
xs:lang	xslang	1.1		0..1	specifies the language of the Observation::result returned for the Condition. See IETF RFC 4646 (http://www.ietf.org/rfc/rfc4646.txt).
state	ConditionStateEnum	1.1		0..1	condition stateindicator of the condition. of the piece of equipment or Component.
type	ConditionEnum	1.1		1
conditionId	string	2.3		1	identifier of an individual condition activationstate transition from Normal to either Warning or Fault. provided by a piece of equipment. Condition::conditionId MUST be unique for all concurrent condition activation. Condition::conditionId MUST be maintained for all state transitions related to the same condition activationstate transition from Normal to either Warning or Fault.. Multiple Condition::conditionIds MAY exist for the same nativeCode. If Condition::conditionId is not given, the value is the Condition::nativeCode. If Condition::nativeCode and Condition::conditionId are not given, Condition::conditionId MUST be generated.

Subclasses

Name	Int	Dep
Actuator	1.1
Communications	1.1
DataRange	1.2
LogicProgram	1.1
MotionProgram	1.1
System	1.1