Instruction Manual

Table 61 TypeTranslatorGet Output Properties
Property Description
<UCPTindex>
The index number assigned to the Type Translator must be in the range 0-32,767.
As mentioned earlier, you can use the TypeTranslatorSet function to create a new
Type Translator, or to modify an existing Type Translator. If you do not specify an
index number in the <Data> parameter you supply to TypeTranslatorSet, the
function will create a new Type Translator using the first available index number.
If you specify an index number that is already being used, the function will
overwrite the configuration of the Type Translator using that index number with
the settings defined in the <Data> parameter.
<UCPTlastUpdate>
A timestamp indicating the last time the configuration of the Type Translator was
updated. This timestamp uses the following format:
YYYY-MM-DDTHH:MM:SSZ
The first segment of the time stamp (YYYY-MM-DD) represents the date the
configuration of the Type Translator was last updated. The second segment
(THH:MM:SS) represents the time of day the configuration of the Type Translator
was last updated, in UTC (Coordinated Universal Time).
UTC is the current term for what was commonly referred to as Greenwich
Meridian Time (GMT). Zero (0) hours UTC is midnight in Greenwich England,
which lies on the zero longitudinal meridian. Universal time is based on a 24 hour
clock, therefore, an afternoon hour such as 4 pm UTC would expressed as 16:00
UTC. The Z appended to the timestamp indicates that it is in UTC.
<UCPTdescription>
A user-defined description of the Type Translator. This can be a maximum of 228
characters.
<UCPTfbName>
The functional block name assigned to the Type Translator in LONMAKER. You can
write to this property, but each time you use the i.LON 100 Configuration
Software to view the Type Translator, it will be reset to match the functional block
name defined in LONMAKER.
<UCPTTranslatorRule>
The name of the Type Translator Rule that this Type Translator will use. This
determines the network variable type of the data points the Type Translator will
take as input, and the network variable type that these data points will be
translated to. It also determines the value to be assigned to the output data
point(s) after the translation.
The input and output data points you select for a Type Translator must use the
network variable types specified by the Type Translator Rule.
The sections immediately following this table describe the Type Translator Rules
included with the i.LON 100 software, the identifiers you can use to reference
them, and the input and output data point types you can use with them. You can
also use the SOAP interface to create your own Type Translator Rules. For more
information on this, see Chapter 13, Type Translator Rules.
If no translator rule is specified, then the Type Translator will convert the input
data point specified for the Type Translator to the format type of the output data
point specified for the Type Translator (e.g. scalar to scalar translation with no
offset and no constant, or enumeration to enumeration). In this case, the value of
the output data point will be updated with the value of the input data point each
time a translation is made.
i.LON 100 Internet Server Program12-6 mer’s Reference