Header

Definition: provides information from 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. defining version information, storage capacity, and parameters associated with the data management within the 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. .

Version Info

Introduced	Deprecated	Updated
1.0

Properties

Name	Type	Int	Dep	Multiplicity	Description
`assetBufferSize`	`uint32`	1.2		1	maximum number of `Asset` types that can be stored in the 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. that published the response documentelectronic document published by an MTConnect Agent in response to a probe request, current request, sample request or asset request.. Note: The implementer is responsible for allocating the appropriate amount of storage capacity required to accommodate the `assetBufferSize`.
`assetCount`	`uint32`	1.2		1	current number of `Asset` that are currently stored in the 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. as of the `creationTime` that the 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. published the response documentelectronic document published by an MTConnect Agent in response to a probe request, current request, sample request or asset request.. `assetCount` MUST NOT be larger than the value reported for `assetBufferSize`.
`bufferSize`	`uint32`	1.0		1	maximum number of DataItemsobservable observed by a Component that may make Observations that MAY be retained in the 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. that published the response documentelectronic document published by an MTConnect Agent in response to a probe request, current request, sample request or asset request. at any point in time. Note 1 to entry: `bufferSize` represents the maximum number of sequence numbers that MAY be stored in the 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. . Note 2 to entry: The implementer is responsible for allocating the appropriate amount of storage capacity required to accommodate the `bufferSize`.
`creationTime`	`datetime`	1.0		1	timestamp that 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. published the response documentelectronic document published by an MTConnect Agent in response to a probe request, current request, sample request or asset request..
`instanceId`	`uint64`	1.0		1	identifier for a specific instantiation of the buffersection of an agent that provides storage for information published from pieces of equipment. associated with the 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. that published the response documentelectronic document published by an MTConnect Agent in response to a probe request, current request, sample request or asset request.. `instanceId` MUST be changed to a different unique number each time the buffersection of an agent that provides storage for information published from pieces of equipment. is cleared and a new set of data begins to be collected.
`sender`	`string`	1.0		1	identification defining where the 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. that published the response documentelectronic document published by an MTConnect Agent in response to a probe request, current request, sample request or asset request. is installed or hosted. `sender` MUST be either an IP Address or Hostname describing where the 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. is installed or the URL of the 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. ; e.g., `http://<address>[:port]/`. Note: The port number need not be specified if it is the default HTTP port 80.
`testIndicator`	`boolean` (Default: `false`)	1.0		0..1	indicates whether the 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. that published the response documentelectronic document published by an MTConnect Agent in response to a probe request, current request, sample request or asset request. is operating in a test mode. If `testIndicator` is not specified, the value for `testIndicator` MUST be interpreted to be `false`.
`version`	`version`	1.0		1	majoridentifier representing a consistent set of functionalities defined by the MTConnect Standard., minoridentifier representing a specific set of functionalities defined by the MTConnect Standard., and revisionsupplemental identifier representing only organizational or editorial changes to a minor version document with no changes in the functionality described in that document. number of the MTConnect Standard that defines the semantic data modelmethodology for defining the structure and meaning for data in a specific logical way that can be interpreted by a software system. that represents the content of the response documentelectronic document published by an MTConnect Agent in response to a probe request, current request, sample request or asset request.. It also includes the revision number of the schemadefinition of the structure, rules, and vocabularies used to define the information published in an electronic document. associated with that specific semantic data modelmethodology for defining the structure and meaning for data in a specific logical way that can be interpreted by a software system. . As an example, the value reported for `version` for a response documentelectronic document published by an MTConnect Agent in response to a probe request, current request, sample request or asset request. that was structured based on schemadefinition of the structure, rules, and vocabularies used to define the information published in an electronic document. revision 10 associated with Version 1.4.0 of the MTConnect Standard would be: 1.4.0.10
~~`firstSequence`~~	`uint64`	1.0	1.2	0..1	sequence numberprimary key identifier used to manage and locate a specific piece of streaming data in an agent. assigned to the oldest piece of streaming dataobservations published by a piece of equipment defined by the equipment metadata. stored in the buffersection of an agent that provides storage for information published from pieces of equipment. of the 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. immediately prior to the time that the 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. published the response documentelectronic document published by an MTConnect Agent in response to a probe request, current request, sample request or asset request..
~~`lastSequence`~~	`uint64`	1.0	1.2	0..1	sequence numberprimary key identifier used to manage and locate a specific piece of streaming data in an agent. assigned to the last piece of streaming dataobservations published by a piece of equipment defined by the equipment metadata. that was added to the buffersection of an agent that provides storage for information published from pieces of equipment. of the 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. immediately prior to the time that the 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. published the response documentelectronic document published by an MTConnect Agent in response to a probe request, current request, sample request or asset request..
~~`nextSequence`~~	`uint64`	1.0	1.2	0..1	sequence numberprimary key identifier used to manage and locate a specific piece of streaming data in an agent. of the piece of streaming dataobservations published by a piece of equipment defined by the equipment metadata. that is the next piece of data to be retrieved from the buffersection of an agent that provides storage for information published from pieces of equipment. of the 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. that was not included in the response documentelectronic document published by an MTConnect Agent in response to a probe request, current request, sample request or asset request. published by the 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. . If the streaming dataobservations published by a piece of equipment defined by the equipment metadata. included in the response documentelectronic document published by an MTConnect Agent in response to a probe request, current request, sample request or asset request. includes the last piece of data stored in the buffersection of an agent that provides storage for information published from pieces of equipment. of the 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. at the time that the document was published, then the value reported for `nextSequence` MUST be equal to `lastSequence` + 1.
`deviceModelChangeTime`	`datetime`	1.7		1	timestamp of the last update of the `Device` information for any device.

