|
1 | 1 | { |
2 | 2 | "title": "InputData", |
| 3 | + "description": "A simple numeric value display widget for showing key metrics with labels and units. Use this widget to prominently display important numbers like sensor readings, KPIs, counts, or any scalar values. Supports multiple value displays in one widget, each with its own label, unit, and formatting. Features include decimal precision control, data freshness validation via timestamps, averaging over recent values, and automatic pivot/split functionality for showing one value per distinct category. Ideal for dashboard KPI tiles, sensor readouts, counters, or any scenario requiring clean numeric value presentation.", |
3 | 4 | "type": "object", |
4 | 5 | "properties": { |
5 | 6 | "title": { |
6 | 7 | "title": "Title", |
| 8 | + "description": "The main heading displayed above the value displays. Use to identify the metric group (e.g., 'Temperature Readings', 'Production Counts').", |
7 | 9 | "type": "string", |
8 | 10 | "order": 1 |
9 | 11 | }, |
10 | 12 | "subTitle": { |
11 | 13 | "title": "Subtitle", |
| 14 | + "description": "Secondary text displayed below the title. Use for additional context like location, time period, or data source.", |
12 | 15 | "type": "string", |
13 | 16 | "order": 2 |
14 | 17 | }, |
15 | 18 | "dataseries": { |
16 | 19 | "title": "Value Displays", |
| 20 | + "description": "Array of value display configurations. Each entry creates a labeled numeric display with optional unit and styling. Add multiple entries to show several related metrics together.", |
17 | 21 | "type": "array", |
18 | 22 | "dataDrivenDisabled": true, |
19 | 23 | "order": 2, |
|
22 | 26 | "properties": { |
23 | 27 | "label": { |
24 | 28 | "title": "Label", |
25 | | - "description": "The label for the value.", |
| 29 | + "description": "Display text identifying this value. Should clearly describe what the number represents (e.g., 'Current Temperature', 'Total Orders', 'CPU Usage').", |
26 | 30 | "type": "string", |
27 | 31 | "required": true, |
28 | 32 | "order": 1 |
29 | 33 | }, |
30 | 34 | "unit": { |
31 | 35 | "title": "Unit", |
32 | | - "description": "The unit of the value. e.g. °C or km/h", |
| 36 | + "description": "The measurement unit displayed after the value. Examples: '°C', 'km/h', '%', 'kWh', 'pcs'. Can be bound to data for dynamic units.", |
33 | 37 | "type": "string", |
34 | 38 | "dataDrivenDisabled": false, |
35 | 39 | "order": 2 |
36 | 40 | }, |
37 | 41 | "precision": { |
38 | 42 | "title": "Decimals", |
39 | | - "description": "Number of digits after the decimal point. (Default 0)", |
| 43 | + "description": "Number of decimal places to display. Default is 0 (whole numbers). Set to 1-3 for measurements requiring decimal precision (e.g., temperature: 2, percentages: 1).", |
40 | 44 | "type": "number", |
41 | 45 | "dataDrivenDisabled": true, |
42 | 46 | "order": 3 |
43 | 47 | }, |
44 | 48 | "value": { |
45 | 49 | "title": "Value", |
46 | | - "description": "The value of the gauge", |
| 50 | + "description": "The numeric value to display. Bind to a data source column containing the metric. Only shown when Multi Chart mode is disabled.", |
47 | 51 | "type": "number", |
48 | 52 | "condition": { |
49 | 53 | "relativePath": "../multiChart", |
|
53 | 57 | }, |
54 | 58 | "multiChart": { |
55 | 59 | "title": "Multi Chart", |
56 | | - "description": "Draw multiple Charts based on the split column of a data table.", |
| 60 | + "description": "Enable to automatically create one value display per distinct pivot value in the data. When enabled, use the data array with pivot column instead of a single value.", |
57 | 61 | "type": "boolean", |
58 | 62 | "dataDrivenDisabled": true, |
59 | 63 | "order": 6 |
60 | 64 | }, |
61 | 65 | "data": { |
62 | 66 | "title": "Data", |
63 | | - "description": "The data used to draw this data series.", |
| 67 | + "description": "Data array for Multi Chart mode. Each row should contain a value and optionally a timestamp and pivot column for splitting into multiple displays.", |
64 | 68 | "type": "array", |
65 | 69 | "condition": { |
66 | 70 | "relativePath": "../multiChart", |
|
72 | 76 | "properties": { |
73 | 77 | "tsp": { |
74 | 78 | "title": "Timestamp", |
75 | | - "description": "This should be an ISO String date like 2023-11-04T22:47:52.351152+00:00. Will only be used to detect data age of data.", |
| 79 | + "description": "ISO 8601 timestamp string (e.g., '2023-11-04T22:47:52.351152+00:00'). Used with Maximum Latency setting to validate data freshness - stale data can be hidden or marked.", |
76 | 80 | "type": "string", |
77 | 81 | "order": 1 |
78 | 82 | }, |
79 | 83 | "value": { |
80 | 84 | "title": "Value", |
| 85 | + "description": "The numeric value from this data row. In Multi Chart mode, the latest value per pivot group is displayed.", |
81 | 86 | "type": "number", |
82 | 87 | "required": true, |
83 | 88 | "order": 1 |
84 | 89 | }, |
85 | 90 | "pivot": { |
86 | 91 | "title": "Split Data by", |
87 | | - "description": "You can specify a column in the input data to autogenerate dataseries for each distinct entry in this column. E.g. if you have a table with columns [city, timestamp, temperature] and specify 'city' as split column, then you will get a value field for each city.", |
| 92 | + "description": "Column used to group data into separate value displays. Each unique value creates its own display. Example: with columns [city, timestamp, temperature], setting pivot to 'city' shows one temperature value per city.", |
88 | 93 | "type": "string", |
89 | 94 | "order": 2 |
90 | 95 | } |
|
93 | 98 | }, |
94 | 99 | "styling": { |
95 | 100 | "title": "Styling", |
96 | | - "description": "", |
| 101 | + "description": "Visual styling options for the label and value text colors.", |
97 | 102 | "type": "object", |
98 | 103 | "order": 8, |
99 | 104 | "properties": { |
100 | 105 | "labelColor": { |
101 | 106 | "title": "Label Color", |
| 107 | + "description": "Color of the label text above or beside the value.", |
102 | 108 | "type": "color", |
103 | 109 | "color": true, |
104 | 110 | "order": 4 |
105 | 111 | }, |
106 | 112 | "valueColor": { |
107 | 113 | "title": "Value Color", |
| 114 | + "description": "Color of the numeric value and unit text.", |
108 | 115 | "type": "color", |
109 | 116 | "color": true, |
110 | 117 | "order": 5 |
|
113 | 120 | }, |
114 | 121 | "advanced": { |
115 | 122 | "title": "Advanced Settings", |
116 | | - "description": "", |
| 123 | + "description": "Advanced data processing options for averaging and freshness validation.", |
117 | 124 | "type": "object", |
118 | 125 | "order": 9, |
119 | 126 | "properties": { |
120 | 127 | "averageLatest": { |
121 | 128 | "title": "Average Latest Values", |
122 | | - "description": "Calculate the average over the given number of newest values. (If you use \"Split data by\", then per each of the pivot dataseries.) If not specified then the latest value is shown without modification.", |
| 129 | + "description": "Calculate and display the average of the N most recent values instead of just the latest. Useful for smoothing noisy sensor data. Leave empty to show the raw latest value. When using pivot/split, averaging is applied per group.", |
123 | 130 | "type": "number", |
124 | 131 | "dataDrivenDisabled": true, |
125 | 132 | "order": 6 |
126 | 133 | }, |
127 | 134 | "maxLatency": { |
128 | 135 | "title": "Maximum Latency", |
129 | | - "description": "If you provide timestamp data, the delivered value is only shown in the gauge when the age of the data is not older than the given maximum Latency in seconds.", |
| 136 | + "description": "Maximum acceptable age of data in seconds. If the timestamp indicates data older than this threshold, the value may be hidden or marked as stale. Requires timestamp data to be provided. Useful for real-time monitoring where outdated values are misleading.", |
130 | 137 | "type": "number", |
131 | 138 | "dataDrivenDisabled": true, |
132 | 139 | "order": 7 |
|
0 commit comments