If your organization has depots containing thousands of streams, the stream filter 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 shown in the StreamBrowser to the
stream path 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 StreamBrowser.
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 stream is part of the stream filter if its checkbox is selected in the list shown in this dialog.
After making your selections, click Ok to filter streams in the AccuRev GUI.
Note: Stream filters are applied first to the data displayed in the Stream Browser. Any use of the display controls in the StreamBrowser is applied to the filtered set of streams. Occasionally, the interaction between these two sets of controls may produce a "surprising" result. For example, if the stream filter contains only one user's workspaces, and the Workspaces drop-down list is set to show another user's workspaces, the (correct) result is a StreamBrowser showing only the root stream. If your stream filter does not produce the expected display in the Stream Browser, remember to check the display controls to verify that these local settings are not affecting the outcome.
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.
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, the StreamBrowser display (and lists of streams in the GUI) will reflect that change.
In the StreamBrowser, there are two methods of quickly filtering the stream display: