Import Configuration Dialog - Configure Tag References for an Add-On Instruction Overview
Use this dialog box to review and configure Add-On Instruction Tag References for the import.
Tag references are represented in the Import Content by the Tags item found under the References folder. When the Tags item is selected, the Details pane displays the tag references in the import content. The list includes any tags directly referenced by any imported logic and tags (via Alias For).
If the operation on a tag is set to use the existing tag in the project, then the Scope, Alias For, Data Type and Description fields show the values from the tag in the project and appear dimmed. Otherwise, these fields display the values from the import file.
TIP:
Consumed tags are not supported through import, therefore any consumed tags import as base tags.
Parameters
Row Header
The left-most part of the grid that provides an indication of the condition of the component that was imported, as follows:
![]() | Indicates why the component needs attention. Hover the cursor over the red flag icon and a tool tip displays and indicates the reason for the message. |
![]() | Indicates a safety warning. |
Scope Column
(Does not display when tag references are for rungs being imported into an Add-On Instruction).
The second column displays the scope of the Final Name component. You can right-click on the scope and choose Toggle Tag Scope from the pop-up menu.
Indicates a non-controller-scoped component. | |
Indicates a controller-scoped component. | |
![]() | Indicates a non-controller-scoped safety component. |
![]() | Indicates a controller-scoped safety component. |
Import Name
Displays the name of the tag as read from the import file.
If the tag has descriptions defined for one or more of its members (bit or otherwise), then the row can be expanded to show only the tag’s members that have these descriptions.
Operation
Identifies what is done with the tag upon import.
The field is pre-populated; however, you can choose from a list of valid choices. See Import Configuration Operations for more details.
For more information, see Import Configuration Operations.
Differences Column
Provides, at a glance, an indication of how the imported content matches the project content.
![]() | Indicates a component that collides with another component has differences in the component definitions. |
![]() | Indicates a component that is present in the import content but is not present in the project. |
![]() | Indicates a component that is present in the project but not in the import content. |
Blank
(no icon) | Indicates a component that collides with another component with an identical component definition. |
Final Name
The final name is the name of the tag as it appears in the project after the import. Changing the Final Name changes the name in all places where this tag’s Import Name is referenced in the import content (throughout the logic and in any alias tag specifiers), This replacement occurs even if you select Discard or Use Existing as the Operation. By default it is initialized to the Import Name.
When you click in the Final Name cell, a menu appears, which lets you pick from a list of all of the appropriate tags that exist in the project.
TIP:
Picking a tag of a different scope changes the scope of the tag you selected.
If Overwrite is selected in the Operation field when the import proceeds, then the imported name (or the name you type as the final name) and the Scope appear in the resulting project, including any case changes. This lets you change the case of component names on import.
You can enter a tag expression or value in the Final Name field and logic references in the imported content are updated to use this in place of the tag name. You can also enter a specified operand (for example, myTagArray[5].myTimer) for the Final Name. The Operation field is set to Discard. References in the imported content are updated to use that new operand name (in place of the name shown in the Import Name column).
Usage
Displays only for tag references for rungs or routines that are imported into an Equipment Phase or Add-On Instruction.
For an Equipment Phase, displays the usage of the tag reference as read from the import file, except in the following cases:
The Usage will be blank if:
- the Operation field is set to Undefined.
- rows represent members of an expanded Tag.
- the Tag is an alias Tag (Alias For field is not empty).
Alias For
Offline, you can modify the Alias For field by typing text in the field or by picking a tag from the existing project from the Tag Browser. A tag is valid if the tag specified matches a tag name in the Final Name column. An invalid tag name results in an unverified tag.
If the Alias For field is changed to an alias component with a data type that is different from the tag specified in the Final Name field, the data type of the resulting reference (whether it is being created or overwritten) is changed to the data type of the tag specified in the Alias For field.
For Add-On Instruction definition, only Input and Output tags can alias Local Tags; Local Tags and InOut tags cannot alias another tag.
Data Type
Displays the data type of the tag reference.
If the Tag is an alias Tag, or if the row represents a member of an expanded tag, this field is blank.
Description
Displays the description of the tag.
You can modify these descriptions only if the Operation field is set to Create or Overwrite.
External Access
This column indicates whether the tag has Read/Write, Read Only, or no access (None) from external applications such as HMIs. You can modify a tag's External Access if the tag's Operation (discussed above) is set to Create or Overwrite. You cannot change a tag's External Access if the tag's Operation is set to Use Existing or Discard. For more information about External Access, see About External Access.
Constant
This column indicates if logic is prevented from writing values to the associated tag or parameter. If a logic routine tries to write to a constant tag, the routine will not verify.
Message
Pay particular attention to warnings that appear in the area below the grid.
Provide Feedback






