2022:Review Queue (Node Type)

From Grooper Wiki

A Review Queue defines a list of users for human-performed document review tasks.

Review Queues are used to distribute review tasks to users or groups of users by assigning them to Batch Processes or Review steps in a Batch Process.

About

Review Queues allow further control of what Batches and tasks Grooper users have access to. You can control the work presented to users in the "Batches" and "Tasks" pages in the Grooper Web Client with Review Queues (or Grooper Dashboard and Grooper Attended Client in the thick client). This allows you to better filter work to your users by defining ACL settings for Batch Processes and/or steps in a Batch Process.

  • Imagine a situation where you have several Batch Processes running in your environment and several users reviewing work in Grooper. You may want to assign certain users to certain Batch Processes based on their experience with the kinds of documents in the document set or quality of their work.
  • Imagine another situation where you want restrict the kinds of review your workers do. Maybe one group only performs data review and another only performs classification review. And maybe any of them can do document scanning.

You can also think of this as a "soft security" measure. By filtering out work available to users, the Review Queue acts as a kind of gatekeeper, controlling what comes across a reviewer's desk.

⚠ Please note this is not a "hard security" measure. There are conceivable ways in which a user assigned a certain Review Queue may still be able to access Batch content that is outside of their queue. For true "hard security", the best practice is to isolate that work in a separate Grooper Repository and restrict user access in the Security settings configured on the root node.


The general steps to create a Review Queue are as follows:

  1. Add the users to the Users list at the root node of the Grooper Repository.
  2. Create a new Review Queue.
  3. Select which Grooper Users you wish to add to the Review Queue.
  4. Then, the Review Queue can be implemented in one of two ways:
    1. On the Batch Process to restrict work accessed from the "Batches Page" of the Grooper Web Client (or Grooper Dashboard in the thick client).
      • Only Grooper Users listed in the Review Queue will be able to access Batches with that Batch Process in the "Batches Page" interface.
      • This will prevent users who are not members of the Review Queue from seeing any Batch using that Batch Process in the "Batches Page" interface.
      • Use this option if you want users to "pull" work from a list of active Batches.
    2. On a Review step of a Batch Process to restrict work accessed from the "Tasks Page" of the Grooper Web Client (or Grooper Attended Client in the thick client).
      • Only Grooper Users listed in the Review Queue will be able to start the Review task from the "Tasks Page".
      • This will prevent users who are not members of the Review Queue from seeing the Review task in the "Tasks Page"
      • Use this option if you want to "push" work to users, feeding them the tasks you want instead of allowing them to pick the Batches they want.

How To

In the following tutorials, we will show you how to create and implement Review Queues for a variety of scenarios. We will set up a number of Review Queues with the following individuals in mind:

  • Dylan - This is our Grooper designer. He will be creating the Review Queues from Grooper Design Studio and implementing them.
  • Randall - This is a Grooper review user. He will have the most access rights. There won't be any review task he won't be able to perform.
  • Chris - This is a Grooper review user. He will have more limited access rights. There are some review tasks Randall will be able to do that Chris won't.
  • Matt - This is a Grooper review user. He will have the most restricted access. There will only be a handful of tasks he will be able to perform.


We will also use a number of Batch Processes to illustrate Review Queues. Any Review step has been highlighted. These processes should be familiar to you if you've reviewed the Web Client and User Guide articles already.

Batch Process Steps In Batch Process Valid Review Users

"OTC Forms"

  • This will be our "control" process. No Review Queues will be implemented for this Batch Process.

Steps in "OTC Forms" Batch Process


Any of our users will be able to process Review tasks.

"HR Docs - Packet Separation"

  • We will use this process to illustrate implementing Review Queues at the Batch Process level.

Steps in "HR Docs - Packet Separation" Batch Process


Only Randall will be allowed to process Review tasks in this Batch Process

"Invoices Process"

  • We will use this process to illustrate implementing Review Queues at the Review step level.

Steps in "Invoices Process" Batch Process


Only Chris and Randall will be allowed to process the "Classification Review" step of this Batch Process.

Only Randall will be allowed to process the "Data Review" step of this Batch Process.

"URLA Redaction"

  • We will use this process to illustrate what not to do when implementing Review Queues (or at least something that goes against general best practice advice).

Steps in "URLA Redaction" Batch Process

For this Batch Process, we will review which users have access to what Batches/Review steps in the #Security Considerations section of this article.

Create a Review Queue

Add Users at Root Node

