Versions Compared

Key

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

Overview

It The Unused Objects page provides a table of solution listing all unused objects , updated through in the solution. This view is not dynamic; it is updated when first loading and via the Refresh button.

Its purpose is to identify and list system components or objects that can be considered for removal, thereby enhancing removed to enhance efficiency by eliminating redundant or outdated configurations. The functionality extends to updating the list of unused objects and deleting them. It also includes an additional verification step for indirect usage through reference tags, script expressions, or reflection methods to prevent the accidental deletion of necessary components. This feature is applicable in scenarios focused on system cleanup, optimization, and maintenance, where identifying unused objects is critical for resource management. It does not need any configuration; to use it, navigate to Track Changes → Unused Objectsunnecessary configurations.

On this page:

Table of Contents
maxLevel3
styleNone


Image Added

Removing Unused Objects

management

Limitations, when its not safe to remove

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

See TrackChanges / CrossReference for example of configuration using objects indirectly. 

Only remove unused objects if you're sure they aren't used indirectly or by external applications. 

Removing steps

If you want to proceed and remove an object with the assistance of this table, follow these steps:

  1. Refresh the UseCount table
  2. Select one or more lines (using shift-click and control-click)
  3. Press the Remove Selected Lines button. 

Unused Objects Table Columns

Unused Objects Table

Column

The Unused Objects feature allows users to identify and remove unused objects from their solution. The Refresh button located on the Unused Objects tab displays all the objects that are unused. Users can select the object they want to remove and click Remove. Multiple objects can be removed at once by selecting multiple objects and clicking Remove. It is important to note that this feature will only work if an object is not in use. If an object is being used, either on the screen or by a line of code or script, this feature will not work. Additionally, it is highly recommended to pay attention to tags that are being passed by the .Link property and to use the <Object>.GetName() method rather than the object name as a typed text in expressions like TK.GetObjectValue.

Identifying

Access the Track Changes → Unused Objects tab and click the Refresh button to get the current unused object list.

Removing Unused Objects

All the objects found are unused. Select the object you want to remove and click Remove. You can remove more than one object by selecting multiple objects at once and clicking Remove...

When It Works and Doesn't 

The Unused Objects feature only works for objects that are not in use. If an object is being used by something on the screen or by a line of code or script, this feature will not work. It is important to note that the functionality does not identify tags being passed as a reference by the .Link property. Therefore, it is highly recommended to use caution when removing objects that are being passed by the .Link property, as this can have unintended consequences. Additionally, the feature does not recognize objects that are used as expressions such as TK.GetObjectValue. To ensure proper identification, it is recommended to use the <Object>.GetName() method rather than the object name as a typed text.

Unused Objects Table Columns

Property

Description

ID

Assigns a unique identifier to each object.

Module

Links the object to a specific module within the solution.

ObjectName

Names the object for easy identification.



Deleting Displays or Referenced Objects

How to delete Displays or Other Objects

  1. Navigate: Go to Displays / List.
  2. Select and Delete: Choose the Display to delete and click the Delete button (X) on the DataGrid toolbar.

 For other objects, follow a similar procedure in their respective configuration tables.

Handling Disabled Delete Button or Error Messages

If the Delete button is disabled or an error message appears, the object is still in use somewhere in the solution.

In this case, it's necessary to locate and remove its references, so you can then delete the object. 

Finding and Removing Object References

  1. Search: Click the Search icon on the main toolbar or open the Find Results panel.
  2. Type and Find: Enter the object name to search for its references. Example: Searching for Display.Logon shows all locations where Logon is used.
  3. Navigate and Remove: Double-click on the references in the Find Results table to navigate and remove them, either by deleting the configuration or replacing the object.

Final Deletion

  • After removing all references, return to the main definition table and delete the object.
  • Alternatively, delete it from the Unused Objects table.

In this section:

Page Tree
root@parent
spacesV10