UZ Core Questionnaire - Uzbekistan Digital Health Platform v0.5.0

Uzbekistan Digital Health Platform
0.5.0 - ci-build Uzbekistan flag

Uzbekistan Digital Health Platform, published by Ministry of Health of the Republic of Uzbekistan. This guide is not an authorized publication; it is the continuous build for version 0.5.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/uzinfocom-org/digital-health-ig/ and changes regularly. See the Directory of published versions

Resource Profile: UZ Core Questionnaire ( Experimental )

Official URL: https://dhp.uz/fhir/core/StructureDefinition/uz-core-questionnaire				Version: 0.5.0	Highlight text changes?
Active as of 2025-12-16					Computable Name: UZCoreQuestionnaire

Uzbekistan Core Questionnaire profile for multilingual structured data capture forms

UZ Core Questionnaire is a form template on the Digital Health Platform - the set of questions, not the answers. Some are nationally standardized (for example, approved by the Ministry of Health); systems and organizations may also define their own local templates. A completed form is captured separately as a QuestionnaireResponse. A Questionnaire has a lifecycle of draft -> active -> retired; only active templates should be used to capture new responses. Items, titles, and answer-option displays support multilingual content (Uzbek, with Russian and Karakalpak translations).

Mandatory and Must Support data elements

The elements below must always be present (mandatory) or must be supported when the data is available (Must Support) - not all are required, but your system must populate each Must Support element when it has the data and process it on receipt. This is the human-readable summary; the formal views below give the exact cardinalities, types, and terminology bindings.

Each UZ Core Questionnaire Must Have

Every Questionnaire must carry a title in Uzbek (1..1), which may bear translation extensions for Russian and Karakalpak, and a status (draft, active, retired, unknown) inherited as mandatory from the base resource.

Each UZ Core Questionnaire Must Support

the canonical url, an identifier, a version, a name, and the status;
the title (and its translations);
a description (with translations), publisher, useContext, jurisdiction, purpose, and effectivePeriod;
the subjectType (resource types this questionnaire applies to);
the item structure - linkId, definition, code, prefix and text (both with translations), type, enableWhen, required, repeats, readOnly, maxLength, answerConstraint, answerValueSet, answerOption (with valueCoding display translations), initial value, and nested items.

Only active templates should be used to capture new responses. A template in draft is not yet ready; a retired template should no longer be issued.

Building the JSON, step by step

A Questionnaire is a form definition rather than a clinical record, so it is mostly authored once and reused. The examples below go from the smallest template the server will accept to a realistic multilingual item. Copy one and adapt it - every value shown validates against this profile. The full reference instance is the patient satisfaction survey.

The smallest Questionnaire you should send

A status is the only strictly mandatory element (inherited from the base resource), and this profile makes title mandatory too. In practice you also send the name (a computer-friendly token) and declare which resource the form is about with subjectType. Every UZ Core resource must also name the profile it claims to conform to in meta.profile:

{
  "resourceType": "Questionnaire",
  "meta": {
    "profile": ["https://dhp.uz/fhir/core/StructureDefinition/uz-core-questionnaire"]
  },
  "status": "active",
  "name": "PatientSatisfactionQuestionnaire",
  "title": "Bemor so'rovnomasi",
  "subjectType": ["Patient"]
}

status uses a required binding - use draft while the form is still being authored, active once it may capture responses, and retired when it should no longer be issued. Only active templates should be used for new responses.

A realistic multilingual form

A real template carries a stable url, a description, and an item list. The title, item text, and answer-option display are written in one language and carry the others as translation extensions on the matching _-prefixed sibling (_text, _display). The example below shows a single coded question with two answer options - each option's valueCoding draws its code and system from a UZ CodeSystem, and the free-text follow-up is a nested string item:

