User Help > Grouping Files Under Version Control > Locating Where a Configuration Management Object Is Used
 
Locating Where a Configuration Management Object Is Used
CLI EQUIVALENT 
si locate
As configuration management projects grow in complexity, it can be difficult to determine the relationships that Integrity Lifecycle Manager objects—projects, subprojects, and members—have with one another. Using the Locate command, you can locate where a specific Integrity Lifecycle Manager object is used in your configuration management repository. The search results appear in a Locate view, that allows you to refine and sort the results, view each located object in greater detail, and perform basic operations on them, such as viewing members.
When working with multiple development paths and shared subprojects or shared member archives, it becomes important to understand what areas of a project might be affected by parallel development. For example, you might need to:
determine what active projects a selected member, subproject, or registered top-level project is shared with. Active projects are projects that are currently under development.
determine what development paths a selected member or subproject belongs to
determine if a selected member revision is part of a checkpoint
confirm all existing checkpoints for a selected revision before you delete it
display the development path that a corresponding member revision belongs to
display which master projects a selected subproject belongs to
Operation
Procedure
To locate where a project is used
Select a project, then select Project > Locate
To locate where a subproject is used
Select a project, then select Project > Subproject > Locate
To locate where a member is used
Select a member, then select Member > Locate
To locate where a revision is used
Select a revision, then select Member > Revision > Locate
To locate where a subproject is used by searching by subproject name
Select a project, then select Project > Subproject > Locate By Name
To locate where a member is used by searching by member name
Select a member, then select Member > Locate By Name
If you are searching for a member or subproject by name, You can specify the maximum number of results to display. The number of results displayed is also controlled by the server limit, which is set at 5000 by default. Administrators can change the default limit. If the number of objects that match the search criteria exceeds the set limit, Integrity Lifecycle Manager displays the following message at the bottom of the Locate view: Showing <set limit> of <total number of objects>.
Key Considerations
You require the OpenProject permission for the project you are running the Locate command from. When the Locate view displays, Integrity Lifecycle Manager informs you if there are additional projects that you do not have permission to view.
Archive locations do not display in the Locate view.
Objects in development paths that have been removed do not display in the Locate view.
Locate Options
Locate View