To create a Review Queue, you will first need to add individual users or groups of users to the Grooper Repository. You will do this by adding users using the Users property at the Root Node.

  1. Select the Root Node of the Grooper Repository.
  2. Under the Security settings, at least one Grooper designer will need to be added to add users.
    • In our case, our designer, Dylan, has already added himself using the Designers property.
    • When adding Designers be sure you, yourself, are added to the list. Otherwise, you will lock yourself out of the Grooper Repository in Grooper Design Studio.
  3. Select the Users property to add users.
  4. Press the ellipsis button at the end of the property.


  1. This will bring up the "ACL Editor" window.
  2. Use the "Groups" tab to add groups of users in your Windows directory.
  3. Use the "Users" tab to add individual users in your Windows directory.
  4. Use the Search box to enter the group name or user name you wish to add.
  5. Select the user you wish to add from the list.
  6. Press the Add button to add the user.


  1. This will add the user to the Users list.
  2. Continue adding users you wish to have access rights to review Batches in the Grooper Repository.
    • We've added our other Grooper users, Chris and Randall, to this list already.
  3. If you intend for your Grooper designers to process Batches in the Grooper Web Client, be sure to add users listed as Designers to the Users list as well!
    • We've added our Grooper designer, Dylan, to the Users list.
    • If you do not, the Grooper designer will not be able to access Batches or process Review tasks in the Grooper Web Client.
  4. Press OK when finished.


  2. When you have finished adding users, press the Save button.

Add a New Review Queue


  1. To add a new Review Queue, right-click the Queues folder.
  2. Select Add.
  3. Then, select Review Queue...

This brings up the "Add New Review Queue" window.

  2. Name the Review Queue.
  3. Press OK when finished.


  2. This will add the Review Queue to the Queues folder.


Next, we will configure the Review Queue by adding users to it, using the Performers property.

Add Users to the Review Queue

Next, we will add users to the Review Queue. When the Review Queue is implemented, it will restrict access to the Batch and/or Review tasks to the users added. To do this, you will add a list of users using the Performers property.

For example, we've added a Review Queue named "Classification Review". Of our three users, Chris, Randall and Matt, we only want Chris and Randall to do document classification review during a Review step. By adding Chris and Randall to the Review Queue (and not Matt) and implementing it on a Review step configured for classification review, this would present the Review task to Chris and Randall, but not Matt.


  1. Select the Review Queue in the Queues folder.
  2. Select the Performers property.
  3. Press the ellipsis button at the end of the property.


  1. This will bring up the "ACL Editor" window.
  2. Just as you did when adding Users to the Grooper Repository, use the "Groups" or "Users" tab to search for user groups or individual users.
  3. Add only the appropriate users/groups according to the Review Queue's function.
    • For our example, Chris and Randall, are our classification reviewers. So, we've only added them to the Review Queue.
    • FYI: As long as a Designer is added to the Users list, they are implicitly members of all Review Queues and do not need to be added to the Performers list.
  4. Press OK when finished.


  2. Don't forget to Save the Review Queue when finished adding Performers.

Next, we will demonstrate how to implement Review Queues. Review Queues can be implemented in one of two ways:

  1. On the Batch Process to restrict work accessed from the "Batches Page" of the Grooper Web Client.
    • Only Grooper Users listed in the Review Queue will be able to access Batches with that Batch Process in the "Batches Page" interface.
    • This will prevent users who are not members of the Review Queue from seeing any Batch using that Batch Process in the "Batches Page" interface.
    • Use this option if you want users to "pull" work from a list of active Batches.
  2. On a Review step of a Batch Process to restrict work accessed from the "Tasks Page" of the Grooper Web Client.
    • Only Grooper Users listed in the Review Queue will be able to start the Review task from the "Tasks Page".
    • This will prevent users who are not members of the Review Queue from seeing the Review task in the "Tasks Page"
    • Use this option if you want to "push" work to users, feeding them the tasks you want instead of allowing them to pick the Batches they want.
Click here to return to the top

Implement a Review Queue on the Batch Process Level

A Review Queue should be implemented on a Batch Process if you intend on users to pull their own work using the "Batches Page" of the Grooper Web Client (or using Grooper Dashboard in the thick client). When you add a Review Queue at the Batch Process level, only users in that Review Queue will be able to access Batches with that process from the "Batches Page". If a user is not a member of that Review Queue, they won't even see the Batches listed.

To illustrate this, we will implement a Review Queue named "PII" set on the "HR Docs - Packet Separation" Batch Process. Only Randall will be listed in the Review Queue. If another user, for example Chris, uses the "Batches Page" to access work, any Batch using the "HR Docs - Packet Separation" process will not be listed.

