add valueMapping support.

See changelog for details.

CHANGELOG.md

@@ -9,14 +9,7 @@ animated lines that are controllable via 'direction' and 'duration' attributes.
 change adds yaml config to drive these animations off of data. When such config is
 present a play/pause button is always added to the panel to ensure the panel is usable
 by all. New config terms:
-- cells.cell-name.flowAnimation.dataRef
-- cells.cell-name.flowAnimation.datapoint
-- cells.cell-name.flowAnimation.thresholdOffValue
-- cells.cell-name.flowAnimation.thresholdLwrValue
-- cells.cell-name.flowAnimation.thresholdLwrDurationSecs
-- cells.cell-name.flowAnimation.thresholdUprValue
-- cells.cell-name.flowAnimation.thresholdUprDurationSecs
-- cells.cell-name.flowAnimation.unidirectional
+- cells.cell-name.flowAnimation
 
 As well as provisioning dashboards, the above functionality is demonstrated in example 4:
 - svg: https://raw.githubusercontent.com/andymchugh/andrewbmchugh-flow-panel/main/examples/darkThemeSvg4.svg
@@ -30,6 +23,18 @@ One Datapoint Interpolation fix
 -------------------------------
 Fixes a bug with timeSeries interpolation which resulted in no data when the timeSeries only had a single datapoint.
 
+Value Mappings Support
+----------------------
+This allows you to configure a custom value based on data-match criteria. i.e. if your data is 0, 1, 2 you can use
+this configuration to replace the 'label' text with 'auto', open', 'closed'. The criteria you can use to match are:
+- exact value match
+- range match
+- partial range match.
+
+New panelConfig terms:
+- cells.cell-name.label.valueMappings
+- cells.cell-name.label.valueMappingsRef
+
 ## 1.10.0
 Increases the range of SVG shape support by relaxing the expected DOM element
 hierachy.

provisioning/dashboardData/dataMappings.yaml

@@ -0,0 +1,56 @@
+---
+
+#------------------------------------------------------------------------------
+# YAML Aliases to simplify maintenance
+
+test:
+  testDataExtendedZero: true
+
+anchorLinks:
+  - valueMappings: &valuemap1
+    - {value: null, text: "panel null"}
+    - {value: 0, text: "panel off"}
+    - {valueMax: 300, text: "panel low"}
+    - {valueMin: 300, valueMax: 600, text: "panel medium"}
+    - {valueMin: 600, text: "panel high"}
+  - thresholds: &thresholds
+    - {color: "green", level: 0}
+    - {color: "orange", level: 500}
+    - {color: "red", level: 1000}
+
+#------------------------------------------------------------------------------
+# Panel Config
+
+cellIdPreamble: "cell-"
+gradientMode: "hue"
+cells: 
+  dbtrans1:
+    dataRef: "test-data-large-cos"
+    label:
+      separator: "replace"
+      units: "ops"
+      valueMappings: *valuemap1
+    labelColor:
+      thresholds: *thresholds
+  dbtrans2:
+    dataRef: "test-data-large-cos"
+    label:
+      separator: "cr"
+      units: "ops"
+    fillColor:
+      thresholds: *thresholds
+  dbtrans3:
+    dataRef: "test-data-large-cos"
+    label:
+      separator: "replace"
+      units: "ops"
+      valueMappingsRef: "dbTrans"
+    labelColor:
+      thresholds: *thresholds
+  dbtrans4:
+    dataRef: "test-data-large-cos"
+    label:
+      separator: "cr"
+      units: "ops"
+    fillColor:
+      thresholds: *thresholds

provisioning/dashboardData/dataMappingsSite.yaml

@@ -0,0 +1,14 @@
+---
+
+colors:
+  red: "#DD0000"
+  amber: "#CC8C00"
+  green: "#00AA00"
+
+valueMappings:
+  dbTrans:
+    - {value: null, text: "site null"}
+    - {value: 0, text: "site off"}
+    - {valueMax: 300, text: "site low"}
+    - {valueMin: 300, valueMax: 600, text: "site medium"}
+    - {valueMin: 600, text: "site high"}

provisioning/dashboardData/dataMappings_sparse.yaml

@@ -0,0 +1,57 @@
+---
+
+#------------------------------------------------------------------------------
+# YAML Aliases to simplify maintenance
+
+test:
+  testDataExtendedZero: true
+  testDataSparse: true
+
+anchorLinks:
+  - valueMappings: &valuemap1
+    - {value: null, text: "panel null"}
+    - {value: 0, text: "panel off"}
+    - {valueMax: 300, text: "panel low"}
+    - {valueMin: 300, valueMax: 600, text: "panel medium"}
+    - {valueMin: 600, text: "panel high"}
+  - thresholds: &thresholds
+    - {color: "green", level: 0}
+    - {color: "orange", level: 500}
+    - {color: "red", level: 1000}
+
+#------------------------------------------------------------------------------
+# Panel Config
+
+cellIdPreamble: "cell-"
+gradientMode: "hue"
+cells: 
+  dbtrans1:
+    dataRef: "test-data-large-cos"
+    label:
+      separator: "replace"
+      units: "ops"
+      valueMappings: *valuemap1
+    labelColor:
+      thresholds: *thresholds
+  dbtrans2:
+    dataRef: "test-data-large-cos"
+    label:
+      separator: "cr"
+      units: "ops"
+    fillColor:
+      thresholds: *thresholds
+  dbtrans3:
+    dataRef: "test-data-large-cos"
+    label:
+      separator: "replace"
+      units: "ops"
+      valueMappingsRef: "dbTrans"
+    labelColor:
+      thresholds: *thresholds
+  dbtrans4:
+    dataRef: "test-data-large-cos"
+    label:
+      separator: "cr"
+      units: "ops"
+    fillColor:
+      thresholds: *thresholds