Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Comments allow review staff to provide applicants with feedback on their reviews, either pointing to issues that require resolution or simply providing guidance. Staff with permissions can add comments in EPR either directly onto a document page during their review or add project-level comments from the project’s COMMENTS tab.

...

The comment form allows users to add comment text and provide additional details to help organize comments within the letter that is returned to the applicant. This comment form can be moved around if necessary by grabbing it (anywhere except within the text and dropdown fields) and dragging it elsewhere in the Review page. Once saved, users will also have access to additional features such as adding attachments, viewing responses, or viewing the history logged for the comment.

...

Some dropdown values are required while others are optional, as indicated in the table below.

Dropdown

Description

Group *

Denotes user affiliation; often a discipline, division, department, or equivalent. Group should be preselected automatically and displays the Group you are representing. The Group cannot be changed or transferred to another Group.

Comment Disposition *

The comment status. New comments should display as “Open” (or equivalent agency label) and resolved comments should be updated to “Closed” (or agency equivalent). Closed comments will not appear on the deliverable PDF files or comment corrections reports returned to the customer.

Impact

Can be used to emphasize relative importance of a project comment. Available if your agency has configured values for this list.

Review Type

Can be used to denote a specific discipline affiliation for assignments when multiple assignments exist within a single Group for the same document. Available if your agency has configured values for this list.

Category

Can be used to organize a comment under a certain value so that it sorts with similar values in a comment report letter. Available if your agency has configured values for this list.

Subcategory

Can be used to organize a comment under a certain sub-value so that it sorts with similar sub-values in a comment report letter. Available if your agency has configured values for this list.

Assigned To

If your agency has adopted the process of “assigning comments” to inform another project team member that a reply is being requested, set the assignee (another project team member) here. They will be notified that a comment has been assigned to them. If not, you can safely ignore this field.

(* Indicates a required field.)

...

The comment pop-up also shows icons for additional comment tag features along the bottom.

Additional Comment Tag Features

Clicking on any of the shortcuts/icons along the bottom of the comment pop-up will…

Feature

Icon

Description

Notes

View Details / Edit

(blue star)

Click to open the Comment Form for viewing or editing.

When you reopen a saved comment it will now display four tabs: DETAILS, RESPONSES, ATTACHMENTS, and LOGS.

Close/Open

(blue star)

Click to quickly switch the comment disposition between the default “Open” and default “Closed” values configured by your agency.

To switch the comment disposition to values besides the two defaults, open the Comment Form and edit in the Disposition dropdown.

Reposition

(blue star)

Click to indicate you want to move the comment tag to a new location, then click elsewhere on the document page to move the tag to that spot.

You cannot click behind the existing comment tag when repositioning a comment.

Pin/Unpin

(blue star) / (blue star)

Click (blue star) to pin comment, which swaps the default comment tag with a comment box that displays comment number, group, reviewer name, and the full comment text directly on the page. This displays on the page in EPR and whenever the PDF is printed.

Click (blue star) to unpin comment, restoring it to a space-saving tag.

Pinned comments display on the document page in EPR as well as on the PDF whenever printed. Unpinned comments display as tags on the PDF and their full text is visible in the PDF viewer comment panel.

Reply to Comment / Response Disabled

(blue star) / (blue star)

Click (blue star) to enable responses to your comment.

Click (blue star) on a comment that has responses enabled to jump to the RESPONSES tab and add a response.

Turn off responses by opening the Comment Form and clicking on (blue star) from the Details tab.

This feature is designed for reviewers who are expecting direct feedback to their comments within EPR, such as those who have Contributors or use the ReviewSessionTM feature.

Attachments

(blue star)

Click (blue star) to jump to the ATTACHMENTS tab.

View existing attachments by clicking download ((blue star)) or add new, comment-specific attachments by clicking on add ((blue star)).

Unpublish/Publish

(blue star) / (blue star)

Click (blue star) to unpublish the comment, meaning only the creator and Admin accounts can see it. Unpublished comments will not appear on any reports or deliverables.

Click (blue star) to republish the comment, meaning all users can see it.

This feature is intended for users to hide (“unpublish”) comments that are only partially complete or that must be re-evaluated before sending them to an applicant.

Flag/Unflag

(blue star) / (blue star)

Click (blue star) to flag the comment as requiring greater attention by external Contributors. Click (blue star) to unflag.

This feature is usually used in conjunction with enabling responses.

Info

Response Enabled, Unpublish,and Flag are typically used when feedback from external sources (such as project owners, applicants, or even external team members) is necessary. 

...

Editing Comments

Comments can be edited by their creator or by other users with rights at any point after they are saved.

...

In addition to the original DETAILS tab, a saved comment will now include additional tabs for RESPONSES, ATTACHMENTS, and LOGS once reopened.

...

Tab

Description

DETAILS

Contains the comment text and other information that displays on the review page, the comment panel, the comments tab, and on all deliverables such as comment report letters and printed PDFs returned to applicants. Edit your comment in this tab.

RESPONSES

