30. Unchanged Property Filter¶

The Unchanged Property Filter provides a way to discard individual datum properties that have not changed within a datum stream.

This filter is provided by the Standard Datum Filters plugin.

Tip

See the Unchanged Datum Filter for a filter that can discard entire unchanging datum (at the source ID level).

30.1 Settings¶

Each filter configuration contains the following overall settings:

Setting	Description
Service Name	A unique ID for the filter, to be referenced by other components.
Service Group	An optional service group name to assign.
Source ID	A case-insensitive pattern to match the input source ID(s) to filter. If omitted then datum for all source ID values will be filtered, otherwise only datum with matching source ID values will be filtered.
Required Mode	If configured, an operational mode that must be active for this filter to be applied.
Required Tag	Only apply the filter on datum with the given tag. A tag may be prefixed with `!` to invert the logic so that the filter only applies to datum without the given tag. Multiple tags can be defined using a `,` delimiter, in which case at least one of the configured tags must match to apply the filter.
Default Unchanged Max Seconds	When greater than `0` then the maximum number of seconds to discard unchanged properties within a single datum stream (source ID). Use this setting to ensure a property is included occasionally, even if the property value has not changed. Having at least one value per hour in a datum stream is recommended. This time period is always relative to the last unfiltered property within a given datum stream seen by the filter.
Property Configurations	A list of property settings.

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

Each property source mapping configuration contains the following settings:

Setting	Description
Property	A regular expression pattern to match against datum property names. All matching properties will be filtered.
Unchanged Max Seconds	When greater than `0` then the maximum number of seconds to discard unchanged properties within a single datum stream (source ID). This can be used to override the filter-wide Default Unchanged Max Seconds setting, or left blank to use the default value.