FHIR © HL7.org  |  FHIRsmith 4.0.1  |  Server Home  |  XIG Home  |  XIG Stats  | 

FHIR IG analytics

Packagehl7.fhir.uv.xver-r5.r4
Resource TypeConceptMap
IdConceptMap-R5-Questionnaire-element-map-to-R4.json
FHIR VersionR4
Sourcehttp://hl7.org/fhir/uv/xver-r5.r4/0.1.0/ConceptMap-R5-Questionnaire-element-map-to-R4.html
URLhttp://hl7.org/fhir/uv/xver/ConceptMap/R5-Questionnaire-element-map-to-R4
Version0.1.0
Statusactive
Date2026-03-17T16:04:47.7237515-05:00
NameR5QuestionnaireElementMapToR4
TitleCross-version mapping for FHIR R5 Questionnaire to FHIR R4 Questionnaire
Realmuv
Authorityhl7
DescriptionThis ConceptMap represents cross-version mappings for elements from a FHIR R5 Questionnaire to FHIR R4.

Resources that use this resource

No resources found


Resources that this resource uses

StructureDefinition
hl7.fhir.uv.xver-r5.r4.r4#0.0.1-snapshot-2extension-Questionnaire.item.answerConstraintCross-version Extension for R5.Questionnaire.item.answerConstraint for use in FHIR R4
hl7.fhir.uv.xver-r5.r4.r4#0.0.1-snapshot-2extension-Questionnaire.item.disabledDisplayCross-version Extension for R5.Questionnaire.item.disabledDisplay for use in FHIR R4
hl7.fhir.uv.xver-r5.r4.r4#0.0.1-snapshot-2extension-Questionnaire.subjectTypeCross-version Extension for R5.Questionnaire.subjectType for use in FHIR R4

Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: ConceptMap R5-Questionnaire-element-map-to-R4

Mapping from http://hl7.org/fhir/5.0 to http://hl7.org/fhir/4.0


Group 1 Mapping from http://hl7.org/fhir/StructureDefinition/Questionnaire|5.0.0 to Questionnaireversion: 4.0.1)

