Creating and managing reviews for assets in forms

Last update: May 3, 2023

CREATED FOR:

  • User
CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

Review

A Review is a mechanism that allows one or more reviewers to comment on an asset that is available in a form.

Setting up a review

  1. Navigate to the Forms tab and select a form.

  2. If the asset does not have a review in progress, a Start Review aem6forms_review_chat_comment icon appears in the Action bar. Click the Start Review aem6forms_review_chat_comment icon.

  3. Enter the following information:

    • Review name: Mandatory, can contain alphanumeric characters, hyphen, or underscore.
    • Review description: Optional, description of the purpose / content for review.
    • Review deadline: Optional, the date on which the review ends. When past the deadline the task appears as ‘Overdue’.
    • Reviewers: A minimum of one is mandatory. Use the combo-box to add reviewers. Typing a name lists all matching names; select a name and click Add.

  4. Fill in all the remaining details, and then click Start.

Actions that occur when a review is set up

This section describes what happens when a review is created or set up.

  1. A new review task is created and assigned to the initiator of the review.

  2. All reviewers are assigned a review task. The task appears in their Notifications section. A reviewer can click a notification, or go to the Inbox to view the task. A reviewer can click to open the review task, to view the form, and start adding comments.

    Reviewer Notification Alert
    Figure: Reviewer Notification Alert

  3. The comment box is available to the initiator and reviewers of the asset. Others can view the comments, but cannot write comments.

Managing a review

NOTE
Only reviews that are in progress can be modified. Reviews that are complete cannot be modified.

  1. Navigate to the Forms tab and select a form.

  2. If an asset has a review in progress and you are the initiator of the review, a Manage Review aem6forms_review_chat_comment icons appears in the Action bar. Only review initiator can manage (update/end) the review.

    Click the Manage Review aem6forms_review_chat_comment icon.

    For user other than initiator the Manage Review icon is disabled.

  3. You get a screen that displays information:

    • Review name: Cannot be edited.
    • Review description: Available for editing.
    • Review deadline: Available for editing. One can modify the deadline to any date and time beyond the current date and time.
    • Reviewers: Available for editing. You can add or remove reviewers. If a task is overdue, you can add reviewers only after extending the deadline beyond the current date.

  4. Edit the necessary fields, and then click Update.

    Review updated state in Task Manager
    Figure: Review updated state in Task Manager

  5. To end the review, click End.