Implementation Guide for fælleskommunal informationsmodel
0.7.0 - CI Build Denmark flag

Implementation Guide for fælleskommunal informationsmodel - Local Development build (v0.7.0). See the Directory of published versions

Resource Profile: MatterOfInterest

Official URL: http://kl.dk/fhir/common/caresocial/StructureDefinition/KLCommonCareSocialMatterOfInterest Version: 0.7.0
Draft as of 2023-07-06 Computable Name: KLCommonCareSocialMatterOfInterest

Matter or area of interest in relation to the care of the citizen, as used in Danish municipalities (Oplysning/Område/Tema)

Scope and usage

The KLCommonCareSocialMatterOfInterest is used in Danish Municipalities, and may be instantiated whenever information about the citizen is recorded, under the headings defined by FFB Themes, Areas (FSIII områder), General Information (FSIII generelle oplysninger). For each heading, a new instance of CommonCareSocialInformation is used. If using the findingInformer extension, each of the matterOfInterest informers’ perspectives have their own instance. I.e. one FFB theme may be associated with three different instances, if all matter-of-interest informers are documented explicitly.

Observation.valueCodeableConcept holds the text-based result of the observation.

The documentation of the care-pathway may be supported using the Observation.encounter which tells in which encounter the KLCommonCareSocialMatterOfInterest has been recorded. Observation.basedOn may tell, which ServiceRequest resulted in the information gathering that this KLCommonCareSocialMatterOfInterest is part of.

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 specificere hvilke af FHIR-profilens atributter der skal bruges til specifikation af indholdet

FKI-attribut Definition FHIR
områdekode Klasse der udtrykker området der belyses. Observation.code.coding
områdetekst Oplysningen af området udtrykt som tekst Observation.valueCodeableConcept.text
områdesubjekt Den borger som oplysningen af området omhandler Observation.subject
områdekontakt Den kontakt hvor oplysningsaktiviteten har fundet sted. Observation.encounter
områdeansvarlig Den fagperson, der er ansvarlig for oplysningsaktiviteten Observation.performer
områdeordre Den anledning, der har udløst at oplysningsaktiviteten er igangsat Observation.basedOn
områdetid Det tidspunkt hvor området er oplyst. Observation.effectiveDateTime
områdeinformant Klasse der udtrykker hvem område/tema er belyst af. Observation.extension:matterOfInterestInformer
områdestatus Klasse der udtrykker, hvor i sin proces, oplysning af området er. Observation.status

Usage:

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

This structure is derived from Observation

NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation 0..*ObservationMeasurements and simple assertions
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... matterOfInterestInformer 0..1CodeableConcept[DK] områdeInformant
URL: http://kl.dk/fhir/common/caresocial/StructureDefinition/MatterOfInterestInformer
Binding: KLKildeTilOplysningFFB (required)
... basedOn 0..1Reference(ServiceRequest)[DK] områdeOrdre
... code 1..1CodeableConcept[DK] områdeKode
Binding: KLOplysningKoder (required)
... subject 0..1Reference(Citizen)[DK] områdeSubjekt
... encounter 0..1Reference(Encounter)[DK] områdeKontakt
... effective[x] 1..1dateTime[DK] områdeTid
... performer 0..1Reference(Practioner)[DK] områdeAnsvarlig
... value[x] 0..1CodeableConceptActual result
.... coding 0..*CodingCode defined by a terminology system
Binding: KLOplysningKoder (required)
.... text 0..1string[DK] områdeTekst

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
Observation.coderequiredKLInformationCodes
Observation.value[x].codingrequiredKLMatterOfInterestValues
NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation C0..*ObservationMeasurements and simple assertions
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... matterOfInterestInformer 0..1CodeableConcept[DK] områdeInformant
URL: http://kl.dk/fhir/common/caresocial/StructureDefinition/MatterOfInterestInformer
Binding: KLKildeTilOplysningFFB (required)
... basedOn Σ0..1Reference(ServiceRequest)[DK] områdeOrdre
... status ?!Σ1..1code[DK] områdeStatus
Binding: ObservationStatus (required): Codes providing the status of an observation.

