Locating Where a Configuration Management Object Is Used
As configuration management projects grow in complexity, it can be difficult to determine the relationships that PTC RV&S objects—projects, subprojects, and members—have with one another. Using the Locate command, you can locate where a specific PTC RV&S 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 >
|
|
To locate where a subproject is used
|
Select a project, then select > >
|
|
To locate where a member is used
|
Select a member, then select >
|
|
To locate where a revision is used
|
Select a revision, then select > >
|
|
To locate where a subproject is used by searching by subproject name
|
Select a project, then select > >
|
|
To locate where a member is used by searching by member name
|
Select a member, then select >
|
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, PTC RV&S 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, PTC RV&S 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.
Related Topics