Scope and usage

CitizensOwnObservation is used to document, performance level (udførelse) or importance level (betydning) as defined by FSIII. Note that each of the observations require its own instance of this model. The observation only makes sense linked to an already defined Condition or MatterOfInterest. Consequently, the focus-attribute is mandatory.

The code-attribute refers to either performance level or importance level using a required ValueSet, and the result is expressed in valueCodeableConcept, which is also bound to a required FSIII valueSet. Observation and value codes should be correctly matched, so that a performance-result is not used with a importance observation-code.

Notice that the status-attribute is mandatory. For normal use, just set to “final”. If data is missing or another problem has occured, follow the FHIR guidance to populate the field correctly.

Conversions between Danish information model and FHIR-profile

Nedenstående tabel oversætter mellem de attributter, der er defineret i den fælleskommunale informationsmodel (FKI), definerer kort den enkelte attribut på dansk og specificerer, hvilke af FHIR-profilens atributter der skal bruges til specifikation af indholdet.

• Differential Table
• Key Elements Table
• Snapshot Table
• Statistics/References
• All

This structure is derived from Observation

Name	Flags	Card.	Type	Description & Constraints
Observation	C	0..*	Observation	Measurements and simple assertions klgateway-citizen-observation-code-and-value-must-match: The value of the observation shall be member of the valueset matching the code of the observation klgateway-focus-must-be-home-care-condition-or-area: The focus shall be a home care condition or a home care matter of interest
identifier		0..0
basedOn		0..0
partOf		0..0
status		1..1	code	[DK] borgervurderingsstatus
category		0..0
code		1..1	CodeableConcept	Type of observation (code / type) Binding: KLBorgervurderingsObservationskoderFSIII (required)
coding		0..*	Coding	[DK] borgervurderingskode
version		0..0
display		0..0
userSelected		0..0
text		0..0
subject		0..1	Reference(CareCitizen) {b}	[DK] borgervurderingssubjekt
focus		1..1	Reference(CareCondition | CareMatterOfInterestObservation) {b}	[DK] borgervurderingsfokus
encounter		0..0
effective[x]		1..1	dateTime	[DK] borgervurderingstid
issued		0..0
performer		0..0
value[x]		1..1	CodeableConcept	Actual result Binding: KLBorgervurderingsResultatkoderFSIII (required)
coding		0..*	Coding	[DK] borgervurderingsresultat
version		0..0
display		0..0
userSelected		0..0
text		0..0
dataAbsentReason		0..0
interpretation		0..0
note		0..0
bodySite		0..0
method		0..0
specimen		0..0
device		0..0
referenceRange		0..0
hasMember		0..0
derivedFrom		0..0
component		0..0
Documentation for this format

Terminology Bindings (Differential)

Path	Conformance	ValueSet
Observation.code	required	KLCitizenObservationCodesFSIII
Observation.value[x]	required	KLCitizenObservationResultCodesFSIII

Constraints

Id	Grade	Path(s)	Details	Requirements
klgateway-citizen-observation-code-and-value-must-match	error	Observation	The value of the observation shall be member of the valueset matching the code of the observation : ((code.coding.code = 'C') and (valueCodeableConcept.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLPerformanceLevelCodesFSIII'))) or ((code.coding.code = 'D') and (valueCodeableConcept.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLImportanceLevelCodesFSIII')))
klgateway-focus-must-be-home-care-condition-or-area	error	Observation	The focus shall be a home care condition or a home care matter of interest : focus.resolve().code.coding.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLConditionCodesHomeCare') or focus.resolve().code.coding.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLHomeCareAreasFSIII')

Name	Flags	Card.	Type	Description & Constraints
Observation	C	0..*	Observation	Measurements and simple assertions klgateway-citizen-observation-code-and-value-must-match: The value of the observation shall be member of the valueset matching the code of the observation klgateway-focus-must-be-home-care-condition-or-area: The focus shall be a home care condition or a home care matter of interest
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
status	?!Σ	1..1	code	[DK] borgervurderingsstatus Binding: ObservationStatus (required): Codes providing the status of an observation.
code	Σ	1..1	CodeableConcept	Type of observation (code / type) Binding: KLBorgervurderingsObservationskoderFSIII (required)
coding	Σ	0..*	Coding	[DK] borgervurderingskode
subject	Σ	0..1	Reference(CareCitizen) {b}	[DK] borgervurderingssubjekt
focus	Σ	1..1	Reference(CareCondition | CareMatterOfInterestObservation) {b}	[DK] borgervurderingsfokus
effective[x]	Σ	1..1	dateTime	[DK] borgervurderingstid
value[x]	ΣC	1..1	CodeableConcept	Actual result Binding: KLBorgervurderingsResultatkoderFSIII (required)
coding	Σ	0..*	Coding	[DK] borgervurderingsresultat
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet
Observation.status	required	ObservationStatus
Observation.code	required	KLCitizenObservationCodesFSIII
Observation.value[x]	required	KLCitizenObservationResultCodesFSIII
Observation.component.code	example	LOINCCodes (a valid code from LOINC)

Constraints

Id	Grade	Path(s)	Details	Requirements
dom-2	error	Observation	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Observation	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	Observation	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	Observation	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Observation	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()
klgateway-citizen-observation-code-and-value-must-match	error	Observation	The value of the observation shall be member of the valueset matching the code of the observation : ((code.coding.code = 'C') and (valueCodeableConcept.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLPerformanceLevelCodesFSIII'))) or ((code.coding.code = 'D') and (valueCodeableConcept.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLImportanceLevelCodesFSIII')))
klgateway-focus-must-be-home-care-condition-or-area	error	Observation	The focus shall be a home care condition or a home care matter of interest : focus.resolve().code.coding.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLConditionCodesHomeCare') or focus.resolve().code.coding.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLHomeCareAreasFSIII')
obs-6	error	Observation	dataAbsentReason SHALL only be present if Observation.value[x] is not present : dataAbsentReason.empty() or value.empty()
obs-7	error	Observation	If Observation.code is the same as an Observation.component.code then the value element associated with the code SHALL NOT be present : value.empty() or component.code.where(coding.intersect(%resource.code.coding).exists()).empty()

Name	Flags	Card.	Type	Description & Constraints
Observation	C	0..*	Observation	Measurements and simple assertions klgateway-citizen-observation-code-and-value-must-match: The value of the observation shall be member of the valueset matching the code of the observation klgateway-focus-must-be-home-care-condition-or-area: The focus shall be a home care condition or a home care matter of interest
id	Σ	0..1	id	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
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 (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
text		0..1	Narrative	Text summary of the resource, for human interpretation
contained		0..*	Resource	Contained, inline Resources
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
status	?!Σ	1..1	code	[DK] borgervurderingsstatus Binding: ObservationStatus (required): Codes providing the status of an observation.
code	Σ	1..1	CodeableConcept	Type of observation (code / type) Binding: KLBorgervurderingsObservationskoderFSIII (required)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
coding	Σ	0..*	Coding	[DK] borgervurderingskode
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	Σ	0..1	uri	Identity of the terminology system
code	Σ	0..1	code	Symbol in syntax defined by the system
subject	Σ	0..1	Reference(CareCitizen) {b}	[DK] borgervurderingssubjekt
focus	Σ	1..1	Reference(CareCondition | CareMatterOfInterestObservation) {b}	[DK] borgervurderingsfokus
effective[x]	Σ	1..1	dateTime	[DK] borgervurderingstid
value[x]	ΣC	1..1	CodeableConcept	Actual result Binding: KLBorgervurderingsResultatkoderFSIII (required)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
coding	Σ	0..*	Coding	[DK] borgervurderingsresultat
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	Σ	0..1	uri	Identity of the terminology system
code	Σ	0..1	code	Symbol in syntax defined by the system
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet
Observation.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding
Observation.status	required	ObservationStatus
Observation.code	required	KLCitizenObservationCodesFSIII
Observation.value[x]	required	KLCitizenObservationResultCodesFSIII
Observation.referenceRange.type	preferred	ObservationReferenceRangeMeaningCodes
Observation.referenceRange.appliesTo	example	ObservationReferenceRangeAppliesToCodes
Observation.component.code	example	LOINCCodes (a valid code from LOINC)
Observation.component.dataAbsentReason	extensible	DataAbsentReason
Observation.component.interpretation	extensible	ObservationInterpretationCodes

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()

Differential View

This structure is derived from Observation

Name	Flags	Card.	Type	Description & Constraints
Observation	C	0..*	Observation	Measurements and simple assertions klgateway-citizen-observation-code-and-value-must-match: The value of the observation shall be member of the valueset matching the code of the observation klgateway-focus-must-be-home-care-condition-or-area: The focus shall be a home care condition or a home care matter of interest
identifier		0..0
basedOn		0..0
partOf		0..0
status		1..1	code	[DK] borgervurderingsstatus
category		0..0
code		1..1	CodeableConcept	Type of observation (code / type) Binding: KLBorgervurderingsObservationskoderFSIII (required)
coding		0..*	Coding	[DK] borgervurderingskode
version		0..0
display		0..0
userSelected		0..0
text		0..0
subject		0..1	Reference(CareCitizen) {b}	[DK] borgervurderingssubjekt
focus		1..1	Reference(CareCondition | CareMatterOfInterestObservation) {b}	[DK] borgervurderingsfokus
encounter		0..0
effective[x]		1..1	dateTime	[DK] borgervurderingstid
issued		0..0
performer		0..0
value[x]		1..1	CodeableConcept	Actual result Binding: KLBorgervurderingsResultatkoderFSIII (required)
coding		0..*	Coding	[DK] borgervurderingsresultat
version		0..0
display		0..0
userSelected		0..0
text		0..0
dataAbsentReason		0..0
interpretation		0..0
note		0..0
bodySite		0..0
method		0..0
specimen		0..0
device		0..0
referenceRange		0..0
hasMember		0..0
derivedFrom		0..0
component		0..0
Documentation for this format

Terminology Bindings (Differential)

Path	Conformance	ValueSet
Observation.code	required	KLCitizenObservationCodesFSIII
Observation.value[x]	required	KLCitizenObservationResultCodesFSIII

Constraints

Id	Grade	Path(s)	Details	Requirements
klgateway-citizen-observation-code-and-value-must-match	error	Observation	The value of the observation shall be member of the valueset matching the code of the observation : ((code.coding.code = 'C') and (valueCodeableConcept.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLPerformanceLevelCodesFSIII'))) or ((code.coding.code = 'D') and (valueCodeableConcept.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLImportanceLevelCodesFSIII')))
klgateway-focus-must-be-home-care-condition-or-area	error	Observation	The focus shall be a home care condition or a home care matter of interest : focus.resolve().code.coding.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLConditionCodesHomeCare') or focus.resolve().code.coding.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLHomeCareAreasFSIII')

Key Elements View

Name	Flags	Card.	Type	Description & Constraints
Observation	C	0..*	Observation	Measurements and simple assertions klgateway-citizen-observation-code-and-value-must-match: The value of the observation shall be member of the valueset matching the code of the observation klgateway-focus-must-be-home-care-condition-or-area: The focus shall be a home care condition or a home care matter of interest
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
status	?!Σ	1..1	code	[DK] borgervurderingsstatus Binding: ObservationStatus (required): Codes providing the status of an observation.
code	Σ	1..1	CodeableConcept	Type of observation (code / type) Binding: KLBorgervurderingsObservationskoderFSIII (required)
coding	Σ	0..*	Coding	[DK] borgervurderingskode
subject	Σ	0..1	Reference(CareCitizen) {b}	[DK] borgervurderingssubjekt
focus	Σ	1..1	Reference(CareCondition | CareMatterOfInterestObservation) {b}	[DK] borgervurderingsfokus
effective[x]	Σ	1..1	dateTime	[DK] borgervurderingstid
value[x]	ΣC	1..1	CodeableConcept	Actual result Binding: KLBorgervurderingsResultatkoderFSIII (required)
coding	Σ	0..*	Coding	[DK] borgervurderingsresultat
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet
Observation.status	required	ObservationStatus
Observation.code	required	KLCitizenObservationCodesFSIII
Observation.value[x]	required	KLCitizenObservationResultCodesFSIII
Observation.component.code	example	LOINCCodes (a valid code from LOINC)

