Show TOC

Function documentationTag Retrieve, Aggregate, or Store Query

 

You can use the following screens to build your PCo query:

  • Tag Retrieve Query

    This screen is active when you select TagRetrieveQuery as your PCo query mode.

  • Tag Aggregate Query

    This screen is active when you select TagAggregateQuery as your PCo query mode.

  • Tag Store Query

    This screen is active when you select TagStoreQuery as your PCo query mode. If the HistoryStore function is supported by the selected PCo agent, you can also provide time input.

Features

Hierarchy Tab

On the Hierarchy tab, you can select tags for which you want to execute the query. If groups are supported by the selected PCo agent, the system displays the groups and tags in the tree view. Depending on the filter type supported by the PCo agent, you can filter the tags using regular expression (RegEx) or native mask.

There are two types of filtering in PCo Query:

  • Native: Used when the Cache mode of the PCo agent is Demand or None. This filtering depends on the selected data source of the PCo Agent. Initially, the PCo routes the filter to the datasource. Ensure that the selected datasource supports wildcards.

  • RegEx or Regular Expressions: Used when the Cache mode of the PCo Agent is Cache or Alias. You can filter using the regular expression. Choose the filtering type based on the cache mode of the PCo Agent. You must use Code as mask to display all tags ending with Code.

Note Note

You can also select the tags dynamically using SelectedTags(tagname1, tagname2,tagname3). For more details on other parameters, see Query Parameters.

End of the note.

For Tag Retrieve queries, you can select the view that is supported by the selected PCo agent (such as Current, Event, or Interpolate) from which you want to retrieve data.

For Tag Aggregate queries, you can select aggregates for which you want to retrieve the value. The list contains aggregates supported by the selected PCo agent.

For Tag Store queries, you can set the following:

  • Write History check box

    If the selected PCo agent supports HistoryStore, the check box is selected. If you select this check box, you can provide the time value with the tag value.

  • Quality field

    You can enter the quality value to be stored for the selected tags.

Extended Tab

The Extended tab contains the list of secondaries and metadata that are available for the tags you selected on the Hierarchy tab. You can select the secondaries and metadata for which you want to retrieve values.

If you are working with a Tag Store query, this tab is not available.