Skip to main content
Version: 3.1

Questionnaire

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​

ComponentsWhat it captures
TitleThe name of the form. The title is required.
SlugA short identifier for the form in the web address. The slug is required.
DescriptionA short text that explains the purpose of the form. The description is optional.
StatusThe stage of the questionnaire in its lifecycle. The status is required.
Subject TypeThe level at which staff fill in the form. The subject type is required.
OrganizationsThe organizations that can see and use the questionnaire. You must select at least one organization.
QuestionsThe questions and the question groups in the form.
VersionThe 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​

StatusDescription
ActiveThe questionnaire is in use. Staff can fill it in.
DraftThe questionnaire is in preparation and is not ready for use.
RetiredThe 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.