The chat responses are generated using Generative AI technology for intuitive search and may not be entirely accurate. They are not intended as professional advice. For full details, including our use rights, privacy practices and potential export control restrictions, please refer to our Generative AI Service Terms of Use and Generative AI Service Privacy Information. As this is a test version, please let us know if something irritating comes up. Like you get recommended a chocolate fudge ice cream instead of an energy managing application. If that occurs, please use the feedback button in our contact form!
Skip to content
Insights Hub and Industrial IoT

Insights Hub drives smart manufacturing through the industrial Internet of Things. Gain actionable insights with asset and operational data and improve your processes.

Custom Data Services API

Idea

The Custom Data Services API enables users to register and manage custom topic mappings for data integration within Insights Hub. This API provides a comprehensive set of endpoints for creating, retrieving, updating and deleting custom topic registrations and their associated mappings.

Access

For accessing this service, you need to have the respective roles listed in MindConnect API roles and scopes.

Basics

Custom Topic Registrations

The core functionality of this API is to manage custom topic registrations for data integration within Insights Hub. You can create, retrieve, update, and delete custom topic mappings and their associated configurations.

Mapping Information

The mapping information represents the details of a custom data mapping, which includes:

  • Asset ID
  • Aspect Name
  • Variable Name
  • Value Expression
  • Timestamp Expression
  • Time Converter settings

Time Converter Options

This API supports multiple time format conversions, such as Epoch, Unix Timestamp, RFC2822, RFC822, RFC3339, MySQL Timestamp, Human Readable Format, and JavaScript Date Format. You can specify the appropriate time converter for their data requirements.

Optimistic Locking

The API uses the ETag mechanism for optimistic locking to prevent concurrent modifications.

Limitations

In order to give optimal performance, Custom Data Services API provides technical limits on API usage and resources which needs to be incorporated while using it.

The following are the technical limits for resource usage:

ResourcePublic CloudLocal Private Cloud (LPC)
Max topics allowed per agent510
Max topics allowed per tenant503000
Max topic hierarchy allowed715

Note

If the converter option is set as ISO8601 and the timestamp ingested has a precision of more than 3 digits (in millisecond unit) for example, 2025-03-28T07:00:14.123456789Z, the timestamp forwarded to the Insights Hub Monitor is 2025-03-28T07:00:14:123Z. This is because the time series handles timestamps only with upto 3 millisecond of precision.

Features

The Custom Data Service exposes its API for realizing the following tasks:

  • Create new topic mappings
  • Retrieve, update and delete the existing custom data mappings
  • Manage mapping rules and expressions
  • Support for multiple time format conversions

Example Scenario

A manufacturing company wants to integrate its own sensor data into the Insights Hub platform to leverage the advanced analytics and monitoring capabilities. By leveraging the Custom Data Services API, this manufacturing company can seamlessly integrate its proprietary data sources with the Insights Hub.