Configuring the Litmus Production Record Digital Twin Message Conversion Flow

o allow the flow to create the right message payload so that the data can be successfully ingested by Litmus Production Record Database using a Litmus Integration, there are two mandatory configurations the user has to make.

The purpose of the flow, is to ingest digital twin data published by Litmus Edge Digital Twin Instances and modify the message payload to meet the requirements of Litmus Production Record Database. The flow has to therefore subscribe to the topics of the Digital Twin Instances which are to be send to Litmus Production Record Database.

The user provides these topics through the use of the Litmus pallet node Datahub Subscribe.

To provide a topic, users edit the datahub subscribe node and replace the placeholder "Please enter topic"

with the topic of a Digital Twin Instance to be used by the event configuration and press the Done button.

If more than one Digital Twin Instance is required, users have one option for providing all the instances they require, as wildcards are not supported at this point in time for Litmus Edge Digital Twins.

The flow comes with a single Datahub Subscribe node in the section

But users are able to add more nodes as they need and wire them all into the output.

The example shows how a user added more node by creating copies of the original node.

For the modification of the message payload, the flow requires at the minimum an API_Key.

To create an API_Key please visit the Litmus Documentation on how to create a Rest API Key.

By default the flow will use as WriteTopic "Litmus.DT_ProRec". But users are able to modify these.

To modify the API_Key and/or WriteTopic, the user has to edit the sub flow.

This allows to set the desired values for these two settings and press the Done button.

To start the processing, deploy the flow.

As Litmus Production Record stores Production Event data such as Downtimes, Energy Management, Product Traceability and more against a unique combination of identifiers as explained in the chapter How are data for a Production Record Data Model stored, these have to be defined also for data coming from a Digital Twin. As a Digital Twin may not have such Items defined, the flow will by default use as Identifiers:

This means, if a Digital Twin Model does not have any Items directly under their root which satisfy the need for Identifiers, the user does not have to do any changes and the flow will take care of it. And the Optional options can be left as they are.

If a Digital Twin model has items directly under the root which would satisfy the needs for Identifiers

the user is able to provide these instead.

After all configurations have been done and are deployed, it is recommended to setup a Litmus Integration using the DB - Microsoft SQL Server connector.

How to setup an integration can be read up on using our Litmus Edge Documentation.

After the integration is established, the user needs to subscribe to the topic which has been setup in the sub flow.

How a subscription for an integration is added, can be found in the Litmus Edge Documentation.

Add as Local Data Topic the value used in your event configuration.

Now, every time the flow publishes a new message on this topic, the integration will send it to Litmus Production Record Database.