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.

You configure the Cumulocity IoT connectivity plug-in by editing the files that come with the Cumulocity Client connectivity bundle. The properties file defines the substitution variables that are used in the YAML configuration file which also comes with the 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. For more information, see the com.apama.cumulocity.Util event in the API Reference for EPL (ApamaDoc) .

Note: The names of the above bundles also include a version number at the end. This refers to the earliest version of Cumulocity IoT with which a bundle can be used.

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.