... code Σ1..1CodeableConcept[DK] områdeKode
Binding: KLOplysningKoder (required)
... subject Σ0..1Reference(Citizen)[DK] områdeSubjekt
... encounter Σ0..1Reference(Encounter)[DK] områdeKontakt
... effective[x] Σ1..1dateTime[DK] områdeTid
... performer Σ0..1Reference(Practioner)[DK] områdeAnsvarlig
... value[x] ΣC0..1CodeableConceptActual result
.... coding Σ0..*CodingCode defined by a terminology system
Binding: KLOplysningKoder (required)
.... text Σ0..1string[DK] områdeTekst

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
Observation.statusrequiredObservationStatus
Observation.coderequiredKLInformationCodes
Observation.value[x].codingrequiredKLMatterOfInterestValues
NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation C0..*ObservationMeasurements and simple assertions
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... matterOfInterestInformer 0..1CodeableConcept[DK] områdeInformant
URL: http://kl.dk/fhir/common/caresocial/StructureDefinition/MatterOfInterestInformer
Binding: KLKildeTilOplysningFFB (required)
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ0..*IdentifierBusiness Identifier for observation
... basedOn Σ0..1Reference(ServiceRequest)[DK] områdeOrdre
... partOf Σ0..*Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy)Part of referenced event
... status ?!Σ1..1code[DK] områdeStatus
Binding: ObservationStatus (required): Codes providing the status of an observation.

... category 0..*CodeableConceptClassification of type of observation
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.


... code Σ1..1CodeableConcept[DK] områdeKode
Binding: KLOplysningKoder (required)
... subject Σ0..1Reference(Citizen)[DK] områdeSubjekt
... focus ΣTU0..*Reference(Resource)What the observation is about, when it is not about the subject of record
... encounter Σ0..1Reference(Encounter)[DK] områdeKontakt
... effective[x] Σ1..1dateTime[DK] områdeTid
... issued Σ0..1instantDate/Time this version was made available
... performer Σ0..1Reference(Practioner)[DK] områdeAnsvarlig
... value[x] ΣC0..1CodeableConceptActual result
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... coding Σ0..*CodingCode defined by a terminology system
Binding: KLOplysningKoder (required)
.... text Σ0..1string[DK] områdeTekst
... dataAbsentReason C0..1CodeableConceptWhy the result is missing
Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing.

... interpretation 0..*CodeableConceptHigh, low, normal, etc.
Binding: ObservationInterpretationCodes (extensible): Codes identifying interpretations of observations.


... note 0..*AnnotationComments about the observation
... bodySite 0..1CodeableConceptObserved body part
Binding: SNOMEDCTBodyStructures (example): Codes describing anatomical locations. May include laterality.

... method 0..1CodeableConceptHow it was done
Binding: ObservationMethods (example): Methods for simple observations.

... specimen 0..1Reference(Specimen)Specimen used for this observation
... device 0..1Reference(Device | DeviceMetric)(Measurement) Device
... referenceRange C0..*BackboneElementProvides guide for interpretation
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... low C0..1SimpleQuantityLow Range, if relevant
.... high C0..1SimpleQuantityHigh Range, if relevant
.... type 0..1CodeableConceptReference range qualifier
Binding: ObservationReferenceRangeMeaningCodes (preferred): Code for the meaning of a reference range.

.... appliesTo 0..*CodeableConceptReference range population
Binding: ObservationReferenceRangeAppliesToCodes (example): Codes identifying the population the reference range applies to.


.... age 0..1RangeApplicable age range, if relevant
.... text 0..1stringText based reference range in an observation
... hasMember Σ0..*Reference(Observation | QuestionnaireResponse | MolecularSequence)Related resource that belongs to the Observation group
... derivedFrom Σ0..*Reference(DocumentReference | ImagingStudy | Media | QuestionnaireResponse | Observation | MolecularSequence)Related measurements the observation is made from
... component Σ0..*BackboneElementComponent results
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code Σ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.

.... value[x] Σ0..1Actual component result
..... valueQuantityQuantity
..... valueCodeableConceptCodeableConcept
..... valueStringstring
..... valueBooleanboolean
..... valueIntegerinteger
..... valueRangeRange
..... valueRatioRatio
..... valueSampledDataSampledData
..... valueTimetime
..... valueDateTimedateTime
..... valuePeriodPeriod
.... dataAbsentReason C0..1CodeableConceptWhy the component result is missing
Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing.

