Skip to content

39. Split Datum Filter

The Split Datum Filter provides a way to split the properties of a datum stream into multiple new derived datum streams.

This filter is provided by the Standard Datum Filters plugin.

39.1 Settings

Split filter component settings

In the example screen shot shown above, the /power/meter/1 datum stream is split into two datum streams: /meter/1/power and /meter/1/energy. Properties with names containing current, voltage, or power (case-insensitive) will be copied to /meter/1/power. Properties with names containing hour (case-insensitive) will be copied to /meter/1/energy.

In addition to the Common Settings, the following general settings are available:

Setting Description
Swallow Input If enabled then discard input datum after splitting. Otherwise leave the input datum as is.
Persist Output If enabled then process and persist output datum after splitting. Otherwise process output datum but do not persist them.
Property Source Mappings A list of property name regular expression with associated source IDs to copy matching properties to.

39.2 Property Source Mappings settings

Use the + and - buttons to add/remove Property Source Mapping configurations.

Each property source mapping configuration contains the following settings:

Setting Description
Property A property name case-sensitive regular expression to match on the input datum stream. You can enable case-insensitive matching by including a (?i) prefix.
Source ID The destination source ID to copy the matching properties to. Supports placeholders.
Rename An optional property name template to rename output properties with. Supports a {p} parameter for an input property name and pattern capture groups from Property are available starting with {1}. For example a Property pattern ^(.*)_s1 with a Rename template {1} would map an input property watts_s1 to watts.

Tip

If multiple property name expressions match the same property name, that property will be copied to all the datum streams of the associated source IDs.