Skip to main content

CREATING A CUMULOCITY CONNECTION

Collecting Expected Information

Parameters required

FieldDescription
HostnameURL used when connecting to Gear Studio instance.
Tenant IDCollected in your profile page
UsernameCredential used when connecting to Cumulocity IoT.
PasswordCredential used when connecting to Cumulocity IoT.

Hostname

Hostname corresponds to the link you are using to connect to your Cumulocity instance.

For example: actility.cumulocity.com

Tenant ID

To collect your Tenant ID, connect to your Cumulocity instance, and then click on your username on the top right corner of the page.

tenant_id

You will be able to copy it.

Username and Password

Username and Password are credentials used to connect to your Cumulocity instance. You need to create a Cumulocity account in the admin panel and use that account to use the API. You cannot use an SSO account.

Creating a Connection From UI

You need to know the parameters that are required to perform this task. To learn more, check the Parameters required for connecting to a Cumulocity platform below in this topic.

  1. Click Connections -> Create -> ThingPark X IoT Flow.

img

Then, a new page will open. Select the connection type : Cumulocity.

img

  1. Fill in the form as in the example below and click on Create.

img

Note

Parameters marked with * are mandatory.

  • A notification appears on the upper right side of your screen to confirm that the application has been created.

img

  1. After creating the application, you will be redirected to the application details.

img

Changing the Settings after Creation

You can change the settings parameters such as the Headers after the creation of the Cumulocity connection.

To do this, proceed as follows:

  1. Select the Cumulocity application for which you want to change one or several parameters.

  2. In the connection information dashboard, click on the Edit icon corresponding to the parameter you want to change.

img

  1. Enter the new value, and click on the Confirm icon.

img

  • The Confirmation window displays,

img

  • A notification will inform you that the parameter is updated.

img

Parameters required for connecting to a Cumulocity platform

The parameters are the following:

UI FieldDescription
NameName of the connection that you want to register (Editable).
Host NameThe hostname of your account on Cumulocity IoT cloud platform
Tenant IDThe tenant of your account on Cumulocity IoT cloud platform
UsernameThe username of your account on Cumulocity IoT cloud platform
PasswordThe password of your account on Cumulocity IoT cloud platform
DescriptionDescription of the connection that you want to register (Editable).

Creating a Connection With API

The creation of a connection establishes a messaging transport link between ThingPark X IoT Flow and the cloud provider. Events and commands from multiple Devices will be sent over this messaging transport link.

To do this, you need to use the Connections group resource:

  • POST/connections to create a new Connection instance
  • PUT/connections to update a Connection instance
  • DELETE/connections to delete a Connection instance
Note

We follow the REST-full API pattern, when updating configuration properties for a connection resource. Thus, you must also provide the whole configuration again.

Example for creation of a new connection instance :

POST /connections
{
"connectorId": "actility-cumulocity-iot",
"name": "Actility Cumulocity Connection",
"configuration": {
"description": "Cumulocity connection test",
"hostName": "actility.cumulocity.com",
"tenantId": "mytenant",
"username": "myusername",
"password": "mypassword"
}
}

The following table lists the properties applicable to a connection instance.

FieldDescription
connectorIdMust be set to actility-cumulocity-iot for Cumulocity IoT cloud platform.
configuration/hostNameURL used to connect to Cumulocity instance.
configuration/tenantIdTenant ID collected in your Cumulocity instance.
configuration/usernameUsername used when connection to Cumulocity instance
configuration/passwordPassword used when connection to Cumulocity instance
Important note

Not all properties are present in this example. You can check the rest of these properties in the common parameters section.

Limitations

Your device drivers must be compatible with points and ontologies to work with the Cumulocity IoT cloud platform.

Displaying information to know if it worked

  1. Go to ThingPark Actility Enterprise

  2. Go to the Devices List section, and click on the device you want to affect to your Cumulocity application.

img

  1. When you are on the device's details page, click on Add a connection.

img

  1. Select your Cumulocity connection and click on the Confirm icon.

img

  • A notification appears to confirm that the application has been added to the device.

img

  1. Go to the Cumulocity IoT Cloud Platform depends on the host name used and login. Here Tpx EU Hostname for our example.

img

  1. Select Devices -> All devices.

img

  • You can then verify if your device is listed and the uplinks are correctly sent.
  1. By clicking on a device, you'll be able to measurements received.

img

Troubleshooting

As for now, there are no detected bugs.