About the Cumulocity IoT transport

Cumulocity IoT is used for communication with connected IoT devices. See http://cumulocity.com/ for detailed information.

Apama provides a connectivity plug-in, the Cumulocity IoT transport, which allows you to communicate with the IoT devices connected to Cumulocity IoT. For example, you can receive events from the devices and send operations to the devices.

For details on the support lifetime of the connectivity to Cumulocity IoT, refer to the Release Availability document for the current Apama version, which is available from the following web page: https://documentation.softwareag.com/apama/index.htm.

You configure the Cumulocity IoT connectivity plug-in by editing the .properties file that comes with the Cumulocity Client connectivity bundle. See Adding the Cumulocity IoT connectivity plug-in to a project for further information.

In addition to the Cumulocity Client connectivity bundle, the following EPL bundles are also available (see also Adding EPL bundles to projects):

Event Definitions for Cumulocity. This EPL bundle defines all events that can be used for interacting with Cumulocity IoT. This includes definitions for events that you receive from Cumulocity IoT, events that you can send to Cumulocity IoT, and event APIs that you can use for requesting data from Cumulocity IoT. For more information, see the com.apama.cumulocity package in the API Reference for EPL (ApamaDoc) .

Utilities for Cumulocity. This EPL bundle contains useful utilities for EPL code that is interacting with Cumulocity IoT. It also contains a geofence helper utility for determining whether a location is part of a geofence or not. For more information, see the com.apama.cumulocity.Util and the com.apama.cumulocity.GeoFenceContainer events in the API Reference for EPL (ApamaDoc) .

In addition to using Software AG Designer to add the above mentioned connectivity and EPL bundles, you can also do this using the apama_project command-line tool. See Creating and managing an Apama project from the command line for more information.

As with other connectivity plug-ins, the EPL application should call com.softwareag.connectivity.ConnectivityPlugins.onApplicationInitialized(). For more information, see Sending and receiving events with connectivity plug-ins.

The samples/cumulocity directory of your Apama installation includes samples which show how to use the Cumulocity IoT transport. For more information, see the README.txt file in the corresponding samples folder.