Implementation Guide for fælleskommunal informationsmodel
0.7.0 - CI Build
Implementation Guide for fælleskommunal informationsmodel - Local Development build (v0.7.0). See the Directory of published versions
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)
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.
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:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from Observation
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Observation | 0..* | Observation | Measurements and simple assertions | |
Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |
matterOfInterestInformer | 0..1 | CodeableConcept | [DK] områdeInformant URL: http://kl.dk/fhir/common/caresocial/StructureDefinition/MatterOfInterestInformer Binding: KLKildeTilOplysningFFB (required) | |
basedOn | 0..1 | Reference(ServiceRequest) | [DK] områdeOrdre | |
status | 1..1 | code | [DK] områdeStatus | |
code | 1..1 | CodeableConcept | [DK] områdeKode Binding: KLOplysningKoder (required) | |
subject | 0..1 | Reference(Citizen) | [DK] områdeSubjekt | |
encounter | 0..1 | Reference(Encounter) | [DK] områdeKontakt | |
effective[x] | 1..1 | dateTime | [DK] områdeTid | |
performer | 0..1 | Reference(Practioner) | [DK] områdeAnsvarlig | |
value[x] | 0..1 | CodeableConcept | Actual result | |
coding | 0..* | Coding | Code defined by a terminology system Binding: KLOplysningKoder (required) | |
text | 0..1 | string | [DK] områdeTekst | |
Documentation for this format |
Path | Conformance | ValueSet |
Observation.code | required | KLInformationCodes |
Observation.value[x].coding | required | KLMatterOfInterestValues |
Path | Conformance | ValueSet |
Observation.status | required | ObservationStatus |
Observation.code | required | KLInformationCodes |
Observation.value[x].coding | required | KLMatterOfInterestValues |
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
Observation | C | 0..* | Observation | Measurements and simple assertions | ||||
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.
| |||||
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 | |||||
matterOfInterestInformer | 0..1 | CodeableConcept | [DK] områdeInformant URL: http://kl.dk/fhir/common/caresocial/StructureDefinition/MatterOfInterestInformer Binding: KLKildeTilOplysningFFB (required) | |||||
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored | ||||
identifier | Σ | 0..* | Identifier | Business Identifier for observation | ||||
basedOn | Σ | 0..1 | Reference(ServiceRequest) | [DK] områdeOrdre | ||||
partOf | Σ | 0..* | Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy) | Part of referenced event | ||||
status | ?!Σ | 1..1 | code | [DK] områdeStatus Binding: ObservationStatus (required): Codes providing the status of an observation. | ||||
category | 0..* | CodeableConcept | Classification of type of observation Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories. | |||||
code | Σ | 1..1 | CodeableConcept | [DK] områdeKode Binding: KLOplysningKoder (required) | ||||
subject | Σ | 0..1 | Reference(Citizen) | [DK] områdeSubjekt | ||||
focus | ΣTU | 0..* | Reference(Resource) | What the observation is about, when it is not about the subject of record | ||||
encounter | Σ | 0..1 | Reference(Encounter) | [DK] områdeKontakt | ||||
effective[x] | Σ | 1..1 | dateTime | [DK] områdeTid | ||||
issued | Σ | 0..1 | instant | Date/Time this version was made available | ||||
performer | Σ | 0..1 | Reference(Practioner) | [DK] områdeAnsvarlig | ||||
value[x] | ΣC | 0..1 | CodeableConcept | Actual result | ||||
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 | Code defined by a terminology system Binding: KLOplysningKoder (required) | ||||
text | Σ | 0..1 | string | [DK] områdeTekst | ||||
dataAbsentReason | C | 0..1 | CodeableConcept | Why the result is missing Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing. | ||||
interpretation | 0..* | CodeableConcept | High, low, normal, etc. Binding: ObservationInterpretationCodes (extensible): Codes identifying interpretations of observations. | |||||
note | 0..* | Annotation | Comments about the observation | |||||
bodySite | 0..1 | CodeableConcept | Observed body part Binding: SNOMEDCTBodyStructures (example): Codes describing anatomical locations. May include laterality. | |||||
method | 0..1 | CodeableConcept | How it was done Binding: ObservationMethods (example): Methods for simple observations. | |||||
specimen | 0..1 | Reference(Specimen) | Specimen used for this observation | |||||
device | 0..1 | Reference(Device | DeviceMetric) | (Measurement) Device | |||||
referenceRange | C | 0..* | BackboneElement | Provides guide for interpretation | ||||
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 | ||||
low | C | 0..1 | SimpleQuantity | Low Range, if relevant | ||||
high | C | 0..1 | SimpleQuantity | High Range, if relevant | ||||
type | 0..1 | CodeableConcept | Reference range qualifier Binding: ObservationReferenceRangeMeaningCodes (preferred): Code for the meaning of a reference range. | |||||
appliesTo | 0..* | CodeableConcept | Reference range population Binding: ObservationReferenceRangeAppliesToCodes (example): Codes identifying the population the reference range applies to. | |||||
age | 0..1 | Range | Applicable age range, if relevant | |||||
text | 0..1 | string | Text 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..* | BackboneElement | Component results | ||||
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 | ||||
code | Σ | 1..1 | CodeableConcept | Type of component observation (code / type) Binding: LOINCCodes (example): Codes identifying names of simple observations. | ||||
value[x] | Σ | 0..1 | Actual component result | |||||
valueQuantity | Quantity | |||||||
valueCodeableConcept | CodeableConcept | |||||||
valueString | string | |||||||
valueBoolean | boolean | |||||||
valueInteger | integer | |||||||
valueRange | Range | |||||||
valueRatio | Ratio | |||||||
valueSampledData | SampledData | |||||||
valueTime | time | |||||||
valueDateTime | dateTime | |||||||
valuePeriod | Period | |||||||
dataAbsentReason | C | 0..1 | CodeableConcept | Why the component result is missing Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing. | ||||
interpretation | 0..* | CodeableConcept | High, low, normal, etc. Binding: ObservationInterpretationCodes (extensible): Codes identifying interpretations of observations. | |||||
referenceRange | 0..* | See referenceRange (Observation) | Provides guide for interpretation of component result | |||||
Documentation for this format |
Path | Conformance | ValueSet | ||||
Observation.language | preferred | CommonLanguages
| ||||
Observation.status | required | ObservationStatus | ||||
Observation.category | preferred | ObservationCategoryCodes | ||||
Observation.code | required | KLInformationCodes | ||||
Observation.value[x].coding | required | KLMatterOfInterestValues | ||||
Observation.dataAbsentReason | extensible | DataAbsentReason | ||||
Observation.interpretation | extensible | ObservationInterpretationCodes | ||||
Observation.bodySite | example | SNOMEDCTBodyStructures | ||||
Observation.method | example | ObservationMethods | ||||
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 |
This structure is derived from Observation
Summary
Mandatory: 1 element
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Differential View
This structure is derived from Observation
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Observation | 0..* | Observation | Measurements and simple assertions | |
Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |
matterOfInterestInformer | 0..1 | CodeableConcept | [DK] områdeInformant URL: http://kl.dk/fhir/common/caresocial/StructureDefinition/MatterOfInterestInformer Binding: KLKildeTilOplysningFFB (required) | |
basedOn | 0..1 | Reference(ServiceRequest) | [DK] områdeOrdre | |
status | 1..1 | code | [DK] områdeStatus | |
code | 1..1 | CodeableConcept | [DK] områdeKode Binding: KLOplysningKoder (required) | |
subject | 0..1 | Reference(Citizen) | [DK] områdeSubjekt | |
encounter | 0..1 | Reference(Encounter) | [DK] områdeKontakt | |
effective[x] | 1..1 | dateTime | [DK] områdeTid | |
performer | 0..1 | Reference(Practioner) | [DK] områdeAnsvarlig | |
value[x] | 0..1 | CodeableConcept | Actual result | |
coding | 0..* | Coding | Code defined by a terminology system Binding: KLOplysningKoder (required) | |
text | 0..1 | string | [DK] områdeTekst | |
Documentation for this format |
Path | Conformance | ValueSet |
Observation.code | required | KLInformationCodes |
Observation.value[x].coding | required | KLMatterOfInterestValues |
Key Elements View
Path | Conformance | ValueSet |
Observation.status | required | ObservationStatus |
Observation.code | required | KLInformationCodes |
Observation.value[x].coding | required | KLMatterOfInterestValues |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
Observation | C | 0..* | Observation | Measurements and simple assertions | ||||
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.
| |||||
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 | |||||
matterOfInterestInformer | 0..1 | CodeableConcept | [DK] områdeInformant URL: http://kl.dk/fhir/common/caresocial/StructureDefinition/MatterOfInterestInformer Binding: KLKildeTilOplysningFFB (required) | |||||
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored | ||||
identifier | Σ | 0..* | Identifier | Business Identifier for observation | ||||
basedOn | Σ | 0..1 | Reference(ServiceRequest) | [DK] områdeOrdre | ||||
partOf | Σ | 0..* | Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy) | Part of referenced event | ||||
status | ?!Σ | 1..1 | code | [DK] områdeStatus Binding: ObservationStatus (required): Codes providing the status of an observation. | ||||
category | 0..* | CodeableConcept | Classification of type of observation Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories. | |||||
code | Σ | 1..1 | CodeableConcept | [DK] områdeKode Binding: KLOplysningKoder (required) | ||||
subject | Σ | 0..1 | Reference(Citizen) | [DK] områdeSubjekt | ||||
focus | ΣTU | 0..* | Reference(Resource) | What the observation is about, when it is not about the subject of record | ||||
encounter | Σ | 0..1 | Reference(Encounter) | [DK] områdeKontakt | ||||
effective[x] | Σ | 1..1 | dateTime | [DK] områdeTid | ||||
issued | Σ | 0..1 | instant | Date/Time this version was made available | ||||
performer | Σ | 0..1 | Reference(Practioner) | [DK] områdeAnsvarlig | ||||
value[x] | ΣC | 0..1 | CodeableConcept | Actual result | ||||
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 | Code defined by a terminology system Binding: KLOplysningKoder (required) | ||||
text | Σ | 0..1 | string | [DK] områdeTekst | ||||
dataAbsentReason | C | 0..1 | CodeableConcept | Why the result is missing Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing. | ||||
interpretation | 0..* | CodeableConcept | High, low, normal, etc. Binding: ObservationInterpretationCodes (extensible): Codes identifying interpretations of observations. | |||||
note | 0..* | Annotation | Comments about the observation | |||||
bodySite | 0..1 | CodeableConcept | Observed body part Binding: SNOMEDCTBodyStructures (example): Codes describing anatomical locations. May include laterality. | |||||
method | 0..1 | CodeableConcept | How it was done Binding: ObservationMethods (example): Methods for simple observations. | |||||
specimen | 0..1 | Reference(Specimen) | Specimen used for this observation | |||||
device | 0..1 | Reference(Device | DeviceMetric) | (Measurement) Device | |||||
referenceRange | C | 0..* | BackboneElement | Provides guide for interpretation | ||||
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 | ||||
low | C | 0..1 | SimpleQuantity | Low Range, if relevant | ||||
high | C | 0..1 | SimpleQuantity | High Range, if relevant | ||||
type | 0..1 | CodeableConcept | Reference range qualifier Binding: ObservationReferenceRangeMeaningCodes (preferred): Code for the meaning of a reference range. | |||||
appliesTo | 0..* | CodeableConcept | Reference range population Binding: ObservationReferenceRangeAppliesToCodes (example): Codes identifying the population the reference range applies to. | |||||
age | 0..1 | Range | Applicable age range, if relevant | |||||
text | 0..1 | string | Text 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..* | BackboneElement | Component results | ||||
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 | ||||
code | Σ | 1..1 | CodeableConcept | Type of component observation (code / type) Binding: LOINCCodes (example): Codes identifying names of simple observations. | ||||
value[x] | Σ | 0..1 | Actual component result | |||||
valueQuantity | Quantity | |||||||
valueCodeableConcept | CodeableConcept | |||||||
valueString | string | |||||||
valueBoolean | boolean | |||||||
valueInteger | integer | |||||||
valueRange | Range | |||||||
valueRatio | Ratio | |||||||
valueSampledData | SampledData | |||||||
valueTime | time | |||||||
valueDateTime | dateTime | |||||||
valuePeriod | Period | |||||||
dataAbsentReason | C | 0..1 | CodeableConcept | Why the component result is missing Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing. | ||||
interpretation | 0..* | CodeableConcept | High, low, normal, etc. Binding: ObservationInterpretationCodes (extensible): Codes identifying interpretations of observations. | |||||
referenceRange | 0..* | See referenceRange (Observation) | Provides guide for interpretation of component result | |||||
Documentation for this format |
Path | Conformance | ValueSet | ||||
Observation.language | preferred | CommonLanguages
| ||||
Observation.status | required | ObservationStatus | ||||
Observation.category | preferred | ObservationCategoryCodes | ||||
Observation.code | required | KLInformationCodes | ||||
Observation.value[x].coding | required | KLMatterOfInterestValues | ||||
Observation.dataAbsentReason | extensible | DataAbsentReason | ||||
Observation.interpretation | extensible | ObservationInterpretationCodes | ||||
Observation.bodySite | example | SNOMEDCTBodyStructures | ||||
Observation.method | example | ObservationMethods | ||||
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 |
This structure is derived from Observation
Summary
Mandatory: 1 element
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Other representations of profile: CSV, Excel, Schematron