Apama 10.2 | Apama Documentation | Connecting Apama Applications to External Components | Standard Connectivity Plug-ins | The Cumulocity IoT Transport Connectivity Plug-in | Using measurements | Querying for measurements
 
Querying for measurements
To search for a measurement or a collection of measurements, send the com.apama.cumulocity.FindMeasurement event to Cumulocity IoT, with a unique reqId to the com.apama.cumulocity.FindMeasurement.CHANNEL channel.
The transport will then respond with zero or more com.apama.cumulocity.FindMeasurementResponse events and then one com.apama.cumulocity.FindMeasurementResponseAck event on the com.apama.cumulocity.FindMeasurementResponse.CHANNEL channel.
Example:
integer reqId := integer.getUnique();
 
com.apama.cumulocity.FindMeasurement request :=
new com.apama.cumulocity.FindMeasurement;
request.reqId := reqId;
 
// Filter based on measurement fragmentType
request.params.add("fragmentType", "c8y_MotionMeasurement");
 
// Send request to find available measurements
send request to com.apama.cumulocity.FindMeasurement.CHANNEL;
 
// Subscribe to com.apama.cumulocity.FindMeasurementResponse.CHANNEL to listen
// for responses
monitor.subscribe(com.apama.cumulocity.FindMeasurementResponse.CHANNEL);
 
// Listen for responses based on reqId
on all com.apama.cumulocity.FindMeasurementResponse(reqId=reqId) as response
// Avoid listener leaks by terminating the listener on completion of the request
and not com.apama.cumulocity.FindMeasurementResponseAck(reqId=reqId)
{
log "Received Measurement " + response.toString() at INFO;
}
 
// Listen for com.apama.cumulocity.FindMeasurementResponseAck,
// this indicates that all responses have been received
on com.apama.cumulocity.FindMeasurementResponseAck(reqId=reqId)
as requestCompleted
{
log "Received all Measurement(s) for request "
+ requestCompleted.reqId.toString() at INFO;
 
// Request is completed and we can unsubscribe from this channel
monitor.unsubscribe(com.apama.cumulocity.FindMeasurementResponse.CHANNEL);
}
Supported query parameters
You can provide the following query parameters with the request:
Parameter
Description
id
Search for a measurement based on measurementId. When searching for a measurement based on Id, all the query parameters listed below are ignored.
source
Search for measurements based on the device identifier or asset identifier of the source.
type
Search for measurements based on the type.
fragmentType
Search for measurements based on the fragment type.
fromDate
Search for measurements from a start date. The date and time is provided as seconds since the epoch.
toDate
Search for measurements within a time range. This is to be used in combination with fromDate. The date and time is provided as seconds since the epoch.
Along with the above parameters, you can also provide other query parameters (such as pageSize) to be forwarded with the request to Cumulocity IoT.

Copyright © 2013-2018 | 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.
Innovation Release