Concepts/Questionnaire

conceptdefinitionsCARE 3.0+

Definition

A questionnaire in Care is the definition of a structured form. It holds the title of the form, the questions, and the order of those questions. A questionnaire is a template, not a submission. When staff fill in a questionnaire for a patient, Care saves the answers as a Questionnaire Response.

Key Attributes

Components	What it captures
Title	The name of the form. The title is required.
Slug	A short identifier for the form in the web address. The slug is required.
Description	A short text that explains the purpose of the form. The description is optional.
Status	The stage of the questionnaire in its lifecycle. The status is required.
Subject Type	The level at which staff fill in the form. The subject type is required.
Organizations	The organizations that can see and use the questionnaire. You must select at least one organization.
Questions	The questions and the question groups in the form.
Version	The version number of the questionnaire. Care sets this value, and you cannot change it.

Slug

The slug must have 5 to 25 characters. The slug accepts letters, numbers, underscores, and hyphens. Each questionnaire needs a different slug.

Subject Type

The subject type is Patient or Encounter. If you select Patient, staff fill in the form at the patient level. If you select Encounter, staff fill in the form inside an encounter.

Questions

Each question has a type. The available types are Group, Display, Boolean, Decimal, Integer, Date, Date Time, Time, String, Text, URL, Choice, Quantity, and Structured. A Group holds other questions together. A Display shows text to the reader and takes no answer.

Each question also has three flags:

Required: staff must answer the question before they submit the form.
Repeatable: staff can give more than one answer to the question. Care hides this flag for the Boolean, Group, Display, and Structured types.
Read only: staff can see the question but cannot change the answer.

A Choice question gets its answers in one of two ways. You add a set of custom options. You can also select a Valueset for the question. A Quantity question always gets its units from a valueset.

Status

Status	Description
Active	The questionnaire is in use. Staff can fill it in.
Draft	The questionnaire is in preparation and is not ready for use.
Retired	The questionnaire is no longer in use.

📝 Note

The questionnaire screens have no action to delete a questionnaire. Set the status to Retired to take a questionnaire out of use.

Access

The Admin Dashboard button opens the questionnaire screens. Care shows this button only to superusers. To create a questionnaire, you need the "Can Create/Update Questionnaires" permission in each organization that you select. To change a saved questionnaire, you must be a superuser. To add or remove the organizations of a saved questionnaire, you need the "Can Create/Update Questionnaires" permission.

Pages that link here:

Concept: Concepts/Observation
Reference: References/Questionnaire