# Configuring Read & Understood Workflows

Read & Understood (R&U) workflows are a special class of workflow that allows users to assign one or more documents to specific users for review. When users complete their review, they can mark the document as "Read & Understood" and provide an eSignature as proof that they've completed the task.



<div class="note-border alert-info">
  <div class="alert alert-info" role="alert">
    <div><i class="far fa-info-circle"></i></div>
    <div class="alert-text">
      <p><strong>Note</strong>: R&amp;U workflows are part of the Read &amp; Understood feature set, available across multiple applications including <a class="external-link " href="https://quality.veevavault.help/en/gr/5442" target="_blank" rel="noopener">QualityDocs<i class="fa fa-external-link" aria-hidden="true"></i></a> (Quality), <a class="external-link " href="https://clinical.veevavault.help/en/gr/4660" target="_blank" rel="noopener">eTMF<i class="fa fa-external-link" aria-hidden="true"></i></a> (Clinical Operations), <a class="external-link " href="https://medical.veevavault.help/en/gr/5439" target="_blank" rel="noopener">MedComms<i class="fa fa-external-link" aria-hidden="true"></i></a> (Medical), and <a class="external-link " href="https://commercial.veevavault.help/en/gr/7479" target="_blank" rel="noopener">PromoMats<i class="fa fa-external-link" aria-hidden="true"></i></a> (PromoMats).</p>
    </div>
  </div>
</div>



## How to Create Read & Understood Workflows

You can create and manage R&U workflows in much the same way as for other document workflows. See the <a href="/en/gr/50498/">document workflow configuration</a> content for detailed instructions on general workflow creation.

To set up a R&U workflow, create a new document workflow and set the **Class** field to _Read & Understood_. This class selection enables the _R&U Workflow Task_ step. Once you've selected the _Read & Understood_ class and saved the workflow, you cannot change the **Class** value.

### Read & Understood Workflow Limits

The following limits apply to configuring and using Read & Understood workflows:

* Selecting the _Read & Understood_ class disables some workflow step types, including state changes, tasks, action, and user decisions. Read & Understood workflows do not support role-based participants, prompts for fields, or workflow variables.
* Users cannot remove documents from the _Envelope_ when an R&U workflow is active.
* By default, the maximum number of participants that users can assign to any workflow participant control is 5,000. To configure a limit between 1 and 5,000, navigate to **Admin > Settings** and enable **Limit workflow participants**. Provide a **Max number of participants per participant control**. Users will encounter an error if they attempt to assign more participants than the configured limit.
* Read & Understood workflows allow up to 20 documents.
* The _Class_ field is unavailable during R&U workflow creation while _Any document lifecycle_ is selected.

## How to Define the Read & Understood Task

Read & Understood workflow tasks allow some of the same options as <a href="/en/gr/50498/#document_task_steps">standard Document Task steps</a>. To define a task step:

1. In the **Workflow Steps** section of the workflow detail page, hover over the workflow and click **Create Step**, or click into an existing placeholder step.
1. Set the **Type** to **R&U Workflow Task**.
1. Enter a **Task Label** to identify the task.
1. Add <a href="/en/gr/50498/#short-circuit">**Tags**</a> if necessary.
1. In **Assign Task To**, select a participant group. Each participant group is defined in the _Start_ step as a _Participants Control_.
1. Enter **Instructions** for the task owner. These appear with the task in the _Home_ tab and in the _Show more_ portion of the workflow heading within the document viewer.
1. Optional: Select **Do not allow workflow owner to receive this task**. This option makes the task unavailable to the workflow owner even if the workflow owner is part of a group assigned to the task.
1. Optional: Select a **Due Date**.
1. Optional: Under **Update Document Sharing Settings**, <a href="/en/gr/50498/#updating-sharing-settings-in-task-steps">create rules</a> to update roles under certain conditions.
1. In the **Prompts** section, configure the verdict. In a _R&U Workflow Task_ there is only one type of verdict, which collects an eSignature from the user. [See below][6] for more information.
1. Optional: Under **Notification**, select an **Email Template** to use when sending an automatic notification to the task owner. You can select **Include verdicts from previous tasks** and select one or more previous tasks in the **Select Tasks** field.
1. Optional: Add **Task Reminders**. <a href="/en/gr/50498/#task-reminders">Task reminders</a> allow you to configure notifications to send task owners about open tasks.

### R&U Workflow Task Verdicts {#verdicts}

Verdicts allow a task owner to indicate a result when completing a workflow task. Within a document workflow, task owners assign verdicts individually for each document. By default, the _R&U Workflow Task_ has the _Sign for Read & Understood_ verdict.

How to Set Up the R&U Workflow Task Verdict

To add verdicts to a workflow task:

  1. Click **Add Verdict** to create each verdict.
  2. Enter a **Verdict Label**, which the task owner will see when selecting a verdict. This label also appears within workflow details.
  3. Optional: Select **Short-circuit tasks with the configured tags** if you want the verdict to short-circuit other workflow tasks.

#### **Optional Verdict Settings**

  * Click **Add Comments** to prompt the user to enter comments. Enter a label for the prompt, for example, "Explanation for verdict." Select the **Required** checkbox to require the task owner to enter comments before they can complete the task.
  * Click **Add Capacities** if task owners selecting this verdict need to provide a <a href="/en/gr/50498/#capacities">capacity</a>.
  * R&U task owners must provide an electronic signature by entering their login credentials. You can optionally add instructions for users. Deselect the **Manifest eSig on Documents** checkbox if you do not want the signature page to be attached to downloaded documents.
  * Click **Add Reasons** to prompt the task owner to select a reason for their verdict. Select the **Required** checkbox to require the task owner to select a reason before they can complete the task. Enter a label for the prompt, for example, "Reason for verdict." Enter each **Reason Value**, which the task owner will see when selecting a reason.

## How to Activate Read & Understood Workflows

When finished defining the workflow, make it active and <a href="/en/gr/12339/#create">create a new user action</a> for each lifecycle state in which the R&U workflow should be available. Generally, these workflows will only be available for documents that are in some kind of approved status that is available in your vault, such as "Ready for Training."

When defining the R&U user action, you can make the action conditional based on a given condition, such as _Document Type_. For example, users would only be able to start the R&U workflow for documents of a given type.

 [6]: #verdicts