Source CodeRelationshipTarget CodeComment
Questionnaire.meta (meta)is equivalent toQuestionnaire.metaElement `Questionnaire.meta` is mapped to FHIR R4 element `Questionnaire.meta` as `Equivalent`.
Questionnaire.implicitRules (implicitRules)is equivalent toQuestionnaire.implicitRulesElement `Questionnaire.implicitRules` is mapped to FHIR R4 element `Questionnaire.implicitRules` as `Equivalent`. Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of its narrative along with other profiles, value sets, etc.
Questionnaire.language (language)is equivalent toQuestionnaire.languageElement `Questionnaire.language` is mapped to FHIR R4 element `Questionnaire.language` as `Equivalent`. Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute).
Questionnaire.text (text)is equivalent toQuestionnaire.textElement `Questionnaire.text` is mapped to FHIR R4 element `Questionnaire.text` as `Equivalent`. Contained resources do not have a narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later.
Questionnaire.contained (contained)is equivalent toQuestionnaire.containedElement `Questionnaire.contained` is mapped to FHIR R4 element `Questionnaire.contained` as `Equivalent`. This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags in their meta elements, but SHALL NOT have security labels.
Questionnaire.url (url)is equivalent toQuestionnaire.urlElement `Questionnaire.url` is mapped to FHIR R4 element `Questionnaire.url` as `Equivalent`. Can be a urn:uuid: or a urn:oid: but real http: addresses are preferred. Multiple instances may share the same URL if they have a distinct version. The determination of when to create a new version of a resource (same url, new version) vs. defining a new artifact is up to the author. Considerations for making this decision are found in [Technical and Business Versions](https://hl7.org/fhir/resource..html#versions). In some cases, the resource can no longer be found at the stated url, but the url itself cannot change. Implementations can use the [meta.source](https://hl7.org/fhir/resou.html#meta) element to indicate where the current master source of the resource can be found. The name of the referenced questionnaire can be conveyed using the http://hl7.org/fhir/StructureDefinition/display extension.
Questionnaire.identifier (identifier)is equivalent toQuestionnaire.identifierElement `Questionnaire.identifier` is mapped to FHIR R4 element `Questionnaire.identifier` as `Equivalent`. Typically, this is used for identifiers that can go in an HL7 V3 II (instance identifier) data type, and can then identify this questionnaire outside of FHIR, where it is not possible to use the logical URI.
Questionnaire.version (version)is equivalent toQuestionnaire.versionElement `Questionnaire.version` is mapped to FHIR R4 element `Questionnaire.version` as `Equivalent`. There may be different questionnaires that have the same url but different versions. The version can be appended to the url in a reference to allow a reference to a particular business version of the questionnaire with the format. The version SHOULD NOT contain a '#' - see [Business Version](https://hl7.org/fhir/resource.h.html#bv-format).
Questionnaire.name (name)is equivalent toQuestionnaire.nameElement `Questionnaire.name` is mapped to FHIR R4 element `Questionnaire.name` as `Equivalent`. The name is not expected to be globally unique. The name should be a simple alphanumeric type no-whitespace name to ensure that it is machine-processing friendly.
Questionnaire.title (title)is equivalent toQuestionnaire.titleElement `Questionnaire.title` is mapped to FHIR R4 element `Questionnaire.title` as `Equivalent`. This name does not need to be machine-processing friendly and may contain punctuation, white-space, etc.
Questionnaire.derivedFrom (derivedFrom)is equivalent toQuestionnaire.derivedFromElement `Questionnaire.derivedFrom` is mapped to FHIR R4 element `Questionnaire.derivedFrom` as `Equivalent`. This element covers a broad range of relationships, from 'somewhat inspired by' to 'fully compliant with'. There is a standard extensionthat allows clearer differentiation between the specifics of the derivation relationship where this is needed - e.g. to determine substitutability and validation expectations - [http://hl7.org/fhir/StructureDefinition/questionnaire-derivationType](http://hl7.org/fhir/extensions/StructureDefinition-questionnaire-derivationType.html).
Questionnaire.status (status)is equivalent toQuestionnaire.statusElement `Questionnaire.status` is mapped to FHIR R4 element `Questionnaire.status` as `Equivalent`. A nominal state-transition diagram can be found in the] documentation Unknown does not represent 'other' - one of the defined statuses must apply. Unknown is used when the authoring system is not sure what the current status is. See guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization).
Questionnaire.experimental (experimental)is equivalent toQuestionnaire.experimentalElement `Questionnaire.experimental` is mapped to FHIR R4 element `Questionnaire.experimental` as `Equivalent`. Allows filtering of questionnaires that are appropriate for use versus not.
Questionnaire.subjectType (subjectType)maps to wider conceptQuestionnaire.subjectTypeElement `Questionnaire.subjectType` is mapped to FHIR R4 element `Questionnaire.subjectType` as `RelatedTo`. The mappings for `Questionnaire.subjectType` do not allow expression of the necessary codes, per the bindings on the source and target. If none are specified, then the subject is unlimited.
Questionnaire.date (date)is equivalent toQuestionnaire.dateElement `Questionnaire.date` is mapped to FHIR R4 element `Questionnaire.date` as `Equivalent`. The date is often not tracked until the resource is published, but may be present on draft content. Note that this is not the same as the resource last-modified-date, since the resource may be a secondary representation of the questionnaire. Additional specific dates may be added as extensions or be found by consulting Provenances associated with past versions of the resource. See guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization).
Questionnaire.publisher (publisher)is equivalent toQuestionnaire.publisherElement `Questionnaire.publisher` is mapped to FHIR R4 element `Questionnaire.publisher` as `Equivalent`. Usually an organization but may be an individual. The publisher (or steward) of the questionnaire is the organization or individual primarily responsible for the maintenance and upkeep of the questionnaire. This is not necessarily the same individual or organization that developed and initially authored the content. The publisher is the primary point of contact for questions or issues with the questionnaire. This item SHOULD be populated unless the information is available from context.
Questionnaire.contact (contact)is equivalent toQuestionnaire.contactElement `Questionnaire.contact` is mapped to FHIR R4 element `Questionnaire.contact` as `Equivalent`. May be a web site, an email address, a telephone number, etc. See guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization).
Questionnaire.description (description)is equivalent toQuestionnaire.descriptionElement `Questionnaire.description` is mapped to FHIR R4 element `Questionnaire.description` as `Equivalent`. This description can be used to capture details such as comments about misuse, instructions for clinical use and interpretation, literature references, examples from the paper world, etc. It is not a rendering of the questionnaire as conveyed in the 'text' field of the resource itself. This item SHOULD be populated unless the information is available from context. (E.g. the language of the questionnaire is presumed to be the predominant language in the place the questionnaire was created).
Questionnaire.useContext (useContext)is equivalent toQuestionnaire.useContextElement `Questionnaire.useContext` is mapped to FHIR R4 element `Questionnaire.useContext` as `Equivalent`. When multiple useContexts are specified, there is no expectation that all or even any of the contexts apply.
Questionnaire.jurisdiction (jurisdiction)is equivalent toQuestionnaire.jurisdictionElement `Questionnaire.jurisdiction` is mapped to FHIR R4 element `Questionnaire.jurisdiction` as `Equivalent`. Element `Questionnaire.jurisdiction` has been flagged as deprecated. It may be possible for the questionnaire to be used in jurisdictions other than those for which it was originally designed or intended. DEPRECATION NOTE: For consistency, implementations are encouraged to migrate to using the new 'jurisdiction' code in the useContext element. (I.e. useContext.code indicating http://terminology.hl7.org/CodeSystem/usage-context-type#jurisdiction and useContext.valueCodeableConcept indicating the jurisdiction.)
Questionnaire.purpose (purpose)is equivalent toQuestionnaire.purposeElement `Questionnaire.purpose` is mapped to FHIR R4 element `Questionnaire.purpose` as `Equivalent`. This element does not describe the usage of the questionnaire. Instead, it provides traceability of ''why'' the resource is either needed or ''why'' it is defined as it is. This may be used to point to source materials or specifications that drove the structure of this questionnaire.
Questionnaire.copyright (copyright)is equivalent toQuestionnaire.copyrightElement `Questionnaire.copyright` is mapped to FHIR R4 element `Questionnaire.copyright` as `Equivalent`.
Questionnaire.approvalDate (approvalDate)is equivalent toQuestionnaire.approvalDateElement `Questionnaire.approvalDate` is mapped to FHIR R4 element `Questionnaire.approvalDate` as `Equivalent`. The 'date' element may be more recent than the approval date because of minor changes or editorial corrections. See guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization).
Questionnaire.lastReviewDate (lastReviewDate)is equivalent toQuestionnaire.lastReviewDateElement `Questionnaire.lastReviewDate` is mapped to FHIR R4 element `Questionnaire.lastReviewDate` as `Equivalent`. If specified, this date follows the original approval date. See guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization).
Questionnaire.effectivePeriod (effectivePeriod)is equivalent toQuestionnaire.effectivePeriodElement `Questionnaire.effectivePeriod` is mapped to FHIR R4 element `Questionnaire.effectivePeriod` as `Equivalent`. The effective period for a questionnaire determines when the content is applicable for usage and is independent of publication and review dates. For example, a questionnaire intended to be used for the year 2016 might be published in 2015. See guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization).
Questionnaire.code (code)is equivalent toQuestionnaire.codeElement `Questionnaire.code` is mapped to FHIR R4 element `Questionnaire.code` as `Equivalent`.
Questionnaire.item (item)maps to wider conceptQuestionnaire.itemElement `Questionnaire.item` is mapped to FHIR R4 element `Questionnaire.item` as `Equivalent`. The content of the questionnaire is constructed from an ordered, hierarchical collection of items.
Questionnaire.item.linkId (linkId)is equivalent toQuestionnaire.item.linkIdElement `Questionnaire.item.linkId` is mapped to FHIR R4 element `Questionnaire.item.linkId` as `Equivalent`. This ''can'' be a meaningful identifier (e.g. a LOINC code) but is not intended to have any meaning. GUIDs or sequential numbers are appropriate here. LinkIds can have whitespaces and slashes by design. Tooling should not rely on linkIds being valid XHTML element IDs, and should not directly embed them as such
Questionnaire.item.definition (definition)is equivalent toQuestionnaire.item.definitionElement `Questionnaire.item.definition` is mapped to FHIR R4 element `Questionnaire.item.definition` as `Equivalent`. The uri refers to an ElementDefinition in a [StructureDefinition](https://hl7.org/fhir/s.html#) or to an [ObservationDefinition](https://hl7.org/fhir/observationdefinition.html) and always starts with the [canonical URL](https://hl7.org/fhir/references.html#canonical) for the target resource. When referring to a StructureDefinition, a fragment identifier is used to specify the element definition by its id [Element.id](https://hl7.org/fhir/types-defin.html#Element.id). E.g. http://hl7.org/fhir/StructureDefinition/Observation#Observation.value[x]. In the absence of a fragment identifier, the first/root element definition in the target is the matching element definition.
Questionnaire.item.code (code)is equivalent toQuestionnaire.item.codeElement `Questionnaire.item.code` is mapped to FHIR R4 element `Questionnaire.item.code` as `Equivalent`. The value may come from the ElementDefinition referred to by .definition.
Questionnaire.item.prefix (prefix)is equivalent toQuestionnaire.item.prefixElement `Questionnaire.item.prefix` is mapped to FHIR R4 element `Questionnaire.item.prefix` as `Equivalent`. These are generally unique within a questionnaire, though this is not guaranteed. Some questionnaires may have multiple questions with the same label with logic to control which gets exposed. Typically, these won't be used for "display" items, though such use is not prohibited. Systems SHOULD NOT generate their own prefixes if prefixes are defined for any items within a Questionnaire.
Questionnaire.item.text (text)is equivalent toQuestionnaire.item.textElement `Questionnaire.item.text` is mapped to FHIR R4 element `Questionnaire.item.text` as `Equivalent`. When using this element to represent the name of a section, use group type item and also make sure to limit the text element to a short string suitable for display as a section heading. Group item instructions should be included as a display type item within the group.
Questionnaire.item.type (type)is equivalent toQuestionnaire.item.typeElement `Questionnaire.item.type` is mapped to FHIR R4 element `Questionnaire.item.type` as `SourceIsNarrowerThanTarget`. The mappings for `Questionnaire.item.type` do not allow expression of the necessary codes, per the bindings on the source and target. Additional constraints on the type of answer can be conveyed by extensions. The value may come from the ElementDefinition referred to by .definition.
Questionnaire.item.enableWhen (enableWhen)maps to wider conceptQuestionnaire.item.enableWhenElement `Questionnaire.item.enableWhen` is mapped to FHIR R4 element `Questionnaire.item.enableWhen` as `Equivalent`. If multiple repetitions of this extension are present, the interpretation is driven by enableBehavior (either all repetitions must evaluate to true for this item to be enabled, or only one must evaluate to true for the item to be enabled). If the enableWhen.question has multiple answers, the condition evaluates to true if *any* of the answers for the referenced item match the enableWhen condition. This element is a modifier because if enableWhen is present for an item, "required" is ignored unless one of the enableWhen conditions is met. When an item is disabled, all of its descendants are disabled, regardless of what their own enableWhen logic might evaluate to. If enableWhen logic depends on an item that is disabled, the logic should proceed as though the item is not valued - even if a default value or other value might be retained in memory in the event of the item being re-enabled. In some cases, the comparison between the indicated answer and the specified value may differ only by precision. For example, the enableWhen might be Q1 > 1970, but the answer to Q1 is 1970-10-15. There is not a clear answer as to whether 1970-10-15 should be considered 'greater' than 1970, given that it is an imprecise value. In these indeterminate situations, the form filler has the option of refusing to render the form. If the form **is** displayed, items where enableWhen is indeterminate SHOULD be treated as enabled with a warning indicating that the questionnaire logic was faulty and it is possible that the item should not be enabled. Questionnaires SHOULD be designed to take into account challenges around varying precision to minimize non-deterministic situations by setting constraints around expected precision, etc.
Questionnaire.item.enableWhen.question (question)is equivalent toQuestionnaire.item.enableWhen.questionElement `Questionnaire.item.enableWhen.question` is mapped to FHIR R4 element `Questionnaire.item.enableWhen.question` as `Equivalent`. If multiple question occurrences are present for the same question (same linkId), then this refers to the nearest question occurrence reachable by tracing first the "ancestor" axis and then the "preceding" axis and then the "following" axis. If there are multiple items with the same linkId and all are equadistant (e.g. a question references a question that appears in a separate repeating group), that is an error. (Consider using the enableWhenExpression extension to define logic to handle such a situation.)
Questionnaire.item.enableWhen.operator (operator)is equivalent toQuestionnaire.item.enableWhen.operatorElement `Questionnaire.item.enableWhen.operator` is mapped to FHIR R4 element `Questionnaire.item.enableWhen.operator` as `Equivalent`.
Questionnaire.item.enableWhen.answer[x] (answer[x])is equivalent toQuestionnaire.item.enableWhen.answer[x]Element `Questionnaire.item.enableWhen.answer[x]` is mapped to FHIR R4 element `Questionnaire.item.enableWhen.answer[x]` as `RelatedTo`. The target context `Questionnaire.item.enableWhen.answer[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Questionnaire.item.enableWhen`.
Questionnaire.item.enableBehavior (enableBehavior)is equivalent toQuestionnaire.item.enableBehaviorElement `Questionnaire.item.enableBehavior` is mapped to FHIR R4 element `Questionnaire.item.enableBehavior` as `Equivalent`. This element must be specified if more than one enableWhen value is provided.
Questionnaire.item.required (required)is equivalent toQuestionnaire.item.requiredElement `Questionnaire.item.required` is mapped to FHIR R4 element `Questionnaire.item.required` as `Equivalent`. If the required item is a question, it must have a direct answer (i.e. an answer to the question itself, not merely answers to child questions) in order for the QuestionnaireResponse to be complete. If the required item is a group, it must have at least one descendant question which has an answer Questionnaire.item.required only has meaning for elements that are conditionally enabled with enableWhen if the condition evaluates to true. It also only has meaning if the parent element is present. If a non-required 'group' item contains a 'required' question item, it's completely fine to omit the group (because it's not required) despite it having a required child. Similarly, if an item that contains other items is marked as required, that does not automatically make the contained elements required (though required groups must contain at least one descendant item with a populated answer). The value for 'required' may come from the ElementDefinition referred to by .definition.
Questionnaire.item.repeats (repeats)is equivalent toQuestionnaire.item.repeatsElement `Questionnaire.item.repeats` is mapped to FHIR R4 element `Questionnaire.item.repeats` as `Equivalent`. If a question is marked as repeats=true, then multiple answers can be provided for the question in the corresponding QuestionnaireResponse. When rendering the questionnaire, it is up to the rendering software whether to render the question text for each answer repetition (i.e. "repeat the question") or to simply allow entry/selection of multiple answers for the question (repeat the answers). Which is most appropriate visually may depend on the type of answer as well as whether there are nested items. The resulting QuestionnaireResponse will be populated the same way regardless of rendering - one 'question' item with multiple answer values. The value may come from the ElementDefinition referred to by .definition. When repeats=true for a group, it'll be represented with multiple items with the same linkId in the QuestionnaireResponse. For a question, it'll be represented by a single item with that linkId with multiple answers.
Questionnaire.item.readOnly (readOnly)is equivalent toQuestionnaire.item.readOnlyElement `Questionnaire.item.readOnly` is mapped to FHIR R4 element `Questionnaire.item.readOnly` as `Equivalent`. If specified on a 'group', then all items beneath the specified group are read only. For questions, this only marks the answer associated with the specific item read only. Descendant questions are not impacted. The value of readOnly elements can be established by asserting extensions for defaultValues, linkages that support pre-population and/or extensions that support calculation based on other answers.
Questionnaire.item.maxLength (maxLength)is equivalent toQuestionnaire.item.maxLengthElement `Questionnaire.item.maxLength` is mapped to FHIR R4 element `Questionnaire.item.maxLength` as `Equivalent`. For base64binary, reflects the number of characters representing the encoded data, not the number of bytes of the binary data. The value may come from the ElementDefinition referred to by .definition.
Questionnaire.item.answerValueSet (answerValueSet)is equivalent toQuestionnaire.item.answerValueSetElement `Questionnaire.item.answerValueSet` is mapped to FHIR R4 element `Questionnaire.item.answerValueSet` as `Equivalent`. LOINC defines many useful value sets for questionnaire responses. See [LOINC Answer Lists](https://terminology.hl7.org/LOINC.html). The value may come from the ElementDefinition referred to by .definition.
Questionnaire.item.answerOption (answerOption)maps to wider conceptQuestionnaire.item.answerOptionElement `Questionnaire.item.answerOption` is mapped to FHIR R4 element `Questionnaire.item.answerOption` as `Equivalent`. This element can be used when the value set machinery of answerValueSet is deemed too cumbersome or when there's a need to capture possible answers that are not codes.
Questionnaire.item.answerOption.value[x] (value[x])is equivalent toQuestionnaire.item.answerOption.value[x]Element `Questionnaire.item.answerOption.value[x]` is mapped to FHIR R4 element `Questionnaire.item.answerOption.value[x]` as `Equivalent`. The target context `Questionnaire.item.answerOption.value[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Questionnaire.item.answerOption`. The data type of the value must agree with the item.type.
Questionnaire.item.answerOption.initialSelected (initialSelected)is equivalent toQuestionnaire.item.answerOption.initialSelectedElement `Questionnaire.item.answerOption.initialSelected` is mapped to FHIR R4 element `Questionnaire.item.answerOption.initialSelected` as `Equivalent`.
Questionnaire.item.initial (initial)maps to wider conceptQuestionnaire.item.initialElement `Questionnaire.item.initial` is mapped to FHIR R4 element `Questionnaire.item.initial` as `Equivalent`. The user is allowed to change the value and override the default (unless marked as read-only). If the user doesn't change the value, then this initial value will be persisted when the QuestionnaireResponse is initially created. Note that initial values can influence results. The data type of initial.answer[x] must agree with the item.type, and only repeating items can have more then one initial value.
Questionnaire.item.initial.value[x] (value[x])is equivalent toQuestionnaire.item.initial.value[x]Element `Questionnaire.item.initial.value[x]` is mapped to FHIR R4 element `Questionnaire.item.initial.value[x]` as `RelatedTo`. The target context `Questionnaire.item.initial.value[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Questionnaire.item.initial`. The type of the initial value must be consistent with the type of the item.
Questionnaire.item.item (item)is equivalent toQuestionnaire.item.itemElement `Questionnaire.item.item` is mapped to FHIR R4 element `Questionnaire.item.item` as `Equivalent`. There is no specified limit to the depth of nesting. However, Questionnaire authors are encouraged to consider the impact on the user and user interface of overly deep nesting.

Group 2 Mapping from http://hl7.org/fhir/StructureDefinition/Questionnaire|5.0.0 to R5: subjectType additional codesversion: 0.1.0)

Source CodeRelationshipTarget CodeComment
Questionnaire.subjectType (subjectType)is equivalent toExtension (R5: subjectType additional codes)Element `Questionnaire.subjectType` is mapped to FHIR R4 element `Questionnaire.subjectType` as `RelatedTo`. The mappings for `Questionnaire.subjectType` do not allow expression of the necessary codes, per the bindings on the source and target. If none are specified, then the subject is unlimited.

Group 3 Mapping from http://hl7.org/fhir/StructureDefinition/Questionnaire|5.0.0 to R5: hidden | protected (new)version: 0.1.0)

Source CodeRelationshipTarget CodeComment
Questionnaire.item.disabledDisplay (disabledDisplay)maps to wider conceptExtension (R5: hidden | protected (new))Element `Questionnaire.item.disabledDisplay` has a context of Questionnaire.item based on following the parent source element upwards and mapping to `Questionnaire`. Element `Questionnaire.item.disabledDisplay` has no mapping targets in FHIR R4. Typically, this is because the element has been added (is a new element). If not specified, rendering behavior is up to the client. This element is only meaningful if enableWhen or an equivalent extension is present

Group 4 Mapping from http://hl7.org/fhir/StructureDefinition/Questionnaire|5.0.0 to R5: optionsOnly | optionsOrType | optionsOrString (new)version: 0.1.0)

Source CodeRelationshipTarget CodeComment
Questionnaire.item.answerConstraint (answerConstraint)is equivalent toExtension (R5: optionsOnly | optionsOrType | optionsOrString (new))Element `Questionnaire.item.answerConstraint` has a context of Questionnaire.item based on following the parent source element upwards and mapping to `Questionnaire`. Element `Questionnaire.item.answerConstraint` has no mapping targets in FHIR R4. Typically, this is because the element has been added (is a new element).

Source1

{
  "resourceType": "ConceptMap",
  "id": "R5-Questionnaire-element-map-to-R4",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "fhir"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 0,
      "_valueInteger": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/uv/xver/ImplementationGuide/hl7.fhir.uv.xver-r5.r4"
          }
        ]
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode": "trial-use",
      "_valueCode": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/uv/xver/ImplementationGuide/hl7.fhir.uv.xver-r5.r4"
          }
        ]
      }
    }
  ],
  "url": "http://hl7.org/fhir/uv/xver/ConceptMap/R5-Questionnaire-element-map-to-R4",
  "version": "0.1.0",
  "name": "R5QuestionnaireElementMapToR4",
  "title": "Cross-version mapping for FHIR R5 Questionnaire to FHIR R4 Questionnaire",
  "status": "active",
  "experimental": false,
  "date": "2026-03-17T16:04:47.7237515-05:00",
  "contact": [
    {
      "name": "FHIR Infrastructure",
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/fiwg"
        }
      ]
    }
  ],
  "description": "This ConceptMap represents cross-version mappings for elements from a FHIR R5 Questionnaire to FHIR R4.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code": "001",
          "display": "World"
        }
      ]
    }
  ],
  "sourceCanonical": "http://hl7.org/fhir/5.0",
  "targetUri": "http://hl7.org/fhir/4.0",
  "group": [
    {
      "source": "http://hl7.org/fhir/StructureDefinition/Questionnaire",
      "sourceVersion": "5.0.0",
      "target": "http://hl7.org/fhir/StructureDefinition/Questionnaire",
      "targetVersion": "4.0.1",
      "element": [
        {
          "code": "Questionnaire.meta",
          "display": "meta",
          "target": [
            {
              "code": "Questionnaire.meta",
              "display": "Questionnaire.meta",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.meta` is mapped to FHIR R4 element `Questionnaire.meta` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Questionnaire.implicitRules",
          "display": "implicitRules",
          "target": [
            {
              "code": "Questionnaire.implicitRules",
              "display": "Questionnaire.implicitRules",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.implicitRules` is mapped to FHIR R4 element `Questionnaire.implicitRules` as `Equivalent`.\nAsserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of its narrative along with other profiles, value sets, etc."
            }
          ]
        },
        {
          "code": "Questionnaire.language",
          "display": "language",
          "target": [
            {
              "code": "Questionnaire.language",
              "display": "Questionnaire.language",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.language` is mapped to FHIR R4 element `Questionnaire.language` as `Equivalent`.\nLanguage is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies  to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute)."
            }
          ]
        },
        {
          "code": "Questionnaire.text",
          "display": "text",
          "target": [
            {
              "code": "Questionnaire.text",
              "display": "Questionnaire.text",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.text` is mapped to FHIR R4 element `Questionnaire.text` as `Equivalent`.\nContained resources do not have a narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied).  This may be necessary for data from legacy systems where information is captured as a \"text blob\" or where text is additionally entered raw or narrated and encoded information is added later."
            }
          ]
        },
        {
          "code": "Questionnaire.contained",
          "display": "contained",
          "target": [
            {
              "code": "Questionnaire.contained",
              "display": "Questionnaire.contained",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.contained` is mapped to FHIR R4 element `Questionnaire.contained` as `Equivalent`.\nThis should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags in their meta elements, but SHALL NOT have security labels."
            }
          ]
        },
        {
          "code": "Questionnaire.url",
          "display": "url",
          "target": [
            {
              "code": "Questionnaire.url",
              "display": "Questionnaire.url",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.url` is mapped to FHIR R4 element `Questionnaire.url` as `Equivalent`.\nCan be a urn:uuid: or a urn:oid: but real http: addresses are preferred.  Multiple instances may share the same URL if they have a distinct version.\n\nThe determination of when to create a new version of a resource (same url, new version) vs. defining a new artifact is up to the author.  Considerations for making this decision are found in [Technical and Business Versions](https://hl7.org/fhir/resource..html#versions).\n\nIn some cases, the resource can no longer be found at the stated url, but the url itself cannot change. Implementations can use the [meta.source](https://hl7.org/fhir/resou.html#meta) element to indicate where the current master source of the resource can be found.\n\nThe name of the referenced questionnaire can be conveyed using the http://hl7.org/fhir/StructureDefinition/display extension."
            }
          ]
        },
        {
          "code": "Questionnaire.identifier",
          "display": "identifier",
          "target": [
            {
              "code": "Questionnaire.identifier",
              "display": "Questionnaire.identifier",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.identifier` is mapped to FHIR R4 element `Questionnaire.identifier` as `Equivalent`.\nTypically, this is used for identifiers that can go in an HL7 V3 II (instance identifier) data type, and can then identify this questionnaire outside of FHIR, where it is not possible to use the logical URI."
            }
          ]
        },
        {
          "code": "Questionnaire.version",
          "display": "version",
          "target": [
            {
              "code": "Questionnaire.version",
              "display": "Questionnaire.version",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.version` is mapped to FHIR R4 element `Questionnaire.version` as `Equivalent`.\nThere may be different questionnaires that have the same url but different versions.  The version can be appended to the url in a reference to allow a reference to a particular business version of the questionnaire with the format. The version SHOULD NOT contain a '#' - see [Business Version](https://hl7.org/fhir/resource.h.html#bv-format)."
            }
          ]
        },
        {
          "code": "Questionnaire.name",
          "display": "name",
          "target": [
            {
              "code": "Questionnaire.name",
              "display": "Questionnaire.name",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.name` is mapped to FHIR R4 element `Questionnaire.name` as `Equivalent`.\nThe name is not expected to be globally unique. The name should be a simple alphanumeric type no-whitespace name to ensure that it is machine-processing friendly."
            }
          ]
        },
        {
          "code": "Questionnaire.title",
          "display": "title",
          "target": [
            {
              "code": "Questionnaire.title",
              "display": "Questionnaire.title",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.title` is mapped to FHIR R4 element `Questionnaire.title` as `Equivalent`.\nThis name does not need to be machine-processing friendly and may contain punctuation, white-space, etc."
            }
          ]
        },
        {
          "code": "Questionnaire.derivedFrom",
          "display": "derivedFrom",
          "target": [
            {
              "code": "Questionnaire.derivedFrom",
              "display": "Questionnaire.derivedFrom",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.derivedFrom` is mapped to FHIR R4 element `Questionnaire.derivedFrom` as `Equivalent`.\nThis element covers a broad range of relationships, from 'somewhat inspired by' to 'fully compliant with'.         There is a standard extensionthat allows clearer differentiation between the specifics of the derivation relationship where          this is needed - e.g. to determine substitutability and validation expectations -          [http://hl7.org/fhir/StructureDefinition/questionnaire-derivationType](http://hl7.org/fhir/extensions/StructureDefinition-questionnaire-derivationType.html)."
            }
          ]
        },
        {
          "code": "Questionnaire.status",
          "display": "status",
          "target": [
            {
              "code": "Questionnaire.status",
              "display": "Questionnaire.status",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.status` is mapped to FHIR R4 element `Questionnaire.status` as `Equivalent`.\nA nominal state-transition diagram can be found in the] documentation\n\nUnknown does not represent 'other' - one of the defined statuses must apply.  Unknown is used when the authoring system is not sure what the current status is.\n\nSee guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization)."
            }
          ]
        },
        {
          "code": "Questionnaire.experimental",
          "display": "experimental",
          "target": [
            {
              "code": "Questionnaire.experimental",
              "display": "Questionnaire.experimental",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.experimental` is mapped to FHIR R4 element `Questionnaire.experimental` as `Equivalent`.\nAllows filtering of questionnaires that are appropriate for use versus not."
            }
          ]
        },
        {
          "code": "Questionnaire.subjectType",
          "display": "subjectType",
          "target": [
            {
              "code": "Questionnaire.subjectType",
              "display": "Questionnaire.subjectType",
              "equivalence": "wider",
              "comment": "Element `Questionnaire.subjectType` is mapped to FHIR R4 element `Questionnaire.subjectType` as `RelatedTo`.\nThe mappings for `Questionnaire.subjectType` do not allow expression of the necessary codes, per the bindings on the source and target.\nIf none are specified, then the subject is unlimited."
            }
          ]
        },
        {
          "code": "Questionnaire.date",
          "display": "date",
          "target": [
            {
              "code": "Questionnaire.date",
              "display": "Questionnaire.date",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.date` is mapped to FHIR R4 element `Questionnaire.date` as `Equivalent`.\nThe date is often not tracked until the resource is published, but may be present on draft content. Note that this is not the same as the resource last-modified-date, since the resource may be a secondary representation of the questionnaire. Additional specific dates may be added as extensions or be found by consulting Provenances associated with past versions of the resource.\n\nSee guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization)."
            }
          ]
        },
        {
          "code": "Questionnaire.publisher",
          "display": "publisher",
          "target": [
            {
              "code": "Questionnaire.publisher",
              "display": "Questionnaire.publisher",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.publisher` is mapped to FHIR R4 element `Questionnaire.publisher` as `Equivalent`.\nUsually an organization but may be an individual. The publisher (or steward) of the questionnaire is the organization or individual primarily responsible for the maintenance and upkeep of the questionnaire. This is not necessarily the same individual or organization that developed and initially authored the content. The publisher is the primary point of contact for questions or issues with the questionnaire. This item SHOULD be populated unless the information is available from context."
            }
          ]
        },
        {
          "code": "Questionnaire.contact",
          "display": "contact",
          "target": [
            {
              "code": "Questionnaire.contact",
              "display": "Questionnaire.contact",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.contact` is mapped to FHIR R4 element `Questionnaire.contact` as `Equivalent`.\nMay be a web site, an email address, a telephone number, etc.\n\nSee guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization)."
            }
          ]
        },
        {
          "code": "Questionnaire.description",
          "display": "description",
          "target": [
            {
              "code": "Questionnaire.description",
              "display": "Questionnaire.description",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.description` is mapped to FHIR R4 element `Questionnaire.description` as `Equivalent`.\nThis description can be used to capture details such as comments about misuse, instructions for clinical use and interpretation, literature references, examples from the paper world, etc. It is not a rendering of the questionnaire as conveyed in the 'text' field of the resource itself. This item SHOULD be populated unless the information is available from context. (E.g. the language of the questionnaire is presumed to be the predominant language in the place the questionnaire was created)."
            }
          ]
        },
        {
          "code": "Questionnaire.useContext",
          "display": "useContext",
          "target": [
            {
              "code": "Questionnaire.useContext",
              "display": "Questionnaire.useContext",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.useContext` is mapped to FHIR R4 element `Questionnaire.useContext` as `Equivalent`.\nWhen multiple useContexts are specified, there is no expectation that all or even any of the contexts apply."
            }
          ]
        },
        {
          "code": "Questionnaire.jurisdiction",
          "display": "jurisdiction",
          "target": [
            {
              "code": "Questionnaire.jurisdiction",
              "display": "Questionnaire.jurisdiction",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.jurisdiction` is mapped to FHIR R4 element `Questionnaire.jurisdiction` as `Equivalent`.\nElement `Questionnaire.jurisdiction` has been flagged as deprecated.\nIt may be possible for the questionnaire to be used in jurisdictions other than those for which it was originally designed or intended.\n\nDEPRECATION NOTE: For consistency, implementations are encouraged to migrate to using the new 'jurisdiction' code in the useContext element.  (I.e. useContext.code indicating http://terminology.hl7.org/CodeSystem/usage-context-type#jurisdiction and useContext.valueCodeableConcept indicating the jurisdiction.)"
            }
          ]
        },
        {
          "code": "Questionnaire.purpose",
          "display": "purpose",
          "target": [
            {
              "code": "Questionnaire.purpose",
              "display": "Questionnaire.purpose",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.purpose` is mapped to FHIR R4 element `Questionnaire.purpose` as `Equivalent`.\nThis element does not describe the usage of the questionnaire. Instead, it provides traceability of ''why'' the resource is either needed or ''why'' it is defined as it is.  This may be used to point to source materials or specifications that drove the structure of this questionnaire."
            }
          ]
        },
        {
          "code": "Questionnaire.copyright",
          "display": "copyright",
          "target": [
            {
              "code": "Questionnaire.copyright",
              "display": "Questionnaire.copyright",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.copyright` is mapped to FHIR R4 element `Questionnaire.copyright` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Questionnaire.approvalDate",
          "display": "approvalDate",
          "target": [
            {
              "code": "Questionnaire.approvalDate",
              "display": "Questionnaire.approvalDate",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.approvalDate` is mapped to FHIR R4 element `Questionnaire.approvalDate` as `Equivalent`.\nThe 'date' element may be more recent than the approval date because of minor changes or editorial corrections.\n\nSee guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization)."
            }
          ]
        },
        {
          "code": "Questionnaire.lastReviewDate",
          "display": "lastReviewDate",
          "target": [
            {
              "code": "Questionnaire.lastReviewDate",
              "display": "Questionnaire.lastReviewDate",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.lastReviewDate` is mapped to FHIR R4 element `Questionnaire.lastReviewDate` as `Equivalent`.\nIf specified, this date follows the original approval date.\n\nSee guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization)."
            }
          ]
        },
        {
          "code": "Questionnaire.effectivePeriod",
          "display": "effectivePeriod",
          "target": [
            {
              "code": "Questionnaire.effectivePeriod",
              "display": "Questionnaire.effectivePeriod",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.effectivePeriod` is mapped to FHIR R4 element `Questionnaire.effectivePeriod` as `Equivalent`.\nThe effective period for a questionnaire  determines when the content is applicable for usage and is independent of publication and review dates. For example, a questionnaire intended to be used for the year 2016 might be published in 2015.\n\nSee guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization)."
            }
          ]
        },
        {
          "code": "Questionnaire.code",
          "display": "code",
          "target": [
            {
              "code": "Questionnaire.code",
              "display": "Questionnaire.code",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.code` is mapped to FHIR R4 element `Questionnaire.code` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Questionnaire.item",
          "display": "item",
          "target": [
            {
              "code": "Questionnaire.item",
              "display": "Questionnaire.item",
              "equivalence": "wider",
              "comment": "Element `Questionnaire.item` is mapped to FHIR R4 element `Questionnaire.item` as `Equivalent`.\nThe content of the questionnaire is constructed from an ordered, hierarchical collection of items."
            }
          ]
        },
        {
          "code": "Questionnaire.item.linkId",
          "display": "linkId",
          "target": [
            {
              "code": "Questionnaire.item.linkId",
              "display": "Questionnaire.item.linkId",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.linkId` is mapped to FHIR R4 element `Questionnaire.item.linkId` as `Equivalent`.\nThis ''can'' be a meaningful identifier (e.g. a LOINC code) but is not intended to have any meaning.  GUIDs or sequential numbers are appropriate here.\n\nLinkIds can have whitespaces and slashes by design. Tooling should not rely on linkIds being valid XHTML element IDs, and should not directly embed them as such"
            }
          ]
        },
        {
          "code": "Questionnaire.item.definition",
          "display": "definition",
          "target": [
            {
              "code": "Questionnaire.item.definition",
              "display": "Questionnaire.item.definition",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.definition` is mapped to FHIR R4 element `Questionnaire.item.definition` as `Equivalent`.\nThe uri refers to an ElementDefinition in a [StructureDefinition](https://hl7.org/fhir/s.html#) or to an [ObservationDefinition](https://hl7.org/fhir/observationdefinition.html) and always starts with the [canonical URL](https://hl7.org/fhir/references.html#canonical) for the target resource. When referring to a StructureDefinition, a fragment identifier is used to specify the element definition by its id [Element.id](https://hl7.org/fhir/types-defin.html#Element.id). E.g. http://hl7.org/fhir/StructureDefinition/Observation#Observation.value[x]. In the absence of a fragment identifier, the first/root element definition in the target is the matching element definition."
            }
          ]
        },
        {
          "code": "Questionnaire.item.code",
          "display": "code",
          "target": [
            {
              "code": "Questionnaire.item.code",
              "display": "Questionnaire.item.code",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.code` is mapped to FHIR R4 element `Questionnaire.item.code` as `Equivalent`.\nThe value may come from the ElementDefinition referred to by .definition."
            }
          ]
        },
        {
          "code": "Questionnaire.item.prefix",
          "display": "prefix",
          "target": [
            {
              "code": "Questionnaire.item.prefix",
              "display": "Questionnaire.item.prefix",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.prefix` is mapped to FHIR R4 element `Questionnaire.item.prefix` as `Equivalent`.\nThese are generally unique within a questionnaire, though this is not guaranteed. Some questionnaires may have multiple questions with the same label with logic to control which gets exposed.  Typically, these won't be used for \"display\" items, though such use is not prohibited.  Systems SHOULD NOT generate their own prefixes if prefixes are defined for any items within a Questionnaire."
            }
          ]
        },
        {
          "code": "Questionnaire.item.text",
          "display": "text",
          "target": [
            {
              "code": "Questionnaire.item.text",
              "display": "Questionnaire.item.text",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.text` is mapped to FHIR R4 element `Questionnaire.item.text` as `Equivalent`.\nWhen using this element to represent the name of a section, use group type item and also make sure to limit the text element to a short string suitable for display as a section heading.  Group item instructions should be included as a display type item within the group."
            }
          ]
        },
        {
          "code": "Questionnaire.item.type",
          "display": "type",
          "target": [
            {
              "code": "Questionnaire.item.type",
              "display": "Questionnaire.item.type",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.type` is mapped to FHIR R4 element `Questionnaire.item.type` as `SourceIsNarrowerThanTarget`.\nThe mappings for `Questionnaire.item.type` do not allow expression of the necessary codes, per the bindings on the source and target.\nAdditional constraints on the type of answer can be conveyed by extensions. The value may come from the ElementDefinition referred to by .definition."
            }
          ]
        },
        {
          "code": "Questionnaire.item.enableWhen",
          "display": "enableWhen",
          "target": [
            {
              "code": "Questionnaire.item.enableWhen",
              "display": "Questionnaire.item.enableWhen",
              "equivalence": "wider",
              "comment": "Element `Questionnaire.item.enableWhen` is mapped to FHIR R4 element `Questionnaire.item.enableWhen` as `Equivalent`.\nIf multiple repetitions of this extension are present, the interpretation is driven by enableBehavior (either all repetitions must evaluate to true for this item to be enabled, or only one must evaluate to true for the item to be enabled).  If the enableWhen.question has multiple answers, the condition evaluates to true if *any* of the answers for the referenced item match the enableWhen condition.  This element is a modifier because if enableWhen is present for an item, \"required\" is ignored unless one of the enableWhen conditions is met. When an item is disabled, all of its descendants are disabled, regardless of what their own enableWhen logic might evaluate to.  If enableWhen logic depends on an item that is disabled, the logic should proceed as though the item is not valued - even if a default value or other value might be retained in memory in the event of the item being re-enabled.  In some cases, the comparison between the indicated answer and the specified value may differ only by precision.  For example, the enableWhen might be Q1 > 1970, but the answer to Q1 is 1970-10-15.  There is not a clear answer as to whether 1970-10-15 should be considered 'greater' than 1970, given that it is an imprecise value.  In these indeterminate situations, the form filler has the option of refusing to render the form.  If the form **is** displayed, items where enableWhen is indeterminate SHOULD be treated as enabled with a warning indicating that the questionnaire logic was faulty and it is possible that the item should not be enabled.  Questionnaires SHOULD be designed to take into account challenges around varying precision to minimize non-deterministic situations by setting constraints around expected precision, etc."
            }
          ]
        },
        {
          "code": "Questionnaire.item.enableWhen.question",
          "display": "question",
          "target": [
            {
              "code": "Questionnaire.item.enableWhen.question",
              "display": "Questionnaire.item.enableWhen.question",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.enableWhen.question` is mapped to FHIR R4 element `Questionnaire.item.enableWhen.question` as `Equivalent`.\nIf multiple question occurrences are present for the same question (same linkId), then this refers to the nearest question occurrence reachable by tracing first the \"ancestor\" axis and then the \"preceding\" axis and then the \"following\" axis.  If there are multiple items with the same linkId and all are equadistant (e.g. a question references a question that appears in a separate repeating group), that is an error.  (Consider using the enableWhenExpression extension to define logic to handle such a situation.)"
            }
          ]
        },
        {
          "code": "Questionnaire.item.enableWhen.operator",
          "display": "operator",
          "target": [
            {
              "code": "Questionnaire.item.enableWhen.operator",
              "display": "Questionnaire.item.enableWhen.operator",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.enableWhen.operator` is mapped to FHIR R4 element `Questionnaire.item.enableWhen.operator` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Questionnaire.item.enableWhen.answer[x]",
          "display": "answer[x]",
          "target": [
            {
              "code": "Questionnaire.item.enableWhen.answer[x]",
              "display": "Questionnaire.item.enableWhen.answer[x]",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.enableWhen.answer[x]` is mapped to FHIR R4 element `Questionnaire.item.enableWhen.answer[x]` as `RelatedTo`.\nThe target context `Questionnaire.item.enableWhen.answer[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Questionnaire.item.enableWhen`."
            }
          ]
        },
        {
          "code": "Questionnaire.item.enableBehavior",
          "display": "enableBehavior",
          "target": [
            {
              "code": "Questionnaire.item.enableBehavior",
              "display": "Questionnaire.item.enableBehavior",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.enableBehavior` is mapped to FHIR R4 element `Questionnaire.item.enableBehavior` as `Equivalent`.\nThis element must be specified if more than one enableWhen value is provided."
            }
          ]
        },
        {
          "code": "Questionnaire.item.required",
          "display": "required",
          "target": [
            {
              "code": "Questionnaire.item.required",
              "display": "Questionnaire.item.required",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.required` is mapped to FHIR R4 element `Questionnaire.item.required` as `Equivalent`.\nIf the required item is a question, it must have a direct answer (i.e. an answer to the question itself, not merely answers to child questions) in order for the QuestionnaireResponse to be complete.  If the required item is a group, it must have at least one descendant question which has an answer  Questionnaire.item.required only has meaning for elements that are conditionally enabled with enableWhen if the condition evaluates to true.  It also only has meaning if the parent element is present.  If a non-required 'group' item contains a 'required' question item, it's completely fine to omit the group (because it's not required) despite it having a required child.  Similarly, if an item that contains other items is marked as required, that does not automatically make the contained elements required (though required groups must contain at least one descendant item with a populated answer). The value for 'required' may come from the ElementDefinition referred to by .definition."
            }
          ]
        },
        {
          "code": "Questionnaire.item.repeats",
          "display": "repeats",
          "target": [
            {
              "code": "Questionnaire.item.repeats",
              "display": "Questionnaire.item.repeats",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.repeats` is mapped to FHIR R4 element `Questionnaire.item.repeats` as `Equivalent`.\nIf a question is marked as repeats=true, then multiple answers can be provided for the question in the corresponding QuestionnaireResponse.  When rendering the questionnaire, it is up to the rendering software whether to render the question text for each answer repetition (i.e. \"repeat the question\") or to simply allow entry/selection of multiple answers for the question (repeat the answers).  Which is most appropriate visually may depend on the type of answer as well as whether there are nested items.\n\nThe resulting QuestionnaireResponse will be populated the same way regardless of rendering - one 'question' item with multiple answer values.\n\n The value may come from the ElementDefinition referred to by .definition.  When repeats=true for a group, it'll be represented with multiple items with the same linkId in the QuestionnaireResponse.  For a question, it'll be represented by a single item with that linkId with multiple answers."
            }
          ]
        },
        {
          "code": "Questionnaire.item.readOnly",
          "display": "readOnly",
          "target": [
            {
              "code": "Questionnaire.item.readOnly",
              "display": "Questionnaire.item.readOnly",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.readOnly` is mapped to FHIR R4 element `Questionnaire.item.readOnly` as `Equivalent`.\nIf specified on a 'group', then all items beneath the specified group are read only.  For questions, this only marks the answer associated with the specific item read only.  Descendant questions are not impacted.  The value of readOnly elements can be established by asserting extensions for defaultValues, linkages that support pre-population and/or extensions that support calculation based on other answers."
            }
          ]
        },
        {
          "code": "Questionnaire.item.maxLength",
          "display": "maxLength",
          "target": [
            {
              "code": "Questionnaire.item.maxLength",
              "display": "Questionnaire.item.maxLength",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.maxLength` is mapped to FHIR R4 element `Questionnaire.item.maxLength` as `Equivalent`.\nFor base64binary, reflects the number of characters representing the encoded data, not the number of bytes of the binary data. The value may come from the ElementDefinition referred to by .definition."
            }
          ]
        },
        {
          "code": "Questionnaire.item.answerValueSet",
          "display": "answerValueSet",
          "target": [
            {
              "code": "Questionnaire.item.answerValueSet",
              "display": "Questionnaire.item.answerValueSet",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.answerValueSet` is mapped to FHIR R4 element `Questionnaire.item.answerValueSet` as `Equivalent`.\nLOINC defines many useful value sets for questionnaire responses. See [LOINC Answer Lists](https://terminology.hl7.org/LOINC.html). The value may come from the ElementDefinition referred to by .definition."
            }
          ]
        },
        {
          "code": "Questionnaire.item.answerOption",
          "display": "answerOption",
          "target": [
            {
              "code": "Questionnaire.item.answerOption",
              "display": "Questionnaire.item.answerOption",
              "equivalence": "wider",
              "comment": "Element `Questionnaire.item.answerOption` is mapped to FHIR R4 element `Questionnaire.item.answerOption` as `Equivalent`.\nThis element can be used when the value set machinery of answerValueSet is deemed too cumbersome or when there's a need to capture possible answers that are not codes."
            }
          ]
        },
        {
          "code": "Questionnaire.item.answerOption.value[x]",
          "display": "value[x]",
          "target": [
            {
              "code": "Questionnaire.item.answerOption.value[x]",
              "display": "Questionnaire.item.answerOption.value[x]",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.answerOption.value[x]` is mapped to FHIR R4 element `Questionnaire.item.answerOption.value[x]` as `Equivalent`.\nThe target context `Questionnaire.item.answerOption.value[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Questionnaire.item.answerOption`.\nThe data type of the value must agree with the item.type."
            }
          ]
        },
        {
          "code": "Questionnaire.item.answerOption.initialSelected",
          "display": "initialSelected",
          "target": [
            {
              "code": "Questionnaire.item.answerOption.initialSelected",
              "display": "Questionnaire.item.answerOption.initialSelected",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.answerOption.initialSelected` is mapped to FHIR R4 element `Questionnaire.item.answerOption.initialSelected` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Questionnaire.item.initial",
          "display": "initial",
          "target": [
            {
              "code": "Questionnaire.item.initial",
              "display": "Questionnaire.item.initial",
              "equivalence": "wider",
              "comment": "Element `Questionnaire.item.initial` is mapped to FHIR R4 element `Questionnaire.item.initial` as `Equivalent`.\nThe user is allowed to change the value and override the default (unless marked as read-only). If the user doesn't change the value, then this initial value will be persisted when the QuestionnaireResponse is initially created.  Note that initial values can influence results.  The data type of initial.answer[x] must agree with the item.type, and only repeating items can have more then one initial value."
            }
          ]
        },
        {
          "code": "Questionnaire.item.initial.value[x]",
          "display": "value[x]",
          "target": [
            {
              "code": "Questionnaire.item.initial.value[x]",
              "display": "Questionnaire.item.initial.value[x]",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.initial.value[x]` is mapped to FHIR R4 element `Questionnaire.item.initial.value[x]` as `RelatedTo`.\nThe target context `Questionnaire.item.initial.value[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Questionnaire.item.initial`.\nThe type of the initial value must be consistent with the type of the item."
            }
          ]
        },
        {
          "code": "Questionnaire.item.item",
          "display": "item",
          "target": [
            {
              "code": "Questionnaire.item.item",
              "display": "Questionnaire.item.item",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.item` is mapped to FHIR R4 element `Questionnaire.item.item` as `Equivalent`.\nThere is no specified limit to the depth of nesting.  However, Questionnaire authors are encouraged to consider the impact on the user and user interface of overly deep nesting."
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/Questionnaire",
      "sourceVersion": "5.0.0",
      "target": "http://hl7.org/fhir/5.0/StructureDefinition/extension-Questionnaire.subjectType",
      "targetVersion": "0.1.0",
      "element": [
        {
          "code": "Questionnaire.subjectType",
          "display": "subjectType",
          "target": [
            {
              "code": "Extension",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.subjectType` is mapped to FHIR R4 element `Questionnaire.subjectType` as `RelatedTo`.\nThe mappings for `Questionnaire.subjectType` do not allow expression of the necessary codes, per the bindings on the source and target.\nIf none are specified, then the subject is unlimited."
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/Questionnaire",
      "sourceVersion": "5.0.0",
      "target": "http://hl7.org/fhir/5.0/StructureDefinition/extension-Questionnaire.item.disabledDisplay",
      "targetVersion": "0.1.0",
      "element": [
        {
          "code": "Questionnaire.item.disabledDisplay",
          "display": "disabledDisplay",
          "target": [
            {
              "code": "Extension",
              "equivalence": "wider",
              "comment": "Element `Questionnaire.item.disabledDisplay` has a context of Questionnaire.item based on following the parent source element upwards and mapping to `Questionnaire`.\nElement `Questionnaire.item.disabledDisplay` has no mapping targets in FHIR R4. Typically, this is because the element has been added (is a new element).\nIf not specified, rendering behavior is up to the client.  This element is only meaningful if enableWhen or an equivalent extension is present"
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/Questionnaire",
      "sourceVersion": "5.0.0",
      "target": "http://hl7.org/fhir/5.0/StructureDefinition/extension-Questionnaire.item.answerConstraint",
      "targetVersion": "0.1.0",
      "element": [
        {
          "code": "Questionnaire.item.answerConstraint",
          "display": "answerConstraint",
          "target": [
            {
              "code": "Extension",
              "equivalence": "equivalent",
              "comment": "Element `Questionnaire.item.answerConstraint` has a context of Questionnaire.item based on following the parent source element upwards and mapping to `Questionnaire`.\nElement `Questionnaire.item.answerConstraint` has no mapping targets in FHIR R4. Typically, this is because the element has been added (is a new element)."
            }
          ]
        }
      ]
    }
  ]
}