From 139a9b09283fc42e31df77f3db11a2ac928ca1de Mon Sep 17 00:00:00 2001 From: Mark Herwege Date: Mon, 16 Dec 2024 13:06:08 +0100 Subject: [PATCH 1/2] persistence exclude documentation Signed-off-by: Mark Herwege --- configuration/persistence.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/configuration/persistence.md b/configuration/persistence.md index b26a8f4669..2d7d00c9f4 100644 --- a/configuration/persistence.md +++ b/configuration/persistence.md @@ -167,12 +167,14 @@ where `` is a comma-separated list consisting of one or more of the fo - `*` - this line should apply to all items in the system - `` a single Item identified by its name. This Item can be a group Item. But note that only the group value will be persisted. The value of the individual group members will not be persisted using this option. +- `!` a single Item or group Item identified by its name, to be excluded from persistence defined by the other elements in this comma-separated ``. - `*` - all members of this group will be persisted, but not the group itself. Optionally, an alias may be provided if the persistence service requires special names (e.g. a table to be used in a database, a feed id for an IoT service, etc.) Note that `*` is NOT a wildcard match character in this context. - +- `!*` all members of this group, but not the group itself, to be excluded from persistence defined by the other elements in this comma-separated ``. The entries are additive. This means if one Item appears in more than one `` either directly or indirectly (e.g. `*` which includes all Items or as a member of a Group used in `*`), all the strategies strategies listed on all those lines apply to that Item. +In the same way, an Item defined by a `!` or `!*` will be excluded after all addititive rules have been applied. Below you will find a complete example persistence configuration file: @@ -198,6 +200,9 @@ Items { // additionally, persist all temperature and weather values every hour Temperature*, Weather* : strategy = everyHour + + // persist all items every day, except items in the weather group and the cellar temperature + *, !Weather*, !CellarTemperature: strategy = everyDay } ``` From a4e71b845faa2aff1013057e5b5f7abf01e5cc3e Mon Sep 17 00:00:00 2001 From: Mark Herwege Date: Mon, 16 Dec 2024 13:06:08 +0100 Subject: [PATCH 2/2] fix spelling Signed-off-by: Mark Herwege --- configuration/persistence.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/configuration/persistence.md b/configuration/persistence.md index 2d7d00c9f4..4c1e16a008 100644 --- a/configuration/persistence.md +++ b/configuration/persistence.md @@ -174,7 +174,7 @@ where `` is a comma-separated list consisting of one or more of the fo - `!*` all members of this group, but not the group itself, to be excluded from persistence defined by the other elements in this comma-separated ``. The entries are additive. This means if one Item appears in more than one `` either directly or indirectly (e.g. `*` which includes all Items or as a member of a Group used in `*`), all the strategies strategies listed on all those lines apply to that Item. -In the same way, an Item defined by a `!` or `!*` will be excluded after all addititive rules have been applied. +In the same way, an Item defined by a `!` or `!*` will be excluded after all additive rules have been applied. Below you will find a complete example persistence configuration file: