Name	Flags	Card.	Type	Description & Constraints
Questionnaire		0..*	Questionnaire	Finnish PHR Questionnaire profile
meta		1..1	Meta	Metadata about the resource
Slices for profile		1..*	canonical(StructureDefinition)	Profiles this resource claims to conform to Slice: Unordered, Open by type:$this
profile:fiphrProfile		1..1	canonical(StructureDefinition)	Profiles this resource claims to conform to Fixed Value: http://phr.kanta.fi/StructureDefinition/fiphr-sd-questionnaire-r4
language		0..1	code	Language of the resource content Binding: CommonLanguages (required)
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
myExtension		0..*	(Complex)	Application identification URL: http://phr.kanta.fi/StructureDefinition/fiphr-ext-creatingapplication
url		1..1	uri	Canonical identifier for this questionnaire, represented as a URI (globally unique)
identifier		1..*	Identifier	Additional identifier for the questionnaire
use		0..1	code	usual | official | temp | secondary | old (If known)
system		1..1	uri	The namespace for the identifier value
value		1..1	string	The value that is unique
version		1..1	string	Business version of the questionnaire
name		1..1	string	Name for this questionnaire (computer friendly)
title		1..1	string	Name for this questionnaire (human friendly)
subjectType		0..1	code	Resource that can be subject of QuestionnaireResponse Fixed Value: Patient
date		1..1	dateTime	Date last changed
description		1..1	markdown	Natural language description of the questionnaire
useContext		0..0
jurisdiction		0..0
Slices for code		1..*	Coding	Concept that represents the overall questionnaire Slice: Unordered, Open by value:code, value:system Binding: https://simplifier.net/finnishphr/fiphr-vs-questionnairecode (extensible)
code:fiphrCode		1..1	Coding	Concept that represents the overall questionnaire
system		1..1	uri	Identity of the terminology system Fixed Value: http://phr.kanta.fi/CodeSystem/fiphr-cs-questionnairecode
code		1..1	code	Finnish PHR: Code for questionnaire
item		1..*	BackboneElement	Questions and sections within the Questionnaire
Documentation for this format

Terminology Bindings (Differential)

Path	Conformance	ValueSet
Questionnaire.language	required	CommonLanguages
Questionnaire.code	extensible	https://simplifier.net/finnishphr/fiphr-vs-questionnairecode

Name	Flags	Card.	Type	Description & Constraints
Questionnaire	C	0..*	Questionnaire	Finnish PHR Questionnaire profile
meta	Σ	1..1	Meta	Metadata about the resource
Slices for profile	Σ	1..*	canonical(StructureDefinition)	Profiles this resource claims to conform to Slice: Unordered, Open by type:$this
profile:fiphrProfile	Σ	1..1	canonical(StructureDefinition)	Profiles this resource claims to conform to Fixed Value: http://phr.kanta.fi/StructureDefinition/fiphr-sd-questionnaire-r4
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: CommonLanguages (required)
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
myExtension		0..*	(Complex)	Application identification URL: http://phr.kanta.fi/StructureDefinition/fiphr-ext-creatingapplication
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
url	Σ	1..1	uri	Canonical identifier for this questionnaire, represented as a URI (globally unique)
identifier	Σ	1..*	Identifier	Additional identifier for the questionnaire
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
system	Σ	1..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value	Σ	1..1	string	The value that is unique Example General: 123456
version	Σ	1..1	string	Business version of the questionnaire
name	ΣC	1..1	string	Name for this questionnaire (computer friendly)
title	Σ	1..1	string	Name for this questionnaire (human friendly)
status	?!Σ	1..1	code	draft | active | retired | unknown Binding: PublicationStatus (required): The lifecycle status of an artifact.
subjectType	Σ	0..1	code	Resource that can be subject of QuestionnaireResponse Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR. Fixed Value: Patient
date	Σ	1..1	dateTime	Date last changed
description		1..1	markdown	Natural language description of the questionnaire
Slices for code	Σ	1..*	Coding	Concept that represents the overall questionnaire Slice: Unordered, Open by value:code, value:system Binding: https://simplifier.net/finnishphr/fiphr-vs-questionnairecode (extensible)
code:fiphrCode	Σ	1..1	Coding	Concept that represents the overall questionnaire Binding: QuestionnaireQuestionCodes (example): Codes for questionnaires, groups and individual questions.
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://phr.kanta.fi/CodeSystem/fiphr-cs-questionnairecode
code	Σ	1..1	code	Finnish PHR: Code for questionnaire
item	C	1..*	BackboneElement	Questions and sections within the Questionnaire
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
linkId		1..1	string	Unique id for item in questionnaire
type		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	?!C	0..*	BackboneElement	Only allow data when
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
question		1..1	string	Question that determines whether item is enabled
operator		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)
answerValueSet	C	0..1	canonical(ValueSet)	Valueset containing permitted answers
answerOption	C	0..*	BackboneElement	Permitted answer
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
value[x]		1..1		Answer value Binding: QuestionnaireAnswerCodes (example): Allowed values to answer questions.
valueInteger			integer
valueDate			date
valueTime			time
valueString			string
valueCoding			Coding
valueReference			Reference(Resource)
initial	C	0..*	BackboneElement	Initial value(s) when item is first rendered
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
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)
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet / Code
Questionnaire.language	required	CommonLanguages
Questionnaire.identifier.use	required	IdentifierUse
Questionnaire.status	required	PublicationStatus
Questionnaire.subjectType	required	Fixed Value: Patient
Questionnaire.code	extensible	https://simplifier.net/finnishphr/fiphr-vs-questionnairecode
Questionnaire.code:fiphrCode	example	QuestionnaireQuestionCodes (a valid code from LOINC)
Questionnaire.item.type	required	QuestionnaireItemType
Questionnaire.item.enableWhen.operator	required	QuestionnaireItemOperator
Questionnaire.item.enableWhen.answer[x]	example	QuestionnaireAnswerCodes (a valid code from SNOMED CT)
Questionnaire.item.answerOption.value[x]	example	QuestionnaireAnswerCodes (a valid code from SNOMED CT)
Questionnaire.item.initial.value[x]	example	QuestionnaireAnswerCodes (a valid code from SNOMED CT)

Constraints

Id	Grade	Path(s)	Details	Requirements
dom-2	error	Questionnaire	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Questionnaire	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Questionnaire	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Questionnaire	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Questionnaire	A resource should have narrative for robust management : text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()
que-0	warning	Questionnaire	Name should be usable as an identifier for the module by machine processing applications such as code generation : name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
que-1	error	Questionnaire.item	Group items must have nested items, display items cannot have nested items : (type='group' implies item.empty().not()) and (type.trace('type')='display' implies item.trace('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 'choice' and 'open-choice' items can have answerValueSet : (type ='choice' or type = 'open-choice' 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' | 'open-choice')) or maxLength.empty()
que-11	error	Questionnaire.item	If one or more answerOption is present, initial[x] must be missing : answerOption.empty() or initial.empty()
que-12	error	Questionnaire.item	If there are more than one enableWhen, enableBehavior must be specified : enableWhen.count() > 2 implies enableBehavior.exists()
que-13	error	Questionnaire.item	Can only have multiple initial values for repeating items : repeats=true or initial.count() <= 1

Name	Flags	Card.	Type	Description & Constraints
Questionnaire	C	0..*	Questionnaire	Finnish PHR Questionnaire profile
id	Σ	0..1	id	Logical id of this artifact
meta	Σ	1..1	Meta	Metadata about the resource
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
versionId	Σ	0..1	id	Version specific identifier
lastUpdated	Σ	0..1	instant	When the resource version last changed
source	Σ	0..1	uri	Identifies where the resource comes from
Slices for profile	Σ	1..*	canonical(StructureDefinition)	Profiles this resource claims to conform to Slice: Unordered, Open by type:$this
profile:fiphrProfile	Σ	1..1	canonical(StructureDefinition)	Profiles this resource claims to conform to Fixed Value: http://phr.kanta.fi/StructureDefinition/fiphr-sd-questionnaire-r4
security	Σ	0..*	Coding	Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
tag	Σ	0..*	Coding	Tags applied to this resource Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: CommonLanguages (required)
text		0..1	Narrative	Text summary of the resource, for human interpretation
contained		0..*	Resource	Contained, inline Resources
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
myExtension		0..*	(Complex)	Application identification URL: http://phr.kanta.fi/StructureDefinition/fiphr-ext-creatingapplication
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
url	Σ	1..1	uri	Canonical identifier for this questionnaire, represented as a URI (globally unique)
identifier	Σ	1..*	Identifier	Additional identifier for the questionnaire
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
system	Σ	1..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value	Σ	1..1	string	The value that is unique Example General: 123456
period	Σ	0..1	Period	Time period when id is/was valid for use
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
version	Σ	1..1	string	Business version of the questionnaire
name	ΣC	1..1	string	Name for this questionnaire (computer friendly)
title	Σ	1..1	string	Name for this questionnaire (human friendly)
derivedFrom		0..*	canonical(Questionnaire)	Instantiates protocol or definition
status	?!Σ	1..1	code	draft | active | retired | unknown Binding: PublicationStatus (required): The lifecycle status of an artifact.
experimental	Σ	0..1	boolean	For testing purposes, not real usage
subjectType	Σ	0..1	code	Resource that can be subject of QuestionnaireResponse Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR. Fixed Value: Patient
date	Σ	1..1	dateTime	Date last changed
publisher	Σ	0..1	string	Name of the publisher (organization or individual)
contact	Σ	0..*	ContactDetail	Contact details for the publisher
description		1..1	markdown	Natural language description of the questionnaire
purpose		0..1	markdown	Why this questionnaire is defined
copyright		0..1	markdown	Use and/or publishing restrictions
approvalDate		0..1	date	When the questionnaire was approved by publisher
lastReviewDate		0..1	date	When the questionnaire was last reviewed
effectivePeriod	Σ	0..1	Period	When the questionnaire is expected to be used
Slices for code	Σ	1..*	Coding	Concept that represents the overall questionnaire Slice: Unordered, Open by value:code, value:system Binding: https://simplifier.net/finnishphr/fiphr-vs-questionnairecode (extensible)
code:fiphrCode	Σ	1..1	Coding	Concept that represents the overall questionnaire Binding: QuestionnaireQuestionCodes (example): Codes for questionnaires, groups and individual questions.
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://phr.kanta.fi/CodeSystem/fiphr-cs-questionnairecode
version	Σ	0..1	string	Version of the system - if relevant
code	Σ	1..1	code	Finnish PHR: Code for questionnaire
display	Σ	0..1	string	Representation defined by the system
userSelected	Σ	0..1	boolean	If this coding was chosen directly by the user
item	C	1..*	BackboneElement	Questions and sections within the Questionnaire
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
linkId		1..1	string	Unique id for item in questionnaire
definition		0..1	uri	ElementDefinition - details for the item
code	C	0..*	Coding	Corresponding concept for this item in a terminology Binding: QuestionnaireQuestionCodes (example): Codes for questionnaires, groups and individual questions.
prefix		0..1	string	E.g. "1(a)", "2.5.3"
text		0..1	string	Primary text for the item
type		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	?!C	0..*	BackboneElement	Only allow data when
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
question		1..1	string	Question that determines whether item is enabled
operator		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)
enableBehavior	C	0..1	code	all | any Binding: EnableWhenBehavior (required): Controls how multiple enableWhen values are interpreted - whether all or any must be true.
required	C	0..1	boolean	Whether the item must be included in data results
repeats	C	0..1	boolean	Whether the item may repeat
readOnly	C	0..1	boolean	Don't allow human editing
maxLength	C	0..1	integer	No more than this many characters
answerValueSet	C	0..1	canonical(ValueSet)	Valueset containing permitted answers
answerOption	C	0..*	BackboneElement	Permitted answer
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
value[x]		1..1		Answer value Binding: QuestionnaireAnswerCodes (example): Allowed values to answer questions.
valueInteger			integer
valueDate			date
valueTime			time
valueString			string
valueCoding			Coding
valueReference			Reference(Resource)
initialSelected		0..1	boolean	Whether option is selected by default
initial	C	0..*	BackboneElement	Initial value(s) when item is first rendered
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
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	C	0..*	See item (Questionnaire)	Nested questionnaire items
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet / Code
Questionnaire.meta.security	extensible	All Security Labels
Questionnaire.meta.tag	example	CommonTags
Questionnaire.language	required	CommonLanguages
Questionnaire.identifier.use	required	IdentifierUse
Questionnaire.identifier.type	extensible	Identifier Type Codes
Questionnaire.status	required	PublicationStatus
Questionnaire.subjectType	required	Fixed Value: Patient
Questionnaire.code	extensible	https://simplifier.net/finnishphr/fiphr-vs-questionnairecode
Questionnaire.code:fiphrCode	example	QuestionnaireQuestionCodes (a valid code from LOINC)
Questionnaire.item.code	example	QuestionnaireQuestionCodes (a valid code from LOINC)
Questionnaire.item.type	required	QuestionnaireItemType
Questionnaire.item.enableWhen.operator	required	QuestionnaireItemOperator
Questionnaire.item.enableWhen.answer[x]	example	QuestionnaireAnswerCodes (a valid code from SNOMED CT)
Questionnaire.item.enableBehavior	required	EnableWhenBehavior
Questionnaire.item.answerOption.value[x]	example	QuestionnaireAnswerCodes (a valid code from SNOMED CT)
Questionnaire.item.initial.value[x]	example	QuestionnaireAnswerCodes (a valid code from SNOMED CT)

