5. The History Browser

5. The History Browser
The History Browser displays some or all of the transactions associated with a particular element, stream, or depot. In addition to viewing information about a transaction and the versions involved in it, you can perform operations on the individual versions (View, Diff, etc.) and on the transaction's set of versions (Promote, Revert).
Opening a History Browser Tab
There are several ways to launch the History Browser:
You can have the History Browser display the transactions in which one particular element was involved. (Other elements may have been involved in these transactions, too.) Elements are listed in various places in the GUI:
In any of these contexts, you can select an element and click the Show History toolbar button. Alternatively, right-click an element and select History > Show History from the context menu.
You can have the History Browser display transactions that affected a particular stream. For a workspace stream, this principally includes the keep transactions that create real versions in the stream. It can also include co, move, defunct, and undefunct transactions. For a dynamic stream, this includes promote transactions to the stream, but not promotions from the stream.
In the StreamBrowser, right-click a stream and select Show History from the context menu.
Every stream has a default group, consisting of the elements that are active in that stream. In the Stream Browser, a stream's context menu includes the command Show Active Transactions; it opens a History Browser tab and loads the set of transactions (Keep, Promote, etc.) in which the stream's active versions were created.
You can view the transactions for an entire depot -- all the elements, in all the streams. Use the Admin > Depots command to list all of the repository's depots. Then, select a depot and choose Show History from its context menu, or from the Actions group in the main menu.
In the Version Browser, selecting Show History from any version's context menu displays the transaction in which that particular version was created.
If you have used AccuWork to promote files (see Transaction-Level Integration between AccuRev and AccuWork on page 331), an issue record's affectedFiles field contains a list of transaction numbers. Click the Show History button next to this field to display just those listed transactions.
History Browser Tab Layout
The History Browser appears in a separate tab of the AccuRev GUI's multiple-tab display. The tab is divided into three panes:
The Summary Pane displays a group of transactions, one per line. This pane displays overall information: transaction number, timestamp, transaction type, etc.
The Comment Pane shows the comment string, if any, that was specified for the currently-selected transaction.
The Versions Pane shows all the versions that were involved in the currently-selected transaction. It also indicates which change packages , if any, those versions belong to (Issues column).
The Summary Pane
The summary pane displays a table containing a set of transactions, one per row. Each row of the summary pane's table displays the following information about an individual transaction:
Time
A timestamp, indicating when the transaction took place.
Action
The kind of transaction: keep, promote, etc.
User
The principal-name of the user who initiated the transaction.
# (transaction number)
The unique number (within this depot) of the transaction.
Version
(only for transactions involving an individual element) The real version or virtual version of the element that was created in this transaction. This column doesn't appear in displays of a stream's history or an entire depot's history; the version(s) created by the transaction appear in the Versions pane.
Comment
The first line of the user-supplied comment for this transaction. If the comment extends to additional lines, an ellipsis ("dot dot dot") appears here. For the full text of the comment, look in the Comment pane.

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