Automatically Trigger Reviews from Files

Project administrators can create review auto-triggers to automatically initiate reviews when specific file actions or file attribute actions and their conditions affect folders with the auto-trigger applied.

• Create Review Auto-Triggers
  • Basic
  • Triggers
    • Trigger and Condition Logic
    • Failure Cases
    • Trigger actions
    • Select folders
  • Conditions
  • Actions
• Review Auto-Trigger Details
  • Create review auto-trigger
  • Apply existing review auto-trigger
  • Edit
  • Remove
  • Delete
• Manage Review Auto-Triggers

Create Review Auto-Triggers

Project administrators can create review auto-triggers either from the:

Review auto-triggers tab in settings:

1. Click Settings.
2. Click Review auto-trigger settings.
3. Click Create review auto-trigger.

Review auto-trigger details panel:

1. Click the More menu of the relevant folder in the folder tree.

2. Click Review auto-trigger details.

3. Click Create.

4. Click Create review auto-trigger.

   This accesses the creation workflow which is split into four sections:

   

Basic

Enter a unique name for the review auto-trigger which is a maximum of 255 characters. This is a required field.

Triggers

You can select one or more file and file attribute trigger actions and the folders which are affected by the triggers. You can select triggers with or without conditions.

The details of how triggers and conditions work together to successfully create a review are listed below.

Trigger and Condition Logic

Failure Cases

• Without any conditions, any selected trigger action will create a review.
• For attribute changes, the review only triggers on actual value changes.
• Multiple auto-triggers can exist on the same folder.
• The system will only create one review per triggering event, even with multiple matching conditions.

Trigger actions

Click the Trigger actions field and choose one or more of the following:

Files actions

• Upload
• Copy
• Move
• Rename

File attribute actions

This section lists custom and naming standard attributes. You can select one or more attributes to automatically trigger a review when the selected attribute values are edited.

Select folders

Click Select folders.

1. Select the folders that you want the review auto-trigger to apply to.

2. Click Select.

   Note: This section will automatically list the selected folder if the review auto-trigger is created from the Review auto-trigger details panel.

Conditions

By default, no conditions are added. This means that any of the selected trigger actions will start a review in the selected folders. You can add one or more conditions using:

• System attributes: This does not include Markup, Indicators, Folder path, Review status, File size, or Version number system attributes.
• Custom attributes

A condition consists of three parts; an attribute, operator, and value:

1. Click
2. Click the drop-down and select a system or custom attribute as necessary.
3. Click the next drop-down and select an operator.
4. Click the next field and either enter a value, or select a value if the attribute is a drop-down list type.
5. Add more conditions as necessary.

Actions

1. Select the desired review approval workflow.

2. Enter a title for the review.

3. Enter any notes for the review as necessary.

   Note: The member who triggers the approval workflow (for example, they upload files or change attribute values to match the trigger conditions) will be the initiator of the review even if they do not have initiator permission for the selected approval workflow.

   Once the review auto-trigger workflow is created, it will display in the Review auto-triggers tab in settings, and for the relevant folder in the Review Auto-Trigger Details panel.

Review Auto-Trigger Details

You can select a folder from the Files tool and use Review Auto-Trigger Details to view the names of the review auto-triggers applied to that folder. Project administrators can also create, apply, edit, remove, and delete review auto-triggers from the Review Auto-Trigger Details panel.

To access Review Auto-Trigger Details:

1. Click the More menu of the relevant folder.

2. Click Review auto-trigger details.

   

   This opens the Review Auto-Trigger Details panel:

   

Create review auto-trigger

1. Click Create.
2. Click Create review auto-trigger from the drop-down list.
3. Follow the steps listed in the previous Create Review Auto-Triggers section.

Apply existing review auto-trigger

Project administrators can apply an existing review auto-trigger to the current folder.

1. Click Create in the Review auto-trigger details panel

2. Click Apply existing review auto-trigger from the drop-down list.

   

3. Select an existing auto-trigger to apply to the folder.

   

4. Click Apply.

Edit

You can edit a review auto-trigger which is applied to the current folder.

1. Click Edit.
2. Edit the review auto-trigger as necessary. See previous Create Review Auto-Triggers section for details.
3. Click Save.

Remove

This removes the review auto-trigger from the current folder only. A project administrator can apply the review auto-trigger again to the folder later if necessary.

Delete

Project administrators can delete a review auto-trigger either from Review auto-triggers settings, or from the Review auto-trigger details panel.

Manage Review Auto-Triggers

Project administrators can view and manage review auto-triggers from The Review auto-triggers tab in Files > Settings. They can access these settings to view details, create, edit, and delete review auto-triggers.

1. Click Settings.

2. Click Review auto-trigger settings.