The global element usage search allows you to check the usages of elements within the Teamwork Cloud repository. This makes it easier to examine how deleting or modifying an element can impact the projects that use it. The following demo shows how this functionality works:



Prerequisites

  • You can only use the Global Element Usage Search feature if Elasticsearch is installed on the server.
  • You can investigate element usages only in projects that have been indexed.

  • Your web application platform URL must be entered in the environment options. If this URL is not added to the environment options, once you select Related Elements > Used by in Server, a window appears, prompting you to enter the web application platform URL.

The command is only available for the elements in an open (main) project. You cannot execute it if:

  • the selected element is from a Used Project
  • the selected element has not yet been committed to the server
  • multiple elements are selected

Searching for usages of single element

To find usages of a single element


  1. Do one of the following:
    • In the Containment tab, right-click an element and select Related Elements > Used by in Server.
    • On the diagram pane, right-click an element shape and select Related Elements > Used by in Server.

The element usage search results panel opens with a list of server projects that use the selected element:

Only the latest indexed branch versions are found. For example, if an element is used in the historical version but is no longer in use, it is not displayed in the element usage search results panel.

If you see a warning message (see below), it means that you do not have permission to read the project(s) using the element you performed the usage search for.

Press the Refresh button to see the latest information on element usage.


2. Select a project to see a list of project branches and versions that use the element.

Press Actions > Open project to open the specific project branch that uses the element.


3. To investigate element usage in more detail, select a specific branch. This shows usage details at the element level:

Searching for usages recursively