.. _conf.dm.tags.group:

=================
Set Up Tag Groups
=================

Grouping tags allows users to organise and find subsets of tags based on specific group values. Each tag group can be displayed as a column, making it easy to search and filter tags. For example, if a pump discharge flowrate tag has an *Origin* group set to “AirStripper,” users can quickly identify and filter all tags related to this specific asset.

By having tag groups as columns, users can efficiently search and filter tags to identify those that belong to the same asset, represent final emissions, or are calculated tags. This functionality enhances the ability to manage and analyse data effectively.

You can create, edit or delete tag groups from the **Tags** pane of the viewing area, which you can access in either of the following ways:

- Choose :menuselection:`Configuration --> Data Management --> Tags` from the menu.
- In the Navigation sidebar, go to :menuselection:`Settings --> Tags`.

Create Tag Groups
*****************

1. On the **Tags** pane, right-click on the row of the tag to which you want to assign a tag group and select **Show Properties/Group** from the context menu that appears.

   .. image:: images/conf.tag_group_rightclick.png

   |

   ..  admonition:: Result 
       
       The **Tag Properties/Groups** sidebar panel opens on the right-hand side of the viewing area.

2. In the **Tag Properties/Groups** sidebar panel, click |add| **Add Group** under the **Groups** section and enter data as follows:
   
   .. list-table:: 
      :widths: 1 5
      :header-rows: 1
      :class: tight-table

      * - Field
        - Description
      * - **Name**
        - Enter the name of the group, which reflects the criteria based on which you want to group the tags. This name appears as the column header in the grid. You can enter a new group name or reuse an existing one.
      * - **Value**
        - Enter the value specific to the tag. You can filter or search tags with this value in the grid.

   If you want to clear the entered values, click |reset|.

3. Click |addblue| to add the specified entry.

   |

   .. image:: images/conf.tag_group_add.png

   |

   ..  admonition:: Result 
    
       The new group can now be added as a column to the grid using the **Columns** toolbar button.
 
       .. image:: images/conf.tag_group_column.png


Update Tag Groups
*****************

You can update the value of any existing tag group as follows:

1. On the **Tags** pane, right-click on the row of the relevant tag and select **Show Properties/Group** from the context menu that appears.

   .. image:: images/conf.tag_group_rightclick.png

   |

   ..  admonition:: Result 
       
       The **Tag Properties/Groups** sidebar panel opens on the right-hand side of the viewing area.

2. In the **Tag Properties/Groups** sidebar panel, click |edit| in the row of the relevant tag group.
3. Update the value as required.
4. Click |saveblue| to save the updated entry. To cancel the update, click |cancel|.


Delete Tag Groups
*****************


1. On the **Tags** pane, right-click on the row of the relevant tag and select **Show Properties/Group** from the context menu that appears.

   .. image:: images/conf.tag_group_rightclick.png

   |

   ..  admonition:: Result 
       
       The **Tag Properties/Groups** sidebar panel opens on the right-hand side of the viewing area.

2. In the **Tag Properties/Groups** sidebar panel, click |delete| in the row of the relevant tag group.
3. Confirm the deletion.

.. |add| image:: images/icon.add.png

.. |edit| image:: images/icon.edit.png

.. |delete| image:: images/icon.delete.png

.. |addblue| image:: images/icon.add.blue.png

.. |saveblue| image:: images/icon.save.blue.png

.. |reset| image:: images/icon.reset.png

.. |cancel| image:: images/icon.cancel.png