.... interpretation 0..*CodeableConceptHigh, low, normal, etc.
Binding: ObservationInterpretationCodes (extensible): Codes identifying interpretations of observations.


.... referenceRange 0..*See referenceRange (Observation)Provides guide for interpretation of component result

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
Observation.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Observation.statusrequiredObservationStatus
Observation.categorypreferredObservationCategoryCodes
Observation.coderequiredKLInformationCodes
Observation.value[x].codingrequiredKLMatterOfInterestValues
Observation.dataAbsentReasonextensibleDataAbsentReason
Observation.interpretationextensibleObservationInterpretationCodes
Observation.bodySiteexampleSNOMEDCTBodyStructures
Observation.methodexampleObservationMethods
Observation.referenceRange.typepreferredObservationReferenceRangeMeaningCodes
Observation.referenceRange.appliesToexampleObservationReferenceRangeAppliesToCodes
Observation.component.codeexampleLOINCCodes (a valid code from LOINC)
Observation.component.dataAbsentReasonextensibleDataAbsentReason
Observation.component.interpretationextensibleObservationInterpretationCodes

Differential View

This structure is derived from Observation

NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation 0..*ObservationMeasurements and simple assertions
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... matterOfInterestInformer 0..1CodeableConcept[DK] områdeInformant
URL: http://kl.dk/fhir/common/caresocial/StructureDefinition/MatterOfInterestInformer
Binding: KLKildeTilOplysningFFB (required)
... basedOn 0..1Reference(ServiceRequest)[DK] områdeOrdre
... code 1..1CodeableConcept[DK] områdeKode
Binding: KLOplysningKoder (required)
... subject 0..1Reference(Citizen)[DK] områdeSubjekt
... encounter 0..1Reference(Encounter)[DK] områdeKontakt
... effective[x] 1..1dateTime[DK] områdeTid
... performer 0..1Reference(Practioner)[DK] områdeAnsvarlig
... value[x] 0..1CodeableConceptActual result
.... coding 0..*CodingCode defined by a terminology system
Binding: KLOplysningKoder (required)
.... text 0..1string[DK] områdeTekst

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
Observation.coderequiredKLInformationCodes
Observation.value[x].codingrequiredKLMatterOfInterestValues

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation C0..*ObservationMeasurements and simple assertions
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... matterOfInterestInformer 0..1CodeableConcept[DK] områdeInformant
URL: http://kl.dk/fhir/common/caresocial/StructureDefinition/MatterOfInterestInformer
Binding: KLKildeTilOplysningFFB (required)
... basedOn Σ0..1Reference(ServiceRequest)[DK] områdeOrdre
... status ?!Σ1..1code[DK] områdeStatus
Binding: ObservationStatus (required): Codes providing the status of an observation.

... code Σ1..1CodeableConcept[DK] områdeKode
Binding: KLOplysningKoder (required)
... subject Σ0..1Reference(Citizen)[DK] områdeSubjekt
... encounter Σ0..1Reference(Encounter)[DK] områdeKontakt
... effective[x] Σ1..1dateTime[DK] områdeTid
... performer Σ0..1Reference(Practioner)[DK] områdeAnsvarlig
... value[x] ΣC0..1CodeableConceptActual result
.... coding Σ0..*CodingCode defined by a terminology system
Binding: KLOplysningKoder (required)
.... text Σ0..1string[DK] områdeTekst

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
Observation.statusrequiredObservationStatus
Observation.coderequiredKLInformationCodes
Observation.value[x].codingrequiredKLMatterOfInterestValues

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation C0..*ObservationMeasurements and simple assertions
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... matterOfInterestInformer 0..1CodeableConcept[DK] områdeInformant
URL: http://kl.dk/fhir/common/caresocial/StructureDefinition/MatterOfInterestInformer
Binding: KLKildeTilOplysningFFB (required)
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ0..*IdentifierBusiness Identifier for observation
... basedOn Σ0..1Reference(ServiceRequest)[DK] områdeOrdre
... partOf Σ0..*Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy)Part of referenced event
... status ?!Σ1..1code[DK] områdeStatus
Binding: ObservationStatus (required): Codes providing the status of an observation.

