SDOH Clinical Care
0.1.0 - STU 1

This page is part of the SDOH Clinical Care for Multiple Domains (v0.1.0: STU 1 Ballot 1) based on FHIR R4. The current version which supercedes this version is 2.0.0. For a full list of available versions, see the Directory of published versions

Resource Profile: SDOHCC Observation ScreeningResponseBase 1

Defining URL:http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Observation-ScreeningResponseBase-1
Version:0.1.0
Name:SDOHCC_Observation_ScreeningResponseBase_1
Title:SDOHCC Observation ScreeningResponseBase 1
Status:Draft as of 2020-12-16T20:13:36+00:00
Definition:

This profile constrains Observations that represent individual Question and Answer (QA) pairs from SDOH screening instruments that are represented in LOINC.

Publisher:HL7 International - Patient Care WG
Source Resource:XML / JSON / Turtle

The official URL for this profile is:

http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Observation-ScreeningResponseBase-1

Additional Guidance

The SDOHCC_Observation_ScreeningResponseBase_1 profile allows the representation of individual Question and Answer pairs (QA pairs) from an SDOH screening questionnaire as Observations. The Question and Answer pairs from the screening questionnaire are also represented using SDC Questionnaire and SDC QuestionnaireResponse.

Many of the resources/profiles used for SDOH reference one another. The current flow is that QuestionnaireResponses result in Observations that are used as evidence for Conditions that are addressed by Goals that lead to ServiceRequests and Procedures.

The sections that follow provide additional guidance on some elements in the SDOHCC_Observation_ScreeningResponseBase_1 profile.

Observation.category

To facilitate searching for SDOH screening response observations, Observation.category is sliced. The required slices are bound to the "social-history" and "survey" codes from the FHIR "Observation Category Codes" value set.

Additionally, an optional Observation.category slice bound to the "SDOHCC ValueSet SDOHDomain 1" value set allows the categorization of an Observation into one or more of the SDOH domains (e.g., food-insecurity-domain, inadequate-housing-domain, etc.). It is recommended that this optional slice be used in order to facilitate searching for SDOH observations.

Observation.code

Observation.code is currently bound to codes from the FHIR "LOINC Codes" value set with binding strength: Required. LOINC codes are required because Gravity intends to use only LOINC encoded Questionnaires to generate QuestionnaireResponses which, in turn, will generate Screening Response Observations. As the Gravity Project continues to refine content for the SDOH domains (e.g., food, housing, transportation etc.), the value set for Observation.code will be refined to LOINC codes that pertain to SDOH domains.

Observation.subject

Observation.subject is restricted to referencing Patient Resource.

Although the US Core Condition, CarePlan, Goal, and Procedure Profiles restrict Subject to US Core Patient Profile, US Core does not offer a generic Observation Profile. For this reason, SDOHCC_Observation_ScreeningResponseBase_1 does not restrict Observation.subject to US Core Patient Profile. However, if an implementer is creating US Core profiles (e.g., US Core Condition, US Core Procedure, etc.) that require US Core Patient for Subject, then US Core Patient should also be used for Subject in other profiles (e.g., Observation, ServiceRequest, etc.) which do not currently specify US Core Patient.

Observation.performer

Some SDOH QA pairs on a screening questionnaire are not answered directly (e.g., asserted) by the individual completing the questionnaire. Rather, some QA pairs (e.g., the Hunger Vital Sign 88124-3 "Food insecurity risk") may be derived from other QA pairs. For a ScreeningResponse Observation that is not answered directly, but rather derived from other QA pairs on a screener, Observation.performer should not be specified and Observation.derivedFrom should reference the relevant ScreeningResponse Observation(s).

Example: 88121-9 Hunger Vital Signs [HVS]

For the LOINC Hunger Vital Sign™ Panel, an answer of "often true" or "sometimes true" to either or both of the Hunger Vital Sign questions (88122-7 or 88123-5) identifies a patient as at risk for food insecurity (i.e., the answer for 88124-3 is "At risk", LA19952-3).

Thus, 88124-3 "Food insecurity risk" is not explicitly answered by the individual completing the questionnaire. In this case, Observation.performer should be left empty and Observation.derivedFrom should reference the Observations that represent the QA pairs for Hunger Vital Sign questions 88122-7 and 88123-5.

