ro.sync.ecss.extensions.api.webapp.review

Interface ReviewController

All Superinterfaces:

AuthorChangeTrackingController, AuthorReviewerNameController, ChangeTrackingController

@API(type=NOT_EXTENDABLE,
     src=PUBLIC)
public interface ReviewController
extends AuthorChangeTrackingController, AuthorReviewerNameController

Provides support for marker related actions (accept/reject tracked changes, add/edit comments, edit author name etc.).

Method Summary

Modifier and Type	Method and Description
void	addComment(int startOffset, int endOffset, java.lang.String comment) Adds a comment marker at given offsets.
void	addReply(java.lang.String replyComment, AuthorPersistentHighlight parentHighlight) Adds a reply to the specified highlight.
void	editComment(AuthorPersistentHighlight highlight, java.lang.String newComment) Edits the comment of a marker (comment and tracked change).
java.util.List<AuthorPersistentHighlight>	getAllHighlights()
java.lang.Integer	getAuthorNumber(java.lang.String author)
void	removeComment(AuthorPersistentHighlight highlight) Removes a comment marker.
void	toggleMarkAsDone(AuthorPersistentHighlight highlight) Toggle the "done" state of the specified highlight.

Methods inherited from interface ro.sync.ecss.extensions.api.ChangeTrackingController

accept, accept, getAttributeChangeHighlights, getChangeHighlights, getChangeHighlights, isTrackingChanges, reject, reject, toggleTrackChanges

Methods inherited from interface ro.sync.ecss.extensions.api.AuthorReviewerNameController

getReviewerAuthorName, setReviewerAuthorName

Method Detail

toggleMarkAsDone

void toggleMarkAsDone(AuthorPersistentHighlight highlight)

Toggle the "done" state of the specified highlight. This state is also applied to all its replies. The highlight can one of the following types:

1. AuthorPersistentHighlight.PersistentHighlightType.CHANGE_INSERT
2. AuthorPersistentHighlight.PersistentHighlightType.CHANGE_DELETE
3. AuthorPersistentHighlight.PersistentHighlightType.COMMENT

For other types, this method does nothing.

Parameters:

highlight - The highlight to toggle the done state for.

Since:

18

*********************************
EXPERIMENTAL - Subject to change
********************************

Please note that this API is not marked as final and it can change in one of the next versions of the application. If you have suggestions, comments about it, please let us know.

addReply

void addReply(java.lang.String replyComment,
              AuthorPersistentHighlight parentHighlight)

Adds a reply to the specified highlight. The parent highlight can one of the following types:

1. AuthorPersistentHighlight.PersistentHighlightType.CHANGE_INSERT
2. AuthorPersistentHighlight.PersistentHighlightType.CHANGE_DELETE
3. AuthorPersistentHighlight.PersistentHighlightType.COMMENT

For other types, this method does not insert any reply or comment.
When the first reply is added to a highlight, a new property is set to this highlight: AuthorPersistentHighlightConstants.COMMENT_ID. All its replies will have the AuthorPersistentHighlightConstants.COMMENT_PARENT_ID property set, with the same value as the id of the parent.

Parameters:

replyComment - The reply comment.

parentHighlight - The parent highlight.

Since:

18

*********************************
EXPERIMENTAL - Subject to change
********************************

Please note that this API is not marked as final and it can change in one of the next versions of the application. If you have suggestions, comments about it, please let us know.

addComment

void addComment(int startOffset,
                int endOffset,
                java.lang.String comment)

Adds a comment marker at given offsets.

Parameters:

startOffset - The start offset of the marker (inclusive).

endOffset - The end offset of the marker (exclusive).

comment - The comment of the marker.

removeComment

void removeComment(AuthorPersistentHighlight highlight)

Removes a comment marker.

Parameters:

highlight - The comment marker.

editComment

void editComment(AuthorPersistentHighlight highlight,
                 java.lang.String newComment)

Edits the comment of a marker (comment and tracked change).

Parameters:

highlight - The marker.

newComment - The new comment.

getAllHighlights

java.util.List<AuthorPersistentHighlight> getAllHighlights()

Returns:

An array with all highlights.

getAuthorNumber

java.lang.Integer getAuthorNumber(java.lang.String author)

Parameters:

author - The name of the author.

Returns:

A number representing the author number.