Relations

Name	Type	Int	Dep	Multiplicity	Description
~~`hasAssetCount`~~	`AssetCount`	1.2	1.4	0..*
`isHeaderOf`	`MTConnectDevices`	1.0		1

Constraints

Error Message OCL Expression

Error Message	OCL Expression
`assetCount` MUST be less than or equal to `assetBufferSize`.	`assetCount <= assetBufferSize`
`creationTime` and `deviceModelChangeTime` MUST be reported in ISO 8601 format.	`creationTime->size() = 1 and creationTime.oclAsType(String).matches('([0-9]+)-([0-9]+)-([0-9]+)T([0-9]+):([0-9]+):([0-9.]+)Z\|([0-9]+)-([0-9]+)-([0-9]+)T([0-9]+):([0-9]+):([0-9.]+)') and deviceModelChangeTime->size() = 1 and deviceModelChangeTime.oclAsType(String).matches('([0-9]+)-([0-9]+)-([0-9]+)T([0-9]+):([0-9]+):([0-9.]+)Z\|([0-9]+)-([0-9]+)-([0-9]+)T([0-9]+):([0-9]+):([0-9.]+)')`

assetCount MUST be less than or equal to assetBufferSize.

assetCount <= assetBufferSize

creationTime and deviceModelChangeTime MUST be reported in ISO 8601 format.

creationTime->size() = 1 and
creationTime.oclAsType(String).matches('([0-9]+)-([0-9]+)-([0-9]+)T([0-9]+):([0-9]+):([0-9.]+)Z|([0-9]+)-([0-9]+)-([0-9]+)T([0-9]+):([0-9]+):([0-9.]+)') and 
deviceModelChangeTime->size() = 1 and
deviceModelChangeTime.oclAsType(String).matches('([0-9]+)-([0-9]+)-([0-9]+)T([0-9]+):([0-9]+):([0-9.]+)Z|([0-9]+)-([0-9]+)-([0-9]+)T([0-9]+):([0-9]+):([0-9.]+)')  

Submit Comment

Header

Version Info

Properties

Relations

Constraints