Observation.value and Observation.dataAbsentReason

Observation.value is currently bound to codes from the FHIR "LOINC Codes" value set. As the Gravity Project continues to refine content for the SDOH domains, the value set for Observation.value will be refined to the LOINC Normative Answer Lists for LOINC codes that address SDOH domains.

Of note, many LOINC Normative Answer Lists include codes that overlap with values in the FHIR value set for Observation.dataAbsentReason.

Example: LOINC code 82589-3

For LOINC code 82589-3 "What is the highest level of school that you have finished?", the Normative Answer List LL5351-3 includes "I choose not to answer this question". This LOINC answer code overlaps with "asked-declined" in the value set for Observation.dataAbsentReason.

However, some LOINC Normative Answer Lists do not include codes that overlap with values in the FHIR value set for Observation.dataAbsentReason.

Example: LOINC Code 76437-3

For LOINC Code 76437-3 "What is your main insurance?", the Normative Answer List does not include a code that overlaps with a code in the value set for Observation.dataAbsentReason (e.g., unknown, asked-declined, etc.).

If the LOINC Normative Answer List for a LOINC code offers an adequate code for why an Observation.value may not be known, it SHOULD be used as the value for Observation.value.

If the LOINC Normative Answer List for a LOINC code does not offer an adequate code for why an Observation.value may not be known, a code from Observation.dataAbsentReason SHOULD be used in lieu of Observation.value.

FHIR already has a rule that: dataAbsentReason SHALL only be present if Observation.value[x] is not present dataAbsentReason.empty() or value.empty(). However, this means that Observation.value and Observation.dataAbsentReason are both optional elements since one or the other may be used. Therefore, a profile could validate without Observation.value and without Observation.dataAbsentReason. For this reason, the Gravity Observation profile has added the FHIRPath rule that: "either Observation.valueCodableConcept or Observation.dataAbsentReason MUST be provided".

Observation.derivedFrom

Observation.derivedFrom is sliced to allow the preferred option of referencing the SDC QuestionnaireResponse Profile and/or the SDOHCC-Observation-ScreeningResponseBase-1 Profile.

Observation.derivedFrom should reference the SDC QuestionnaireResponse Profile and/or the SDOHCC-Observation-ScreeningResponseBase-1 Profile if they exist.

Additionally, Observation.derivedFrom may reference DocumentReference, Observation and/or QuestionnaireResponse.

Generally, Observation.derivedFrom will reference the SDC QuestionnaireResponse which, in turn, will reference the Questionnaire from which a QA pair in an Observation is derived.

However, some SDOH QA pairs (e.g., HVS 88124-3 "Food insecurity risk") are not answered directly (e.g., asserted) by the individual completing the screening questionnaire but rather are derived from other QA pairs on the screener. In that case, Observation.derivedFrom SHOULD also reference any relevant Screening Response Observations (using SDOHCC_Observation_ScreeningResponseBase_1).

Example: 88121-9 Hunger Vital Signs [HVS]

For the LOINC Hunger Vital Sign™ Panel, an answer of "often true" or "sometimes true" to either or both of the Hunger Vital Sign questions (88122-7 or 88123-5) identifies a patient as at risk for food insecurity (i.e., the answer for 88124-3 is "At risk", LA19952-3).

Thus, 88124-3 "Food insecurity risk" is not explicitly answered by the individual completing the questionnaire. Observation.derivedFrom should be used to reference the Observations that represent the QA pairs for Hunger Vital Sign questions 88122-7 and 88123-5.

Formal Views of Profile Content

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

This structure is derived from Observation

Summary

Mandatory: 4 elements (2 nested mandatory elements)
Must-Support: 14 elements
Prohibited: 4 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element Observation.category is sliced based on the value of pattern:$this
  • The element Observation.effective[x] is sliced based on the value of type:$this
  • The element Observation.derivedFrom is sliced based on the value of profile:resolve()

This structure is derived from Observation

NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation I0..*ObservationMeasurements and simple assertions
SDOHCC-1: either Observation.valueCodableConcept or Observation.dataAbsentReason MUST be provided
... status S1..1coderegistered | preliminary | final | amended +
... category 2..*(Slice Definition)Classification of type of observation
Slice: Unordered, Open by pattern:$this
.... category:SocialHistory S1..1CodeableConceptClassification of type of observation
Required Pattern: At least the following
..... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
...... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/observation-category
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: social-history
.... category:Survey S1..1CodeableConceptClassification of type of observation
Required Pattern: At least the following
..... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
...... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/observation-category
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: survey
.... category:SDOHDomain S0..*CodeableConcepte.g., food-insecurity-domain | transportation-insecurity-domain
Binding: SDOHCC ValueSet SDOHDomain 1 (required)
... code S1..1CodeableConceptType of observation (code / type)
Binding: LOINCCodes (required)
... effective[x] S1..1(Slice Definition)Clinically relevant time/time-period for observation
Slice: Unordered, Open by type:$this
.... effectiveDateTimedateTime
.... effectivePeriodPeriod
.... effective[x]:effectivePeriod 0..1PeriodClinically relevant time/time-period for observation
..... start S1..1dateTimeStarting time with inclusive boundary
..... end S1..1dateTimeEnd time with inclusive boundary, if not ongoing
... performer S0..*Reference(Practitioner | PractitionerRole | Patient | RelatedPerson)Who is responsible for the observation
... value[x] S0..1CodeableConceptActual result
Binding: LOINCCodes (required)
... dataAbsentReason S0..1CodeableConceptWhy the result is missing
... interpretation 0..0
... bodySite 0..0
... specimen 0..0
... referenceRange 0..0
... derivedFrom S0..*(Slice Definition)Related measurements the observation is made from
Slice: Unordered, Open by profile:resolve()
.... derivedFrom:SupportedDerivedFrom S0..*Reference(SDOHCC Observation ScreeningResponseBase 1 | SDC Questionnaire Response)Related measurements the observation is made from

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation I0..*ObservationMeasurements and simple assertions
SDOHCC-1: either Observation.valueCodableConcept or Observation.dataAbsentReason MUST be provided
... id ÎŁ0..1stringLogical 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)
Max Binding: AllLanguages: A human language.

... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier ÎŁ0..*IdentifierBusiness Identifier for observation
... basedOn ÎŁ0..*Reference(CarePlan | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | ServiceRequest)Fulfills plan, proposal or order
... partOf ÎŁ0..*Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy)Part of referenced event
... status ?!SÎŁ1..1coderegistered | preliminary | final | amended +
Binding: ObservationStatus (required): Codes providing the status of an observation.

... category 2..*(Slice Definition)Classification of type of observation
Slice: Unordered, Open by pattern:$this
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.


.... category:SocialHistory S1..1CodeableConceptClassification of type of observation
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.



Required Pattern: At least the following
..... id0..1stringUnique id for inter-element referencing
..... extension0..*ExtensionAdditional content defined by implementations
..... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
...... id0..1stringUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/observation-category
...... version0..1stringVersion of the system - if relevant
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: social-history
...... display0..1stringRepresentation defined by the system
...... userSelected0..1booleanIf this coding was chosen directly by the user
..... text0..1stringPlain text representation of the concept
.... category:Survey S1..1CodeableConceptClassification of type of observation
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.



Required Pattern: At least the following
..... id0..1stringUnique id for inter-element referencing
..... extension0..*ExtensionAdditional content defined by implementations
..... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
...... id0..1stringUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/observation-category
...... version0..1stringVersion of the system - if relevant
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: survey
...... display0..1stringRepresentation defined by the system
...... userSelected0..1booleanIf this coding was chosen directly by the user
..... text0..1stringPlain text representation of the concept
.... category:SDOHDomain S0..*CodeableConcepte.g., food-insecurity-domain | transportation-insecurity-domain
Binding: SDOHCC ValueSet SDOHDomain 1 (required)
... code SÎŁ1..1CodeableConceptType of observation (code / type)
Binding: LOINCCodes (required)
... subject SÎŁ1..1Reference(Patient)Who and/or what the observation is about
... focus ÎŁ0..*Reference(Resource)What the observation is about, when it is not about the subject of record
... encounter ÎŁ0..1Reference(Encounter)Healthcare event during which this observation is made
... effective[x] SÎŁ1..1(Slice Definition)Clinically relevant time/time-period for observation
Slice: Unordered, Open by type:$this
.... effectiveDateTimedateTime
.... effectivePeriodPeriod
.... effective[x]:effectivePeriod ÎŁ0..1PeriodClinically relevant time/time-period for observation
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... start SÎŁI1..1dateTimeStarting time with inclusive boundary
..... end SÎŁI1..1dateTimeEnd time with inclusive boundary, if not ongoing
... issued ÎŁ0..1instantDate/Time this version was made available
... performer SÎŁ0..*Reference(Practitioner | PractitionerRole | Patient | RelatedPerson)Who is responsible for the observation
... value[x] SÎŁI0..1CodeableConceptActual result
Binding: LOINCCodes (required)
... dataAbsentReason SI0..1CodeableConceptWhy the result is missing
Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing.