... category 0..*CodeableConceptClassification of type of observation
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.


... code Σ1..1CodeableConcept[DK] områdeKode
Binding: KLOplysningKoder (required)
... subject Σ0..1Reference(Citizen)[DK] områdeSubjekt
... focus ΣTU0..*Reference(Resource)What the observation is about, when it is not about the subject of record
... encounter Σ0..1Reference(Encounter)[DK] områdeKontakt
... effective[x] Σ1..1dateTime[DK] områdeTid
... issued Σ0..1instantDate/Time this version was made available
... performer Σ0..1Reference(Practioner)[DK] områdeAnsvarlig
... value[x] ΣC0..1CodeableConceptActual result
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... coding Σ0..*CodingCode defined by a terminology system
Binding: KLOplysningKoder (required)
.... text Σ0..1string[DK] områdeTekst
... dataAbsentReason C0..1CodeableConceptWhy the result is missing
Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing.

... interpretation 0..*CodeableConceptHigh, low, normal, etc.
Binding: ObservationInterpretationCodes (extensible): Codes identifying interpretations of observations.


... note 0..*AnnotationComments about the observation
... bodySite 0..1CodeableConceptObserved body part
Binding: SNOMEDCTBodyStructures (example): Codes describing anatomical locations. May include laterality.

... method 0..1CodeableConceptHow it was done
Binding: ObservationMethods (example): Methods for simple observations.

... specimen 0..1Reference(Specimen)Specimen used for this observation
... device 0..1Reference(Device | DeviceMetric)(Measurement) Device
... referenceRange C0..*BackboneElementProvides guide for interpretation
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... low C0..1SimpleQuantityLow Range, if relevant
.... high C0..1SimpleQuantityHigh Range, if relevant
.... type 0..1CodeableConceptReference range qualifier
Binding: ObservationReferenceRangeMeaningCodes (preferred): Code for the meaning of a reference range.

.... appliesTo 0..*CodeableConceptReference range population
Binding: ObservationReferenceRangeAppliesToCodes (example): Codes identifying the population the reference range applies to.


.... age 0..1RangeApplicable age range, if relevant
.... text 0..1stringText based reference range in an observation
... hasMember Σ0..*Reference(Observation | QuestionnaireResponse | MolecularSequence)Related resource that belongs to the Observation group
... derivedFrom Σ0..*Reference(DocumentReference | ImagingStudy | Media | QuestionnaireResponse | Observation | MolecularSequence)Related measurements the observation is made from
... component Σ0..*BackboneElementComponent results
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code Σ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.

.... value[x] Σ0..1Actual component result
..... valueQuantityQuantity
..... valueCodeableConceptCodeableConcept
..... valueStringstring
..... valueBooleanboolean
..... valueIntegerinteger
..... valueRangeRange
..... valueRatioRatio
..... valueSampledDataSampledData
..... valueTimetime
..... valueDateTimedateTime
..... valuePeriodPeriod
.... dataAbsentReason C0..1CodeableConceptWhy the component result is missing
Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing.

.... interpretation 0..*CodeableConceptHigh, low, normal, etc.
Binding: ObservationInterpretationCodes (extensible): Codes identifying interpretations of observations.


.... referenceRange 0..*See referenceRange (Observation)Provides guide for interpretation of component result

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
Observation.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Observation.statusrequiredObservationStatus
Observation.categorypreferredObservationCategoryCodes
Observation.coderequiredKLInformationCodes
Observation.value[x].codingrequiredKLMatterOfInterestValues
Observation.dataAbsentReasonextensibleDataAbsentReason
Observation.interpretationextensibleObservationInterpretationCodes
Observation.bodySiteexampleSNOMEDCTBodyStructures
Observation.methodexampleObservationMethods
Observation.referenceRange.typepreferredObservationReferenceRangeMeaningCodes
Observation.referenceRange.appliesToexampleObservationReferenceRangeAppliesToCodes
Observation.component.codeexampleLOINCCodes (a valid code from LOINC)
Observation.component.dataAbsentReasonextensibleDataAbsentReason
Observation.component.interpretationextensibleObservationInterpretationCodes

 

Other representations of profile: CSV, Excel, Schematron