38. 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.
38.1 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. |
| Property Source Mappings | A list of property name regular expression with associated source IDs to copy matching properties to. |
38.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. |
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.