Developing Apama Applications > Developing Apama Applications in EPL > Making Application Data Available to Clients > Creating DataView items > DataViewAddOrUpdateItem
DataViewAddOrUpdateItem
Syntax
event DataViewAddOrUpdateItem {
   string msgId;
   string dvName;
   string owner;
   float timeStamp;
   sequence<string> fieldValues;
   dictionary<string, string> extraParams;
}
Create and route an event of this type to create a DataView item if it does not already exist, or update a DataView item if it already exists. A response is provided by a DataViewItem or DataViewException event. For details, see DataViewItem and DataViewException.
Note: This will only work when keyFields are used.
Any attempts to change the owner of an existing item will be rejected with a DataViewItemException.
Syntax description
msgId
Optional field for a message ID that applications can use to identify responses.
dvName
Unique name of this item's associated DataView definition.
owner
Only used for new items. Name of the user of this item. Specify "*" to allow all users to access the new DataView item.
timeStamp
Timestamp of the initial update (seconds since epoch). If the value given is -1.0, the service will populate this field by using correlator currentTime. Note that the default value of the field is 0.0, which prevents trend graphs from updating.
fieldValues
A sequence of field values in string form. The ith value in this sequence is the value of the ith field specified in the fieldNames sequence of the associated DataView definition.
extraParams
Optional field that future implementations may use.
Copyright © 2013-2015 Software AG, Darmstadt, Germany and/or Software AG USA Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.
Use, reproduction, transfer, publication or disclosure is prohibited except as specifically provided for in your License Agreement with Software AG.