Constraints

Id	Grade	Path(s)	Details	Requirements
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()
que-1	error	Questionnaire.item	Group items must have nested items, display items cannot have nested items : (type='group' implies item.empty().not()) and (type.trace('type')='display' implies item.trace('item').empty())
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 'choice' and 'open-choice' items can have answerValueSet : (type ='choice' or type = 'open-choice' 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' | 'open-choice')) or maxLength.empty()
que-11	error	Questionnaire.item	If one or more answerOption is present, initial[x] must be missing : answerOption.empty() or initial.empty()
que-12	error	Questionnaire.item	If there are more than one enableWhen, enableBehavior must be specified : enableWhen.count() > 2 implies enableBehavior.exists()
que-13	error	Questionnaire.item	Can only have multiple initial values for repeating items : repeats=true or initial.count() <= 1

Summary

Mandatory: 17 elements
Fixed Value: 3 elements
Prohibited: 2 elements

Extensions

This structure refers to these extensions:

• http://phr.kanta.fi/StructureDefinition/fiphr-ext-creatingapplication

Slices

This structure defines the following Slices:

• The element Questionnaire.meta.profile is sliced based on the value of type:$this
• The element Questionnaire.code is sliced based on the values of value:code, value:system

Name	Flags	Card.	Type	Description & Constraints
Questionnaire		0..*	Questionnaire	Finnish PHR Questionnaire profile
meta		1..1	Meta	Metadata about the resource
Slices for profile		1..*	canonical(StructureDefinition)	Profiles this resource claims to conform to Slice: Unordered, Open by type:$this
profile:fiphrProfile		1..1	canonical(StructureDefinition)	Profiles this resource claims to conform to Fixed Value: http://phr.kanta.fi/StructureDefinition/fiphr-sd-questionnaire-r4
language		0..1	code	Language of the resource content Binding: CommonLanguages (required)
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
myExtension		0..*	(Complex)	Application identification URL: http://phr.kanta.fi/StructureDefinition/fiphr-ext-creatingapplication
url		1..1	uri	Canonical identifier for this questionnaire, represented as a URI (globally unique)
identifier		1..*	Identifier	Additional identifier for the questionnaire
use		0..1	code	usual | official | temp | secondary | old (If known)
system		1..1	uri	The namespace for the identifier value
value		1..1	string	The value that is unique
version		1..1	string	Business version of the questionnaire
name		1..1	string	Name for this questionnaire (computer friendly)
title		1..1	string	Name for this questionnaire (human friendly)
subjectType		0..1	code	Resource that can be subject of QuestionnaireResponse Fixed Value: Patient
date		1..1	dateTime	Date last changed
description		1..1	markdown	Natural language description of the questionnaire
useContext		0..0
jurisdiction		0..0
Slices for code		1..*	Coding	Concept that represents the overall questionnaire Slice: Unordered, Open by value:code, value:system Binding: https://simplifier.net/finnishphr/fiphr-vs-questionnairecode (extensible)
code:fiphrCode		1..1	Coding	Concept that represents the overall questionnaire
system		1..1	uri	Identity of the terminology system Fixed Value: http://phr.kanta.fi/CodeSystem/fiphr-cs-questionnairecode
code		1..1	code	Finnish PHR: Code for questionnaire
item		1..*	BackboneElement	Questions and sections within the Questionnaire
Documentation for this format

Terminology Bindings (Differential)

Path	Conformance	ValueSet
Questionnaire.language	required	CommonLanguages
Questionnaire.code	extensible	https://simplifier.net/finnishphr/fiphr-vs-questionnairecode

Name	Flags	Card.	Type	Description & Constraints
Questionnaire	C	0..*	Questionnaire	Finnish PHR Questionnaire profile
meta	Σ	1..1	Meta	Metadata about the resource
Slices for profile	Σ	1..*	canonical(StructureDefinition)	Profiles this resource claims to conform to Slice: Unordered, Open by type:$this
profile:fiphrProfile	Σ	1..1	canonical(StructureDefinition)	Profiles this resource claims to conform to Fixed Value: http://phr.kanta.fi/StructureDefinition/fiphr-sd-questionnaire-r4
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: CommonLanguages (required)
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
myExtension		0..*	(Complex)	Application identification URL: http://phr.kanta.fi/StructureDefinition/fiphr-ext-creatingapplication
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
url	Σ	1..1	uri	Canonical identifier for this questionnaire, represented as a URI (globally unique)
identifier	Σ	1..*	Identifier	Additional identifier for the questionnaire
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
system	Σ	1..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value	Σ	1..1	string	The value that is unique Example General: 123456
version	Σ	1..1	string	Business version of the questionnaire
name	ΣC	1..1	string	Name for this questionnaire (computer friendly)
title	Σ	1..1	string	Name for this questionnaire (human friendly)
status	?!Σ	1..1	code	draft | active | retired | unknown Binding: PublicationStatus (required): The lifecycle status of an artifact.
subjectType	Σ	0..1	code	Resource that can be subject of QuestionnaireResponse Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR. Fixed Value: Patient
date	Σ	1..1	dateTime	Date last changed
description		1..1	markdown	Natural language description of the questionnaire
Slices for code	Σ	1..*	Coding	Concept that represents the overall questionnaire Slice: Unordered, Open by value:code, value:system Binding: https://simplifier.net/finnishphr/fiphr-vs-questionnairecode (extensible)
code:fiphrCode	Σ	1..1	Coding	Concept that represents the overall questionnaire Binding: QuestionnaireQuestionCodes (example): Codes for questionnaires, groups and individual questions.
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://phr.kanta.fi/CodeSystem/fiphr-cs-questionnairecode
code	Σ	1..1	code	Finnish PHR: Code for questionnaire
item	C	1..*	BackboneElement	Questions and sections within the Questionnaire
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
linkId		1..1	string	Unique id for item in questionnaire
type		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	?!C	0..*	BackboneElement	Only allow data when
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
question		1..1	string	Question that determines whether item is enabled
operator		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)
answerValueSet	C	0..1	canonical(ValueSet)	Valueset containing permitted answers
answerOption	C	0..*	BackboneElement	Permitted answer
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
value[x]		1..1		Answer value Binding: QuestionnaireAnswerCodes (example): Allowed values to answer questions.
valueInteger			integer
valueDate			date
valueTime			time
valueString			string
valueCoding			Coding
valueReference			Reference(Resource)
initial	C	0..*	BackboneElement	Initial value(s) when item is first rendered
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
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)
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet / Code
Questionnaire.language	required	CommonLanguages
Questionnaire.identifier.use	required	IdentifierUse
Questionnaire.status	required	PublicationStatus
Questionnaire.subjectType	required	Fixed Value: Patient
Questionnaire.code	extensible	https://simplifier.net/finnishphr/fiphr-vs-questionnairecode
Questionnaire.code:fiphrCode	example	QuestionnaireQuestionCodes (a valid code from LOINC)
Questionnaire.item.type	required	QuestionnaireItemType
Questionnaire.item.enableWhen.operator	required	QuestionnaireItemOperator
Questionnaire.item.enableWhen.answer[x]	example	QuestionnaireAnswerCodes (a valid code from SNOMED CT)
Questionnaire.item.answerOption.value[x]	example	QuestionnaireAnswerCodes (a valid code from SNOMED CT)
Questionnaire.item.initial.value[x]	example	QuestionnaireAnswerCodes (a valid code from SNOMED CT)

