4. The StreamBrowser : The Stream Issues and Stream Diff (Issues) Tabs

The Stream Issues and Stream Diff (Issues) Tabs
The Stream Issues and Stream Diff (Issues) tabs are essentially similar. A table in the Issues pane (upper) displays the issue records that are in a particular stream. The Change Package Contents pane (lower) displays the entries in a selected issue record's change package.
Note: Terminology -- issues "in" a stream
Strictly speaking, the only objects that are "in" a stream are versions. It makes sense to describe a set of versions as being "in" a stream. And so, it makes sense to describe the set of versions in a change package as being "in" a stream. From there, we make the leap to describing the AccuWork issue record containing the change package as being "in" a stream.
Opening the Tab
To open a Stream Issues tab, showing the contents of a stream in terms of change packages: choose Show Active Issues from the context menu of any stream, or snapshot, or workspace in the StreamBrowser. Note: If the StreamBrowser is displaying development activity by issue record, you can click the icon under the stream itself to open a subwindow containing the same data as a separate Stream Issues tab.
1.
2.
Choose the Show Diff by Issues command from the selection's context menu, or click the button on the StreamBrowser's toolbar.
3.
Stream Issues Tab Layout
The Stream Issues tab includes two panes, each with its own toolbar:
The Issues pane displays selected fields from the issue records whose change packages are "in the stream"— partially or completely. (To get here, use the Admin> Schema Editor command to open a Schema Editor tab. Go to the Change Packages subtab, and select fields to be displayed in the upper Change Package Results pane).When you're comparing the contents of two streams, this pane displays the issues whose change packages are in one stream, but not the other.
The Change Package Contents pane displays the entries in the change package of the currently selected issue record.
Working in the Issues Pane
You can control which issues are displayed, and you can invoke commands on one or more issues' change packages.
Controlling Which Issues are Displayed
Checkboxes at the bottom of the Issues pane control which issues are displayed. The Show Active, Include Incomplete Issues, and Include Hierarchy checkboxes appear only when you're displaying a single stream's change packages. (When comparing streams, AccuRev always proceeds as if these checkboxes are cleared.) The Bidirectional checkbox appears only when you're comparing two streams.
Show Active
If checked, an issue is included only if one or more of its versions was promoted to the stream, but has not yet been promoted from the stream to its parent. This helps you to concentrate on current programming efforts, rather than those that were completed long ago.
Note: For the purposes of the Show Active filter, a Revert to Backed operation has the same effect as a Promote operation. For a workspace, substitute the phrase "created in" for "promoted to".
Include Incomplete Issues
If cleared, the listing includes only issues that are completely in the stream, where “completely in” means that for every change package entry, the head version (Version column) itself is in the stream, or one of its descendants is in the stream.
If checked, the listing includes all issues, including ones that are partially in the stream, where “partially in” means that for some but not all change package entries, the head version (Version column) itself is in the stream, or one of its descendants is in the stream.
On the Change Package Contents pane, the Status column and background shading indicate which change package entries are "in" the stream and which are not in ("missing" from) the stream.
Include Hierarchy
(available only if Show Active is checked) If checked, also includes issues that are in the streams below the selected stream.
Bidirectional
(Stream Diff only) If cleared, the Issues pane displays the issue records in the first stream ("source"), but not in the second stream ("destination").
If checked, the listing also displays the issues that are in the second stream, but not in the first stream. Color-shading helps you to distinguish the two sets of change packages.
Commands Available in the Issues Pane
Select one or more issues to invoke commands on the issues, or on their change packages.
These commands are available through context menus and in the toolbar of the issues pane.
Open Issue
Open an edit form on the selected issue, and display the Changes tab.
Promote Issue(s)
Stream Issues tab (enabled only if Show Active is set and Show Incomplete is cleared): promotes each currently-active head version in the issue's change package to the parent stream. That is, if a version listed in the Version column is currently active in the stream on which you invoked the Show Issues command, that version is promoted to the parent stream.
Example:
The following illustration shows the Stream Issues tab for dynamic stream plum12_dvt.
Invoking the Promote command on issue #7 causes some or all these versions to be promoted. The versions promoted are the ones that are currently in the workspace's default group:
Stream Diff (Issues) tab (works only for issues in the source stream, not for issues in the destination stream): promotes each currently-active head version in the issue's change package from the source stream to the destination stream. If there is an overlap between the two streams for any element, the promote operation fails with a "merge required" error box.
Send to Change Palette
(enabled only if Show Active is set and Show Incomplete is cleared) Opens a Change Palette tab, containing each head version in the issue's change package.
Send to Issue
Adds (or combines) the selected issue record's change package entries with those of one or more other issue records. A popup window prompts you to specify the destination issue record(s).
Revert Change Package
(Formerly named Revert by Change Package.) Removes the changes in the selected issue's change package from the stream. A dialog appears offering you two options for performing this operation:
In reverse order, these options are:
Use a workspace to peform revert — Choose this option if you wish to test the results of the revert before promoting them back into the stream. You must choose a workspace to which you have access to perform the revert. (All workspace appear in the selection list. If you select a workspace to which you do not have access, AccuRev will display an error). The revert operation typically involves one or more reverse patch operations on file elements' contents, performed with the Merge tool.
Important: If no valid workspaces exist, this dialog is bypassed and you are prompted whether or not to proceed without a workspace (see below). A "valid" workspace is one of your own workspaces which has local (or accessible mounted) storage on the machine that the revert is being performed from. If none of your workspaces are attached to the stream the issue is being reverted from, or for some reason are not accessible from the machine that the client is running on, you can still proceed with the revert, keeping the new file versions directly in the stream. However, AccuRev warns you that this is what happening if you choose to proceed with the revert operation.
Note: This feature is not intended to be used within a workspace; it is meant to be executed within a stream, but with the aid of a workspace to perform any necessary Merge operations. If you try to execute this operation directly within a workspace, you will get an error message: "You need to have at least one workspace associated with stream..." Try the following workaround:
1. Create a new stream between the workspace and its backing stream.
2. Promote the issue to the new stream.
3. Invoke the Revert Change Package Using Workspace command on that issue in the new stream.
Continue revert operation without using a workspace — Similar to Use a workspace to peform revert, except that the results are placed directly in the stream, without the requirement of a workspace. This means that the results of the revert will be immediately propagated downstream in the hierarchy.
AccuRev prompts you for an issue number against which to the record the Revert changes. Either create a new issue, or select an existing issue that you created specifically for this Revert. (You should rarely—if ever—select an existing issue that has been used for previous operations.) Then peform whatever merge changes are required by the revert.
Important: If no workspaces to which you have access exist, the dialog described above is bypassed and you are simply prompted whether or not to proceed without a workspace.
Note: Continue revert operation without using a workspace saves the step of merging and testing the revert in a workspace and then promoting the changes, but at the risk of propagating the changes as soon as the revert has been completed. This feature should not be used casually by developers, as you could easily propagate complex, untested changes to other users. This feature is useful for reverting relatively simple changes, or for backing out a change in an isolated build stream. AccuRev recommends that you build and test these changes in an updated workspace to verify the results, before promoting or cross-promoting the changes to other users.
Show Dependencies
Opens an Issue Dependencies tab, displaying the change package dependencies of the selected issue record(s).
Working in the Change Package Contents Pane
Select any change package entry and invoke any of the commands described below. In most cases, the operation is performed on the entry's head version (Version column). You can invoke the Remove and Send to Issue commands on a selection consisting of two or more change package entries.
Open (equivalent to double-click)
Windows: Run the appropriate command on the file, according to its file type. (The Windows file-typing system — "file associations" — does not provide for assigning a file type if the filename has no suffix.)
UNIX: Open a text editor on the file.
View
Open a text editor on a temporary copy of the currently selected version (text files only).
Save As
Copy the currently selected version to another filename.
Promote
Promote the head version(s) of the selected entry(s) to the parent stream.
Remove
Remove the selected entry(s) from the change package.
Diff Against Basis
Compare the selected version with the corresponding basis version.
Show History
Open a History Browser tab, containing the transactions involving the selected file or directory.
Browse Versions
Open a Version Browser tab, showing all the versions of the selected file or directory, and their interrelationships (ancestry).
Send to Issue
Copies the selected entry(s) to another issue record's change package. If there's an existing entry for an element in a destination change package, an attempt is made to combine the existing entry with the entry you specified.
The default query is executed, and the results are displayed in a dialog. You are prompted to choose one or more of the issue records selected by the query. You can also create a new issue record, whose number will be entered in the dialog.
Properties
Displays a message box with information about the selected element.

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