Version Browser Layout
The Version Browser display consists of two panes. The upper pane provides a graphical summary of element versions, where they exist in the stream and workspace structure, and the relationships between them. The lower pane provides a list of the involved streams, workspaces, and issues. (Note: Some screen shots may not reflect the latest Version Browser color scheme.)
Selections made in one pane are reflected in the other. Default behavior of the Version Browser is set in the Tool -> Preferences dialog box (see AccuRev Preferences (Tools > Preferences Command)).
Upper (Graphical) Pane
The borders of the graphical pane provide information or viewing functionality:
- The top border provides a time line for each transaction. Looking to see who created a version on a particular day? Adjust the time span as described below and scroll to the date of interest.
- The toolbar above the time line provides a variety of controls: use Show: to select from a predefined number of transactions to display in the Version Browser. This will adjust the time line depending on how long it took for that many transactions to occur — an active element that gets changed often might have multiple transactions in a single day, while a relatively static element might have only a few transactions over the course of multiple years. Alternatively, use the Date Range control to display everything between specific dates. The remaining controls provide information about selected versions. Mouse over the controls to display tool tip information about their purpose.
- The right border lists the streams and workspaces where versions reside. White labels indicate dynamic streams; light yellow indicate individual workspaces. Gold labels represent workspace groups, which make the version browser easier to view and navigate. To view the workspaces that belong to workspace group, either mouseover the group, or view individual workspaces in the tabular pane (see below) and examine any entries under the Groups column.
- The left and bottom borders contain scroll bars for navigating within the graphical pane. (You can also click and drag within the graphical pane to adjust the view.)
The main body of the graphical view displays the versions of the current element, the stream(s) where they exist, the AccuWork issue(s) related to the version, and the relationship between a version and its immediate predecessor.
- Each version is represented by a yellow box. The number in the box is the version number of the element in that particular stream at that particular time (as represented in the timeline along the upper border).
- The yellow box with a blue outline is the version in the workspace or stream from which you launched the Version Browser.
- Workspace versions associated with an issue have a box underneath them showing the issue number. If the version is associated with more than one issue, or if the issue number is too long to display, then the issue number will end with an ellipsis (...). The number that is displayed is either an AccuWork number or a Third Party ITS number, depending on how your installation is configured. To open the issue, double-click it, or right-click for the context menu.
- Issue numbers with a period and a number appended indicate issue variants, an automatically-generated variation of the main issue that AccuRev uses to track merges, patches, and reverts. You generally do not need to concern yourself with variants, but if you would like to understand how they work, see Variants. If an issue number display includes ellipses (...), mouse over the box to display the list of issues.
- When you mouse over a version box, the tool tip for the version box displays information about the creation of the version: the transaction number and timestamp, the action (keep, promote, etc.), the stream name and version number of the current version and of the “real” version, as well as any comments that were entered at the time of the transaction. Note that in the case of alias versions (see below) the “current” version number in the tool tip is the same as the version in the yellow box, and the second version number in the tool tip reflects the real version, which differs from the version number displayed in the yellow box.
- The color-coded ancestry lines connecting the versions indicate how the later version was derived from the earlier version.
Lower (Tabular) Pane
The bottom half of the version browser displays in a table only stream and issue details that are relevant in the upper graphical pane. You can focus on either Streams & Workspaces or Issues by selecting the appropriate tab.
Streams & Workspaces Tab
- To highlight the versions associated with a particular stream or workspace in the upper pane, select that stream or workspace entry in the table in the lower pane. If a workspace is collapsed into one or more workspace groups in the upper pane, the versions in those workspace groups will be highlighted.
- To limit the display of streams and workspaces to those with names that include specific text, enter that text string in the Name filter.
- To limit the display of workspaces, select an option from the Filter Workspaces drop-down menu.
- To control the display of individual streams, use the checkboxes under the Show column, then click the Refresh button. Note: You cannot turn off the display of workspaces or workspace groups from the checkboxes. Use the Filter Workspaces control instead. You also cannot turn off the display of dynamic streams that contain real versions, such as those where a direct revert operation was performed. Streams and workspaces that cannot be hidden are always checked and cannot be unchecked.
- To identify which workspace group(s) a workspace belongs to (if any), look for a number in the “Groups” column.
- When stream labels are selected on the right of the top, graphical pane, they will highlight the corresponding rows in the Streams and Workspaces tab.
- If a single line is selected, then the context menu works exactly like it does on a stream label or a single workspace label. (The context menu would have no meaning on a workspace group.)
- Select an issue’s entry in the table to highlight the versions associated with that issue in the upper pane.
- Double-click or right-click an issue to open its Edit Form.