Global element usage search

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

To find element usages

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.