4. The StreamBrowser : Using Stream Favorites

Using Stream Favorites
A Stream Favorite is a way to limit the stream hierarchy shown in the StreamBrowser to the stream path of a specific stream and all its children. If your organization has depots containing thousands of streams, Stream Favorites is a powerful tool to improve system performance and focus attention on just the streams you're interested in.
Note: Although you create and apply Stream Favorites in the StreamBrowser, their use affects the display of streams throughout the AccuRev GUI. Any list of streams available in the GUI will contain only the subset of streams shown in the StreamBrowser.
Stream Favorites and Stream Filters
Prior to AccuRev Version 5.5, Stream Favorites were called stream filters. The idea behind them -- to provide a handy way to create different views of the streams in your depot -- is the same, but there are a few important differences:
If you are upgrading from AccuRev Version 5.4.1 or earlier, AccuRev automatically converts existing stream filters to Stream Favorites.
Stream Favorites and StreamBrowser Display Filters
When AccuRev displays streams in the StreamBrowser, it applies Stream Favorites first. Any display controls in the StreamBrowser are then applied to the filtered set of streams. Occasionally, the interaction between Stream Favorites and display controls might produce an unexpected result. For example, if you have selected the Only stream paths to workspaces checkbox at the bottom of the StreamBrowser, only those paths that lead to workspaces will be displayed, even if the current Stream Favorite includes streams that do not lead to workspaces. If your Stream Filter does not produce the expected display in the StreamBrowser, remember to check the display controls to verify that these local settings are not affecting the outcome.
Creating a Stream Favorite
To create a Stream Favorite:
1.
The Stream Favorites panel appears.
2.
Click the New button.
The Create Stream Favorite dialog box appears.
3.
In the Name field, enter the name for the Stream Favorite.
4.
By default, Stream Favorites are private -- that is, the Stream Favorite you create can be used only by you. If you want to be able to share your Stream Favorite with others, click the Public radio button.
5.
Note: By default, AccuRev searches the depot for any streams that contain the string you enter, but you can change that to matches, starts with, or ends with. The search field is case-sensitive -- searching on, say, AccuRev and accurev will yield different results.
6.
AccuRev displays the streams that match your search criteria in the Search Results list box.
7.
Use the Add and Add All buttons to choose the streams you want to mark as favorites.
Tip: You can use Shift+ and Ctrl+ click to select more than one stream at a time.
8.
9.
10.
When you have finished choosing streams, click Ok to create the Stream Favorite.
The new Stream Favorite appears in the Stream Favorites panel under the My Favorites folder.
Tip: Private Stream Favorites are displayed with a simple star icon (). Public Stream Favorites are displayed with the star icon against a blue background ().
11.
Working with Stream Favorites
This section describes common procedures used with Stream Favorites.
Applying a Stream Favorite
To apply a Stream Favorite, double-click it.
In addition to changing the StreamBrowser display itself, AccuRev shows information about the current Stream Favorite in two places:
The Showing Stream Favorite field at the top of the StreamBrowser identifies which Stream Favorite is active.
The Number of favorite streams field at the bottom of the StreamBrowser indicates how many streams were specified as favorites in the current Stream Favorite.
Clearing a Stream Favorite from the StreamBrowser
To clear a Stream Favorite, click the Show All Streams button at the bottom of the Stream Favorites panel.
Depending on the size and complexity of your stream hierarchy, showing all streams can take a long time. AccuRev displays an informational message, which gives you the chance to cancel the operation.
Tip: If you check the Do not show this again check box, you can restore this dialog box by clearing the Skip "Show All Streams" checkbox on the General tab of the AccuRev Preferences dialog box (Tools > Preferences).
Editing a Stream Favorite
You can make the following changes to a Stream Favorite:
To edit a Stream Favorite:
1.
The Edit Stream Favorite dialog box appears.
2.
3.
Deleting a Stream Favorite
When you delete a Stream Favorite that you created as a public Stream Favorite, it will no longer be available to any users who might have added it to their Stream Favorites panel.
To delete a Stream Favorite:
Getting Others’ Stream Favorites
In addition to creating your own Stream Favorites, you can add Stream Favorites created by other users to your Stream Favorites panel. To be accessible to you, they must have been created as public, and not private, Stream Favorites. If the author of a public favorite you have added to your Stream Favorites panel later deletes that favorite, it will no longer appear on your Stream Favorites panel.
Note: When you add a user, you get all of that user’s public favorites.
To add others’ Stream Favorites to your Stream Favorites panel:
1.
2.
The Add Other Users’ Public Favorites dialog box appears.
3.
Tip: Use Crtl+ and Shift+ click to select multiple users at the same time.
4.
Click Ok.
The users you selected appear in the Public Favorites folder.
5.
Removing Other Users’s Stream Favorites
To remove another user’s Stream Favorites from the Public Favorites folder in your Stream Favorites panel:
The user, and all of that user’s favorites, is removed from the Public Favorites list in your Stream Favorites panel.

AccuRev, Inc.
Phone: 781-861-8700
Fax: 781-861-8704
support@accurev.com