Description

Use this command to create a new comment on a review. You can specify various options to control the type and location where the comment is created.

Annotation: --annotation

Overall: (default - no extra options necessary)

Label: --label <label>

Line: --line-number <number>

Coordinate: --page <number> --x <number> --y <number>

Cell: --cell <cell reference>

To specify an existing conversation in a file, it is best to specify --conversation-id <id> to disambiguate situations where there is more than one conversation at a particular location.

To learn about different types of comments, see Types of Review Comments and Defects.

Command Line Syntax:

ccollab [global-options] admin review comment create [--annotation --cell <value>] [--conversation-id <value>] [--label <value>] [--line-number <value>] [--page <value> --x <value> --y <value>] [--file <value>] [--version <value>] <review> <comment>

Command Options

Examples:

To create a comment in the overall section of review #123:

ccollab admin review comment create 123 "overall review comment"

To create an annotation comment for the "foobar.c" file in the review #345:

ccollab admin review comment create 345 --file "foobar.c" --annotation "ignore this file"

To create a comment at certain coordinates on first page of the "picture.png" file in the review #567:

ccollab admin review comment create 567 --file "picture.png" --page 1 --x 35 --y 56 "at this point"

To create a comment at certain cell of the "results.xls" file in the review #789:

ccollab admin review comment create 789 --file "results.xls" --cell "'Sheet 1'!G17" "This data seems unlikely"

To create a comment on a line 36 of a file version with ID 789 in the review #1000:

ccollab admin review comment create 1000 --version 789 --line-number 36 "I like this line"