The Review View

The Review view is a framework-independent panel, available both for built-in, and custom XML document frameworks. It is designed to offer an enhanced way of monitoring all the changes that you make to a document. This means you are able to view and control highlighted, commented, inserted, and deleted content, or even changes made to attributes, using a single view.

The Review view is useful when you are working with documents that contain large quantities of edits. The edits are presented in a compact form, in the order they appear in the document. Each edit is marked with a type-specific icon.

Figure: The Review View

To activate the Review view, do one of the following:

Click the Manage reviews button on the Review toolbar.
Right-click in a document and from the contextual menu go to Review, Manage reviews.
Go to Window > Show View > Review.

This view and the editing area are synchronized. When you select an edit listed in the Review view, its corresponding fragment of text is highlighted in the editing area and the reverse is also true. For example, when you place the cursor inside an area of text marked as inserted, its corresponding edit is selected in the list.

The upper part of the view contains a filtering area which allows you to search for specific edits. Use the small arrow symbol from the right side of the search field to display the search history. The Settings button allows you to:

Show highlights - controls whether the Review view displays the highlighting in your document.
Show comments - controls whether the Review view displays the comments in the document you are editing.
Show track changes - controls whether the Review view displays the inserted and deleted content in your document.
Show review time - displays the time when the edits from the Review view were made.

The following actions are available when you hover the edits in the Review view, using the cursor:

Remove: Action available for highlights and comments presented in the Review view. Use this action to remove these highlights or comments from your document;
Accept: Action available for inserted and deleted content presented in the Review view. Use this action to accept the changes in your document;
Reject: Action available for inserted and deleted content presented in the Review view. Use this action to reject the changes in your document.

Depending on the type of an edit, the following actions are available in its contextual menu in the Review view:

Show comment: This option is available in the contextual menu of changes not made by you and of any comment listed in the Review view. Use this option to view a comment in the Show comment dialog box.
Edit comment: This option is available in the contextual menu of your comments, listed in the Review view. Use this action to start editing the comment.
Remove comment: This option is available in the contextual menu of a comment listed in the Review view. Use this action to remove the selected comment.
Show only reviews by: This option is available in the contextual menu of any edit listed in the Review view. Use this action to keep visible only the edits of a certain author in the view.
Remove all comments: This option is available in the contextual menu of any comment listed in the Review view. Use this action to remove all the comments that appear in the edited document.
Change color: Opens a palette that allows you to choose a new color for the highlighted content.
Remove highlight: Removes the selected highlighting.
Remove highlights with the same color: Removes all the highlighting with the same color from the entire document.
Remove all highlights: Clears all the highlighting in your document.
Accept change: Accepts the selected change.
Reject change: Rejects the selected change.
Comment change: This option is available in the contextual menu of an insertion or deletion that you made. Use this option to open the Edit comment dialog box and comment the change you made.
Accept all changes: Accepts all the changes made to a document.
Reject all changes: Rejects all the changes made to a document.

To watch our video demonstration about the Review view, go to http://oxygenxml.com/demo/Review_Panel.html.