Skip to main content

Reviews

Reviews are an integral part of the most internal process, where requests are validated and approved by relevant parties. For example, a procurement team can review purchase requests above a set threshold, and IT can review requests for a new AI tool.

In the Reviews Preference page, configure your review policies and reviewer mapping, specifying which reviews are required for which type of request. You can also specify the order of reviews by placing them in the relevant review round.

Review Rounds

Configure each round of reviews, when they’re required, and the order in which they take place.

Add and Configure Review Policies

To create and configure a review policy, follow the steps below:

  1. In the Review Policies table, scroll to the bottom of the table and select the Create Row button, preference-table-create-row.png. The Create Row window displays.

  2. Configure by entering values for the relevant fields:

    1. Name (Required) - Enter a descriptive name for the review policy.

    2. Description - Enter a description of the review policy.

    3. Round (1st - 4th) - For each review round in the policy, select the review or reviews that must take place. For example, 1st Round may be set to “Direct Manager” and 2nd Round may be set to “Legal”.

      Each round may have one or more reviews, with each round not beginning until the previous round is complete. Reviews in the same round run in parallel. Additionally, if a round is marked as non-blocking, it does not have to be completed before the round is marked as complete.

    4. Reviews Share a Collaboration Space - Select whether to enable reviewers to collaborate on internal comments. If set to Yes, all reviewers are able to collaborate in internal comments on the relevant request interface. If set to No, internal comments will be private to each review.

  3. When finished, select Create. The review policy is created.

Review to Always Include

Select a review that, if not already included in the review policy, is always included for any request.

Default Review Policy

Select the policy to use as the default for all requests. For example, if all requests required at least a review by the user’s direct supervisor, you could include the review policy that contains only this review here.

Reviewer Types/Modules

Reviewer mappings are essentially review types. Configure the different types of reviews your review rounds can include.

Default Reviewer Module

Select the review module that serves as the default review module.

This is a core module, configured to use the Solution Preferences. Overriding a core module may cause some Preference configurations to become obsolete. Update with caution.

Configure Review Types

To create and configure a review type, follow the steps below:

  1. In the Review Types table, scroll to the bottom of the table and select the Create Row button, preference-table-create-row.png. The Create Row window displays.

  2. Configure by entering values for the relevant fields:

    Remember, you can select the insert field button, insert_field.png, to add schema fields and other dynamic values.

    1. Name (Required) - Enter a name for the review type.

    2. Contract Module - Select a custom extension module to supplement the review process. This module can contain any logic that has the ability to approve or reject the review, set the assignee, add a summary interface, override the main review interface, and so on.

    3. Reviewer Variant (Overwrite Default) - Select to use a custom review module, overriding the default module.

    4. Default Assignee Email - Select the user who will be assigned this review by default. Use the relevant schema field whenever possible. For example, if you have a schema field for “Direct Manager,” use this field here to dynamically assign the review to the requester’s direct manager.

    5. Required Questionnaires - Select which questionnaires are required before the review is assigned. Note that all questionnaires added to Required Questionnaires must be completed before the review is assigned.

    6. Review Due Date - If the review due date must be automatically set, define the number of days after the review is assigned that it is due. Enter only a numeral.

    7. Can Approve in Tonkean - Select if the review can be completed/approved in Tonkean. If set to Yes, an Approve button is provided on the review side panel. If set to No, this Approve button is hidden.

    8. Can Add Manual Tasks? - Select whether to allow users to create and assign manual tasks to other users. If set to Yes, the Manual Task tab displays in the review interface. If set to No, the Manual Task tab does not display. Default: No.

    9. Can Edit Request? - Select whether to allow the reviewer to edit the request. If set to Yes, the reviewer is able to edit information on the request. If set to No, the request fields will be read-only for the reviewers.

    10. Skip Conditions - Define the conditions that determine when the review is skipped.

      For more information about condition groups, see Conditions.

    11. Doesn't Block Downstream? - Select whether the review does not prevent subsequent reviews or processes. By default, each review blocks subsequent reviews. If set to Yes, this review runs in parallel with subsequent reviews. If set to No, this review must be completed before the subsequent review is assigned.

    12. Allow AI Auto Assignment? - Select whether to use the AI Auto Assignment feature. If set to Yes, the review type uses AI auto-assignment. If set to No, the review type follows the assignment rules as defined.

    13. Can Manage Reviews? - Select whether to allow users to access the interface to manage reviews and add additional review types.

    14. Rejecting Cancels Request? - Select whether a reviewer rejecting a request cancels and closes out that request. If set to Yes, reviewers can select the available Reject button to cancel the request. If set to No, this Reject button does not cancel the request.

    15. Can Reject in Tonkean? - Select whether the Reject button displays in the review side panel. If set to Yes, the Reject button displays. If set to No, the Reject button is hidden. Additionally, a custom extension review module can mark a request as rejected. If this is your preference, you can set this option to No.

    16. Can Return to Requester? - Select whether to allow reviewers to return requests to the requester. If set to Yes, reviewers can return requests to the requester, who can make edits to the request and resubmit. If set to No, reviewers cannot return the request to the requester.

      If a request is returned to a requester, who edits and resubmits, the request is not re-classified. If you need the request to be re-classified/triaged, use the request reuse option and instruct requesters to create a new request.

    17. Can Override Main Review Interface? - Select whether an extension module can replace the core part of the review interface.

    18. Hide Manual Summary - Select whether to hide the manual summary on the review interface side panel. If set to Yes, the manual summary is hidden. If set to No, the manual summary displays. Set this option to Yes to display the summary from an extension module. Default = No.

    19. Can Conditionally Approve in Tonkean? - Select whether a Conditionally Approve button displays for the reviewer. If set to Yes, the button is displayed on the side panel. If set to No, the button is hidden. When enabled, reviewers will be required to provide the condition on which the approval is granted, and the status of the review is updated to Conditionally Approved (instead of Approved).

    20. Review Type Can Be Added More Than Once? - Select whether this review type can be added more than once to a singular request. If set to Yes, the review type can be included more than once. If set to No, the review type can only be included in a request once. Default = No.

    21. AI Specific Ranking - Provide additional context that Tonkean AI uses to populate the “AI Highlights” section in the side panel when the review is created.

    22. Should Show Internal Comments? - Select whether the internal comments tab displays on the review interface side panel. This tab contains comments only for reviewers that are not displayed to requesters.

    23. Processing Steps to Add On Review Creation - Select the processing steps that you want to include when the review is created. The review will not be marked as completed until all blocking processing steps are done.

    24. Processing Steps to Add On Review In Progress - Select the processing steps that you want to include when the review is in progress. The review will not be marked as completed until all blocking processing steps are done.

    25. Processing Steps to Add On Review Approved - Select the processing steps that you want to include when the review is approved. The review will not be marked as completed until all blocking processing steps are done.

  3. 3. When finished, select Create. The review type is created.

