BaSyx / Documentation / Components / DataBridge / Features / Routes Configuration

Routes Configuration

A route is a sequence of steps, executed in order by DataBridge, that consume and process a message. A route starts with a source and is followed by a chain of endpoints and processors such as transformers and sinks.

A route in DataBridge can be configured using Json file. You can specify the Data Sources, Transformers, Data Sinks, and Route trigger. Specifying the trigger in the route instructs the DataBridge about when the route would be started. More information on different types of triggers can be found here [link].

Sample Single Route Configuration

[
	{
		"routeId": "namedRoute",
		"datasource": "property1",
		"transformers": ["jsonataA"],
		"datasinks": ["ConnectedSubmodel/ConnectedPropertyA"],
		"trigger": "event"
	}
]

The datasource, transformers, and datasinks should be defined in their respective configuration files. For details please see Protocol Integration [link].

Similary, you can configure multiple routes.

Sample Multiple Routes Configuration

[
	{
		"routeId": "namedRoute",
		"datasource": "property1",
		"transformers": ["jsonataA"],
		"datasinks": ["ConnectedSubmodel/ConnectedPropertyA"],
		"trigger": "event"
	},
        {
		"datasource": "property2",
		"transformers": ["jsonataA", "jsonataB"],
		"datasinks": ["ConnectedSubmodel/ConnectedPropertyA", "ConnectedSubmodel/ConnectedPropertyB"],
		"trigger": "event"
	}
]

Naming Conventions

The name of the routes configuration file should be routes.json.