Filter Streams
(Tools > Filter > Streams Command)
You can invoke this command in any of these ways:
Choose Tools > Filter > Streams from the GUI main menu.
Click the Filter Streams button on the GUI main toolbar.
You also have the option to bypass the dialog and add or remove streams directly from the Stream Browser's context menu. See the Quick Filtering Options, below, for more information.
If your organization has depots containing thousands of streams, the stream filter The set of streams whose stream paths and children are visible in the AccuRev GUI. is a powerful tool to improve system performance and focus attention on just the streams you're interested in.
Adding a stream to the filter will limit the stream hierarchy The tree-structured collection of streams -- including snapshots and workspace streams -- for a particular depot. shown in the Stream Browser to the stream path A subset of the stream hierarchy that starts at the root stream and ends at the stream being referenced. of that stream and all its children. Also, any list of streams available in the GUI will contain only the subset of streams shown in the Stream Browser.
The Filter Streams command allows you to restrict the total number of streams displayed in the AccuRev GUI. When you invoke the command, the Configure Stream Filter dialog shows a list of all the streams that you have chosen. You can use this dialog to keep a list of "interesting" streams, and to control which streams are part of the stream filter A subset of streams whose stream paths and children are visible in the AccuRev GUI.. A stream is part of the stream filter if its checkbox is selected in the list shown in this dialog.
You can use the dialog to:
Add more streams to the list
Remove streams from the list
Toggle the checkbox(es) next to one or more streams to indicate that they should be added to or removed from the stream filter. If you have many streams of interest, you may find it useful to use the Select All and Deselect All buttons to quickly make your selections.
After making your selections, click Ok to filter streams in the AccuRev GUI.
Notes (click to view):
You can add streams to the stream filter by clicking the Add to List button. The resulting dialog allows you to search in two ways for streams that you would like to add:
by stream name
by workspace
When the Results list contains the desired streams, select one or more and click Ok to add them to the stream filter A subset of streams whose stream paths and children are visible in the AccuRev GUI..
Notes (click to view):
Use the Name radio button to search by stream name. Stream name searches can be exact matches (using matching), or partial matches (using starting with, ending with, or containing). Once you have specified the item to search for, click the Search button or press Enter to see the resulting list of streams in the Results list.
Use the Workspaces for radio button to search by workspace. Choose a user or group name from the drop-down list to see the list of those workspaces in the Results list.
Note that the users and groups available from the drop-down list are limited by any user/group filters you have set.
You can remove streams from the list in the Configure Stream Filter dialog by selecting one or more streams and clicking the Remove from List button. Click the Ok button to save your changes.
This action only removes the streams from the list in the dialog; it does not apply the Remove command to the stream itself. If the stream you remove is part of the stream filter A subset of streams whose stream paths and children are visible in the AccuRev GUI., the Stream Browser display (and lists of streams in the GUI) will reflect that change.
In the Stream Browser, there are two methods of quickly filtering the stream display:
Add a stream directly to the stream filter. To do this, right-click on the stream, and choose the Add to Stream Filter option from the context menu that appears. This action will immediately apply the filter, causing the Stream Browser display to change, so if you have multiple streams to add to the filter, you may want to use theFilter Streams command instead.
Notes (click to view):
For a single user or group, show only the stream paths to that user's or group's workspaces. To do this, select a user or group from the Workspaces drop-down list at the bottom of the Stream Browser, then select the Only stream paths to workspaces checkbox. This option does not add the workspaces to the stream filter, nor does it restrict the display of streams anywhere but the Stream Browser; it is simply a shortcut display mechanism there.