Displays the original comment followed by any responses to that comment. If the comment is updated, the updated version displays followed by any additional responses. To add a response ( (blue star) ), responses must be enabled by the comment creator or an Admin.

ATTACHMENTS

Allows users with rights to add attachments ( (blue star) ) to the comment for reference. These attachments are listed within this tab and will be returned to the applicant as additional files along with the marked-up documents at the end of the review.

LOGS

Displays an audit log of field-level edits made to the comment, including both comment text, disposition, and other dropdown values. Check the comment log to determine when a change happened or who performed the change.

Updating Comment Text

You can update your comment text at any time by editing it in the text field on the DETAILS tab. Users often decide to format text differently, change wording, or even insert standard comments into an existing comment. In some cases, you may want to update your comment after receiving responses from others to clarify meaning as well.

...

At any point during a review you can update your comment’s disposition as needed, either to a “Closed” (or equivalent) disposition if the applicant has already addressed the issue, or to another disposition if your Agency has others set up. There are two ways to update this disposition:

From the Comment Pop-up

From Inside the Comment Form

  1. Click on the tag ( (blue star) ).

  2. Click on Close/Open ( (blue star) ) at the bottom of the comment pop-up to switch from the current disposition to the other.

Info

This shortcut will only alternate between the default “Open” and default “Closed” dispositions. To switch to any other disposition you will need to open the comment form.

  1. Click on the tag ( (blue star) ).

  2. Click on View Details ( (blue star) ).

  3. In DETAILS, click the Comment Disposition dropdown and select the desired status.

  4. Click SAVE to confirm update and close the form.

Moving Comments

If you are not happy with the current location for your comment, you can move to a new location at any time. There are two ways to move a comment tag:

From the Comment Tag

From the Comment Pop-up

  1. Double-click on the tag ( (blue star) ).

  2. Click on a new location on the document page.

  1. Click on the tag ( (blue star) ).

  2. Click on Reposition ( (blue star) ).

  3. Click on a new location on the document page.

In either case, the comment tag will move to the new spot, even if you have the comment pinned open.

...

You can enable responses for a comment in two ways:

From the Comment Tag

From Inside the Comment Form

  1. Click on the tag ( (blue star) ).

  2. Click on Response Disabled ( (blue star) ) to switch it to enable responses for this comment.

  1. Click on the tag ( (blue star) ).

  2. Click on View Details ( (blue star) ).

  3. In DETAILS, click the (blue star) button beneath the dropdowns.

  4. Click SAVE to confirm update and close the form.

Once a comment has responses enabled, any user with rights can view the comment and add a response from within the RESPONSES tab.

...

You can access the response thread to view or add a response in two ways:

From the Comment Tag

From Inside the Comment Form

Image Modified
  1. Click on the tag ( (blue star) ).

  2. Click on Reply to Comment ( (blue star) ) to open the RESPONSES tab.

  3. Click Add ( (blue star) ) on the lower right.

  4. In the “Reply” form, type in your message.

  5. Click Confirm to add your message to the existing response thread. It will display beneath the comment, in the order it was added.

  1. Click on the tag ( (blue star) ).

  2. Click on View Details ( (blue star) ).

  3. Click on the RESPONSES tab.

  4. Click Add ( (blue star) ) on the lower right.

  5. In the “Reply” form, type in your message.

  6. Click Confirm to add your message to the existing response thread. It will display beneath the comment, in the order it was added.

Info

To disable responses for a comment you will need to open the comment form and click on (blue star) to prevent any further feedback.

...

You can upload attachments two ways:

From the Comment Tag

From Inside the Comment Form

Image Modified
  1. Click on the tag ( (blue star) ).

  2. Click on View Attachments ( (blue star) ) to open the ATTACHMENTS tab.

  3. Click Add ( (blue star) ) on the lower right.

  4. In the “Attachment Manager” form, either drag and drop a file or click Select Files to search for a file to upload.

  5. Click UPLOAD to add your file.

  1. Click on the tag ( (blue star) ).

  2. Click on View Details ( (blue star) ).

  3. Click on the ATTACHMENTS tab.

  4. Click Add ( (blue star) ) on the lower right.

  5. In the “Attachment Manager” form, either drag and drop a file or click Select Files to search for a file to upload.

  6. Click UPLOAD to add your file.

Info

Any files you add will be listed in the comment’s attachments as well as on the overall project attachments list. Other users can download them from there.

...

In addition to adding comments directly onto a document from the Review page, users can also add comments from the project’s COMMENTS tab. This allows users to add comments about the overall application, about the submittal process, or even about deficiencies that apply to a large number of pages or a large number of documents within the submittal.For more details, refer to Project Comments page.  

Filter by label (Content by label)
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@10c5c
showSpacefalse
sortmodified
typepage
reversetrue
labelscomment disposition flag group private pin response log hyperlink category attachment owner permission
cqllabel in ( "log" , "comment" , "attachment" , "group" , "hyperlink" , "flag" , "permission" , "pin" , "disposition" , "private" , "response" , "category" , "owner" ) and type = "page" and space = "EKB"

...