{
  "resourceType": "Questionnaire",
  "language": "uz",
  "meta": {
    "profile": ["https://dhp.uz/fhir/core/StructureDefinition/uz-core-questionnaire"]
  },
  "url": "https://dhp.uz/fhir/core/Questionnaire/PatientSatisfactionQuestionnaire",
  "status": "active",
  "name": "PatientSatisfactionQuestionnaire",
  "title": "Bemor so'rovnomasi",
  "_title": {
    "extension": [
      {
        "extension": [
          { "url": "lang", "valueCode": "ru" },
          { "url": "content", "valueString": "Опросник удовлетворённости пациента" }
        ],
        "url": "http://hl7.org/fhir/StructureDefinition/translation"
      }
    ]
  },
  "description": "Bemor so'rovnomasi uchun savollar (Patient Portal uchun)",
  "_description": {
    "extension": [
      {
        "extension": [
          { "url": "lang", "valueCode": "ru" },
          { "url": "content", "valueString": "Вопросы для опросника пациента (для Patient Portal)" }
        ],
        "url": "http://hl7.org/fhir/StructureDefinition/translation"
      }
    ]
  },
  "subjectType": ["Patient"],
  "item": [
    {
      "linkId": "appointment-method",
      "text": "Qabulga qanday yozildingiz?",
      "_text": {
        "extension": [
          {
            "extension": [
              { "url": "lang", "valueCode": "ru" },
              { "url": "content", "valueString": "Как вы записались на приём?" }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/translation"
          }
        ]
      },
      "type": "coding",
      "required": true,
      "answerOption": [
        {
          "valueCoding": {
            "code": "phone",
            "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/patient-satisfaction-cs",
            "display": "Telefon orqali yozildim",
            "_display": {
              "extension": [
                {
                  "extension": [
                    { "url": "lang", "valueCode": "ru" },
                    { "url": "content", "valueString": "По телефону" }
                  ],
                  "url": "http://hl7.org/fhir/StructureDefinition/translation"
                }
              ]
            }
          }
        },
        {
          "valueCoding": {
            "code": "other",
            "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/patient-satisfaction-cs",
            "display": "Boshqa",
            "_display": {
              "extension": [
                {
                  "extension": [
                    { "url": "lang", "valueCode": "ru" },
                    { "url": "content", "valueString": "Другое" }
                  ],
                  "url": "http://hl7.org/fhir/StructureDefinition/translation"
                }
              ]
            }
          }
        }
      ],
      "item": [
        {
          "linkId": "appointment-method-other",
          "text": "Boshqa (ko'rsating)",
          "_text": {
            "extension": [
              {
                "extension": [
                  { "url": "lang", "valueCode": "ru" },
                  { "url": "content", "valueString": "Другое (укажите)" }
                ],
                "url": "http://hl7.org/fhir/StructureDefinition/translation"
              }
            ]
          },
          "type": "string"
        }
      ]
    }
  ]
}

Each item needs a linkId (unique within the form) and a type (coding, string, text, …). For a coding item the selectable answers go in answerOption as valueCoding. The translation extension always nests two child extensions - lang (the language code) and content (the translated string) - under the http://hl7.org/fhir/StructureDefinition/translation URL. Use a nested item for follow-up questions such as a free-text "other" field.

For example API calls and a sample payload, see the Quick Start at the bottom of this page.

Usages:

Examples for this Profile: PatientSatisfactionQuestionnaire

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description Differentials, Snapshots, and other representations.

Key Elements Table
Differential Table
Snapshot Table
Statistics/References
All

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Questionnaire	C	0..*	Questionnaire(5.0.0)	A structured set of questions Interfaces Implemented: MetadataResource Constraints: cnl-0, que-2
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
contained		0..*	Resource	Contained, inline Resources
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored Constraints: ext-1
url	SΣC	0..1	uri	Canonical identifier for this questionnaire, represented as an absolute URI (globally unique) Constraints: cnl-1
identifier	SΣ	0..*	Identifier	Business identifier for questionnaire
version	SΣ	0..1	string	Business version of the questionnaire
name	SΣC	0..1	string	Name for this questionnaire (computer friendly)
title	SΣ	1..1	string	Questionnaire title (in Uzbek language)
Slices for extension		0..*	Extension	Questionnaire title (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url Constraints: ext-1
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation Constraints: ext-1
status	?!SΣC	1..1	code	draft \| active \| retired \| unknown Binding: PublicationStatus (required): The lifecycle status of an artifact.
subjectType	SΣ	0..*	code	Resource types that can be subject of this questionnaire Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR.
publisher	SΣ	0..1	string	Name of the publisher/steward (organization or individual)
description	SΣ	0..1	markdown	Natural language description of the questionnaire
Slices for extension		0..*	Extension	Description (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url Constraints: ext-1
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation Constraints: ext-1
useContext	SΣ	0..*	UsageContext	The context that the content is intended to support
jurisdiction	SΣ	0..*	CodeableConcept	Intended jurisdiction for questionnaire (if applicable) Binding: JurisdictionValueSet (extensible): Countries and regions within which this artifact is targeted for use.
purpose	S	0..1	markdown	Why this questionnaire is defined
effectivePeriod	SΣ	0..1	Period	When the questionnaire is expected to be used
item	SC	0..*	BackboneElement	Questions and sections within the Questionnaire Constraints: que-1a, que-1b, que-1c, que-3, que-4, que-5, que-6, que-8, que-9, que-10, que-11, que-12, que-13, que-14
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized Constraints: ext-1
linkId	SC	1..1	string	Unique id for item in questionnaire Constraints: que-15
definition	S	0..1	uri	ElementDefinition - details for the item
code	SC	0..*	Coding	Corresponding concept for this item in a terminology Binding: QuestionnaireQuestionCodes (example): Codes for questionnaires, groups and individual questions.
prefix	S	0..1	string	E.g. "1(a)", "2.5.3"
Slices for extension		0..*	Extension	Item prefix (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url Constraints: ext-1
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation Constraints: ext-1
text	S	0..1	string	Primary text for the item
Slices for extension		0..*	Extension	Item text (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url Constraints: ext-1
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation Constraints: ext-1
type	SC	1..1	code	group \| display \| boolean \| decimal \| integer \| date \| dateTime + Binding: QuestionnaireItemType (required): Distinguishes groups from questions and display text and indicates data type for questions.
enableWhen	?!SC	0..*	BackboneElement	Only allow data when Constraints: que-7
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized Constraints: ext-1
question		1..1	string	The linkId of question that determines whether item is enabled/disabled
operator	C	1..1	code	exists \| = \| != \| > \| < \| >= \| <= Binding: QuestionnaireItemOperator (required): The criteria by which a question is enabled.
answer[x]	C	1..1		Value for question comparison based on operator Binding: QuestionnaireAnswerCodes (example): Allowed values to answer questions.
answerBoolean			boolean
answerDecimal			decimal
answerInteger			integer
answerDate			date
answerDateTime			dateTime
answerTime			time
answerString			string
answerCoding			Coding
answerQuantity			Quantity
answerReference			Reference(Resource)
required	SC	0..1	boolean	Whether the item must be included in data results
repeats	SC	0..1	boolean	Whether the item may repeat
readOnly	SC	0..1	boolean	Don't allow human editing
maxLength	SC	0..1	integer	No more than these many characters
answerConstraint	SC	0..1	code	optionsOnly \| optionsOrType \| optionsOrString Binding: QuestionnaireAnswerConstraint (required): Indicates differnt modes for restricting values when options or valueset are specified
answerValueSet	SC	0..1	canonical(ValueSet)	ValueSet containing permitted answers
answerOption	SC	0..*	BackboneElement	Permitted answer
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized Constraints: ext-1
Slices for value[x]	S	1..1		Answer value Slice: Unordered, Open by type:$this Binding: QuestionnaireAnswerCodes (example): Allowed values to answer questions.
valueInteger			integer
valueDate			date
valueTime			time
valueString			string
valueCoding			Coding
valueReference			Reference(Resource)
value[x]:valueCoding	S	0..1	Coding	Answer value Binding: QuestionnaireAnswerCodes (example): Allowed values to answer questions.
display	ΣC	0..1	string	Representation defined by the system
Slices for extension		0..*	Extension	Answer option display (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url Constraints: ext-1
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation Constraints: ext-1
initial	SC	0..*	BackboneElement	Initial value(s) when item is first rendered
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized Constraints: ext-1
value[x]		1..1		Actual value for initializing the question Binding: QuestionnaireAnswerCodes (example): Allowed values to answer questions.
valueBoolean			boolean
valueDecimal			decimal
valueInteger			integer
valueDate			date
valueDateTime			dateTime
valueTime			time
valueString			string
valueUri			uri
valueAttachment			Attachment
valueCoding			Coding
valueQuantity			Quantity
valueReference			Reference(Resource)
item	S	0..*	See item (Questionnaire)	Nested questionnaire items
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Questionnaire.status	Base	required	PublicationStatus	📍5.0.0	FHIR Std.
Questionnaire.subjectType	Base	required	Resource Types	📍5.0.0	FHIR Std.
Questionnaire.jurisdiction	Base	extensible	Jurisdiction ValueSet	📍5.0.0	FHIR Std.
Questionnaire.item.code	Base	example	Questionnaire Question Codes	📍5.0.0	FHIR Std.
Questionnaire.item.type	Base	required	Questionnaire Item Type	📍5.0.0	FHIR Std.
Questionnaire.item.enableWhen.operator	Base	required	Questionnaire Item Operator	📍5.0.0	FHIR Std.
Questionnaire.item.enableWhen.answer[x]	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.
Questionnaire.item.answerConstraint	Base	required	Questionnaire answer constraints value set	📍5.0.0	FHIR Std.
Questionnaire.item.answerOption.value[x]	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.
Questionnaire.item.answerOption.value[x]:valueCoding	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.
Questionnaire.item.initial.value[x]	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
cnl-0	warning	Questionnaire	Name should be usable as an identifier for the module by machine processing applications such as code generation	`name.exists() implies name.matches('^[A-Z]([A-Za-z0-9_]){1,254}$')`
cnl-1	warning	Questionnaire.url	URL should not contain \| or # - these characters make processing canonical references problematic	`exists() implies matches('^[^\|# ]+$')`
ele-1	error	Questionnaire.implicitRules, Questionnaire.modifierExtension, Questionnaire.url, Questionnaire.identifier, Questionnaire.version, Questionnaire.name, Questionnaire.title, Questionnaire.title.extension, Questionnaire.title.extension:translation, Questionnaire.status, Questionnaire.subjectType, Questionnaire.publisher, Questionnaire.description, Questionnaire.description.extension, Questionnaire.description.extension:translation, Questionnaire.useContext, Questionnaire.jurisdiction, Questionnaire.purpose, Questionnaire.effectivePeriod, Questionnaire.item, Questionnaire.item.modifierExtension, Questionnaire.item.linkId, Questionnaire.item.definition, Questionnaire.item.code, Questionnaire.item.prefix, Questionnaire.item.prefix.extension, Questionnaire.item.prefix.extension:translation, Questionnaire.item.text, Questionnaire.item.text.extension, Questionnaire.item.text.extension:translation, Questionnaire.item.type, Questionnaire.item.enableWhen, Questionnaire.item.enableWhen.modifierExtension, Questionnaire.item.enableWhen.question, Questionnaire.item.enableWhen.operator, Questionnaire.item.enableWhen.answer[x], Questionnaire.item.required, Questionnaire.item.repeats, Questionnaire.item.readOnly, Questionnaire.item.maxLength, Questionnaire.item.answerConstraint, Questionnaire.item.answerValueSet, Questionnaire.item.answerOption, Questionnaire.item.answerOption.modifierExtension, Questionnaire.item.answerOption.value[x], Questionnaire.item.answerOption.value[x]:valueCoding, Questionnaire.item.answerOption.value[x]:valueCoding.display, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension:translation, Questionnaire.item.initial, Questionnaire.item.initial.modifierExtension, Questionnaire.item.initial.value[x], Questionnaire.item.item	All FHIR elements must have a @value or children	`hasValue() or (children().count() > id.count())`
ext-1	error	Questionnaire.modifierExtension, Questionnaire.title.extension, Questionnaire.title.extension:translation, Questionnaire.description.extension, Questionnaire.description.extension:translation, Questionnaire.item.modifierExtension, Questionnaire.item.prefix.extension, Questionnaire.item.prefix.extension:translation, Questionnaire.item.text.extension, Questionnaire.item.text.extension:translation, Questionnaire.item.enableWhen.modifierExtension, Questionnaire.item.answerOption.modifierExtension, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension:translation, Questionnaire.item.initial.modifierExtension	Must have either extensions or value[x], not both	`extension.exists() != value.exists()`
que-1a	error	Questionnaire.item	Group items must have nested items when Questionanire is complete	`(type='group' and %resource.status='complete') implies item.empty().not()`
que-1b	warning	Questionnaire.item	Groups should have items	`type='group' implies item.empty().not()`
que-1c	error	Questionnaire.item	Display items cannot have child items	`type='display' implies item.empty()`
que-2	error	Questionnaire	The link ids for groups and questions must be unique within the questionnaire	`descendants().linkId.isDistinct()`
que-3	error	Questionnaire.item	Display items cannot have a "code" asserted	`type!='display' or code.empty()`
que-4	error	Questionnaire.item	A question cannot have both answerOption and answerValueSet	`answerOption.empty() or answerValueSet.empty()`
que-5	error	Questionnaire.item	Only coding, decimal, integer, date, dateTime, time, string or quantity items can have answerOption or answerValueSet	`(type='coding' or type = 'decimal' or type = 'integer' or type = 'date' or type = 'dateTime' or type = 'time' or type = 'string' or type = 'quantity') or (answerValueSet.empty() and answerOption.empty())`
que-6	error	Questionnaire.item	Required and repeat aren't permitted for display items	`type!='display' or (required.empty() and repeats.empty())`
que-7	error	Questionnaire.item.enableWhen	If the operator is 'exists', the value must be a boolean	`operator = 'exists' implies (answer is boolean)`
que-8	error	Questionnaire.item	Initial values can't be specified for groups or display items	`(type!='group' and type!='display') or initial.empty()`
que-9	error	Questionnaire.item	Read-only can't be specified for "display" items	`type!='display' or readOnly.empty()`
que-10	error	Questionnaire.item	Maximum length can only be declared for simple question types	`(type in ('boolean' \| 'decimal' \| 'integer' \| 'string' \| 'text' \| 'url')) or answerConstraint='optionOrString' or maxLength.empty()`
que-11	error	Questionnaire.item	If one or more answerOption is present, initial cannot be present. Use answerOption.initialSelected instead	`answerOption.empty() or initial.empty()`
que-12	error	Questionnaire.item	If there are more than one enableWhen, enableBehavior must be specified	`enableWhen.count() > 1 implies enableBehavior.exists()`
que-13	error	Questionnaire.item	Can only have multiple initial values for repeating items	`repeats=true or initial.count() <= 1`
que-14	warning	Questionnaire.item	Can only have answerConstraint if answerOption or answerValueSet are present. (This is a warning because extensions may serve the same purpose)	`answerConstraint.exists() implies answerOption.exists() or answerValueSet.exists()`
que-15	warning	Questionnaire.item.linkId	Link ids should be 255 characters or less	`$this.length() <= 255`

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Questionnaire		0..*	Questionnaire(5.0.0)	A structured set of questions Interfaces Implemented: MetadataResource
url	S	0..1	uri	Canonical identifier for this questionnaire, represented as an absolute URI (globally unique)
identifier	S	0..*	Identifier	Business identifier for questionnaire
version	S	0..1	string	Business version of the questionnaire
name	S	0..1	string	Name for this questionnaire (computer friendly)
title	S	1..1	string	Questionnaire title (in Uzbek language)
Slices for extension		0..*	Extension	Questionnaire title (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation
status	S	1..1	code	draft \| active \| retired \| unknown
subjectType	S	0..*	code	Resource types that can be subject of this questionnaire
publisher	S	0..1	string	Name of the publisher/steward (organization or individual)
description	S	0..1	markdown	Natural language description of the questionnaire
Slices for extension		0..*	Extension	Description (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation
useContext	S	0..*	UsageContext	The context that the content is intended to support
jurisdiction	S	0..*	CodeableConcept	Intended jurisdiction for questionnaire (if applicable)
purpose	S	0..1	markdown	Why this questionnaire is defined
effectivePeriod	S	0..1	Period	When the questionnaire is expected to be used
item	S	0..*	BackboneElement	Questions and sections within the Questionnaire
linkId	S	1..1	string	Unique id for item in questionnaire
definition	S	0..1	uri	ElementDefinition - details for the item
code	S	0..*	Coding	Corresponding concept for this item in a terminology
prefix	S	0..1	string	E.g. "1(a)", "2.5.3"
Slices for extension		0..*	Extension	Item prefix (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation
text	S	0..1	string	Primary text for the item
Slices for extension		0..*	Extension	Item text (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation
type	S	1..1	code	group \| display \| boolean \| decimal \| integer \| date \| dateTime +
enableWhen	S	0..*	BackboneElement	Only allow data when
required	S	0..1	boolean	Whether the item must be included in data results
repeats	S	0..1	boolean	Whether the item may repeat
readOnly	S	0..1	boolean	Don't allow human editing
maxLength	S	0..1	integer	No more than these many characters
answerConstraint	S	0..1	code	optionsOnly \| optionsOrType \| optionsOrString
answerValueSet	S	0..1	canonical(ValueSet)	ValueSet containing permitted answers
answerOption	S	0..*	BackboneElement	Permitted answer
Slices for value[x]	S	1..1	integer, date, time, string, Coding, Reference(Resource)	Answer value Slice: Unordered, Open by type:$this
value[x]:valueCoding	S	0..1	Coding	Answer value
display
Slices for extension		0..*	Extension	Answer option display (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation
initial	S	0..*	BackboneElement	Initial value(s) when item is first rendered
item	S	0..*		Nested questionnaire items
Documentation for this format

Description & Constraints Filter: Filters

Questionnaire

C

0..*

Questionnaire(5.0.0)

A structured set of questions
Interfaces Implemented: MetadataResource
Constraints: cnl-0, que-2

id

Σ

0..1

id

Logical id of this artifact

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Questionnaire.language	Base	required	All Languages	📍5.0.0	FHIR Std.
Questionnaire.versionAlgorithm[x]	Base	extensible	Version Algorithm	📍5.0.0	FHIR Std.
Questionnaire.status	Base	required	PublicationStatus	📍5.0.0	FHIR Std.
Questionnaire.subjectType	Base	required	Resource Types	📍5.0.0	FHIR Std.
Questionnaire.jurisdiction	Base	extensible	Jurisdiction ValueSet	📍5.0.0	FHIR Std.
Questionnaire.code	Base	example	Questionnaire Question Codes	📍5.0.0	FHIR Std.
Questionnaire.item.code	Base	example	Questionnaire Question Codes	📍5.0.0	FHIR Std.
Questionnaire.item.type	Base	required	Questionnaire Item Type	📍5.0.0	FHIR Std.
Questionnaire.item.enableWhen.operator	Base	required	Questionnaire Item Operator	📍5.0.0	FHIR Std.
Questionnaire.item.enableWhen.answer[x]	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.
Questionnaire.item.enableBehavior	Base	required	Enable When Behavior	📍5.0.0	FHIR Std.
Questionnaire.item.disabledDisplay	Base	required	Questionnaire Item Disabled Display	📍5.0.0	FHIR Std.
Questionnaire.item.answerConstraint	Base	required	Questionnaire answer constraints value set	📍5.0.0	FHIR Std.
Questionnaire.item.answerOption.value[x]	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.
Questionnaire.item.answerOption.value[x]:valueCoding	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.
Questionnaire.item.initial.value[x]	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
cnl-0	warning	Questionnaire	Name should be usable as an identifier for the module by machine processing applications such as code generation	`name.exists() implies name.matches('^[A-Z]([A-Za-z0-9_]){1,254}$')`
cnl-1	warning	Questionnaire.url	URL should not contain \| or # - these characters make processing canonical references problematic	`exists() implies matches('^[^\|# ]+$')`
ele-1	error	Questionnaire.meta, Questionnaire.implicitRules, Questionnaire.language, Questionnaire.text, Questionnaire.extension, Questionnaire.modifierExtension, Questionnaire.url, Questionnaire.identifier, Questionnaire.version, Questionnaire.versionAlgorithm[x], Questionnaire.name, Questionnaire.title, Questionnaire.title.extension, Questionnaire.title.extension:translation, Questionnaire.derivedFrom, Questionnaire.status, Questionnaire.experimental, Questionnaire.subjectType, Questionnaire.date, Questionnaire.publisher, Questionnaire.contact, Questionnaire.description, Questionnaire.description.extension, Questionnaire.description.extension:translation, Questionnaire.useContext, Questionnaire.jurisdiction, Questionnaire.purpose, Questionnaire.copyright, Questionnaire.copyrightLabel, Questionnaire.approvalDate, Questionnaire.lastReviewDate, Questionnaire.effectivePeriod, Questionnaire.code, Questionnaire.item, Questionnaire.item.extension, Questionnaire.item.modifierExtension, Questionnaire.item.linkId, Questionnaire.item.definition, Questionnaire.item.code, Questionnaire.item.prefix, Questionnaire.item.prefix.extension, Questionnaire.item.prefix.extension:translation, Questionnaire.item.text, Questionnaire.item.text.extension, Questionnaire.item.text.extension:translation, Questionnaire.item.type, Questionnaire.item.enableWhen, Questionnaire.item.enableWhen.extension, Questionnaire.item.enableWhen.modifierExtension, Questionnaire.item.enableWhen.question, Questionnaire.item.enableWhen.operator, Questionnaire.item.enableWhen.answer[x], Questionnaire.item.enableBehavior, Questionnaire.item.disabledDisplay, Questionnaire.item.required, Questionnaire.item.repeats, Questionnaire.item.readOnly, Questionnaire.item.maxLength, Questionnaire.item.answerConstraint, Questionnaire.item.answerValueSet, Questionnaire.item.answerOption, Questionnaire.item.answerOption.extension, Questionnaire.item.answerOption.modifierExtension, Questionnaire.item.answerOption.value[x], Questionnaire.item.answerOption.value[x]:valueCoding, Questionnaire.item.answerOption.value[x]:valueCoding.extension, Questionnaire.item.answerOption.value[x]:valueCoding.system, Questionnaire.item.answerOption.value[x]:valueCoding.version, Questionnaire.item.answerOption.value[x]:valueCoding.code, Questionnaire.item.answerOption.value[x]:valueCoding.display, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension:translation, Questionnaire.item.answerOption.value[x]:valueCoding.userSelected, Questionnaire.item.answerOption.initialSelected, Questionnaire.item.initial, Questionnaire.item.initial.extension, Questionnaire.item.initial.modifierExtension, Questionnaire.item.initial.value[x], Questionnaire.item.item	All FHIR elements must have a @value or children	`hasValue() or (children().count() > id.count())`
ext-1	error	Questionnaire.extension, Questionnaire.modifierExtension, Questionnaire.title.extension, Questionnaire.title.extension:translation, Questionnaire.description.extension, Questionnaire.description.extension:translation, Questionnaire.item.extension, Questionnaire.item.modifierExtension, Questionnaire.item.prefix.extension, Questionnaire.item.prefix.extension:translation, Questionnaire.item.text.extension, Questionnaire.item.text.extension:translation, Questionnaire.item.enableWhen.extension, Questionnaire.item.enableWhen.modifierExtension, Questionnaire.item.answerOption.extension, Questionnaire.item.answerOption.modifierExtension, Questionnaire.item.answerOption.value[x]:valueCoding.extension, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension:translation, Questionnaire.item.initial.extension, Questionnaire.item.initial.modifierExtension	Must have either extensions or value[x], not both	`extension.exists() != value.exists()`
que-1a	error	Questionnaire.item	Group items must have nested items when Questionanire is complete	`(type='group' and %resource.status='complete') implies item.empty().not()`
que-1b	warning	Questionnaire.item	Groups should have items	`type='group' implies item.empty().not()`
que-1c	error	Questionnaire.item	Display items cannot have child items	`type='display' implies item.empty()`
que-2	error	Questionnaire	The link ids for groups and questions must be unique within the questionnaire	`descendants().linkId.isDistinct()`
que-3	error	Questionnaire.item	Display items cannot have a "code" asserted	`type!='display' or code.empty()`
que-4	error	Questionnaire.item	A question cannot have both answerOption and answerValueSet	`answerOption.empty() or answerValueSet.empty()`
que-5	error	Questionnaire.item	Only coding, decimal, integer, date, dateTime, time, string or quantity items can have answerOption or answerValueSet	`(type='coding' or type = 'decimal' or type = 'integer' or type = 'date' or type = 'dateTime' or type = 'time' or type = 'string' or type = 'quantity') or (answerValueSet.empty() and answerOption.empty())`
que-6	error	Questionnaire.item	Required and repeat aren't permitted for display items	`type!='display' or (required.empty() and repeats.empty())`
que-7	error	Questionnaire.item.enableWhen	If the operator is 'exists', the value must be a boolean	`operator = 'exists' implies (answer is boolean)`
que-8	error	Questionnaire.item	Initial values can't be specified for groups or display items	`(type!='group' and type!='display') or initial.empty()`
que-9	error	Questionnaire.item	Read-only can't be specified for "display" items	`type!='display' or readOnly.empty()`
que-10	error	Questionnaire.item	Maximum length can only be declared for simple question types	`(type in ('boolean' \| 'decimal' \| 'integer' \| 'string' \| 'text' \| 'url')) or answerConstraint='optionOrString' or maxLength.empty()`
que-11	error	Questionnaire.item	If one or more answerOption is present, initial cannot be present. Use answerOption.initialSelected instead	`answerOption.empty() or initial.empty()`
que-12	error	Questionnaire.item	If there are more than one enableWhen, enableBehavior must be specified	`enableWhen.count() > 1 implies enableBehavior.exists()`
que-13	error	Questionnaire.item	Can only have multiple initial values for repeating items	`repeats=true or initial.count() <= 1`
que-14	warning	Questionnaire.item	Can only have answerConstraint if answerOption or answerValueSet are present. (This is a warning because extensions may serve the same purpose)	`answerConstraint.exists() implies answerOption.exists() or answerValueSet.exists()`
que-15	warning	Questionnaire.item.linkId	Link ids should be 255 characters or less	`$this.length() <= 255`

Summary

Mandatory: 1 element
Must-Support: 37 elements

Extensions

This structure refers to these extensions:

http://hl7.org/fhir/StructureDefinition/translation|5.3.0

Slices

This structure defines the following Slices:

The element 1 is sliced based on the value of Questionnaire.item.answerOption.value[x]

Key Elements View

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Questionnaire	C	0..*	Questionnaire(5.0.0)	A structured set of questions Interfaces Implemented: MetadataResource Constraints: cnl-0, que-2
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
contained		0..*	Resource	Contained, inline Resources
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored Constraints: ext-1
url	SΣC	0..1	uri	Canonical identifier for this questionnaire, represented as an absolute URI (globally unique) Constraints: cnl-1
identifier	SΣ	0..*	Identifier	Business identifier for questionnaire
version	SΣ	0..1	string	Business version of the questionnaire
name	SΣC	0..1	string	Name for this questionnaire (computer friendly)
title	SΣ	1..1	string	Questionnaire title (in Uzbek language)
Slices for extension		0..*	Extension	Questionnaire title (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url Constraints: ext-1
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation Constraints: ext-1
status	?!SΣC	1..1	code	draft \| active \| retired \| unknown Binding: PublicationStatus (required): The lifecycle status of an artifact.
subjectType	SΣ	0..*	code	Resource types that can be subject of this questionnaire Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR.
publisher	SΣ	0..1	string	Name of the publisher/steward (organization or individual)
description	SΣ	0..1	markdown	Natural language description of the questionnaire
Slices for extension		0..*	Extension	Description (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url Constraints: ext-1
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation Constraints: ext-1
useContext	SΣ	0..*	UsageContext	The context that the content is intended to support
jurisdiction	SΣ	0..*	CodeableConcept	Intended jurisdiction for questionnaire (if applicable) Binding: JurisdictionValueSet (extensible): Countries and regions within which this artifact is targeted for use.
purpose	S	0..1	markdown	Why this questionnaire is defined
effectivePeriod	SΣ	0..1	Period	When the questionnaire is expected to be used
item	SC	0..*	BackboneElement	Questions and sections within the Questionnaire Constraints: que-1a, que-1b, que-1c, que-3, que-4, que-5, que-6, que-8, que-9, que-10, que-11, que-12, que-13, que-14
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized Constraints: ext-1
linkId	SC	1..1	string	Unique id for item in questionnaire Constraints: que-15
definition	S	0..1	uri	ElementDefinition - details for the item
code	SC	0..*	Coding	Corresponding concept for this item in a terminology Binding: QuestionnaireQuestionCodes (example): Codes for questionnaires, groups and individual questions.
prefix	S	0..1	string	E.g. "1(a)", "2.5.3"
Slices for extension		0..*	Extension	Item prefix (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url Constraints: ext-1
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation Constraints: ext-1
text	S	0..1	string	Primary text for the item
Slices for extension		0..*	Extension	Item text (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url Constraints: ext-1
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation Constraints: ext-1
type	SC	1..1	code	group \| display \| boolean \| decimal \| integer \| date \| dateTime + Binding: QuestionnaireItemType (required): Distinguishes groups from questions and display text and indicates data type for questions.
enableWhen	?!SC	0..*	BackboneElement	Only allow data when Constraints: que-7
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized Constraints: ext-1
question		1..1	string	The linkId of question that determines whether item is enabled/disabled
operator	C	1..1	code	exists \| = \| != \| > \| < \| >= \| <= Binding: QuestionnaireItemOperator (required): The criteria by which a question is enabled.
answer[x]	C	1..1		Value for question comparison based on operator Binding: QuestionnaireAnswerCodes (example): Allowed values to answer questions.
answerBoolean			boolean
answerDecimal			decimal
answerInteger			integer
answerDate			date
answerDateTime			dateTime
answerTime			time
answerString			string
answerCoding			Coding
answerQuantity			Quantity
answerReference			Reference(Resource)
required	SC	0..1	boolean	Whether the item must be included in data results
repeats	SC	0..1	boolean	Whether the item may repeat
readOnly	SC	0..1	boolean	Don't allow human editing
maxLength	SC	0..1	integer	No more than these many characters
answerConstraint	SC	0..1	code	optionsOnly \| optionsOrType \| optionsOrString Binding: QuestionnaireAnswerConstraint (required): Indicates differnt modes for restricting values when options or valueset are specified
answerValueSet	SC	0..1	canonical(ValueSet)	ValueSet containing permitted answers
answerOption	SC	0..*	BackboneElement	Permitted answer
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized Constraints: ext-1
Slices for value[x]	S	1..1		Answer value Slice: Unordered, Open by type:$this Binding: QuestionnaireAnswerCodes (example): Allowed values to answer questions.
valueInteger			integer
valueDate			date
valueTime			time
valueString			string
valueCoding			Coding
valueReference			Reference(Resource)
value[x]:valueCoding	S	0..1	Coding	Answer value Binding: QuestionnaireAnswerCodes (example): Allowed values to answer questions.
display	ΣC	0..1	string	Representation defined by the system
Slices for extension		0..*	Extension	Answer option display (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url Constraints: ext-1
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation Constraints: ext-1
initial	SC	0..*	BackboneElement	Initial value(s) when item is first rendered
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized Constraints: ext-1
value[x]		1..1		Actual value for initializing the question Binding: QuestionnaireAnswerCodes (example): Allowed values to answer questions.
valueBoolean			boolean
valueDecimal			decimal
valueInteger			integer
valueDate			date
valueDateTime			dateTime
valueTime			time
valueString			string
valueUri			uri
valueAttachment			Attachment
valueCoding			Coding
valueQuantity			Quantity
valueReference			Reference(Resource)
item	S	0..*	See item (Questionnaire)	Nested questionnaire items
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Questionnaire.status	Base	required	PublicationStatus	📍5.0.0	FHIR Std.
Questionnaire.subjectType	Base	required	Resource Types	📍5.0.0	FHIR Std.
Questionnaire.jurisdiction	Base	extensible	Jurisdiction ValueSet	📍5.0.0	FHIR Std.
Questionnaire.item.code	Base	example	Questionnaire Question Codes	📍5.0.0	FHIR Std.
Questionnaire.item.type	Base	required	Questionnaire Item Type	📍5.0.0	FHIR Std.
Questionnaire.item.enableWhen.operator	Base	required	Questionnaire Item Operator	📍5.0.0	FHIR Std.
Questionnaire.item.enableWhen.answer[x]	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.
Questionnaire.item.answerConstraint	Base	required	Questionnaire answer constraints value set	📍5.0.0	FHIR Std.
Questionnaire.item.answerOption.value[x]	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.
Questionnaire.item.answerOption.value[x]:valueCoding	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.
Questionnaire.item.initial.value[x]	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
cnl-0	warning	Questionnaire	Name should be usable as an identifier for the module by machine processing applications such as code generation	`name.exists() implies name.matches('^[A-Z]([A-Za-z0-9_]){1,254}$')`
cnl-1	warning	Questionnaire.url	URL should not contain \| or # - these characters make processing canonical references problematic	`exists() implies matches('^[^\|# ]+$')`
ele-1	error	Questionnaire.implicitRules, Questionnaire.modifierExtension, Questionnaire.url, Questionnaire.identifier, Questionnaire.version, Questionnaire.name, Questionnaire.title, Questionnaire.title.extension, Questionnaire.title.extension:translation, Questionnaire.status, Questionnaire.subjectType, Questionnaire.publisher, Questionnaire.description, Questionnaire.description.extension, Questionnaire.description.extension:translation, Questionnaire.useContext, Questionnaire.jurisdiction, Questionnaire.purpose, Questionnaire.effectivePeriod, Questionnaire.item, Questionnaire.item.modifierExtension, Questionnaire.item.linkId, Questionnaire.item.definition, Questionnaire.item.code, Questionnaire.item.prefix, Questionnaire.item.prefix.extension, Questionnaire.item.prefix.extension:translation, Questionnaire.item.text, Questionnaire.item.text.extension, Questionnaire.item.text.extension:translation, Questionnaire.item.type, Questionnaire.item.enableWhen, Questionnaire.item.enableWhen.modifierExtension, Questionnaire.item.enableWhen.question, Questionnaire.item.enableWhen.operator, Questionnaire.item.enableWhen.answer[x], Questionnaire.item.required, Questionnaire.item.repeats, Questionnaire.item.readOnly, Questionnaire.item.maxLength, Questionnaire.item.answerConstraint, Questionnaire.item.answerValueSet, Questionnaire.item.answerOption, Questionnaire.item.answerOption.modifierExtension, Questionnaire.item.answerOption.value[x], Questionnaire.item.answerOption.value[x]:valueCoding, Questionnaire.item.answerOption.value[x]:valueCoding.display, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension:translation, Questionnaire.item.initial, Questionnaire.item.initial.modifierExtension, Questionnaire.item.initial.value[x], Questionnaire.item.item	All FHIR elements must have a @value or children	`hasValue() or (children().count() > id.count())`
ext-1	error	Questionnaire.modifierExtension, Questionnaire.title.extension, Questionnaire.title.extension:translation, Questionnaire.description.extension, Questionnaire.description.extension:translation, Questionnaire.item.modifierExtension, Questionnaire.item.prefix.extension, Questionnaire.item.prefix.extension:translation, Questionnaire.item.text.extension, Questionnaire.item.text.extension:translation, Questionnaire.item.enableWhen.modifierExtension, Questionnaire.item.answerOption.modifierExtension, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension:translation, Questionnaire.item.initial.modifierExtension	Must have either extensions or value[x], not both	`extension.exists() != value.exists()`
que-1a	error	Questionnaire.item	Group items must have nested items when Questionanire is complete	`(type='group' and %resource.status='complete') implies item.empty().not()`
que-1b	warning	Questionnaire.item	Groups should have items	`type='group' implies item.empty().not()`
que-1c	error	Questionnaire.item	Display items cannot have child items	`type='display' implies item.empty()`
que-2	error	Questionnaire	The link ids for groups and questions must be unique within the questionnaire	`descendants().linkId.isDistinct()`
que-3	error	Questionnaire.item	Display items cannot have a "code" asserted	`type!='display' or code.empty()`
que-4	error	Questionnaire.item	A question cannot have both answerOption and answerValueSet	`answerOption.empty() or answerValueSet.empty()`
que-5	error	Questionnaire.item	Only coding, decimal, integer, date, dateTime, time, string or quantity items can have answerOption or answerValueSet	`(type='coding' or type = 'decimal' or type = 'integer' or type = 'date' or type = 'dateTime' or type = 'time' or type = 'string' or type = 'quantity') or (answerValueSet.empty() and answerOption.empty())`
que-6	error	Questionnaire.item	Required and repeat aren't permitted for display items	`type!='display' or (required.empty() and repeats.empty())`
que-7	error	Questionnaire.item.enableWhen	If the operator is 'exists', the value must be a boolean	`operator = 'exists' implies (answer is boolean)`
que-8	error	Questionnaire.item	Initial values can't be specified for groups or display items	`(type!='group' and type!='display') or initial.empty()`
que-9	error	Questionnaire.item	Read-only can't be specified for "display" items	`type!='display' or readOnly.empty()`
que-10	error	Questionnaire.item	Maximum length can only be declared for simple question types	`(type in ('boolean' \| 'decimal' \| 'integer' \| 'string' \| 'text' \| 'url')) or answerConstraint='optionOrString' or maxLength.empty()`
que-11	error	Questionnaire.item	If one or more answerOption is present, initial cannot be present. Use answerOption.initialSelected instead	`answerOption.empty() or initial.empty()`
que-12	error	Questionnaire.item	If there are more than one enableWhen, enableBehavior must be specified	`enableWhen.count() > 1 implies enableBehavior.exists()`
que-13	error	Questionnaire.item	Can only have multiple initial values for repeating items	`repeats=true or initial.count() <= 1`
que-14	warning	Questionnaire.item	Can only have answerConstraint if answerOption or answerValueSet are present. (This is a warning because extensions may serve the same purpose)	`answerConstraint.exists() implies answerOption.exists() or answerValueSet.exists()`
que-15	warning	Questionnaire.item.linkId	Link ids should be 255 characters or less	`$this.length() <= 255`

Differential View

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Questionnaire		0..*	Questionnaire(5.0.0)	A structured set of questions Interfaces Implemented: MetadataResource
url	S	0..1	uri	Canonical identifier for this questionnaire, represented as an absolute URI (globally unique)
identifier	S	0..*	Identifier	Business identifier for questionnaire
version	S	0..1	string	Business version of the questionnaire
name	S	0..1	string	Name for this questionnaire (computer friendly)
title	S	1..1	string	Questionnaire title (in Uzbek language)
Slices for extension		0..*	Extension	Questionnaire title (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation
status	S	1..1	code	draft \| active \| retired \| unknown
subjectType	S	0..*	code	Resource types that can be subject of this questionnaire
publisher	S	0..1	string	Name of the publisher/steward (organization or individual)
description	S	0..1	markdown	Natural language description of the questionnaire
Slices for extension		0..*	Extension	Description (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation
useContext	S	0..*	UsageContext	The context that the content is intended to support
jurisdiction	S	0..*	CodeableConcept	Intended jurisdiction for questionnaire (if applicable)
purpose	S	0..1	markdown	Why this questionnaire is defined
effectivePeriod	S	0..1	Period	When the questionnaire is expected to be used
item	S	0..*	BackboneElement	Questions and sections within the Questionnaire
linkId	S	1..1	string	Unique id for item in questionnaire
definition	S	0..1	uri	ElementDefinition - details for the item
code	S	0..*	Coding	Corresponding concept for this item in a terminology
prefix	S	0..1	string	E.g. "1(a)", "2.5.3"
Slices for extension		0..*	Extension	Item prefix (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation
text	S	0..1	string	Primary text for the item
Slices for extension		0..*	Extension	Item text (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation
type	S	1..1	code	group \| display \| boolean \| decimal \| integer \| date \| dateTime +
enableWhen	S	0..*	BackboneElement	Only allow data when
required	S	0..1	boolean	Whether the item must be included in data results
repeats	S	0..1	boolean	Whether the item may repeat
readOnly	S	0..1	boolean	Don't allow human editing
maxLength	S	0..1	integer	No more than these many characters
answerConstraint	S	0..1	code	optionsOnly \| optionsOrType \| optionsOrString
answerValueSet	S	0..1	canonical(ValueSet)	ValueSet containing permitted answers
answerOption	S	0..*	BackboneElement	Permitted answer
Slices for value[x]	S	1..1	integer, date, time, string, Coding, Reference(Resource)	Answer value Slice: Unordered, Open by type:$this
value[x]:valueCoding	S	0..1	Coding	Answer value
display
Slices for extension		0..*	Extension	Answer option display (in Russian and Karakalpak languages) Slice: Unordered, Open by value:url
extension:translation	S	0..*	(Complex)	Language Translation (Localization) URL: http://hl7.org/fhir/StructureDefinition/translation
initial	S	0..*	BackboneElement	Initial value(s) when item is first rendered
item	S	0..*		Nested questionnaire items
Documentation for this format

Snapshot ViewView

Description & Constraints Filter: Filters

Questionnaire

C

0..*

Questionnaire(5.0.0)

A structured set of questions
Interfaces Implemented: MetadataResource
Constraints: cnl-0, que-2

id

Σ

0..1

id

Logical id of this artifact

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Questionnaire.language	Base	required	All Languages	📍5.0.0	FHIR Std.
Questionnaire.versionAlgorithm[x]	Base	extensible	Version Algorithm	📍5.0.0	FHIR Std.
Questionnaire.status	Base	required	PublicationStatus	📍5.0.0	FHIR Std.
Questionnaire.subjectType	Base	required	Resource Types	📍5.0.0	FHIR Std.
Questionnaire.jurisdiction	Base	extensible	Jurisdiction ValueSet	📍5.0.0	FHIR Std.
Questionnaire.code	Base	example	Questionnaire Question Codes	📍5.0.0	FHIR Std.
Questionnaire.item.code	Base	example	Questionnaire Question Codes	📍5.0.0	FHIR Std.
Questionnaire.item.type	Base	required	Questionnaire Item Type	📍5.0.0	FHIR Std.
Questionnaire.item.enableWhen.operator	Base	required	Questionnaire Item Operator	📍5.0.0	FHIR Std.
Questionnaire.item.enableWhen.answer[x]	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.
Questionnaire.item.enableBehavior	Base	required	Enable When Behavior	📍5.0.0	FHIR Std.
Questionnaire.item.disabledDisplay	Base	required	Questionnaire Item Disabled Display	📍5.0.0	FHIR Std.
Questionnaire.item.answerConstraint	Base	required	Questionnaire answer constraints value set	📍5.0.0	FHIR Std.
Questionnaire.item.answerOption.value[x]	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.
Questionnaire.item.answerOption.value[x]:valueCoding	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.
Questionnaire.item.initial.value[x]	Base	example	Questionnaire Answer Codes	📍5.0.0	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
cnl-0	warning	Questionnaire	Name should be usable as an identifier for the module by machine processing applications such as code generation	`name.exists() implies name.matches('^[A-Z]([A-Za-z0-9_]){1,254}$')`
cnl-1	warning	Questionnaire.url	URL should not contain \| or # - these characters make processing canonical references problematic	`exists() implies matches('^[^\|# ]+$')`
ele-1	error	Questionnaire.meta, Questionnaire.implicitRules, Questionnaire.language, Questionnaire.text, Questionnaire.extension, Questionnaire.modifierExtension, Questionnaire.url, Questionnaire.identifier, Questionnaire.version, Questionnaire.versionAlgorithm[x], Questionnaire.name, Questionnaire.title, Questionnaire.title.extension, Questionnaire.title.extension:translation, Questionnaire.derivedFrom, Questionnaire.status, Questionnaire.experimental, Questionnaire.subjectType, Questionnaire.date, Questionnaire.publisher, Questionnaire.contact, Questionnaire.description, Questionnaire.description.extension, Questionnaire.description.extension:translation, Questionnaire.useContext, Questionnaire.jurisdiction, Questionnaire.purpose, Questionnaire.copyright, Questionnaire.copyrightLabel, Questionnaire.approvalDate, Questionnaire.lastReviewDate, Questionnaire.effectivePeriod, Questionnaire.code, Questionnaire.item, Questionnaire.item.extension, Questionnaire.item.modifierExtension, Questionnaire.item.linkId, Questionnaire.item.definition, Questionnaire.item.code, Questionnaire.item.prefix, Questionnaire.item.prefix.extension, Questionnaire.item.prefix.extension:translation, Questionnaire.item.text, Questionnaire.item.text.extension, Questionnaire.item.text.extension:translation, Questionnaire.item.type, Questionnaire.item.enableWhen, Questionnaire.item.enableWhen.extension, Questionnaire.item.enableWhen.modifierExtension, Questionnaire.item.enableWhen.question, Questionnaire.item.enableWhen.operator, Questionnaire.item.enableWhen.answer[x], Questionnaire.item.enableBehavior, Questionnaire.item.disabledDisplay, Questionnaire.item.required, Questionnaire.item.repeats, Questionnaire.item.readOnly, Questionnaire.item.maxLength, Questionnaire.item.answerConstraint, Questionnaire.item.answerValueSet, Questionnaire.item.answerOption, Questionnaire.item.answerOption.extension, Questionnaire.item.answerOption.modifierExtension, Questionnaire.item.answerOption.value[x], Questionnaire.item.answerOption.value[x]:valueCoding, Questionnaire.item.answerOption.value[x]:valueCoding.extension, Questionnaire.item.answerOption.value[x]:valueCoding.system, Questionnaire.item.answerOption.value[x]:valueCoding.version, Questionnaire.item.answerOption.value[x]:valueCoding.code, Questionnaire.item.answerOption.value[x]:valueCoding.display, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension:translation, Questionnaire.item.answerOption.value[x]:valueCoding.userSelected, Questionnaire.item.answerOption.initialSelected, Questionnaire.item.initial, Questionnaire.item.initial.extension, Questionnaire.item.initial.modifierExtension, Questionnaire.item.initial.value[x], Questionnaire.item.item	All FHIR elements must have a @value or children	`hasValue() or (children().count() > id.count())`
ext-1	error	Questionnaire.extension, Questionnaire.modifierExtension, Questionnaire.title.extension, Questionnaire.title.extension:translation, Questionnaire.description.extension, Questionnaire.description.extension:translation, Questionnaire.item.extension, Questionnaire.item.modifierExtension, Questionnaire.item.prefix.extension, Questionnaire.item.prefix.extension:translation, Questionnaire.item.text.extension, Questionnaire.item.text.extension:translation, Questionnaire.item.enableWhen.extension, Questionnaire.item.enableWhen.modifierExtension, Questionnaire.item.answerOption.extension, Questionnaire.item.answerOption.modifierExtension, Questionnaire.item.answerOption.value[x]:valueCoding.extension, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension, Questionnaire.item.answerOption.value[x]:valueCoding.display.extension:translation, Questionnaire.item.initial.extension, Questionnaire.item.initial.modifierExtension	Must have either extensions or value[x], not both	`extension.exists() != value.exists()`
que-1a	error	Questionnaire.item	Group items must have nested items when Questionanire is complete	`(type='group' and %resource.status='complete') implies item.empty().not()`
que-1b	warning	Questionnaire.item	Groups should have items	`type='group' implies item.empty().not()`
que-1c	error	Questionnaire.item	Display items cannot have child items	`type='display' implies item.empty()`
que-2	error	Questionnaire	The link ids for groups and questions must be unique within the questionnaire	`descendants().linkId.isDistinct()`
que-3	error	Questionnaire.item	Display items cannot have a "code" asserted	`type!='display' or code.empty()`
que-4	error	Questionnaire.item	A question cannot have both answerOption and answerValueSet	`answerOption.empty() or answerValueSet.empty()`
que-5	error	Questionnaire.item	Only coding, decimal, integer, date, dateTime, time, string or quantity items can have answerOption or answerValueSet	`(type='coding' or type = 'decimal' or type = 'integer' or type = 'date' or type = 'dateTime' or type = 'time' or type = 'string' or type = 'quantity') or (answerValueSet.empty() and answerOption.empty())`
que-6	error	Questionnaire.item	Required and repeat aren't permitted for display items	`type!='display' or (required.empty() and repeats.empty())`
que-7	error	Questionnaire.item.enableWhen	If the operator is 'exists', the value must be a boolean	`operator = 'exists' implies (answer is boolean)`
que-8	error	Questionnaire.item	Initial values can't be specified for groups or display items	`(type!='group' and type!='display') or initial.empty()`
que-9	error	Questionnaire.item	Read-only can't be specified for "display" items	`type!='display' or readOnly.empty()`
que-10	error	Questionnaire.item	Maximum length can only be declared for simple question types	`(type in ('boolean' \| 'decimal' \| 'integer' \| 'string' \| 'text' \| 'url')) or answerConstraint='optionOrString' or maxLength.empty()`
que-11	error	Questionnaire.item	If one or more answerOption is present, initial cannot be present. Use answerOption.initialSelected instead	`answerOption.empty() or initial.empty()`
que-12	error	Questionnaire.item	If there are more than one enableWhen, enableBehavior must be specified	`enableWhen.count() > 1 implies enableBehavior.exists()`
que-13	error	Questionnaire.item	Can only have multiple initial values for repeating items	`repeats=true or initial.count() <= 1`
que-14	warning	Questionnaire.item	Can only have answerConstraint if answerOption or answerValueSet are present. (This is a warning because extensions may serve the same purpose)	`answerConstraint.exists() implies answerOption.exists() or answerValueSet.exists()`
que-15	warning	Questionnaire.item.linkId	Link ids should be 255 characters or less	`$this.length() <= 255`

Summary

Mandatory: 1 element
Must-Support: 37 elements

Extensions

This structure refers to these extensions:

http://hl7.org/fhir/StructureDefinition/translation|5.3.0

Slices

This structure defines the following Slices:

The element 1 is sliced based on the value of Questionnaire.item.answerOption.value[x]

Other representations of profile: CSV, Excel, Schematron

Quick Start

A Questionnaire is a template, not patient data, so searches are by form metadata rather than by patient. [base] is the FHIR server base URL; | separates system from value and must be URL-encoded as %7C.

Read by server id

GET [base]/Questionnaire/[id]

Find questionnaires

GET [base]/Questionnaire?status=active
GET [base]/Questionnaire?name=PatientHealthDeclaration
GET [base]/Questionnaire?title=Health
GET [base]/Questionnaire?url=https://dhp.uz/fhir/core/Questionnaire/health-declaration
GET [base]/Questionnaire?version=1.0.0
GET [base]/Questionnaire?date=ge2025-01-01
GET [base]/Questionnaire?context=...

Create

POST [base]/Questionnaire
{
  "resourceType": "Questionnaire",
  "meta": { "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-questionnaire" ] },
  "status": "draft",
  "title": "...",
  "item": [ ... ],
  ...
}

Update (e.g. publish a draft by setting status to active, or retire an old template) - PUT the full resource back with the new status:

PUT [base]/Questionnaire/[id]
If-Match: W/"3"   # the ETag from your last read; 412 if it changed since

See the CapabilityStatement for all supported search parameters.

< prev

top

next >

IG © 2025+ Ministry of Health of the Republic of Uzbekistan. Package uz.dhp.core#0.5.0 based on FHIR 5.0.0. Generated 2026-06-05
Links: Table of Contents | QA Report

Resource Profile: UZ Core Questionnaire ( Experimental )

Mandatory and Must Support data elements

Each UZ Core Questionnaire Must Have

Each UZ Core Questionnaire Must Support

Building the JSON, step by step

The smallest Questionnaire you should send

A realistic multilingual form

Formal Views of Profile Content

Terminology Bindings

Constraints

Terminology Bindings

Constraints

Terminology Bindings

Constraints

Terminology Bindings

Constraints

Quick Start

Related