User Help > Managing Source Files as Members > Filtering a Member or Project History in the GUI
Filtering a Member or Project History in the GUI
You can use the revision filter in the GUI to display any revisions of the selected member or project that meet specified selection criteria. You can change the filter by selecting View > Change Filter. This allows you to display a specific group of revisions for a member or project that might have hundreds or thousands of revisions. Revisions selected with this command can be manipulated as a group by other Windchill RV&S commands. You can apply filters to a member or project history in either the graphical history view or the list view.
Even with filtering, the number of revisions displayed can be too large to work with. By default, a maximum of 200 trunk revisions are displayed (the revisions branched from these trunk revisions are also displayed). You can change the maximum by selecting View > Maximum trunk revisions. The number of revisions displayed is calculated based on the number of visible mainline revisions; branched revisions are not included in the count.
For example, specifying the range of branched revisions to might return a results screen with 4000 branched revisions of the form 1.14.x.x.x.x. The 200 trunk revision display maximum is not reached because all of the branched revisions are for the single trunk revision 1.14.
If you limit the number of revisions to display and the maximum has been reached, a banner displays at the top of the view indicating the number of revisions displayed.
By default, checkpoints for development paths that have been deactivated are not shown. To view these checkpoints, select View > Show Inactive Development Paths. Inactive development paths are shown with “[Inactive]” at the end of the development path name.
This filtering is not available in the Web client. All checkpoints are shown.
Selecting Filter Criteria
You choose the selection criteria you want to use by selecting one or more check boxes in the Filter Revisions dialog box, specifying filter values where required.
To invert a filter, click the filter a second time and the ! symbol displays. You would invert a filter if you wanted to display, for example, revisions that are not locked.
If you choose more than one selection criteria, select whether the criteria should be combined using a Logical AND or a LogicalOR.
All Revisions
All revisions of the selected member (no filter).
You cannot use the All Revisions filter in combination with other filters. Selecting the All Revisions filter deactivates other filters.
In Development path
Project checkpoints that are on the specified development path. This option does not display for member histories.
On Branch
Revisions that are on the specified branch.
In Range
Revisions that are in the specified revision number range. If required, you can enter just one end of the range. The range includes the low and high values.
Check the Include Subbranches option to include any branched revisions within the range.
Revision Date the Past
Revisions corresponding to a date in the past.
Revision Date in Time Range
Revisions that correspond to the specified time range. You can also specify one end of the range.
Labeled revisions
Revisions with labels. If a label is specified, only revisions with that label are displayed. If no label is specified, all labeled revisions are displayed.
With Label like
Revisions with labels similar to the specified label. Recently used terms can be selected from the drop-down list. Wildcards such as * and ? are supported.
Locked By
Revisions that are locked. If a user is specified, only revisions locked by that user are displayed. If no user is specified, all locked revisions are displayed. This option does not display for project histories.
Lock Type
Revisions locked with the specified type of lock.
At State
Revisions at the specified state. States are defined by your administrator.
By Author
Revisions created by the specified author. You can choose yourself by selecting your name or -Me- from the user list.
Pending Revisions
Revisions that are pending.
Special Revisions
Member and working revisions.
Branch Boundaries
Revisions that are branched, or at the base or tip of a branch.