Capture Field Values

Step-by-step instructions: Enter the values an Assignment takes in and produces
Updated 2 weeks ago

Fields are the typed values an Assignment takes in and produces, such as a new hire's name or a laptop's asset tag. A Procedure's authors define its Fields (see Define Procedure Fields); you enter their values while you work the Assignment. Each value is captured where it is owned: the Assignment's own Inputs & Outputs on its Info tab, and each Step's Fields on that Step's Task.

Enter the Assignment's Inputs & Outputs

  1. Select the Assignment and press the Info tab in the detail pane.
  2. In the Progress panel, fill in the fields under Inputs & Outputs. An Input badge marks a value the work starts from; an Output badge marks a value the work produces.
    Progress panel on an Assignment's Info tab, with Input and Output Fields

Each value saves as you enter it. Inputs are often filled in already: the member who assigned the Procedure, or the Trigger that started it, may have supplied them.

Enter a Task's Fields

  1. Select the Task and press its Info tab.
  2. Fill in the Fields section, just above the Completion Status control, so entering the values and completing the Task happen in one place.

A File Field has an upload button; a Yes / No Field is a switch with a Clear button to remove the value.

Who captures a value

  • While a Task that produces a Field is open, only that Task can capture its value. Everywhere else the Field is read-only, and its label names the Task that produces it.
  • A value can't be empty. To clear a Field, delete its value: empty its input, or press Clear or the file's remove button.
  • A value must fit the Field as it was when the Assignment started, even if the Field has changed since.

Required Fields

A Field marked Required is listed under "Required Fields awaiting values" until it has a value.

  • A Task waits for a value for each of its Required Inputs before it can start. Every Task of an Assignment also waits for the Procedure's Required Inputs.
  • A Task can't be completed, or submitted for approval, until each of its Required Outputs has a value.
  • Skipping a Task that still needs a Required Field asks you to confirm first, in the Skip Without Required Fields? dialog. Press Skip Anyway to skip it without the value, or Cancel to go back and enter it.

See Update Assignment or Task Completion Status for how a Task shows what it waits on.

Frozen values

Once a Task closes, the values captured on it are frozen: they stay on the record and can no longer be changed. Hover over a frozen value to see why.

See every captured value

Press the Assignment's Fields tab to see every Field the Assignment takes in and produces, its value, and where it was Captured at: the Assignment itself or the Task that owns it. A Field with no value yet shows "Not yet entered"; press a Task name to open the Task that captures that Field.

Fields tab of an Assignment listing each Field, its value, and where it was captured

Related Articles

Overview

  1. Assignments Overview
  2. Key Terms

Step-by-Step

  1. Define Procedure Fields
  2. Create an Assignment
  3. Update Assignment or Task Completion Status
  4. Follow a Task's Guide
Did this answer your question?