Skip to content

Fill out a task form

Overview

Task forms allow to collect data as images are being reviewed and evaluated. They are defined in the protocol used to create the task. When a task is launched in the Flywheel viewer, the task form is displayed in the right-side panel. A task can only be completed once the form has been correctly filled out.

Form field types

There are currently seven different field types supported in task forms (see also REF TO FORM DOCUMENTATION):

  1. Paragraph: This type of field does not require user input and is used to provide additional context or information to the person filling out the form.

Task form with a paragraph field on RECIST criteria above a target lesion count question

  1. Instructions: This type of field is generally used to provide additional instructions to the user for the completion of their task. Those fields can be displayed only upon providing a specific answer to a question. See below an example of instructions that are displayed when "Tumor" is selected as an answer.

Radio question with Tumor selected, showing an Instructions panel on measuring the tumor long axis

  1. Free-text: This type of field allows the user to type in their answer to a question. Some conditions can be configured on which entries are allowed.

Empty free-text field for a required lesion-type question, with a Tumor or Malignant LN hint below

  1. Dropdown: This type of fields forces the user to select an answer from a dropdown list.

Dropdown open for a target lesion count question, showing Zero, One, Two, and more than Two

  1. Radio buttons: This type of field forces the user to select one answer from multiple choices.

Radio buttons

  1. Checkboxes: This type of field allows the user to select one or multiple answers from a a list of answers.

Checkbox question about target lesion size, with the CT option checked among CXR and Other

Required questions

Some questions in the form must be answered in order to complete the task. These questions are identified with a red asterisk. If you try to complete the task by clicking the Submit button before all required questions have been answered, an error message is displayed and missing answers are highlighted in the form. The up and down arrows allow you to jump from one question to the next.

Required questions

Conditional visibility

The form can be configured so that additional questions appear in the form based on the answers that you provide. For that reason it is good practice to answer questions in order when filling out the form. See below an example of a form where the answer to the first question determines which follow-up questions are displayed in the form.