Constraints

Id	Grade	Path(s)	Details	Requirements
dom-2	error	Observation	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Observation	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	Observation	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	Observation	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Observation	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()
klgateway-citizen-observation-code-and-value-must-match	error	Observation	The value of the observation shall be member of the valueset matching the code of the observation : ((code.coding.code = 'C') and (valueCodeableConcept.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLPerformanceLevelCodesFSIII'))) or ((code.coding.code = 'D') and (valueCodeableConcept.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLImportanceLevelCodesFSIII')))
klgateway-focus-must-be-home-care-condition-or-area	error	Observation	The focus shall be a home care condition or a home care matter of interest : focus.resolve().code.coding.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLConditionCodesHomeCare') or focus.resolve().code.coding.memberOf('http://kl.dk/fhir/common/caresocial/ValueSet/KLHomeCareAreasFSIII')
obs-6	error	Observation	dataAbsentReason SHALL only be present if Observation.value[x] is not present : dataAbsentReason.empty() or value.empty()
obs-7	error	Observation	If Observation.code is the same as an Observation.component.code then the value element associated with the code SHALL NOT be present : value.empty() or component.code.where(coding.intersect(%resource.code.coding).exists()).empty()

Snapshot View

Name	Flags	Card.	Type	Description & Constraints
Observation	C	0..*	Observation	Measurements and simple assertions klgateway-citizen-observation-code-and-value-must-match: The value of the observation shall be member of the valueset matching the code of the observation klgateway-focus-must-be-home-care-condition-or-area: The focus shall be a home care condition or a home care matter of interest
id	Σ	0..1	id	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
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 (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
text		0..1	Narrative	Text summary of the resource, for human interpretation
contained		0..*	Resource	Contained, inline Resources
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
status	?!Σ	1..1	code	[DK] borgervurderingsstatus Binding: ObservationStatus (required): Codes providing the status of an observation.
code	Σ	1..1	CodeableConcept	Type of observation (code / type) Binding: KLBorgervurderingsObservationskoderFSIII (required)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
coding	Σ	0..*	Coding	[DK] borgervurderingskode
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	Σ	0..1	uri	Identity of the terminology system
code	Σ	0..1	code	Symbol in syntax defined by the system
subject	Σ	0..1	Reference(CareCitizen) {b}	[DK] borgervurderingssubjekt
focus	Σ	1..1	Reference(CareCondition | CareMatterOfInterestObservation) {b}	[DK] borgervurderingsfokus
effective[x]	Σ	1..1	dateTime	[DK] borgervurderingstid
value[x]	ΣC	1..1	CodeableConcept	Actual result Binding: KLBorgervurderingsResultatkoderFSIII (required)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
coding	Σ	0..*	Coding	[DK] borgervurderingsresultat
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	Σ	0..1	uri	Identity of the terminology system
code	Σ	0..1	code	Symbol in syntax defined by the system
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet
Observation.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding
Observation.status	required	ObservationStatus
Observation.code	required	KLCitizenObservationCodesFSIII
Observation.value[x]	required	KLCitizenObservationResultCodesFSIII
Observation.referenceRange.type	preferred	ObservationReferenceRangeMeaningCodes
Observation.referenceRange.appliesTo	example	ObservationReferenceRangeAppliesToCodes
Observation.component.code	example	LOINCCodes (a valid code from LOINC)
Observation.component.dataAbsentReason	extensible	DataAbsentReason
Observation.component.interpretation	extensible	ObservationInterpretationCodes

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()

This structure is derived from Observation

Summary

Mandatory: 3 elements
Prohibited: 26 elements

Structures

This structure refers to these other structures:

• CareCitizen (http://gateway.kl.dk/1.0/StructureDefinition/klgateway-care-citizen)
• CareCondition (http://gateway.kl.dk/1.0/StructureDefinition/klgateway-care-condition)
• CareMatterOfInterestObservation (http://gateway.kl.dk/1.0/StructureDefinition/klgateway-care-matter-of-interest-observation)