Online documentation for DataspaceInterface
Generated 2006-03-17
A bean which interfaces directly to the installation dataspace, allowing values to be copied in and out.
Description
Each ECT installation contains an EQUIP dataspace for data distribution and coordination. This component
allows values (in particular Dictionary values) to be shared via this dataspace. Published values are
retrieved from the dataspace by pattern matching the "templates" values. Multiple instances of this
component running in the same installation will have access to the same shared values.
Installation
No specific installation requirements - this software-only component interfaces to the installation's
internal EQUIP dataspace.
Configuration
The value of the "configchannelname" property is included in the values and templates shared in the,
so that only values with the same "configchannelname" will be matched, i.e. values published by components
set to the same "channel".
Usage
The (array of Dictionaries) value(s) presented to the "publish" property will be published in the
dataspace as data objects, tagged by the current "configchannelname". Note that this property will
merge inputs from multiple incoming links into a single array. The "templates" (array of Dictionaries)
value will query the dataspace for all matching values, which are reported by the "matches" property.
As values are published/removed from the dataspace the "matches" property will be updated accordingly.
Technical Details
Each published value is placed into the dataspace as a 3-element Tuple, whose first element is
"DataspaceInterfaceValue:1.0", second element is the channel name (string box), and third element
is the Dictionary. Each change of publish value results in any/all values being re-published.
There are no dataspace updates performed. The value merging in "publish" relies on the equip.ect.IActiveComponent
interface facilities (see component documentation).