Constraints

Id	Grade	Path(s)	Details	Requirements
dom-2	error	Questionnaire	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Questionnaire	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Questionnaire	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Questionnaire	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Questionnaire	A resource should have narrative for robust management : text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()
que-0	warning	Questionnaire	Name should be usable as an identifier for the module by machine processing applications such as code generation : name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
que-1	error	Questionnaire.item	Group items must have nested items, display items cannot have nested items : (type='group' implies item.empty().not()) and (type.trace('type')='display' implies item.trace('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 'choice' and 'open-choice' items can have answerValueSet : (type ='choice' or type = 'open-choice' 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' | 'open-choice')) or maxLength.empty()
que-11	error	Questionnaire.item	If one or more answerOption is present, initial[x] must be missing : answerOption.empty() or initial.empty()
que-12	error	Questionnaire.item	If there are more than one enableWhen, enableBehavior must be specified : enableWhen.count() > 2 implies enableBehavior.exists()
que-13	error	Questionnaire.item	Can only have multiple initial values for repeating items : repeats=true or initial.count() <= 1

Name	Flags	Card.	Type	Description & Constraints
Questionnaire	C	0..*	Questionnaire	Finnish PHR Questionnaire profile
id	Σ	0..1	id	Logical id of this artifact
meta	Σ	1..1	Meta	Metadata about the resource
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
versionId	Σ	0..1	id	Version specific identifier
lastUpdated	Σ	0..1	instant	When the resource version last changed
source	Σ	0..1	uri	Identifies where the resource comes from
Slices for profile	Σ	1..*	canonical(StructureDefinition)	Profiles this resource claims to conform to Slice: Unordered, Open by type:$this
profile:fiphrProfile	Σ	1..1	canonical(StructureDefinition)	Profiles this resource claims to conform to Fixed Value: http://phr.kanta.fi/StructureDefinition/fiphr-sd-questionnaire-r4
security	Σ	0..*	Coding	Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
tag	Σ	0..*	Coding	Tags applied to this resource Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: CommonLanguages (required)
text		0..1	Narrative	Text summary of the resource, for human interpretation
contained		0..*	Resource	Contained, inline Resources
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
myExtension		0..*	(Complex)	Application identification URL: http://phr.kanta.fi/StructureDefinition/fiphr-ext-creatingapplication
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
url	Σ	1..1	uri	Canonical identifier for this questionnaire, represented as a URI (globally unique)
identifier	Σ	1..*	Identifier	Additional identifier for the questionnaire
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
system	Σ	1..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value	Σ	1..1	string	The value that is unique Example General: 123456
period	Σ	0..1	Period	Time period when id is/was valid for use
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
version	Σ	1..1	string	Business version of the questionnaire
name	ΣC	1..1	string	Name for this questionnaire (computer friendly)
title	Σ	1..1	string	Name for this questionnaire (human friendly)
derivedFrom		0..*	canonical(Questionnaire)	Instantiates protocol or definition
status	?!Σ	1..1	code	draft | active | retired | unknown Binding: PublicationStatus (required): The lifecycle status of an artifact.
experimental	Σ	0..1	boolean	For testing purposes, not real usage
subjectType	Σ	0..1	code	Resource that can be subject of QuestionnaireResponse Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR. Fixed Value: Patient
date	Σ	1..1	dateTime	Date last changed
publisher	Σ	0..1	string	Name of the publisher (organization or individual)
contact	Σ	0..*	ContactDetail	Contact details for the publisher
description		1..1	markdown	Natural language description of the questionnaire
purpose		0..1	markdown	Why this questionnaire is defined
copyright		0..1	markdown	Use and/or publishing restrictions
approvalDate		0..1	date	When the questionnaire was approved by publisher
lastReviewDate		0..1	date	When the questionnaire was last reviewed
effectivePeriod	Σ	0..1	Period	When the questionnaire is expected to be used
Slices for code	Σ	1..*	Coding	Concept that represents the overall questionnaire Slice: Unordered, Open by value:code, value:system Binding: https://simplifier.net/finnishphr/fiphr-vs-questionnairecode (extensible)
code:fiphrCode	Σ	1..1	Coding	Concept that represents the overall questionnaire Binding: QuestionnaireQuestionCodes (example): Codes for questionnaires, groups and individual questions.
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://phr.kanta.fi/CodeSystem/fiphr-cs-questionnairecode
version	Σ	0..1	string	Version of the system - if relevant
code	Σ	1..1	code	Finnish PHR: Code for questionnaire
display	Σ	0..1	string	Representation defined by the system
userSelected	Σ	0..1	boolean	If this coding was chosen directly by the user
item	C	1..*	BackboneElement	Questions and sections within the Questionnaire
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
linkId		1..1	string	Unique id for item in questionnaire
definition		0..1	uri	ElementDefinition - details for the item
code	C	0..*	Coding	Corresponding concept for this item in a terminology Binding: QuestionnaireQuestionCodes (example): Codes for questionnaires, groups and individual questions.
prefix		0..1	string	E.g. "1(a)", "2.5.3"
text		0..1	string	Primary text for the item
type		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	?!C	0..*	BackboneElement	Only allow data when
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
question		1..1	string	Question that determines whether item is enabled
operator		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)
enableBehavior	C	0..1	code	all | any Binding: EnableWhenBehavior (required): Controls how multiple enableWhen values are interpreted - whether all or any must be true.
required	C	0..1	boolean	Whether the item must be included in data results
repeats	C	0..1	boolean	Whether the item may repeat
readOnly	C	0..1	boolean	Don't allow human editing
maxLength	C	0..1	integer	No more than this many characters
answerValueSet	C	0..1	canonical(ValueSet)	Valueset containing permitted answers
answerOption	C	0..*	BackboneElement	Permitted answer
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
value[x]		1..1		Answer value Binding: QuestionnaireAnswerCodes (example): Allowed values to answer questions.
valueInteger			integer
valueDate			date
valueTime			time
valueString			string
valueCoding			Coding
valueReference			Reference(Resource)
initialSelected		0..1	boolean	Whether option is selected by default
initial	C	0..*	BackboneElement	Initial value(s) when item is first rendered
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
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	C	0..*	See item (Questionnaire)	Nested questionnaire items
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet / Code
Questionnaire.meta.security	extensible	All Security Labels
Questionnaire.meta.tag	example	CommonTags
Questionnaire.language	required	CommonLanguages
Questionnaire.identifier.use	required	IdentifierUse
Questionnaire.identifier.type	extensible	Identifier Type Codes
Questionnaire.status	required	PublicationStatus
Questionnaire.subjectType	required	Fixed Value: Patient
Questionnaire.code	extensible	https://simplifier.net/finnishphr/fiphr-vs-questionnairecode
Questionnaire.code:fiphrCode	example	QuestionnaireQuestionCodes (a valid code from LOINC)
Questionnaire.item.code	example	QuestionnaireQuestionCodes (a valid code from LOINC)
Questionnaire.item.type	required	QuestionnaireItemType
Questionnaire.item.enableWhen.operator	required	QuestionnaireItemOperator
Questionnaire.item.enableWhen.answer[x]	example	QuestionnaireAnswerCodes (a valid code from SNOMED CT)
Questionnaire.item.enableBehavior	required	EnableWhenBehavior
Questionnaire.item.answerOption.value[x]	example	QuestionnaireAnswerCodes (a valid code from SNOMED CT)
Questionnaire.item.initial.value[x]	example	QuestionnaireAnswerCodes (a valid code from SNOMED CT)

Constraints

Id	Grade	Path(s)	Details	Requirements
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()
que-1	error	Questionnaire.item	Group items must have nested items, display items cannot have nested items : (type='group' implies item.empty().not()) and (type.trace('type')='display' implies item.trace('item').empty())
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 'choice' and 'open-choice' items can have answerValueSet : (type ='choice' or type = 'open-choice' 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' | 'open-choice')) or maxLength.empty()
que-11	error	Questionnaire.item	If one or more answerOption is present, initial[x] must be missing : answerOption.empty() or initial.empty()
que-12	error	Questionnaire.item	If there are more than one enableWhen, enableBehavior must be specified : enableWhen.count() > 2 implies enableBehavior.exists()
que-13	error	Questionnaire.item	Can only have multiple initial values for repeating items : repeats=true or initial.count() <= 1

Summary

Mandatory: 17 elements
Fixed Value: 3 elements
Prohibited: 2 elements

Extensions

This structure refers to these extensions:

• http://phr.kanta.fi/StructureDefinition/fiphr-ext-creatingapplication

Slices

This structure defines the following Slices:

• The element Questionnaire.meta.profile is sliced based on the value of type:$this
• The element Questionnaire.code is sliced based on the values of value:code, value:system