Data Collection

Push data collection values

Push values to data collection items with origin "push". Multiple values for different objects and DCIs can be submitted in a single request.

Target object is identified either by objectId or by objectName, and target DCI either by dciId or by dciName. When a DCI is addressed by name and does not exist yet, the server attempts to create it through instance discovery.

The whole batch is validated before any value is pushed, so values are either applied completely or not at all. If validation fails, the response body identifies the offending element by its position in the request array. Note that DCIs created through instance discovery for elements addressed by dciName are created during validation and are not removed if a later element fails.

Requires OBJECT_ACCESS_PUSH_DATA on every target object.

post/v1/push-data

Request body

objectIdinteger

Target object ID

objectNamestring

Target object name, used when objectId is not provided. Matched case-insensitively against data collection targets only.

dciIdinteger

Target DCI ID

dciNamestring

Target DCI name, used when dciId is not provided. If no matching DCI exists, the server attempts to create one through instance discovery.

Response

Values pushed successfully

Changes

Changed in 1 of the 115 revisions of this API.1