Pre-requisites:
The 'Enable Comment Review' setting should be enabled on the project to create a review.
You need to have the role privilege 'Can Create Review' on the project where a review needs to be created.
To create a private review, you will need the role privilege 'Can Create Private Review' on the project.
You can create new review comments on any file revisions accessible to you and collaborate with other users on the project. Review comments once created can be viewed and replied to by its recipients and other users having access to the file review including file publisher and folder administrator/s as applicable.
Since review comments are created for review purposes, every such comment created on a file revision can have a specific status based on which it can be reviewed separately. However, any replies created on a review comment won't have a status.
To start a new review, select the project folder under the 'Files' tab then select single or multiple files for which a new review will be created using the corresponding checkboxes. Now, right-click and select 'New' then 'Create Review'.
Alternatively, click the icon at the top right. Under the 'Files' section, select 'New' then 'Create Review'.
Below is a description of the different fields available while creating a new review:
1. To - Click the 'To' box to see a dropdown list of the project users / distribution groups / roles / organizations from which you can add recipient/s for distributing this review, by manually selecting their names using the corresponding checkboxes. If you need to, type in the initial characters of the user / distribution group / role / organization name to get auto-suggestions based on the same, then select the required names using the corresponding checkboxes. Accordingly, the selected users / distribution groups / roles / organizations will start appearing in the 'To' field. You can click on each recipient (selected users / distribution groups / roles / organizations) to see relevant details and view or edit task details for each recipient.
By default, the 'For Information' task associates with all the users added in the 'To' textbox. To change the task, click on the name of the specific user / distribution group / role / organization for whom the task needs to be changed then select a different task from the dropdown. Next, choose an expected date from a calendar to complete that task by clicking the icon.
The envelope icon is a switch option that helps you specify whether or not you need to send an email notification for each user who is being assigned a task selected as part of the distribution. A yellow envelope icon indicates that the switch is on and an email notification will be sent. If the switch is turned off, the envelope icon will then show in grey color and email notification won't be sent.
The 'To' field is mandatory to fill.
As part of a file review distribution, the selected task will be distributed to individual project users with access to that file. Click here to understand the different file tasks.
To expand distribution groups / roles / organizations and find the users in them, click the icon that will appear upon mouse hover on the concerned distribution group / role / organization.
Note - Selecting a distribution group, a role, or an organization is treated as an object. When pre-populating them in any future case, they will be pre-populated as an entire object and not as individual recipient/s from the object.Click the icon to give other tasks to the same user if required.
To remove users from distribution, click the icon corresponding to the name of the selected distribution groups, users, roles, or organizations.
If there is a long list of users / distribution groups / roles / organizations in the project, click the 'Show All' link opposite the relevant column header to see the complete list as required.
Selecting a task due date is not mandatory if you are assigning a 'For Information' task to anyone. However, it is mandatory if you are assigning other types of tasks.
When assigning tasks to multiple users / distribution groups / roles / organizations, you can directly bulk-apply values from the top header. Enter required values that you want to apply in bulk from the top header - like the task to be assigned, due date and email notification switch on or off as required - then click the icon to bulk apply the selected option to all records chosen below.
To clear all selected tasks, due dates, and email notification options simultaneously, click the 'Clear' option at the top left.
Once you have selected recipients and task details, click the 'Close' option at the top left to close the dropdown list.
2. Review Disciplines - Select any one option to continue. The options available by default are - Architect, Contractor, Electrician, Engineer, and Mechanic. These options can be edited and managed as configurable attributes on the project.
3. Suggested Status - Select a suggested status for this file review. These status options can be edited and managed under file statuses on the project.
4. Title - Enter the title text for a new review. This is a mandatory field.
5. Mark as Private - Turn on the switch to mark the review under creation as private. Otherwise, turn off the switch to mark the review under creation as private. The default behavior will depend on your project settings (for 'File Reviews / Model Comments default').
6. Comment - Enter a comment under the new review. You can specifically mention a project member in your review comment by typing '@' and then selecting the name of that particular member whenever you need it from the suggested dropdown list. Type in the initial characters, if there is a long list of project members to filter the list accordingly.
Such members will be added as recipients to the review automatically and will get a separate 'Read' task on the review.
icon - Click if you don't have anything specific to comment.
icon - Click to attach external files from your computer. A layered page populates allowing you to select and upload files from your local device storage.
icon - Click on the 'Association' icon to view association options which include 'Associate Files', 'Associate Reviews', and 'Associate Apps'.
Associate Files - Click to associate documents with this review comment. Upon clicking, a layered page displays the files you can select and associate with the review comment under creation.
Associate Reviews - Click to associate other review comments with this review comment. Upon clicking, a layered page displays the other file review comments you can select and associate with the review comment under creation.
Associate Apps - Click to associate forms with this review comment. Upon clicking, a layered page displays the forms you can select and associate with the review comment under creation.
Associate Markups - Click to associate markups with this review comment. Upon clicking, a layered page displays the markups you can select and associate with the review comment under creation.
icon - Click to view the toolbar with rich text options (appears as a top bar in the comment box) that you can use while creating the review comment.
icon - Click to save the review comment you entered.
To enter additional comments within the same review, click the 'Add Comment' option and follow the same steps.
To edit or delete a saved comment created on the review, click the icon or icon corresponding to the comment as applicable.
Once done entering all comments as needed for the review, click 'Submit'.
Otherwise, click 'Save Draft' to edit and submit later. If you don't want to save any of the changes you made, click 'Cancel' to go back to the previous screen.
Click here to understand how to view file reviews once created.
Related Articles: Reply to an Existing Review
Next Collection: Editing Files or its Attributes, Editing Secondary Files