... note 0..*AnnotationComments about the observation
... method 0..1CodeableConceptHow it was done
Binding: ObservationMethods (example): Methods for simple observations.

... device 0..1Reference(Device | DeviceMetric)(Measurement) Device
... hasMember ÎŁ0..*Reference(Observation | QuestionnaireResponse | MolecularSequence)Related resource that belongs to the Observation group
... derivedFrom SÎŁ0..*(Slice Definition)Related measurements the observation is made from
Slice: Unordered, Open by profile:resolve()
.... derivedFrom:SupportedDerivedFrom SÎŁ0..*Reference(SDOHCC Observation ScreeningResponseBase 1 | SDC Questionnaire Response)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 I0..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
NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation I0..*ObservationMeasurements and simple assertions
SDOHCC-1: either Observation.valueCodableConcept or Observation.dataAbsentReason MUST be provided
... status ?!ÎŁ1..1coderegistered | preliminary | final | amended +
Binding: ObservationStatus (required): Codes providing the status of an observation.

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



Required Pattern: At least the following
.... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
..... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/observation-category
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: social-history
... category:Survey 1..1CodeableConceptClassification of type of observation
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.



Required Pattern: At least the following
.... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
..... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/observation-category
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: survey
... code ÎŁ1..1CodeableConceptType of observation (code / type)
Binding: LOINCCodes (required)
... subject ÎŁ1..1Reference(Patient)Who and/or what the observation is about
... effective[x] ÎŁ1..1(Slice Definition)Clinically relevant time/time-period for observation
Slice: Unordered, Open by type:$this
.... effectiveDateTimedateTime
.... effectivePeriodPeriod
.... effective[x]:effectivePeriod ÎŁ0..1PeriodClinically relevant time/time-period for observation
..... start ÎŁI1..1dateTimeStarting time with inclusive boundary
..... end ÎŁI1..1dateTimeEnd time with inclusive boundary, if not ongoing
... performer ÎŁ0..*Reference(Practitioner | PractitionerRole | Patient | RelatedPerson)Who is responsible for the observation
... value[x] ÎŁI0..1CodeableConceptActual result
Binding: LOINCCodes (required)
... dataAbsentReason I0..1CodeableConceptWhy the result is missing
Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing.

... derivedFrom ÎŁ0..*(Slice Definition)Related measurements the observation is made from
Slice: Unordered, Open by profile:resolve()
.... derivedFrom:SupportedDerivedFrom ÎŁ0..*Reference(SDOHCC Observation ScreeningResponseBase 1 | SDC Questionnaire Response)Related measurements the observation is made from

doco Documentation for this format

This structure is derived from Observation

Summary

Mandatory: 4 elements (2 nested mandatory elements)
Must-Support: 14 elements
Prohibited: 4 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element Observation.category is sliced based on the value of pattern:$this
  • The element Observation.effective[x] is sliced based on the value of type:$this
  • The element Observation.derivedFrom is sliced based on the value of profile:resolve()

Differential View

This structure is derived from Observation

NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation I0..*ObservationMeasurements and simple assertions
SDOHCC-1: either Observation.valueCodableConcept or Observation.dataAbsentReason MUST be provided
... status S1..1coderegistered | preliminary | final | amended +
... category 2..*(Slice Definition)Classification of type of observation
Slice: Unordered, Open by pattern:$this
.... category:SocialHistory S1..1CodeableConceptClassification of type of observation
Required Pattern: At least the following
..... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
...... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/observation-category
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: social-history
.... category:Survey S1..1CodeableConceptClassification of type of observation
Required Pattern: At least the following
..... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
...... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/observation-category
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: survey
.... category:SDOHDomain S0..*CodeableConcepte.g., food-insecurity-domain | transportation-insecurity-domain
Binding: SDOHCC ValueSet SDOHDomain 1 (required)
... code S1..1CodeableConceptType of observation (code / type)
Binding: LOINCCodes (required)
... effective[x] S1..1(Slice Definition)Clinically relevant time/time-period for observation
Slice: Unordered, Open by type:$this
.... effectiveDateTimedateTime
.... effectivePeriodPeriod
.... effective[x]:effectivePeriod 0..1PeriodClinically relevant time/time-period for observation
..... start S1..1dateTimeStarting time with inclusive boundary
..... end S1..1dateTimeEnd time with inclusive boundary, if not ongoing
... performer S0..*Reference(Practitioner | PractitionerRole | Patient | RelatedPerson)Who is responsible for the observation
... value[x] S0..1CodeableConceptActual result
Binding: LOINCCodes (required)
... dataAbsentReason S0..1CodeableConceptWhy the result is missing
... interpretation 0..0
... bodySite 0..0
... specimen 0..0
... referenceRange 0..0
... derivedFrom S0..*(Slice Definition)Related measurements the observation is made from
Slice: Unordered, Open by profile:resolve()
.... derivedFrom:SupportedDerivedFrom S0..*Reference(SDOHCC Observation ScreeningResponseBase 1 | SDC Questionnaire Response)Related measurements the observation is made from

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation I0..*ObservationMeasurements and simple assertions
SDOHCC-1: either Observation.valueCodableConcept or Observation.dataAbsentReason MUST be provided
... id ÎŁ0..1stringLogical 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)
Max Binding: AllLanguages: A human language.

... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier ÎŁ0..*IdentifierBusiness Identifier for observation
... basedOn ÎŁ0..*Reference(CarePlan | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | ServiceRequest)Fulfills plan, proposal or order
... partOf ÎŁ0..*Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy)Part of referenced event
... status ?!SÎŁ1..1coderegistered | preliminary | final | amended +
Binding: ObservationStatus (required): Codes providing the status of an observation.

... category 2..*(Slice Definition)Classification of type of observation
Slice: Unordered, Open by pattern:$this
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.


.... category:SocialHistory S1..1CodeableConceptClassification of type of observation
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.



Required Pattern: At least the following
..... id0..1stringUnique id for inter-element referencing
..... extension0..*ExtensionAdditional content defined by implementations
..... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
...... id0..1stringUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/observation-category
...... version0..1stringVersion of the system - if relevant
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: social-history
...... display0..1stringRepresentation defined by the system
...... userSelected0..1booleanIf this coding was chosen directly by the user
..... text0..1stringPlain text representation of the concept
.... category:Survey S1..1CodeableConceptClassification of type of observation
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.



Required Pattern: At least the following
..... id0..1stringUnique id for inter-element referencing
..... extension0..*ExtensionAdditional content defined by implementations
..... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
...... id0..1stringUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/observation-category
...... version0..1stringVersion of the system - if relevant
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: survey
...... display0..1stringRepresentation defined by the system
...... userSelected0..1booleanIf this coding was chosen directly by the user
..... text0..1stringPlain text representation of the concept
.... category:SDOHDomain S0..*CodeableConcepte.g., food-insecurity-domain | transportation-insecurity-domain
Binding: SDOHCC ValueSet SDOHDomain 1 (required)
... code SÎŁ1..1CodeableConceptType of observation (code / type)
Binding: LOINCCodes (required)
... subject SÎŁ1..1Reference(Patient)Who and/or what the observation is about
... focus ÎŁ0..*Reference(Resource)What the observation is about, when it is not about the subject of record
... encounter ÎŁ0..1Reference(Encounter)Healthcare event during which this observation is made
... effective[x] SÎŁ1..1(Slice Definition)Clinically relevant time/time-period for observation
Slice: Unordered, Open by type:$this
.... effectiveDateTimedateTime
.... effectivePeriodPeriod
.... effective[x]:effectivePeriod ÎŁ0..1PeriodClinically relevant time/time-period for observation
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... start SÎŁI1..1dateTimeStarting time with inclusive boundary
..... end SÎŁI1..1dateTimeEnd time with inclusive boundary, if not ongoing
... issued ÎŁ0..1instantDate/Time this version was made available
... performer SÎŁ0..*Reference(Practitioner | PractitionerRole | Patient | RelatedPerson)Who is responsible for the observation
... value[x] SÎŁI0..1CodeableConceptActual result
Binding: LOINCCodes (required)
... dataAbsentReason SI0..1CodeableConceptWhy the result is missing
Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing.