This is a way of filtering work to individual users based on specific Batch Processes. Perhaps Randall is better trained to handle human resources documents than Chris. Considering they have Personally Identifiable Information (PII), Randall may be certified to view and review more sensitive data, whereas Chris may not be. Setting the Review Queue on the Batch Process level is a way to better ensure Chris pulls the right Batches for himself, when accessing work using the "Batches Page".

Set Up the Review Queue


  1. We have added a Review Queue named "PII"
  2. Using the Performers property, we have added a single user, Randall.

Assign the Review Queue to the Batch Process


  1. Select the Batch Process you wish to assign the Review Queue to.
  2. Using the Batch Process Properties panel, select the Review Queue property.
  3. Using the dropdown list selector, select the Review Queue you wish to use.
    • In this case the one named "PII", listing only Randal as a performer.


⚠ Don't forget to publish changes to your Batch Process! If you add a Review Queue to a previously published Batch Process, those changes won't be reflected in production Batches until the Batch Process is re-published.

The Review Queue Performer's Perspective


Now that we've assigned the Batch Process a Review Queue, we can see the differences in users' perspectives from the "Batches Page". We will start with Randall's perspective, who is listed as a performer for the "PII" Review Queue (which is assigned to the "HR Docs - Packet Separation" Batch Process.

  1. When implementing Review Queues on the Batch Process level, you should access work from the "Batches Page" in the Grooper Web Client.
    • Or if using the thick client, using Grooper Dashboard.


The "Batches Page" interface will filter out Batches based on a user's membership in any Review Queue defined on a Batch Process.

  1. Because Randall is listed as a performer for the "PII" Review Queue, he is able to see any Batches using the "HR Docs - Packet Separation" process.
  2. With this Review step listed as Ready, he could go ahead and process this task.

Other Users' Perspective

For users who are not a member of the Review Queue, they will see something quite different when they use the "Batches Page". We'll look at things from Chris's perspective next. He is not listed as a performer for the "PII" Review Queue.

The "Batches Page" interface will filter out Batches based on a user's membership in any Review Queue defined on a Batch Process. The Batch using the "HR Docs - Packet Separation" process, is therefore not present in Chris's list of Batches.

  1. If the user is listed as a performer in the Review Queue defined for a Batch's process (or if no Review Queue is defined), the user will see the Batch listed. Otherwise, they will not.

Click here to return to the top

Implement a Review Queue on the Review Step Level

A Review Queue should be implemented on a Review step of a Batch Process if you intend on pushing work to reviewers using the "Tasks Page" of the Grooper Web Client (or using Grooper Attended Client in the thick client). When you add a Review Queue at the Review step level, only users in that Review Queue will be able to process that Review step. If a user is not a member of that Review Queue, they will not be apple to execute the Review step as configured in the Batch Process. If you have multiple Review steps in a Batch Process, they can each use their own Review Queues, based on the task at hand.

To illustrate this, we will implement two Review Queues: one named "Classification Review" set on a Review step intended to review document classification and another named "Data Review" set on a Review step intended to review document data extraction. Both Randall and Chris will be listed in the "Classification Review" queue, but only Randall will be listed in the "Data Review" queue. This means both Chris and Randall will be able to perform tasks using the "Classification Review" queue, but only Randall will be able to perform tasks using the "Data Review" queue. And our other user, Matt, wouldn't be able to do either.

This is a way of filtering work to individual users based on the types of work in a given Review task. Randall may be best trained in reviewing extracted data. There may be more stringent business requirements for a reviewer to even understand the data extracted. However, both Chris and Randall may be equally qualified to determine if a document was classified correctly. By putting Chris and Randall in the "Classification Review" queue but only Randall is put in the "Data Review" queue, you can ensure the right types of work suited to the individual are pushed across their desk when using the "Tasks Page" to filter their work.

Set Up the Review Queue(s)

In this tutorial, we will set two Review Queues on two Review steps of a single Batch Process.


  1. The first Review Queue is named "Classification Review"
    • This will be implemented on the same-named "Classification Review" step of the "Invoices Process" Batch Process.
  2. Using the Performers property, we've added two users.
  3. Both Chris and Randall have been added to the Review Queue.


  1. The second Review Queue is named "Data Review"
    • This will be implemented on the same-named "Data Review" step of the "Invoices Process" Batch Process.
  2. Using the Performers property, we've added one user, Randall.

Assign the Review Queue(s) to the Review Step(s)

The Review Queue Performer's Perspective

Other Users' Perspective

Click here to return to the top

Security Considerations

Retrieved from "https://wiki.grooper.com/index.php?title=2022:Review_Queue_(Node_Type)&oldid=8877"