Configure Additional Reviews Settings

Can Add Additional Review Types?

If selected, admins/reviewers with the ability to add additional reviews ad-hoc will be able to add reviews not directly configured in the "Reviewer Mapping" table.

Calculate AI Highlights for each review?

If selected, AI-generated highlights will be calculated and presented for each reviewer.

Enable Auto-Delegates?

If selected, users are allowed to set auto-delegates for reviews assigned to them.

When add a review ad-hoc, how do you want to handle missing questionnaires?

Select how to handle situations in which a review with required questionnaires is added after the initial request classification:

  • Bypass Questionnaire - Skip the questionnaire and add the review.

  • Ask User - Include an additional question asking users if they would like to add the questionnaire.

  • Auto-Create Questionnaire - Automatically create and add the questionnaire along with the review.

Review Visibility

Manage which users can see which reviews, and when.

Enable Review Visibility

Select whether review visibility is determined by the relevant visibility type. If selected, review visibility is controlled by the selected visibility type in the Review Visibility Types table.

Configure Review Visibility Types

To create and configure a review visibility type, follow the steps below:

  1. In the Review Visibility Types table, scroll to the bottom of the table and select the Create Row button, preference-table-create-row.png. The Create Row window displays.

  2. Configure by entering values for the relevant fields:

    1. Name (Required) - Enter a name for the review visibility type.

    2. Description - Enter a description for the visibility type.

    3. Allowed Emails - Enter the email addresses for the users the review is visible to. To make the review visible to all email addresses, enter “*”.

    4. Allowed Business Group ID - Enter the business group ID for the business group the review type should be visible to. For more information about business groups, see Create and Manage Business Groups.

    5. Active - Select whether the visibility type is active. If set to Yes, the visibility type is active and its rules are applied. If set to No, the visibility type is inactive and the configuration applied here is not applied.

  3. When finished, select Create. The review visibility type is created.

Default Visibility Type

Select the default visibility type for all reviews as they’re created—select from the review visibility types created in the Review Visibility Types table.

Always Allowed Business Group

Select the business group that is always allowed to view all reviews, regardless of their visibility type. This field is optional.