Manage a tag collection
- Last UpdatedJan 31, 2025
- 6 minute read
On the External Data Manager, you can create, rename, and delete tag collections. On the Tag Collection Editor, you can connect a tag collection to an external database, add tags to the tag collection, and map the tags to AVEVA Process Simulation model variables.
|
Activity |
Directions |
|---|---|
|
Opening the External Data Manager |
On the Process, Fluid Flow, or Dynamics tab, in the External Data group, select Open External Data manager |
|
Creating a tag collection |
On the External Data Manager, select Add tag collection |
|
Opening the Tag Collection Editor |
On the External Data Manager, select the tag collection that you want to modify and then select Define. |
|
Connecting a tag collection to an external database |
On the Tag Collection Editor, in the Provider list, select the type of database that you want to connect to. Currently, AVEVA Process Simulation can connect to OSIsoft PI Data Archive servers and AF attributes only. In the Server list, enter the name of the database that you want to connect to. |
|
Adding a tag to a tag collection |
If you know the server name of the tag, in the Tags Configuration area, select Add Tag Mapping Alternatively, you can search for a tag and add it from the Tags Browser area. |
|
Searching for a tag |
On the Tag Collection Editor, in the Tags Browser area, in the Contains box, enter a search string, and then select Search. A list of tags that contain the search string appears. Select If you are searching for attributes in a PI Asset Framework (AF) server, you must search for the parent element to load a list of available attributes. |
|
Mapping a tag to a model variable |
On the Tag Collection Editor, in the Tags Configuration area, select the Model variable column for the tag that you want to map. Enter the name of the model variable that you want to map to the tag. A list of model variables in the simulation appears as you enter the name. |
|
Exporting a tag mapping configuration |
On the Tag Collection Editor, in the Tags Configuration area, select Export tag mapping table to a csv file The tag mapping file includes all the information from the Tags Configuration area for archival purposes. However, the software loads only the Sim Variable and Tag Name values if you import the .csv file in another simulation. |
|
Importing a tag mapping configuration |
On the Tag Collection Editor, in the Tags Configuration area, select Import a pre-configured tag mapping table csv file The import loads the Sim Variable and Tag Name values, but does not load Sim Units or Tag Units. The Sim Units update to the units of measure (UOMs) from the simulation. The Tag Units update to the UOMs from the database the next time you select Check all tags If you have added UOM mappings for OSIsoft PI tags, the Sim Units values update according to the corresponding Tag Units values the next time you select Check all tags |
|
Checking all tags across all tag collections |
On the External Data Manager, select Check All. The software checks all the tags in all the tag collections, and all Status badges update to show the current status. You can exclude tags from the tag check. See Exclude tags from the tag check for more information. |
.
.
. A new line appears in the tag list. Select the 
to verify that the tag is present on the server.
. Browse to the folder in which you want to save the tag mapping file, enter the name
of the file, and then select 
. Browse to and select the .csv file that contains the desired tag mapping, and then
select Example: Add a tag to a tag collection and map it to a model variable
-
Open the External Data Manager.
-
Select the tag collection that you want to add the tag to, and then select Define. The Tag Collection Editor appears.
-
In the Tags Browser area, in the Contains box, enter a text string that appears in the name of the tag that you want to add.
For this example, we enter CC2 to search for all tags related to the CC2 unit.
-
Select Search.
A list of tags that match the search criteria appears.
-
Select
next to a tag to add it to the tag collection.
The added tag appears in the Tags Configuration area.
For this example, we add the CC2:TEMP tag.
-
In the Tags Configuration area, select the Sim Variable column for the newly added tag. Enter the name of a model variable that has the same dimension as the tag.
A list of available model variables appears as you enter the name.
For this example, CC2:TEMP represents a temperature variable, so we map it to the temperature variable in the CC2Feed unit, CC2Feed.T.
-
In the Sim Units column, select the UOM for the model variable so that it uses the same UOM as the tag.
For this example, the UOM for the model variable does not match the UOM for the tag, so we change the UOM for the model variable to C, the UOM for the tag.
If you have added UOM mappings for OSIsoft PI tags, the Sim Units values should automatically update based on the mappings that you provide in the UOM mapping file, and you should be able to skip this step. See Add UOM mappings for OSIsoft PI tags for more information.
-
Select Check all tags
to ensure that the tag mapping is valid.