# Defining Document State Entry Criteria

You may need to ensure that a document meets certain conditions (fields are populated, etc.) before entering a specific lifecycle state. For example, users won't know the MLR meeting date when they upload the first draft, but they will need to fill in the _MLR Meeting Date_ field before the document can enter the _Ready for MLR_ state. You can configure a lifecycle state's "entry criteria" to enforce rules like this.

When users move a document from one state to another (through a state change or workflow), Vault confirms that the document meets the entry criteria and does not allow the move until the criteria are fulfilled. Users see a message with details on the unmet entry criteria.

## About Enforcing Entry Criteria

Vault enforces document state entry criteria as follows:

* Vault does not enforce entry criteria on the initial lifecycle state (_Draft_ state in most cases) when users create a new document. However, if the document moves to another state, Vault enforces the entry criteria when the document moves back into the initial state. 
* Vault does not enforce entry criteria when a user changes the state by selecting **Create Draft** from the **Actions** menu. 
* When a user cancels a document workflow, Vault enforces entry criteria and entry actions when the document moves state, even when the new state is the same as the current state. 
* When a user cancels a legacy document workflow, Vault does not enforce entry criteria and entry actions when the document moves state. 

## Accessing Entry Criteria Administration

You can configure user actions for a specific lifecycle state from **Admin > Configuration > Document Lifecycles > [Lifecycle] > States > [State] > Entry Criteria**.

You must have a security profile with the **Admin: Lifecycles and Workflows** permissions.

## Criteria Types {#types}

You can set up the following types of entry criteria:

Content
: Require that users have uploaded content (a source file) for the document

Field
: Require that a specific document field is populated or meets the specified requirements. For example, you could create entry criteria that require a document to have at least one annotation before moving into the _Review Complete_ state by setting **Field > Annotations (All) > is greater than > 0**.

Formula is True
: Require that a formula expression returns a boolean true expression before moving the document to a new state. If the formula returns a false expression, no state change occurs and Vault displays an error message with the validation error to the user who initiated the state change. This criteria type also allows you to configure a custom error message to display to users when a formula returns false.


Relationship
: Require that the document has one or more relationships of the specified relationship type; all standard relationship types are available.

Rendition
: Require that a file with the specified rendition type is attached to the document; standard video and audio rendition types generated by Vault are not available for selection.

Version Binding
: Require that all documents in a binder are either explicitly bound or bound to a steady state; Vault only enforces this criteria for binders.

Binder content
: Require that all component documents (and binders) within the binder are in a specific state type or are not in a workflow; Vault only enforces this criteria for binders and it's only available on RIM Submissions Vaults where the [Cascading Review & Approval for Binder Content](/en/lr/38813/) feature is enabled.

Content is not checked out
: Require that the source file is not currently checked out by any user.

## How to Create Entry Criteria

To add a new entry criterion for a lifecycle state:

  1. From the **Entry Criteria** tab, click **Edit**.
  2. Click **Create Rule**.
  3. Optional: Add conditions to the entry criteria rule by selecting **All conditions are met** or **Formula evaluates to True**. See [details below][2].
  4. Under **Validate that**, select a [criteria type][3].
  5. Select the criterion and any other needed values. For example, with a **Relationship** criteria you only need to select a relationship type to require, but with a **Field** criteria, you need to select a field, operator, and value.
  6. Optional: Add additional criteria by clicking **Add Criteria**. If the rule is conditional, these additional criteria will share the same conditions.
  7. Click **Save**. Vault immediately starts to enforce the entry criteria rule for documents moving into the lifecycle state, but this does not affect documents that are already in the state.

## How to Define Conditions {#how-to-conditional}

Certain entry criteria only need to apply when the document meets a set of conditions. For example, different renditions are required for US documents and UK documents.

To define conditions, select **All Conditions are met**, and then a document field, operator, and value. Then, select a criteria type. You can also select **Formula evaluates to True** to use a formula expression that returns a boolean (true/false) expression to define the condition. Vault applies the entry criteria only if the formula returns a true expression. Some system fields and most fields associated with document types that use the lifecycle are available. If needed, you can define additional conditions by clicking **Add condition**.

A document must meet all of the defined conditions within a rule for Vault to apply the entry criteria. If a rule's condition uses a field that does not apply to the document, Vault does not apply the rule to the document.

<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>: With the exception of annotation-related formula fields, Vault does not support formula types of document fields in entry criteria conditions.</p>
    </div>
  </div>
</div>



## How to Edit or Delete Entry Criteria

To make changes to entry criteria rules, click **Edit**. Make any necessary edits. If you need to delete a rule, click the **X** icon. When your changes are complete, click **Save**.

## Entry Criteria Limits

For each lifecycle state, you can define up to 25 entry criteria rules. Within a rule, you can specify up to ten (10) entry criteria. If a rule is conditional, it can have up to five (5) conditions. If your entry criteria validates conditions on related object records, the number of related records cannot exceed 1,000 records.

 [2]: #how-to-conditional
 [3]: #types
