You can import Tags to an individual folder or under the Tags tab. To import Tags under the Tags tab, you can click the Tags tab or the empty space at the bottom of the Tag Browser below all your Tags. When importing Tags, you need to tell Ignition how to handle duplicate Tags. If any of the Tags being imported already exist in the folder you specify, Ignition can abort the import, overwrite the Tags, rename them, ignore them, or merge them. This is called a collision policy.
Collision Policy Options Table
Aborts the import if duplicate Tags are found.
Overwrites any Tags in the folder that have the same name as Tags being imported. Note this a complete overwrite of the Tag.
Renames any duplicate Tags.
Ignores duplicate Tags and imports only those that are unique.
Overwrites the Tag with the exception of any properties that aren't defined in the import folder. Those properties will be merged.
To import Tags, do the steps that follow.
In the Tag Browser toolbar, right click on your folder and select Import Tags.
Specify the folder you want to import your Tags from, and choose a previously exported file either .json , .xml , or . csv file type.
Choose a Collision Policy, which indicates how Ignition will deal with duplicate Tags.
Click Open to import the Tags.
The Tags now appear in the Tag Browser in the folder you indicated for the import.
Advanced Tag Import
The Advanced Tag Import tool allows users to edit Tag properties in the Designer before import. It combines the functionality of the basic Import Tags tool with the Tag Editor window.
|Adds the selected Tag, folder, or UDT to the Staging Area.|
|Adds all Tags, folders, and UDTs in the Selection Pane to the Staging Area.|
|Creates a new folder or Tag at the selected node in the Staging Area, or the root if a node is not selected.|
|Opens a Tag Editor window for the selected Tag or UDT.|
Deletes the selected Tag or UDT from the Staging Area.
- From the Tag Browser, click the More Options menu and select Import Tags > Interactive.
- Select the .json, .xml, or .csv file to import.
- Move the desired Tags and UDTs from the Selection Pane to the Staging Area using the Add or Add All buttons.
- Edit Tags in the Staging Area by selecting a Tag and clicking Edit
If any collisions are detected, you will be prompted to select a Collision Policy from the dropdown menu.
Note: Unlike the basic Import Tags tool, you may only choose to Overwrite or Ignore duplicate Tags imported via the Advanced Tag Import tool.
- Click OK to import the Tags and UDTs
The Tags now appear in the Tag Browser.
Tag File Formats
Tags can be imported from CSV, JSON, and XML. Tags can only be exported in XML or JSON. There are many configuration settings for Tags than what is displayed in a JSON or XML export file. The Tag export feature only exports the configuration properties that have been edited in at least one of the Tags in the selected export folder. Therefore, to ensure the desired configuration setting is available in the export file, at least one Tag within the selected export folder must have that configuration property changed
Ignition supports importing tags from a CSV format. Details of the format are below, if you expand "CSV Example Format". This format can contain tag types, OPC paths, and most tag properties. One difference between the CSV format and the XML and JSON format is that the CSV format does not include support for alarm configurations. Alarms can certainly be added to tags in the Ignition Designer after tags have been imported from CSV, but alarms cannot be defined directly in the CSV.
Below is an example of the legacy CSV format, which contains a couple of different tag types, purely for demonstrative purposes. It contains:
- An OPC Tag
- A Folder
- An OPC Tag located in a folder
- A Derived Tag
- An Expression Tag
- A Memory Tag
- A Query Tag
Property Values in the CSV Import
The following table shows the configuration property names and values contained in legacy CSV Tag import files. Tags were overhauled in Ignition 8.0, so the properties listed here are not the same as Tags export from an Ignition 8.0+ system. For modern tag properties, see the Tag Properties page.
Values (if applicable)
|Value||The value of the Tag, dependent on the data type.|
0 - Int1
0 - OPC Tag
Determines the type of the tag.
A value of one is a "DB Tag", which is either a Memory Tag, Query Tag, or Expression Tag, depending on the value of the ExpressionType field.
0 - None
|Used in conjunction when the TagType is set to 1 (DB Tag), otherwise this field is ignored.|
|AccessRights||Int||0 - Read Only|
1 - Read/Write
2 - Custom
|If custom, will be defined by a Permissions Tag.|
|OPCWriteBackServer||String||Write back target for expression T ags.|
|ScaleMode||Int||0 - Off|
1 - Linear
2 - Square Root
3 - Exponential Filter
|ScaleFactor||Float||For exponential filter.|
|RawLow||Float||Defines scale range.|
0 - None
0 - Absolute
0 - None
|DriverName||String||Used for external Tags.|
|ScanClass||String||The export will only include the name of the Scanclass, not the configuration of the Scanclass itself. A Scanclass with the same name needs to already exist on the Gateway that the Tags are being imported to, prior to importing them.|
|PrimaryHistoryProvider||String||The history provider to use if storing history.|
0 - Absolute
0 - Discrete
How values are interpolated. 2 exists for backwards compatibility (and is equivalent to 1), but only 0 or 3 should be used in the future.
0 - System
0 - Unlimited
|HistoryMaxAge||Int||Max cycles between storage.|
The path to the parent UDT type. Used by sub-types and instances.
Although Ignition can import tags from a CSV format, Ignition does not export tags to a CSV format. Since multiple alarms can be configured per tag, the XML or JSON formats provide a much better format to allow for the tree structures needed to fully represent Ignition tags.
In this example, we exported three Tags from the Motor UDT in JSON format.
- Amps - Expression Tag with an Alarm and History enabled
- HI SP - Memory Tag which is bound to a parameter to an OPC Tag
- HOA - OPC Tag
The following exported Tag file is in JSON format. As you browse through the JSON file, you will see the Tag properties and configuration settings for each of the three Tags listed above.
Below is an example of a JSON format tag export. Descriptions on the various properties can be found on the Tag Properties page.
In this example, we exported the same three Tags from our Tag Browser, that were also used in the JSON example, in XML format. As you browse through the XML file, you will see the Tag properties and configuration settings for each of the same three Tags.
Below is an example of an XML format tag export. Descriptions on the various properties can be found on the Tag Properties page.