As we already have a very good C8Y API coverage for mapping not all complex cases might be supported. Currently, the mappings to the following C8Y APIs are supported:
- inventory
- events
- measurements
- alarms
- operations (outbound to devices)
A mapping is defined of mapping properties and substitutions. The substitutions are mapping rules copying date from the incoming payload to the payload in the target system. These substitutions are defined using the standard JSONata as JSONata expressions. These JSONata expressions are evaluated in two different libraries:
dynamic-mapping
: (nodejs) npmjs JSONata anddynamic-mapping-service
(java): JSONata4Java Please be aware that slight in differences in the evaluation of these expressions exist.
Differences in more advanced expressions can occur. Please test your expressions before you use advanced elements.
For Cumulocity MQTT Service currently no wildcards topics (e.g. topic/#
or topic/+
) for Inbound Mappings / Subscriptions are allowed.
The java library for JSONata uses the words and
, or
and in
as reserved words in their expression language, hence they can be used as key in an JSON payload, see issue.