Like any other wiki, the Audit Trail in Traction TeamPage includes Edit History, but goes much further. Like an accounting journal, the Traction Journal records every change made to the system, even cases where labels are added to an article and where articles are e-mailed from Traction. The audit trail includes a full trail of all articles posted as well as all article edits, comments, addition or removal of labels from an article, emails sent out, page name additions and removals, moderation events and other activities.
What Can You Learn from the Audit Trail?
For record keepers, the audit trail provides an exceptionally deep and useful view of article (and comment) history.
For users, the audit trail can help answer questions like:
"Who removed the requirement labeland when did they do that?"
"Who tagged this feature with the done label?"
"Was this e-mailed to the customer before or after the last edit?"
"Was the third comment made before the Priority 1 label was tagged to this article?"
"Which version of this article was Published when the 2nd comment was made?"
"When was a particular Page Name added or removed?"
Looking beyond the history of a single article, its also possible to query Traction for certain types of events in the audit trail. For example, you can discover "What features were tagged with the Done label last week?" The results will display the articles where that happened, even if that Done label was since removed (such that it is no longer present on the article).
Attachments may also have an edit history. Attachments are maintained in the WebDAV (Web Distributed Authoring and Versioning) document store and may be versioned selectively or you can set mandatory versioning in projects.
History and Cross Reference Views
To explain the History and Cross Reference views, we can take a look at the article titled TIP Editor, and then take a look at its history and cross-reference map.
You can see that the article currently has 5 labels (Done, Feature, P3, V2, and Feedback from StarCustomer project), 2 comments on a paragraph, 1 comment on an article, and 3 Page Names (TIP Editor and Instant Publisher in this project and a global name TIP). In the Related Articles area, you can also see this Article was e-mailed twice, references 1 article and is referenced by 2 other articles.
When you click the History tab, you see breakout sections for Edit, Moderation, Name and Label History. These breakouts are followed by a Complete History that opens up the interleaved history of all types of actions that have occurred.
When you click on Show Reference Map, you see a map view showing history (left to right) of all actions and relationships.
For example, starting at the first bubble on the Updates line, you can see that it was edited (updates) and then it was emailed 2 times (emails), then labels were changed (changes labels) then 2 comments (comments on) came in before it was edited (updates) again.
Clicking View All takes you to a vertical time history view with more detail, including the date of the event, the user, and, in the cases of Changes Labels On, the actual label change action (added P3, removed P1). Here is an image of the slice that is narrated above:
Any of the items in the view can be clicked to get even more detail about what happened.
Perspective Views
Perspective views are a very powerful way to examine history of label changes.
With Perspective views, it's possible to look at Traction with the label set as it was based on any time period or perspective. So you can answer questions like:
"What articles were marked Done in the Engineering project last week?" or
"What Issues were labeled To Do and Priority 3 as of June of 2005?"
Perspective views also come in handy if you change do a batch label change because your terms have changed (e.g. change the label Weblog to the label Blog) but at some point later you want to see how the content was organized, rather than how it is organized. See Changing Perspective for more information on how these views work and how to use Rapid Selector to enter a perspective view.