... note 0..*AnnotationComments about the observation
... method 0..1CodeableConceptHow it was done
Binding: ObservationMethods (example): Methods for simple observations.

... device 0..1Reference(Device | DeviceMetric)(Measurement) Device
... hasMember ÎŁ0..*Reference(Observation | QuestionnaireResponse | MolecularSequence)Related resource that belongs to the Observation group
... derivedFrom SÎŁ0..*(Slice Definition)Related measurements the observation is made from
Slice: Unordered, Open by profile:resolve()
.... derivedFrom:SupportedDerivedFrom SÎŁ0..*Reference(SDOHCC Observation ScreeningResponseBase 1 | SDC Questionnaire Response)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 I0..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

 

Other representations of profile: Schematron

Terminology Bindings

PathConformanceValueSet / Code
Observation.languagepreferredCommonLanguages
Max Binding: AllLanguages
Observation.statusrequiredObservationStatus
Observation.categorypreferredObservationCategoryCodes
Observation.category:SocialHistorypreferredPattern: social-history
Observation.category:SurveypreferredPattern: survey
Observation.category:SDOHDomainrequiredSDOHCC_ValueSet_SDOHDomain_1
Observation.coderequiredLOINCCodes
Observation.value[x]requiredLOINCCodes
Observation.dataAbsentReasonextensibleDataAbsentReason
Observation.methodexampleObservationMethods
Observation.referenceRange.typepreferredObservationReferenceRangeMeaningCodes
Observation.referenceRange.appliesToexampleObservationReferenceRangeAppliesToCodes
Observation.component.codeexampleLOINCCodes
Observation.component.dataAbsentReasonextensibleDataAbsentReason
Observation.component.interpretationextensibleObservationInterpretationCodes

Constraints

IdPathDetailsRequirements
dom-2ObservationIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3ObservationIf 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-4ObservationIf 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-5ObservationIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6ObservationA resource should have narrative for robust management
: text.`div`.exists()
obs-6ObservationdataAbsentReason SHALL only be present if Observation.value[x] is not present
: dataAbsentReason.empty() or value.empty()
obs-7ObservationIf 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()
SDOHCC-1Observationeither Observation.valueCodableConcept or Observation.dataAbsentReason MUST be provided
: valueCodeableConcept.exists() or dataAbsentReason.exists()
ele-1Observation.metaAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.implicitRulesAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.languageAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.textAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Observation.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Observation.modifierExtensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Observation.modifierExtensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Observation.identifierAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.basedOnAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.partOfAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.statusAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.categoryAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.category:SocialHistoryAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.category:SurveyAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.category:SDOHDomainAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.codeAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.subjectAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.focusAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.encounterAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.effective[x]All FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.effective[x]:effectivePeriodAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.effective[x]:effectivePeriod.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Observation.effective[x]:effectivePeriod.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Observation.effective[x]:effectivePeriod.startAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.effective[x]:effectivePeriod.endAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.issuedAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.performerAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.value[x]All FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.dataAbsentReasonAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.noteAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.methodAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.deviceAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.referenceRange.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Observation.referenceRange.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Observation.referenceRange.modifierExtensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Observation.referenceRange.modifierExtensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Observation.referenceRange.lowAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.referenceRange.highAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.referenceRange.typeAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.referenceRange.appliesToAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.referenceRange.ageAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.referenceRange.textAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.hasMemberAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.derivedFromAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.derivedFrom:SupportedDerivedFromAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.componentAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.component.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Observation.component.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Observation.component.modifierExtensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Observation.component.modifierExtensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Observation.component.codeAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.component.value[x]All FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.component.dataAbsentReasonAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.component.interpretationAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Observation.component.referenceRangeAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())