.. _dr.tags:

===========
Review Tags
===========

Tags in WIP allow you to store, manage and review current and historical values of various types of data, including measured, filtered, calculated data, as well as data quality (see :ref:`data.quality`). For more information about the functionality of tags, see :ref:`tags`.

You can also build a hierarchy of tags with different levels to allow easier grouping and structuring. For more information, see :ref:`user.hierarchy`.

Prerequisites
*************

To be able to review data associated with tags, they must be set up and configured as described in :ref:`conf.dm.tags`.

Review Tag Data
***************


You can review tag data in the **Tags** pane of the WIP application, accessible via :menuselection:`Settings --> Tags` from the Navigation sidebar.

.. image:: images/dr.tags.png

|

The **Tags** pane is divided into multiple sections that allow you to filter and select tags, and review different types of data associated with the selected tag:

.. image:: images/dr.tags.screen.png

|

Tag Filtering
-------------

Use the filtering section to search for tags based on specific criteria:


- **Add Expression**: Add one or more filtering expressions based on tag attributes. For example, to find tags with *TEST* in their name:
  
  - Select **Name**
  - Choose **Contains**
  - Enter **TEST**

  Only tags matching this condition will appear in the Tag List.


- **And/Or**: When using multiple expressions or groups, choose whether to apply all conditions (**And**) or any condition (**Or**).

  Example with two expressions:

  - Name contains *TEST*
  - Name ends with *JB*

  - **And**: Shows tags that match both conditions.

    .. image:: images/dr.tags.filter.and.png

    |

  - **Or**: Shows tags that match either condition.

    .. image:: images/dr.tags.filter.or.png

    |



- **Add Group**: Create groups of filters for more complex logic. For example, to filter tags that:

  - Either contain *MA* in their name **OR**
  - Contain *MC* **AND** start with *1*

  Steps:

  1. Add an expression for *Name Contains MA*.
  2. Add a new group and select **OR** at the top.
  3. In the new group, add two expressions and select **AND** at the top of the group:

     - Name contains *MC*
     - Name starts with *1*

  .. image:: images/dr.tags.filter.group.png

  |

Tag List
--------

Select a tag from the filtered or unfiltered list at the bottom-left of the screen. The rest of the screen will populate with data related to the selected tag.

Basic Tag Data
--------------

This section displays basic parameters of the selected tag, as shown also in the **Tag Configuration** pane (see :ref:`conf.dm.tags.setup`):

- Tag name (copyable via the Copy icon)
- Current value, unit type, quality, and timestamp
- Assigned Tag Group (see :ref:`conf.dm.tags.group`) under **Categories**
- Tag description

Trend View
----------

The **Trend** section visualises historical values of the selected tag. You can:

- Choose a predefined time period
- Select *User Defined Period* to enter custom start and end times
- Set the **Refresh Rate** to control how often the data is updated


Historical Data View
--------------------

This section displays historical values in list format, based on the selected Trend period. You can:

- Check **Show Raw Data** to show unfiltered tag values
- Click the blue Excel icon to download the data as an Excel file


Tracker View Reference
----------------------

Under **Reference**, you’ll see a snapshot of the **Tracker View** for the selected tag, showing its first-level dependencies. This is a read-only view that you can zoom in/out using your mouse scroll.

For more details on Tracker View functionality, see :ref:`conf.tools.tracker_view`.



.. seealso::

   - :ref:`tags` 
   - :ref:`conf.dm.tags`
   - :ref:`user.hierarchy`