Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

The Cross-reference displays Reference provides a table that enables users to view and interact with the cross-referencing of all objects within the solution. It shows the connections and dependencies among system components, facilitating the identification of how alterations in one segment could influence others and thus, preempting potential system-wide issues. The table is updated via a refresh button and supports navigation through selection and action commands, such as "Go To Link" or double-clicking on a desired row. It also offers the capability to replace objects in selected rows, enhancing the management of object interrelations. This feature is instrumental in troubleshooting and maintenance tasks, where understanding object relationships is crucial. For tracking and management dependencies in your solutions., navigate to Track Changes → Cross-Reference. Check out the Cross-Reference documentation to read more about how to leverage this feature

The contents of this table enables the Find Results Panel at the Designer main interface. See Designer (IDE Overview) / Find Results Panel.

Usually, it easier than to use the Find Results panel to presents the referenced elements of the selected object, rather than execution the search in this table.

On this page:

Table of Contents
maxLevel3
styleNone


Image Added

Cross-Reference Table Columns

Properties reference

Cross-Reference Table

Property

Description

ID

Assigns a unique identifier to each cross-referenced item.

ObjectName

Names the object that is being referenced.

UsedByTable

Identifies the table that uses the object.

TableItem

Specifies the item within the table that references the object.

Location

Pinpoints the location of the object within the system.


Tip

Double-click on a row navigates to the Designer configuration UI of the selected location.



Objects Usage not Visible to Cross-Reference

This feature only shows the places the object is being used directly, not used by an indirect reference or string manipulation. 

Here are some examples where an object is used indirectly:

  • Via TagReference using the .Link Property (reason why use the Tag1.GetName() when possible, instead of "Tag1" when setting the value for this property)

  • Via AssetPath, using the syntax. Asset("/folder1/tag1")

  • Via scripts settings directly TagNames on TrendChart and other objects.

  • Via .NET classes, or Toolkit methods, which allows the access of objects by a string with its name, not the object directly. 

  • Objects used by external Applications, using DataAccess API, or consumed via the built-in OPC UA Server or MQTT Broker.

Warning

The Find Results panel, UseCount, and Unused Count relies on the Cross-Reference table. Therefore, objects used by an indirect access are also not visible to those tools.

Verify and be ware of these limitation when deleting or renaming objects. 



In this section:

Page Tree
root@parent
spacesV10