Track Changes in a Document
The functionality of track changes, also known as reviewing, allows you to track changes to content and formatting made by you or other users. This track changes feature with Aspose.Words supports track changes in Microsoft Word. With this functionality, you can access individual revisions in your document and apply different properties to them.
When you enable the track changes feature, all inserted, deleted, and modified elements of the document will be visually highlighted with information about by whom, when, and what was changed. Objects that carry the information about what was changed are called “tracking changes”. For example, assume that you want to review a document and make important changes – this may mean that you need to make revisions. Also, you may need to insert comments to discuss some of the changes. That is where tracking changes in documents come in.
This article explains how to manage and track changes created by many reviewers on the same document, as well as the properties for tracking changes.
What Is a Revision
Before diving into revisions, let’s explain the meaning of revisions. A Revision is a change that occurs in one node of a document while a revision group, represented by the RevisionGroup class, is a group of sequential revisions that occur in many nodes of a document. Basically, revision is a tool for tracking changes.
Revisions are used in the tracking changes feature and within the compare documents feature, where revisions appear as a result of comparison. So, revisions within the tracking changes feature show by whom and what was changed.
Aspose.Words supports different revision types, as well as in Microsoft Word, such as Insertion, Deletion, FormatChange, StyleDefinitionChange, and Moving. All revision types are represented with the RevisionType enumeration.
Start and Stop Tracking Changes
Editing a document usually does not count as a revision until you begin tracking it. Aspose.Words allows you to automatically track all changes in your document with simple steps. You can easily start the process of tracking changes by using the start_track_revisions method. If you need to stop the process of tracking changes so that any future edits are not considered revisions, you will need to use the stop_track_revisions method.
At the end of the tracking changes process in your document, you will have the ability to even accept all revisions or reject them to revert the document to its original form. This can be achieved by either using the accept_all_revisions or reject_all method. In addition, you can accept or reject each revision separately by using the accept or reject method.
All changes will be tracked for one iteration from the moment you start the process to the moment you stop it. The connection between different iterations is represented as the following scenario: you complete the tracking process, then make some changes, and start tracking changes again. With this scenario, all changes that you did not accept or reject will be displayed again.
The following code example shows how to work with tracking changes:
The following code example shows how revisions are generated when a node is moved within a tracked document:
Manage and Store Changes as Revisions
With the previous tracking changes feature, you can understand which changes were made in your document and who made those changes. While with the track_revisions feature, you force any changes within your document to be stored as revisions.
Aspose.Words allows you to check if a document has a revision or not by using the has_revision property. If you do not need to automatically track the changes in your document through the start_track_revisions and stop_track_revisions methods, then you can use the TrackRevisions property to check if the changes are tracked while editing a document in Microsoft Word and stored as revisions.
The track_revisions feature makes revisions instead of real DOM changes. But the revisions themselves are separate. For example, If you delete any paragraph, Aspose.Words make it as a revision, marking it as deletion, instead of deleting it.
In addition, Aspose.Words allows you to check if an object was inserted, deleted, or changed formatting using the is_delete_revision, is_format_revision, is_insert_revision, is_move_from_revision, and is_move_to_revision properties.
The following code example shows how to apply different properties with revisions: