Retrieve configuration details for a tag
- Last UpdatedJan 31, 2025
- 4 minute read
You can retrieve configuration details for tags, such as a description. The configuration details that can be retrieved depend on the type of tag. For example, the minimum and maximum values are only applicable for an analog tag.
To retrieve tag details:
-
On the Historian tab, in the Tag Management group, click Tag Configuration, and then click Tag Details. The Tag Details - Step 1 of 3 dialog box appears.
-
In the Server list, click the name of the server to use.
-
In the Select cell(s) containing tag name(s) list, specify the location of the worksheet cell(s) that contains the tag name(s). Click on the button to select the cell(s). For more information, see Selecting Cells.
-
If you want to use a named tag range variable instead, click Binding Options and then configure the range. For more information, see Use "Binding" tags in a query at run time.
-
Click Next. The Tag Details - Step 2 of 3 dialog box appears.
-
In the Select cell for output list, specify the location of the worksheet cell(s) that will contain the output. Click on the button to select the cell(s) using your mouse. For more information, see Selecting Cells.
-
Select the Enter the results as an array-formula check box to insert the results as an array formula. An array formula can perform one or more calculations and then return either single result or multiple results. An array formula allows for the resending of the query, since the query parameters are included in the cells that contain the query results. For more information, see Working with Functions, Formulas, and Cells.
-
Select the Select cells to specify format options check box to specify a range of cells that contain formatting information. The formatting information in the cells will be applied to the query results. For more information, see Selecting Cells.
-
Click Next. The Tag Details - Step 3 of 3 dialog box appears. This dialog box displays different options, depending on the type of tag you have selected.
-
For analog and summary tags, configure the following options:
-
Description: The description of the tag.
-
Raw value range: The minimum value of the raw acquired value. Also, the maximum value of the raw acquired value.
-
Engineering units: The unit of measure.For example mph, grams, and pounds.
-
Engineering units range: The minimum value of the tag, measured in engineering units. Also, the maximum value of the tag, measured in engineering units.
-
Storage rate and type: The type of storage defined for the tag, either cyclic or delta. The storage rate is the rate at which the tag is stored if the storage type is cyclic.
-
Source tag: The source tag of the tag.
-
Source server: The source server of the tag.
-
-
For discrete tags, configure the following options:
-
Description: The description of the tag.
-
Storage rate and type: The type of storage defined for the tag, either cyclic or delta. The storage rate is the rate at which the tag is stored if the storage type is cyclic.
-
Messages: The messages associated with the TRUE/FALSE or ON/OFF state of the tag.
-
-
For string tags, configure the following options:
-
Description: The description of the tag.
-
Maximum tag name length permitted: The maximum number of characters for the string.
-
-
For event tags, configure the following options:
-
Description: The description of the tag.
-
Time deadband: The minimum time, in milliseconds, between stored events. If more than one event occurs during the deadband, only the most recent are stored. The system does not store another event until the specified time has elapsed. A time deadband of 0 indicates that the system stores all events.
-
Detector type: The name given to the type of detector.
-
Action type: The name given to the type of action.
-
Status: The flag used by the event system at system startup and during runtime to determine if the event tag has been modified. 0 = Posted. Any changes have been detected and effected by the system. 1 = New. An event tag has been inserted, but is not yet executing. 2 = Modification. An event tag has been updated, but the older one is already executing. 98 = Disabled. 99 = Disabling requested. The event tag does not execute, even though the definition still exists in the schema. Note that there may be a delay of up to 30 seconds before a change in an event tag is seen by the running system.
-
Logged: Used to specify whether or not to log events for this tag into the EventHistory table. Event logging can only be turned off if no associated actions are configured.
-
Scan rate: The interval, in milliseconds, at which the system will check to see if the event conditions specified by the detector have occurred. This value must be greater than or equal to 500 milliseconds, and less than or equal to 1 hour (3600000 ms).
-
-
Click Finish. The details appear in the spreadsheet.