Applies to Collaborator 12.1, last modified on August 21, 2019

About

As you integrate reviewing into your work process, you may need to create slightly different reviews for different document types or different projects. For example, depending on the document type reviews may require different type-specific fields, and depending on projects they may need slightly different participant roles.

To adjust a review to the form you need, you use review templates. A review template is a configuration of user-defined fields, roles, and other settings that you can quickly apply to a review. You can do this when you are creating a review or editing it:

Applying a review template

Click the image to enlarge it.

Applying a template to a review may clear custom fields and the list of participants of this review. Existing values of custom fields will be retained upon changing review template if the custom field exists in both templates. Existing review participants will be retained upon changing review template if they are allowed to use new template.

Template Components

Each review template includes the following settings:

Custom fields

One or multiple custom fields to be added to a review. You can see these custom fields at the beginning of the review, right after the general settings:

See example

For information on creating custom fields and on their parameters, see Custom Fields.

Checklists

A checklist is a list with check boxes for its items. You can see it as a list of actions to do or conditions to check for a review. You can use different checklists for different document types. You can see the check lists on the review screen.

See example

For information on creating and configuring check lists, see Checklists.

Roles

A configuration of participant roles that Collaborator will use in a review. You can use them to change role permissions and names.

See example

For information on creating and configuring roles, see Roles.

Automatic links

Review fields may contain links to external resources like website pages or links to items of a remote bug tracking system.

The Automatic links group of settings let you specify rules that Collaborator will use to replace text in multiline or single line fields with links to remote resources.

See example

For information on creating and configuring automatic links, see Automatic Links.

Create and Edit Template

You create and edit review templates in the Admin > Review Templates section of Collaborator settings:

Create a review template

Click the image to enlarge it.

To create and edit review templates, you need administrator permissions in Collaborator.

Create template

  1. Log in to Collaborator as administrator.

  2. Select ADMIN on the main toolbar. Then choose Review Templates on the left.

  3. On the Enabled Review Templates tab, click New Template and specify the template-parameters:

    Create a review template

    Click the image to enlarge it.

  4. Click Save anywhere on the page to save the changes.

Edit template

  • Log in to Collaborator as administrator.

  • Go to ADMIN > Review Templates.

  • Find the review in the list and click Edit:

    Edit a review template

    Click the image to enlarge it.

  • Configure template parameters and click any Save button to apply the changes.

Collaborator will not apply changes to existing reviews immediately. Instead, it will mark the template as disabled signaling that you need to re-apply the template:

Disable templates on the review screen

To re-apply a template, simply select it again from the Template drop-down list.

Disable or delete template

Review templates cannot be deleted. If you don’t need a template any more, you can disable it. This will hide that template from the Template drop-down box on the Review screen:

Disable templates on the review screen

To disable a template:

  1. Log in to Collaborator as administrator.

  2. Go to ADMIN > Review Templates.

  3. On the Enabled Review Templates tab, find the desired template and click Disable:

    Disable a review template

    Click the image to enlarge it.

Collaborator will not update reviews that use the disabled template immediately. Instead, it will mark the template as disabled on the review screen, so that you know you need to apply another template:

Disable templates on the review screen

Enable template

  1. Log in to Collaborator as administrator.

  2. Go to ADMIN > Review Templates.

  3. On the Disabled Review Templates tab, find the desired template and click Enable:

    Enable a review template

    Click the image to enlarge it.

Template Parameters

Parameter Description
Name

The name that will identify the template in the Collaborator UI.

Description

An arbitrary description of the template.

Review reject reasons

Specifies whether to display a list of reject reasons when rejectig reviews that use this template.

Checklist

Specifies whether to display any of predefined checklists.

Checklist mandatory?

Specifies whether all items must be checked before the review can be approved.

Review custom fields

Specifies which review custom fields should be available to reviews that use this template.

Participant custom fields

Specifies which participatn custom fields should be available to reviews that use this template.

Defect custom fields

Specifies which defect custom fields should be available to reviews that use this template.

Roles

Specifies which of predefined role configurations to use for this template.

Automatic links: <Configuration_Name>

Specifies which of predefined automatic link configurations will be enabled for this template.

Remote system links: Enabled

Specifies whether to display the Remote System Links section of the Review Summary page for reviews that use the template.

<Configuration_Name>: Automatically add remote system links

Specifies which of predefined issue-tracking configurations will be enabled for this template. This will converts ticket identifiers into hyperlinks to the specified remote system and will append the items to the Remote System Links section of the Review Summary page.

<Configuration_Name>: Automatically create new work item for external defects

Enables the ability to create new work items in the selected issue-tracking system directly from Collaborator.

<Configuration_Name>: Default project

Specifies the project to be pre-selected in the dialog that suggests creating a ticket/work item.

See Also

Review Templates

Highlight search results