DataViewUpdateItemDelta
Syntax
event DataViewUpdateItemDelta {
string msgId;
string dvName;
integer dvItemId;
float timeStamp;
dictionary<integer,string> fieldValues;
dictionary<string, string> extraParams;
}
Create and route an event of this type in order to update a data item by specifying a dictionary of field-position/field-value pairs. If the update does not succeed, a response is provided by a
DataViewItemException event.
Syntax description
msgId is an optional field for a message ID that applications can use to identify responses.
dvName is the unique name of this item’s associated DataView definition.
dvItemId is the service-generated ID (see
DataViewItem) of the item to be deleted, or
-1 if you supply all key field values in
fieldValues (see below).
timeStamp is the timestamp of the update (seconds since epoch). If the value given is -1.0, the service will populate it using correlator currentTime. Note that the default value of the field is 0.0, which prevents trend graphs from updating.
fieldValues is a dictionary of field-position/field-value pairs that specifies the new field values. Field values are in string form. A field’s position is its index into the
fieldNamessequence specified in the associated DataView definition (see also
Looking Up Field Positions). If
dvItemId is
-1,
fieldValues must include the key values.
extraParams is an optional field that future implementations may use.