OpenPlant Modeler Help

Import Tag Instances

This option lets you import graphical and non-graphical tag instances from an external database file directly to a PlantSight iModel.

Note: If working in standalone mode (not connected) you can import non-graphical tags into the active model. Graphical tags can only be imported when connected and provisioned to an PlantSight iModel.
Accessed from:
When you click the icon, a standard File Open dialog displays letting you select the file containing the existing tag instances. The following file formats are supported:
  • Excel - *.xls, *xlsx
  • Access - *.mdb, *.accdb
  • SQLite - *.db, *.db3, *.sqlite, *.dqlite3

An example of an Excel file is listed below

The Sheet names correspond to EC Classes. Both Graphical and Non-Graphical tags can also be imported. Non-Graphical tags consists of Plant Breakdown System (PBS) items: UNIT, SERVICE, PLANT_AREA as well as Pipelines.

Graphical tags include items with graphics associated with them such as Pumps, Vessels, Valves etc.

Once you select which file to import the Import Instances dialog displays:

Note: If working in a standalone mode (not connect to an iModel) then only the non-graphical instances are displayed in this dialog.
SettingDescription
Import Click to import the selected tag instances. Once the instances have been imported, they will be available to use when placing tagged components through the Tag Browser or the Consistency Manager. The Tag Browser is displayed when you click the Browse button in the Placement dialog when placing a tagged component such as a pump, vessel, etc.
Note: Only new instances can be imported. Existing or modified tags currently cannot be imported using this option.
Show Import Log on complete When importing tag instances, a log file is created. This option toggles whether the log file is displayed once the import has been completed.
Open Log File Location This option navigates to the location of the Log File in File Explorer.
Instance Selection Options The following options are available for selecting the instances to import.
  • Select All : Select all of the instances in the grid.
  • De-Select All : De-selects all of the instances in the grid.
  • Invert Selection : Inverts the current selection status of all instances in the grid.
Classes The Classes listed in the left pane are the sheets which were listed in the Excel file.

You can use the checkboxes to determine which classes you want to import.

Instances to Import - New

When you select a Class from the list the instances to import for that particular class are displayed. When the New option is displayed, the instances not already in the For example, the image above is showing the new Equipment instances to import. If you were to select the Unit class the instances may display as follows:

Existing When importing tag instances, the Existing tab will list any instances which may have already been imported into the drawing or defined in PlantSight. If there are no existing instances then this tab will be disabled.
Important: Currently you are not able to modify existing tags in a local file and import the changes back to the PlantSight iModel. So if only Existing tags are available then the Import option is disabled.
If property differences are found the symbol is displayed in the column next to the record. When you hover over the symbol a popup displays showing the properties which have the differences as shown above.
Note: This is for information purposes only. These values cannot be edited in this dialog.
If you scroll over the property column which has the difference (i.e. TOTAL_WEIGHT) and click in the field with the difference, then the difference between the imported instance and the value in the repository is displayed in the Difference section at the bottom of the dialog:
Filtering If desired you can drag a column header into the empty space above the headers to group the results by the column name:
Key-in: OPENPLANTMODELER IMPORTEXCEL