# Configuring Legacy Workflows: Document Update Steps


<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>: The content in this article refers to single-document workflows, now known as legacy workflows. While existing workflows remain supported and such workflows can continue to be updated and used, legacy workflows will not receive new functionality in future releases. As of the 21R1.2 release, <a href="/en/gr/70436/">multi-document workflows and object workflows</a>
 are unified under <strong>Admin &gt; Configuration &gt; Workflows</strong>.</p>

<p>If your document lifecycle does not have any legacy workflows, the <em>Legacy Workflow</em> tab will not appear on your document lifecycle configuration page. If you require legacy workflow functionality for such a document lifecycle in your Vault during this release period, contact Support.</p>

<p>After the 21R3 release, you cannot create or copy legacy workflows in any Vault. You can continue to refresh or clone Vaults with existing legacy workflows.</p>
    </div>
  </div>
</div>



Workflow steps define all the actions within a workflow, whether they are user actions like providing electronic signatures or system actions like sending notifications. This article covers types of steps that relate to document updates:

  * **State Change** steps move a document from one lifecycle state to another. See [details][2].
  * **Update Document Field** steps automatically update one or more fields on the document based on the configured rule or value. See [details][3].

You can read details about other types of steps in <a href="/en/gr/21922/">Legacy Workflow Tasks & Decision Steps</a>
 and <a href="/en/gr/21904/">Legacy Workflow Process Steps</a>
. To learn about creating new steps and linking them together, see <a href="/en/gr/2453/">Configuring Legacy Workflow Steps</a>
.

## State Change Steps {#state_change}

State Change steps move a document from one lifecycle state to another, for example, from _Draft_ to _In Review_. This step could move the document into a state with more restrictive user permissions during a workflow, or could advance the document to the next stage of a lifecycle at the end of the workflow. For example, in a review workflow, a State Change step just after the Start step could move the document into _In Review_ state, in which users are not able to perform certain tasks. After a Decision step that evaluates verdicts from users' review tasks, the workflow could move the document backward to _Draft_ state or forward into _Ready for Approval_ state.

When a document changes states through a workflow step, Vault automatically applies entry criteria and executes entry actions as part of the State Change step. Two _State Change_ steps must have at least one _Task_ step between them. Otherwise, entry actions which send notifications on the second _State Change_ step will not execute properly.

### Step Configuration Fields

<table class="wbord">
  <tr>
    <td>
      <strong>Field</strong>
    </td>
    <td>
      <strong>Description</strong>
    </td>
  </tr>
  <tr>
    <td>
      Next State
    </td>
    <td>
      Select the next lifecycle state to apply to the document.
    </td>
  </tr>
</table>

## Update Document Field Step {#update_document_field}

Update Document Field steps allow you to automatically update document fields. For example, a workflow to withdraw a document could use this step to set the _Withdrawal Effective Date_ field to 10 days past the current date.

### Step Configuration

To set up an Update Document Field step, select a document field and a value. The value options depend on field type:

<table class="wbord">
  <tr>
    <td>
      <strong>Field Type</strong>
    </td>
    <td>
      <strong>Value Options</strong>
    </td>
  </tr>
  <tr>
    <td>
      Text
    </td>
    <td>
      Allows "Blank" or "Text"; "Text" show a text field in which you can enter a value.
    </td>
  </tr>
  <tr>
    <td>
      Date
    </td>
    <td>
      Allows "Blank," "Today," and other date fields. When selecting "Today" or other date fields, you can create calculated values, for example, "Today + 10 days" or "Workflow Due Date + 90 days."
    </td>
  </tr>
  <tr>
    <td>
      Numeric
    </td>
    <td>
      Allows "Blank," "Number," and other numeric fields; with "Number," you must enter a numeric value. With other numeric fields, you can create a calculated value like "MLR Cycle Count + 1." If a numeric field used for a calculated value is blank, Vault treats it as a zero.
    </td>
  </tr>
  <tr>
    <td>
      Yes/No
    </td>
    <td>
      Allows "Blank," "Yes," and "No."
    </td>
  </tr>
  <tr>
    <td>
      Picklist
    </td>
    <td>
      Allows "Blank" and "Values." "Values" shows a picklist field where you can select one or more options.
    </td>
  </tr>
</table>

You can add as many fields as needed by clicking the plus (+) icon.

### Behavior Details

There are some differences between updating document fields using this step and updating fields manually:

  * The Workflow Owner does not need the **Edit Fields** permission for the document in order to complete a workflow that contains this type of step.
  * Audit Trail shows "System" as the **User Name** when reporting on the document field updates, not the Workflow Owner's name.
  * Vault ignores dependent field rules when updating fields. This means that Vault can update a document field even if it's hidden or read-only, or populate it with a picklist value that would otherwise not be available.

 [2]: #state_change
 [3]: #update_document_field