Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ JSON example using a function:
CSV example using a function:

```csv
variable,value,time,serie
variable,value,time,group
temperature,$random$,2019-09-19,1568913302243
```

Expand Down
2 changes: 1 addition & 1 deletion docs/tagoio/devices/device-emulator/device-emulator.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ section, select the device, and then click on the Emulator tab.
TagoIO accepts two types of payloads: JSON and Raw.

- **JSON**: The payload is a JSON object that follows TagoIO's data schema by
using the following fields: `variable`, `value`, `unit`, `time`, `serie`,
using the following fields: `variable`, `value`, `unit`, `time`, `group`,
`location`, and `metadata`.
- **Raw**: Raw binary data. If you need to parse text data such as CSV or XML,
add a [Payload Parser](/docs/tagocore/resources/device/payload-parser.md).
Expand Down
6 changes: 3 additions & 3 deletions docs/tagoio/integrations/networks/sigfox/sigfox-downlink.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,17 +102,17 @@ Go to the Sigfox portal and perform the following steps:
{
"variable": "device",
"value": "{device}",
"serie": "{time}"
"group": "{time}"
},
{
"variable": "data",
"value": "{data}",
"serie": "{time}"
"group": "{time}"
},
{
"variable": "seqNumber",
"value": "{seqNumber}",
"serie": "{time}"
"group": "{time}"
}
]
```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,22 +47,22 @@ Configure the `uplink` callback with the following settings:
{
"variable": "device",
"value": "{device}",
"serie": "{time}"
"group": "{time}"
},
{
"variable": "data",
"value": "{data}",
"serie": "{time}"
"group": "{time}"
},
{
"variable": "seqNumber",
"value": "{seqNumber}",
"serie": "{time}"
"group": "{time}"
},
{
"variable": "location",
"location": {computedLocation},
"serie": "{time}"
"group": "{time}"
}
]
```
Expand Down
6 changes: 3 additions & 3 deletions docs/tagoio/integrations/networks/sigfox/sigfox.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,17 +74,17 @@ STATION, you can use the
{
"variable": "device",
"value": "{device}",
"serie": "{time}"
"group": "{time}"
},
{
"variable": "data",
"value": "{data}",
"serie": "{time}"
"group": "{time}"
},
{
"variable": "seqNumber",
"value": "{seqNumber}",
"serie": "{time}"
"group": "{time}"
}
]
```
Expand Down
2 changes: 1 addition & 1 deletion docs/tagoio/profiles/services/data-records.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ All fields and [metadata](/docs/tagoio/devices/payload-parser/metadata.md) store
"value": 71,
"unit": "F",
"time": "2019-06-30 01:58:11",
"serie": "1561859891862",
"group": "1561859891862",
"location": {
"lat": 35.770723,
"lng": -78.677328
Expand Down
6 changes: 3 additions & 3 deletions docs/tagoio/widgets/charts/area-chart-widget.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Charts are a powerful way to visualize your data and discover insights. The Area

![Example area charts illustrating different styles and color schemes](/docs_imagem/tagoio/area-chart-widget-2.png)

This widget also accepts features like [metadata](/docs/tagoio/devices/payload-parser/metadata.md) and [series](/docs/tagoio/devices/grouping-variables.md), which can be set in your variable data.
This widget also accepts features like [metadata](/docs/tagoio/devices/payload-parser/metadata.md) and [groups](/docs/tagoio/devices/grouping-variables.md), which can be set in your variable data.

## 1. 'Data From' Field

Expand Down Expand Up @@ -38,9 +38,9 @@ In the area chart widget, it is possible to customize how the data will be displ
### 2.1 X-axis

By default, the X‑axis of the chart will be the time of the values, and you can customize the range of time.
If you need to group your data through the X‑axis even if they don't have the same time, select a variable that contains the group; all data will then be grouped by **series**.
If you need to group your data through the X‑axis even if they don't have the same time, select a variable that contains the group; all data will then be grouped by **groups**.

Data is ordered by time ascending, but it is possible to change it to series:
Data is ordered by time ascending, but it is possible to change it to groups:

![Image 7](/docs_imagem/tagoio/Captura-20de-20tela-20de-202021-06-17-2018-25-18-hFU.png)

Expand Down
4 changes: 2 additions & 2 deletions docs/tagoio/widgets/charts/horizontal-bar-widget.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Charts are a powerful way to visualize your data and look for insights. You can

![Horizontal bar examples](/docs_imagem/tagoio/horizontal-bar-widget-2.png)

This widget also accepts features such as [metadata](/docs/tagoio/devices/payload-parser/metadata.md) and [series](/docs/tagoio/devices/grouping-variables.md), which can be set in your variable data.
This widget also accepts features such as [metadata](/docs/tagoio/devices/payload-parser/metadata.md) and [groups](/docs/tagoio/devices/grouping-variables.md), which can be set in your variable data.

## 1. 'Data From' Field

Expand Down Expand Up @@ -39,7 +39,7 @@ In the horizontal bar chart widget you can customize how data is displayed on bo
### 2.1 X‑axis

By default, the X‑axis shows the time of each value, and you can set a custom time range.
If you need to group data that does not share the same timestamp, select a variable that contains the grouping key; all values will then be grouped by **series**.
If you need to group data that does not share the same timestamp, select a variable that contains the grouping key; all values will then be grouped by **groups**.

You can also define the X‑axis time range dynamically using another variable’s metadata:

Expand Down
6 changes: 3 additions & 3 deletions docs/tagoio/widgets/charts/line-chart-widget.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Charts are a powerful way to visualize your data and discover insights. The Line

![Line chart examples](/docs_imagem/tagoio/line-chart-widget-2.png)

This widget also accepts features like [metadata](/docs/tagoio/devices/payload-parser/metadata.md) and [series](/docs/tagoio/devices/grouping-variables.md), which can be set in your variable data.
This widget also accepts features like [metadata](/docs/tagoio/devices/payload-parser/metadata.md) and [groups](/docs/tagoio/devices/grouping-variables.md), which can be set in your variable data.

## On this page

Expand Down Expand Up @@ -37,9 +37,9 @@ In the line chart widget, it is possible to customize how the data will be displ
### 2.1 X-axis

By default, the X‑axis of the chart will be the time of the values, and you can customize the range of time.
If you need to group your data through the X‑axis even if they don't have the same time, select a variable that contains the group; all data will then be grouped by **series**.
If you need to group your data through the X‑axis even if they don't have the same time, select a variable that contains the group; all data will then be grouped by **groups**.

Data is ordered by time ascending, but it is possible to change it to series.
Data is ordered by time ascending, but it is possible to change it to groups.

![Image 5](/docs_imagem/tagoio/Captura-20de-20tela-20de-202021-06-17-2016-32-49-2mY.png)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,5 +30,5 @@ Once you have configured the axes, click **Confirm** to preview the changes and

Notes:

- After enabling multiple axes, you can assign different series to specific Y‑axes so each series scales appropriately.
- After enabling multiple axes, you can assign different groups to specific Y‑axes so each groups scales appropriately.
- Use the Y‑axis settings to configure labels, units, and axis position (left/right) for each axis. You can also hide a label if desired.
10 changes: 5 additions & 5 deletions docs/tagoio/widgets/charts/multiple-charts-widget.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ keywords: [tagoio, iot, widget, multiple charts, data visualization]
Charts are a powerful way to visualize your data and find insights. The Multiple
Charts widget lets you customize colors, apply Formula
(/docs/tagoio/widgets/general/formula), change line shapes (step or smooth),
choose whether series are stacked, and more.
choose whether groups are stacked, and more.

When using multiple charts widget, each variable produces a different chart. In
the same widget it is possible to have each chart as an
Expand All @@ -21,7 +21,7 @@ the same widget it is possible to have each chart as an

This widget also accepts features like
[metadata](/docs/tagoio/devices/payload-parser/metadata.md) and
[series](/docs/tagoio/devices/grouping-variables.md), which can be set in your
[groups](/docs/tagoio/devices/grouping-variables.md), which can be set in your
variable data.

## 1. 'Data From' Field
Expand Down Expand Up @@ -58,13 +58,13 @@ By default, the X‑axis of the chart will be the time of the values, and you ca
customize the range of time.\
If you need to group your data through the X‑axis, even if they don't have the
same time, select a variable that contains the group; all data will then be
grouped by **series**.
grouped by **groups**.

<!-- Info icon placeholder: X-axis grouping example -->

Data is ordered by time ascending, but it can also be sorted by series:
Data is ordered by time ascending, but it can also be sorted by groups:

<!-- Image temporarily disabled: Series sorting example - /cdn.elev.io/file/uploads/8Kr8tD8c3s2gigLME_FvaA_bT6A7DbPNHE1DBsJtJDw/c1IxSaBHG9OmIf4MOI9_tXqBo1IhruO5gcPnGdBbg5c/Captura%20de%20tela%20de%202021-06-22%2022-02-03-D7c.png -->
<!-- Image temporarily disabled: Groups sorting example - /cdn.elev.io/file/uploads/8Kr8tD8c3s2gigLME_FvaA_bT6A7DbPNHE1DBsJtJDw/c1IxSaBHG9OmIf4MOI9_tXqBo1IhruO5gcPnGdBbg5c/Captura%20de%20tela%20de%202021-06-22%2022-02-03-D7c.png -->

It is also possible to define the X‑axis time range dynamically, using another
variable’s data. The variable payload should look like:
Expand Down
10 changes: 5 additions & 5 deletions docs/tagoio/widgets/charts/vertical-column-widget.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
title: "Vertical Column Widget"
description: "A brief guide to the Vertical Column Widget in TagoIO, explaining what it does, configurable features (like Formula, metadata, and series), and the first configuration field ('Data From') used to select device and variable data for the widget."
description: "A brief guide to the Vertical Column Widget in TagoIO, explaining what it does, configurable features (like Formula, metadata, and groups), and the first configuration field ('Data From') used to select device and variable data for the widget."
tags: ["tagoio", "widgets"]
keywords: [tagoio, iot, widget, vertical column chart, data visualization]
---

Charts are a powerful way to visualize your data and gain insights. The Vertical Column Widget lets you customize colors, apply [Formula](/docs/tagoio/widgets/general/formula.md), choose whether series are stacked, and more.
Charts are a powerful way to visualize your data and gain insights. The Vertical Column Widget lets you customize colors, apply [Formula](/docs/tagoio/widgets/general/formula.md), choose whether groups are stacked, and more.

![Vertical column charts showing different color themes and stacked columns](/docs_imagem/tagoio/vertical-column-widget-2.png)

This widget also supports features such as [metadata](/docs/tagoio/devices/payload-parser/metadata.md) and [series](/docs/tagoio/devices/grouping-variables.md), which can be set in your variable data.
This widget also supports features such as [metadata](/docs/tagoio/devices/payload-parser/metadata.md) and [groups](/docs/tagoio/devices/grouping-variables.md), which can be set in your variable data.

## 1. 'Data From' Field

Expand Down Expand Up @@ -38,9 +38,9 @@ In the vertical column chart widget you can customize how data is displayed on b
### 2.1 X‑axis

By default, the X‑axis shows the time of each value, and you can set a custom time range.
If you need to group data that does not share the same timestamp, select a variable that contains the grouping key; all values will then be grouped by **series**.
If you need to group data that does not share the same timestamp, select a variable that contains the grouping key; all values will then be grouped by **groups**.

Data is ordered by time ascending by default, but it can also be sorted by series.
Data is ordered by time ascending by default, but it can also be sorted by groups.

You can define the X‑axis time range dynamically using another variable. The payload should look like this:

Expand Down
4 changes: 2 additions & 2 deletions docs/tagoio/widgets/general/formula.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ tags: ["tagoio"]
keywords: [tagoio, iot, widgets, formula, data transformation]
---

The Formula feature enables users to modify the visualization of data in specific widgets. Located inside the configuration tab of most widgets, a Formula can be applied to all fields of a stored register, including variable, value, unit, series, location, and metadata.
The Formula feature enables users to modify the visualization of data in specific widgets. Located inside the configuration tab of most widgets, a Formula can be applied to all fields of a stored register, including variable, value, unit, group, location, and metadata.

<!-- Image placeholder removed for build -->

Expand Down Expand Up @@ -49,7 +49,7 @@ Example formula (temperature conversion):

- The output generated by a Formula is temporary and only used by the widget for display purposes.
- The original variable and device data remain unchanged by a Formula.
- Formula expressions can reference stored fields like value, unit, series, location, and metadata.
- Formula expressions can reference stored fields like value, unit, group, location, and metadata.

### Source options

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,17 +24,17 @@ In the Fields Configuration tab of your [Input Form](/docs/tagoio/widgets/input-

## Structure

To enable filtering, each option in your list must contain a `serie` property. For example, if you have a variable named `food_options`, each item should look like:
To enable filtering, each option in your list must contain a `group` property. For example, if you have a variable named `food_options`, each item should look like:

```json
{
"variable": "food_options",
"value": "Apple",
"serie": "fruit"
"group": "fruit"
}
```

When the value of the **Filter origin** field changes, the list filters its items by comparing that value with the `serie` property of each option. The comparison ignores whitespace and case (e.g., `"my value 1"` matches `"myvalue1"`).
When the value of the **Filter origin** field changes, the list filters its items by comparing that value with the `group` property of each option. The comparison ignores whitespace and case (e.g., `"my value 1"` matches `"myvalue1"`).

## Example

Expand All @@ -45,22 +45,22 @@ Below is a concrete example using the structure described above.
{
"variable": "food_options",
"value": "Apple",
"serie": "fruit"
"group": "fruit"
},
{
"variable": "food_options",
"value": "Banana",
"serie": "fruit"
"group": "fruit"
},
{
"variable": "food_options",
"value": "Broccoli",
"serie": "vegetable"
"group": "vegetable"
},
{
"variable": "food_options",
"value": "Carrot",
"serie": "vegetable"
"group": "vegetable"
}
]
```
Expand Down
4 changes: 2 additions & 2 deletions docs/tagoio/widgets/map-and-location/map-widget/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ The variable data should look like the following payload. Note that the 'lat' an
}
```

This widget also accepts features like [metadata](/docs/tagoio/devices/payload-parser/metadata.md) and [series](/docs/tagoio/devices/grouping-variables.md), that can be set in your variable data.
This widget also accepts features like [metadata](/docs/tagoio/devices/payload-parser/metadata.md) and [groups](/docs/tagoio/devices/grouping-variables.md), that can be set in your variable data.

## Creating your own

Expand Down Expand Up @@ -97,7 +97,7 @@ In the widget edit screen, you can customize the following options for the varia

Also, you can customize an image and a link that could be set through the edit screen or by metadata. **In this widget, metadata always has priority over options set by the edit screen.**

In addition, the map widget supports [series](/docs/tagoio/devices/grouping-variables.md), so you can group your variables' data in the same infobox.
In addition, the map widget supports [groups](/docs/tagoio/devices/grouping-variables.md), so you can group your variables' data in the same infobox.

:::tip

Expand Down
6 changes: 3 additions & 3 deletions docs/tagoio/widgets/tables/dynamic-table-widget.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Dynamic Table Widget"
description: "This article describes the Dynamic Table widget in TagoIO, how it populates rows dynamically as data arrives, and how to customize its appearance and behavior (including metadata and series support)."
description: "This article describes the Dynamic Table widget in TagoIO, how it populates rows dynamically as data arrives, and how to customize its appearance and behavior (including metadata and groups support)."
tags: ["tagoio", "widgets"]
keywords: [tagoio, iot, widget, dynamic table, data visualization]
---
Expand All @@ -13,7 +13,7 @@ You can customize the widget color, apply formulas to columns, show a time colum

:::info

This widget also accepts features like [metadata](/docs/tagoio/devices/payload-parser/metadata.md) and [series](/docs/tagoio/devices/grouping-variables.md), which can be set in your variable data.
This widget also accepts features like [metadata](/docs/tagoio/devices/payload-parser/metadata.md) and [groups](/docs/tagoio/devices/grouping-variables.md), which can be set in your variable data.

:::

Expand Down Expand Up @@ -41,7 +41,7 @@ From the option **Data From** on the right menu, add the [Blueprint device](/doc

### 2. Grouping data

The dynamic table lets you group related data from multiple columns in the same row by either **series** or time.
The dynamic table lets you group related data from multiple columns in the same row by either **groups** or time.

<!-- Image temporarily disabled: Image 3 - /cdn.elev.io/file/uploads/8Kr8tD8c3s2gigLME_FvaA_bT6A7DbPNHE1DBsJtJDw/a5qbzEpKPdKvAAYdvNp1Ue32vefQzbVwZz4Pkp8yoVM/Captura%20de%20tela%20de%202021-07-06%2011-39-24-EVQ.png -->

Expand Down
Loading