Release 4 5

This page is part of the FHIR Specification (v4.0.1: R4 (v5.0.0: R5 - Mixed Normative and STU ) ). This is the current published version in it's permanent home (it will always be available at this URL). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4

8.26 8.29 Resource ObservationDefinition - Content

Orders and Observations icon Work Group Maturity Level : 0 1   Trial Use Security Category : Business Compartments : Not linked to any No defined compartments

Set of definitional characteristics for a kind of observation or measurement produced or consumed by an orderable health care service.

Note that this content is preliminary has not undergone proper review by the appropriate Workgroups.

An instance of ObservationDefinition represents the definitional aspects of a kind of observation. This resource is used in a catalog of products or services for healthcare. It provides the definition of observations, which are used as input or produced as outcome of these products and services. The focus of the definitional aspects of ObservationDefinition is not on the action of performing observations of that kind. Rather, it is on the outcome of the observations. An instance of ObservationDefinition represents a set of constraints applicable to the value produced by observations of this kind. This set of constraints may have two utilities: 1) It guides the entry of the result of an observation of the kind defined. 2) It helps the consumer of the results of observations of that kind, to interpret properly these results. If one wants to technically constrain an Observation resource for a particular use case across implementers, a profile is the preferred option and may include profiling on ObservationDefinition and Observation.

For instance, in a catalog of laboratory in vitro diagnostic services, the ObservationDefinition resources describe the observations that should be provided by the orderer alongside with an ordered service (questions asked at order entry or at specimen collection, prior results) as well as the observations that will be reported once the service has been performed.

In a catalog of medications, ObservationDefinition Observation Definition resources can be used to describe observations the result thereof which may need to be checked against the prescription of evaluated in order to determine whether a particular medicinal product (therapeutic range, units ...) specific medicine can be administered or held (e.g., weight, lab value result) and provide guidance on the dose to be administered (e.g., sliding scale insulin dose).

In the catalog of tests of an in vitro diagnostic device, ObservationDefinition resources can be used to characterize (absolute range, unit, decimal precision, critical values ...) the observations that will be produced by the IVD tests performed by the device.

ObservationDefinition may be used to characterize observations from any discipline.

This An ObservationDefinition resource relates provides the definitional characteristics for a certain kind of observation. Each time that kind of observation is collected and recorded it is instantiated as an Observation resource, which conforms to these other resource:. definitional characteristics. Thus, there is a relationship between ObservationDefinition and Observation: The latter may instantiate the former.

When an Observation instantiates an ObservationDefinition, the elements of the Observation resource are expected to inherit their content from the corresponding definitional elements declared in the ObservationDefinition resource:

  • Resource Category, code, datatype of the value, bodySite, method.
  • Each referenceRange element present in Observation should come from a qualifiedValue element of ObservationDefinition.
  • If ObservationDefinition has declared a ValueSet of valid coded values, and if Observation has a valueCodeableConcept, the value is expected to be part of that ValueSet.
  • The subject of the Observation should be conformant with one of the subjectCodeableConcept listed in ObservationDefinition.
  • If the Observation has a device element, the referenced by Device resource CatalogEntry. This enables items of catalogs, representing healthcare services or products, should conform to declare the observations, which are consumed a DeviceDefinition or produced Device referenced by these items. ObservationDefinition.device (if present).
  • Observation.basedOn references ObservationDefinition resource. If the Observation has a specimen element, the referenced Specimen resource should conform to a SpecimenDefinition referenced by ObservationDefinition.specimen (if present).

This resource is referenced ObservationDefinition enables to express some Quantity results in two distinct units of measure: the primary or SI one, represented by element unit, and a converted one, provided for accommodation of some actors, represented by element customaryUnit. Observation may pick only the primary unit, or may express its result in both units, in two component results.

ObservationDefinitions are only to be used when describing the contents of an observation (including observations in order catalogs or panels). When additional structure, sequence, or rules are needed, the Questionnaire resource should be used.

Structure

Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData reference
Name Flags Card. Type Description & Constraints doco
. . ObservationDefinition TU DomainResource Definition of an observation
+ Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation
+ Rule: If permittedUnit exists, then permittedDataType=Quantity must exist.

Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
Interfaces Implemented: MetadataResource
. . category . url Σ 0..* 0..1 CodeableConcept uri Category of observation Observation Category Codes ( Example ) Logical canonical URL to reference this ObservationDefinition (globally unique)
. . . code identifier Σ 1..1 0..1 CodeableConcept Identifier Type Business identifier of observation (code / type) the ObservationDefinition
LOINC Codes
. . . version Σ 0..1 string Business version of the ObservationDefinition
... versionAlgorithm[x] Σ 0..1 How to compare versions
Binding: Version Algorithm ( Example Extensible )
. . . . versionAlgorithmString string
.... versionAlgorithmCoding Coding
. . identifier . name Σ C 0..* 0..1 Identifier string Business identifier Name for this ObservationDefinition instance (computer friendly)
. . . permittedDataType title Σ T 0..* 0..1 string Name for this ObservationDefinition (human friendly)
... status ?! Σ 1..1 code draft | time active | dateTime retired | Period unknown
ObservationDataType Binding: PublicationStatus ( Required )
. . . experimental Σ 0..1 boolean If for testing purposes, not real usage
. . . multipleResultsAllowed date Σ 0..1 boolean dateTime Multiple results allowed Date last changed
. . method . publisher Σ T 0..1 CodeableConcept string Method used to produce The name of the observation individual or organization that published the ObservationDefinition
Observation Methods ( Example )
. . preferredReportName . contact Σ 0..1 0..* string ContactDetail Preferred report name Contact details for the publisher

. . quantitativeDetails . description T 0..1 BackboneElement markdown Characteristics Natural language description of quantitative results the ObservationDefinition
. . . customaryUnit useContext Σ 0..1 0..* CodeableConcept UsageContext Customary unit for quantitative results Content intends to support these contexts

UCUM Codes ( Extensible )
. . . unit jurisdiction Σ XD 0..1 0..* CodeableConcept SI unit Intended jurisdiction for quantitative results this ObservationDefinition (if applicable)
UCUM Codes Binding: Jurisdiction ValueSet ( Extensible )

. . . conversionFactor purpose T 0..1 decimal markdown SI to Customary unit conversion factor Why this ObservationDefinition is defined
. . . copyright T 0..1 markdown Use and/or publishing restrictions
... copyrightLabel T 0..1 string Copyright holder and year(s)
.. . decimalPrecision approvalDate 0..1 date When ObservationDefinition was approved by publisher
... lastReviewDate 0..1 date Date on which the asset content was last reviewed by the publisher
... effectivePeriod Σ 0..1 integer Period Decimal precision The effective date range for the ObservationDefinition
... derivedFromCanonical Σ 0..* canonical ( ObservationDefinition ) Based on FHIR definition of another observation quantitative results

. . qualifiedInterval . derivedFromUri Σ 0..* uri Based on external definition

... subject Σ 0..* BackboneElement CodeableConcept Qualified range Type of subject for continuous and ordinal the defined observation results

. . . performerType Σ 0..1 CodeableConcept Desired kind of performer for such kind of observation
. . . category Σ 0..* CodeableConcept General type of observation
Binding: Observation Category Codes ( Example )

... code Σ 0..1 1..1 CodeableConcept Type of observation
Binding: LOINC Codes ( Example )
... permittedDataType C 0..* code Quantity | critical CodeableConcept | absolute string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period
ObservationRangeCategory Binding: Observation Data Type ( Required )

. . . multipleResultsAllowed 0..1 boolean Multiple results allowed for conforming observations
. . . range bodySite 0..1 CodeableConcept Body part to be observed
Binding: SNOMED CT Body Structures ( Example )
... method 0..1 CodeableConcept Method used to produce the observation
Binding: Observation Methods ( Example )
... specimen 0..* Reference ( SpecimenDefinition ) Kind of specimen used by this type of observation

... device 0..* Reference ( DeviceDefinition | Device ) Measurement device or model of device

... preferredReportName 0..1 Range string The interval itself, preferred name to be used when reporting the observation results
... permittedUnit C 0..* Coding Unit for continuous or ordinal observations quantitative results
Binding: UCUM Codes ( Preferred )

. . . qualifiedValue 0..* BackboneElement Set of qualified values for observation results

. . . . context 0..1 CodeableConcept Range context Context qualifier for the set of qualified values
Binding: Observation Reference Range Meaning Codes ( Extensible )
. . . . appliesTo 0..* CodeableConcept Targetted population of for the range set of qualified values
Binding: Observation Reference Range Applies To Codes ( Example )

. . . . gender 0..1 code male | female | other | unknown
Binding: AdministrativeGender ( Required )
. . . . age 0..1 Range Applicable age range, if relevant range for the set of qualified values
. . . . gestationalAge 0..1 Range Applicable gestational age range, if relevant range for the set of qualified values
. . . . condition 0..1 string Condition associated with the set of qualified values
.... rangeCategory 0..1 code reference | critical | absolute
Binding: Observation Range Category ( Required )
.... range 0..1 Range The range for continuous or ordinal observations
. . . . validCodedValueSet 0..1 Reference canonical ( ValueSet ) Value set of valid coded values for the observations conforming to as part of this ObservationDefinition set of qualified values
. . . . normalCodedValueSet 0..1 Reference canonical ( ValueSet ) Value set of normal coded values for the observations conforming to as part of this ObservationDefinition set of qualified values
. . . . abnormalCodedValueSet 0..1 Reference canonical ( ValueSet ) Value set of abnormal coded values for the observations conforming to as part of this ObservationDefinition set of qualified values
. . . . criticalCodedValueSet 0..1 Reference canonical ( ValueSet ) Value set of critical coded values for the observations conforming to as part of this set of qualified values
... hasMember 0..* Reference ( ObservationDefinition | Questionnaire ) Definitions of related resources belonging to this kind of observation group

... component C 0..* BackboneElement Component results
+ Rule: If permittedUnit exists, then permittedDataType=Quantity must exist.

.... code 1..1 CodeableConcept Type of observation
Binding: LOINC Codes ( Example )
.... permittedDataType C 0..* code Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period
Binding: Observation Data Type ( Required )

.... permittedUnit C 0..* Coding Unit for quantitative results
Binding: UCUM Codes ( Preferred )

.... qualifiedValue 0..* see qualifiedValue Set of qualified values for observation results


doco Documentation for this format icon

See the Extensions for this resource

UML Diagram ( Legend )

ObservationDefinition ( DomainResource ) + MetadataResource An absolute URL that is used to identify this ObservationDefinition when it is referenced in a specification, model, design or an instance. This SHALL be a URL, SHOULD be globally unique, and SHOULD be an address at which this ObservationDefinition is (or will be) published. The URL SHOULD include the major version of the ObservationDefinition. For more information see Technical and Business Versions url : uri [0..1] Business identifiers assigned to this ObservationDefinition. by the performer and/or other systems. These identifiers remain constant as the resource is updated and propagates from server to server identifier : Identifier [0..1] The identifier that is used to identify this version of the ObservationDefinition when it is referenced in a specification, model, design or instance. This is an arbitrary value managed by the ObservationDefinition author and is not expected to be globally unique. For example, it might be a timestamp (e.g. yyyymmdd) if a managed version is not available. There is also no expectation that versions are orderable version : string [0..1] Indicates the mechanism used to compare versions to determine which is more current versionAlgorithm[x] : DataType [0..1] « string | Coding ; null (Strength=Extensible) VersionAlgorithm + » A natural language name identifying the ObservationDefinition. This name should be usable as an identifier for the module by machine processing applications such as code generation name : string [0..1] « This element has or is affected by some invariants C » A short, descriptive, user-friendly title for the ObservationDefinition title : string [0..1] The current state of the ObservationDefinition (this element modifies the meaning of other elements) status : code [1..1] « null (Strength=Required) PublicationStatus ! » A flag to indicate that this ObservationDefinition is authored for testing purposes (or education/evaluation/marketing), and is not intended to be used for genuine usage experimental : boolean [0..1] The date (and optionally time) when the ObservationDefinition was last significantly changed. The date must change when the business version changes and it must change if the status code changes. In addition, it should change when the substantive content of the ObservationDefinition changes date : dateTime [0..1] Helps establish the "authority/credibility" of the ObservationDefinition. May also allow for contact publisher : string [0..1] Contact details to assist a user in finding and communicating with the publisher contact : ContactDetail [0..*] A free text natural language description of the ObservationDefinition from the consumer's perspective description : markdown [0..1] The content was developed with a focus and intent of supporting the contexts that are listed. These contexts may be general categories (gender, age, ...) or may be references to specific programs (insurance plans, studies, ...) and may be used to assist with indexing and searching for appropriate ObservationDefinition instances useContext : UsageContext [0..*] A jurisdiction in which the ObservationDefinition is intended to be used jurisdiction : CodeableConcept [0..*] « null (Strength=Extensible) JurisdictionValueSet + » Explains why this ObservationDefinition is needed and why it has been designed as it has purpose : markdown [0..1] Copyright statement relating to the ObservationDefinition and/or its contents. Copyright statements are generally legal restrictions on the use and publishing of the ObservationDefinition copyright : markdown [0..1] A short string (<50 characters), suitable for inclusion in a page footer that identifies the copyright holder, effective period, and optionally whether rights are resctricted. (e.g. 'All rights reserved', 'Some rights reserved') copyrightLabel : string [0..1] The date on which the asset content was approved by the publisher. Approval happens once when the content is officially approved for usage approvalDate : date [0..1] The date on which the asset content was last reviewed. Review happens periodically after that, but doesn't change the original approval date lastReviewDate : date [0..1] The period during which the ObservationDefinition content was or is planned to be effective effectivePeriod : Period [0..1] The canonical URL pointing to another FHIR-defined ObservationDefinition that is adhered to in whole or in part by this definition derivedFromCanonical : canonical [0..*] « ObservationDefinition » The URL pointing to an externally-defined observation definition, guideline or other definition that is adhered to in whole or in part by this definition derivedFromUri : uri [0..*] A code that describes the intended kind of subject of Observation instances conforming to this ObservationDefinition subject : CodeableConcept [0..*] The type of individual/organization/device that is expected to act upon instances of this definition performerType : CodeableConcept [0..1] A code that classifies the general type of observation category : CodeableConcept [0..*] « Codes for high level observation categories. null (Strength=Example) ObservationCategoryCodes ?? » Describes what will be observed. Sometimes this is called the observation "name" code : CodeableConcept [1..1] « Codes identifying names of simple observations. null (Strength=Example) LOINCCodes ?? » A unique identifier assigned to this ObservationDefinition artifact identifier : Identifier [0..*] The data types allowed for the value element of the instance observations conforming to this ObservationDefinition permittedDataType : code [0..*] « Permitted data type for observation value. null (Strength=Required) ObservationDataType ! » « This element has or is affected by some invariants C » Multiple results allowed for observations conforming to this ObservationDefinition multipleResultsAllowed : boolean [0..1] The site on the subject's body where the observation is to be made bodySite : CodeableConcept [0..1] « null (Strength=Example) SNOMEDCTBodyStructures ?? » The method or technique used to perform the observation method : CodeableConcept [0..1] « Methods for simple observations. null (Strength=Example) ObservationMethods ?? » The preferred name to be used when reporting the results kind of observations conforming to specimen that this ObservationDefinition type of observation is produced on preferredReportName specimen : string Reference [0..1] [0..*] « SpecimenDefinition » The set measurement model of valid coded results for the observations conforming device or actual device used to produce observations of this ObservationDefinition type validCodedValueSet device : Reference [0..1] [0..*] « ValueSet DeviceDefinition | Device » The set of normal coded results for preferred name to be used when reporting the results of observations conforming to this ObservationDefinition normalCodedValueSet preferredReportName : Reference string [0..1] « ValueSet » The set of abnormal coded results Units allowed for the observation valueQuantity element in the instance observations conforming to this ObservationDefinition abnormalCodedValueSet permittedUnit : Reference Coding [0..1] [0..*] « ValueSet null (Strength=Preferred) UCUMCodes ? » « This element has or is affected by some invariants C » The This ObservationDefinition defines a group observation (e.g. a battery, a panel of tests, a set of critical coded results for vital sign measurements) that includes the observation conforming to this ObservationDefinition target as a member of the group criticalCodedValueSet hasMember : Reference [0..1] [0..*] « ValueSet ObservationDefinition | Questionnaire » QuantitativeDetails QualifiedValue Customary unit used to report quantitative results of observations conforming to A concept defining the context for this ObservationDefinition set of qualified values customaryUnit context : CodeableConcept [0..1] « Codes identifying units of measure. null (Strength=Extensible) UCUMCodes ObservationReferenceRangeMean... + » SI unit used to report quantitative results The target population this set of observations conforming qualified values applies to this ObservationDefinition unit appliesTo : CodeableConcept [0..1] [0..*] « Codes identifying units of measure. (Strength=Extensible) null (Strength=Example) UCUMCodes + ObservationReferenceRangeAppl... ?? » Factor for converting value expressed with SI unit The gender this set of qualified values applies to value expressed with customary unit conversionFactor gender : decimal code [0..1] « null (Strength=Required) AdministrativeGender ! » Number of digits after decimal separator when the results of such observations are The age range this set of type Quantity qualified values applies to decimalPrecision age : integer Range [0..1] The gestational age this set of qualified values applies to gestationalAge : Range [0..1] QualifiedInterval Text based condition for which the the set of qualified values is valid condition : string [0..1] The category of interval range of values for continuous or ordinal observations conforming to that match the criteria of this ObservationDefinition set of qualified values category rangeCategory : code [0..1] « Codes identifying the category of observation range. null (Strength=Required) ObservationRangeCategory ! » The low and high range of values determining defined for continuous or ordinal observations that match the interval. There may be only one criteria of the two this set of qualified values range : Range [0..1] Codes to indicate the health context the range applies to. For example, The set of valid coded results for qualitative observations that match the normal or therapeutic range criteria of this set of qualified values context validCodedValueSet : CodeableConcept canonical [0..1] « Code identifying the health context of a range. (Strength=Extensible) ObservationReferenceRangeMean... ValueSet + » Codes to indicate The set of normal coded results for qualitative observations that match the target population criteria of this reference range applies to set of qualified values appliesTo normalCodedValueSet : CodeableConcept canonical [0..*] [0..1] « Codes identifying the population the reference range applies to. (Strength=Example) ObservationReferenceRangeAppl... ValueSet ?? » Sex The set of abnormal coded results for qualitative observations that match the population the range applies to criteria of this set of qualified values gender abnormalCodedValueSet : code canonical [0..1] « ValueSet » The gender set of a person used critical coded results for administrative purposes. (Strength=Required) qualitative observations that match the criteria of this set of qualified values AdministrativeGender ! criticalCodedValueSet : canonical [0..1] « ValueSet » Component The age at which this reference range is applicable. This is a neonatal age (e.g. number of weeks at term) if the meaning says so Describes what will be observed age code : Range CodeableConcept [0..1] [1..1] « null (Strength=Example) LOINCCodes ?? » The gestational age to which this reference range is applicable, in data types allowed for the context value element of pregnancy the instance of this component observations gestationalAge permittedDataType : Range code [0..1] [0..*] « null (Strength=Required) ObservationDataType ! » « This element has or is affected by some invariants C » Text based condition Units allowed for which the reference range is valid valueQuantity element in the instance observations conforming to this ObservationDefinition condition permittedUnit : string Coding [0..1] [0..*] « null (Strength=Preferred) UCUMCodes ? » « This element has or is affected by some invariants C » Characteristics A set of qualified values associated with a context and a set of conditions - provides a range for quantitative results and ordinal observations and a collection of this observation value sets for qualitative observations quantitativeDetails qualifiedValue [0..1] [0..*] Multiple ranges A set of results qualified by different contexts values associated with a context and a set of conditions - provides a range for quantitative and ordinal or continuous observations conforming to this ObservationDefinition and a collection of value sets for qualitative observations qualifiedInterval qualifiedValue [0..*] Some observations have multiple component observations, expressed as separate code value pairs component [0..*]

XML Template

<ObservationDefinition xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <</category>
 <</code>
 <</identifier>
 <
 <

 <url value="[uri]"/><!-- 0..1 Logical canonical URL to reference this ObservationDefinition (globally unique) -->
 <identifier><!-- 0..1 Identifier Business identifier of the ObservationDefinition --></identifier>
 <version value="[string]"/><!-- 0..1 Business version of the ObservationDefinition -->
 <versionAlgorithm[x]><!-- 0..1 string|Coding How to compare versions --></versionAlgorithm[x]>
 <name value="[string]"/><!-- I 0..1 Name for this ObservationDefinition (computer friendly) -->
 <title value="[string]"/><!-- 0..1 Name for this ObservationDefinition (human friendly) -->
 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <experimental value="[boolean]"/><!-- 0..1 If for testing purposes, not real usage -->
 <date value="[dateTime]"/><!-- 0..1 Date last changed -->
 <publisher value="[string]"/><!-- 0..1 The name of the individual or organization that published the ObservationDefinition -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <description value="[markdown]"/><!-- 0..1 Natural language description of the ObservationDefinition -->
 <useContext><!-- 0..* UsageContext Content intends to support these contexts --></useContext>
 <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for this ObservationDefinition (if applicable) --></jurisdiction>
 <purpose value="[markdown]"/><!-- 0..1 Why this ObservationDefinition is defined -->
 <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions -->
 <copyrightLabel value="[string]"/><!-- 0..1 Copyright holder and year(s) -->
 <approvalDate value="[date]"/><!-- 0..1 When ObservationDefinition was approved by publisher -->
 <lastReviewDate value="[date]"/><!-- 0..1 Date on which the asset content was last reviewed by the publisher -->
 <effectivePeriod><!-- 0..1 Period The effective date range for the ObservationDefinition --></effectivePeriod>
 <derivedFromCanonical><!-- 0..* canonical(ObservationDefinition) Based on FHIR definition of another observation --></derivedFromCanonical>
 <derivedFromUri value="[uri]"/><!-- 0..* Based on external definition -->
 <subject><!-- 0..* CodeableConcept Type of subject for the defined observation --></subject>
 <performerType><!-- 0..1 CodeableConcept Desired kind of performer for such kind of observation --></performerType>
 <category><!-- 0..* CodeableConcept General type of observation --></category>
 <code><!-- 1..1 CodeableConcept Type of observation --></code>
 <permittedDataType value="[code]"/><!-- I 0..* Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period -->
 <multipleResultsAllowed value="[boolean]"/><!-- 0..1 Multiple results allowed for conforming observations -->
 <bodySite><!-- 0..1 CodeableConcept Body part to be observed --></bodySite>

 <method><!-- 0..1 CodeableConcept Method used to produce the observation --></method>
 <
 <
  <</customaryUnit>
  <</unit>
  <
  <
 </quantitativeDetails>
 <
  <
  <</range>
  <</context>
  <</appliesTo>
  <
  <</age>
  <</gestationalAge>
  <
 </qualifiedInterval>
 <</validCodedValueSet>
 <</normalCodedValueSet>
 <</abnormalCodedValueSet>
 <</criticalCodedValueSet>

 <specimen><!-- 0..* Reference(SpecimenDefinition) Kind of specimen used by this type of observation --></specimen>
 <device><!-- 0..* Reference(Device|DeviceDefinition) Measurement device or model of device --></device>
 <preferredReportName value="[string]"/><!-- 0..1 The preferred name to be used when reporting the observation results -->
 <permittedUnit><!-- I 0..* Coding Unit for quantitative results --></permittedUnit>
 <qualifiedValue>  <!-- 0..* Set of qualified values for observation results -->
  <context><!-- 0..1 CodeableConcept Context qualifier for the set of qualified values --></context>
  <appliesTo><!-- 0..* CodeableConcept Targetted population for the set of qualified values --></appliesTo>
  <gender value="[code]"/><!-- 0..1 male | female | other | unknown -->
  <age><!-- 0..1 Range Applicable age range for the set of qualified values --></age>
  <gestationalAge><!-- 0..1 Range Applicable gestational age range for the set of qualified values --></gestationalAge>
  <condition value="[string]"/><!-- 0..1 Condition associated with the set of qualified values -->
  <rangeCategory value="[code]"/><!-- 0..1 reference | critical | absolute -->
  <range><!-- 0..1 Range The range for continuous or ordinal observations --></range>
  <validCodedValueSet><!-- 0..1 canonical(ValueSet) Value set of valid coded values as part of this set of qualified values --></validCodedValueSet>
  <normalCodedValueSet><!-- 0..1 canonical(ValueSet) Value set of normal coded values as part of this set of qualified values --></normalCodedValueSet>
  <abnormalCodedValueSet><!-- 0..1 canonical(ValueSet) Value set of abnormal coded values as part of this set of qualified values --></abnormalCodedValueSet>
  <criticalCodedValueSet><!-- 0..1 canonical(ValueSet) Value set of critical coded values as part of this set of qualified values --></criticalCodedValueSet>
 </qualifiedValue>
 <hasMember><!-- 0..* Reference(ObservationDefinition|Questionnaire) Definitions of related resources belonging to this kind of observation group --></hasMember>
 <component>  <!-- 0..* Component results -->
  <code><!-- 1..1 CodeableConcept Type of observation --></code>
  <permittedDataType value="[code]"/><!-- I 0..* Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period -->
  <permittedUnit><!-- I 0..* Coding Unit for quantitative results --></permittedUnit>
  <qualifiedValue><!-- 0..* Content as for ObservationDefinition.qualifiedValue Set of qualified values for observation results --></qualifiedValue>
 </component>

</ObservationDefinition>

JSON Template

{doco
  "resourceType" : "ObservationDefinition",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "
  "
  "
  "
  "

  "url" : "<uri>", // Logical canonical URL to reference this ObservationDefinition (globally unique)
  "identifier" : { Identifier }, // Business identifier of the ObservationDefinition
  "version" : "<string>", // Business version of the ObservationDefinition
  // versionAlgorithm[x]: How to compare versions. One of these 2:

  "versionAlgorithmString" : "<string>",
  "versionAlgorithmCoding" : { Coding },
  "name" : "<string>", // I Name for this ObservationDefinition (computer friendly)
  "title" : "<string>", // Name for this ObservationDefinition (human friendly)
  "status" : "<code>", // R!  draft | active | retired | unknown
  "experimental" : <boolean>, // If for testing purposes, not real usage
  "date" : "<dateTime>", // Date last changed
  "publisher" : "<string>", // The name of the individual or organization that published the ObservationDefinition
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "description" : "<markdown>", // Natural language description of the ObservationDefinition
  "useContext" : [{ UsageContext }], // Content intends to support these contexts
  "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for this ObservationDefinition (if applicable)
  "purpose" : "<markdown>", // Why this ObservationDefinition is defined
  "copyright" : "<markdown>", // Use and/or publishing restrictions
  "copyrightLabel" : "<string>", // Copyright holder and year(s)
  "approvalDate" : "<date>", // When ObservationDefinition was approved by publisher
  "lastReviewDate" : "<date>", // Date on which the asset content was last reviewed by the publisher
  "effectivePeriod" : { Period }, // The effective date range for the ObservationDefinition
  "derivedFromCanonical" : ["<canonical(ObservationDefinition)>"], // Based on FHIR definition of another observation
  "derivedFromUri" : ["<uri>"], // Based on external definition
  "subject" : [{ CodeableConcept }], // Type of subject for the defined observation
  "performerType" : { CodeableConcept }, // Desired kind of performer for such kind of observation
  "category" : [{ CodeableConcept }], // General type of observation
  "code" : { CodeableConcept }, // R!  Type of observation
  "permittedDataType" : ["<code>"], // I Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period
  "multipleResultsAllowed" : <boolean>, // Multiple results allowed for conforming observations
  "bodySite" : { CodeableConcept }, // Body part to be observed

  "method" : { CodeableConcept }, // Method used to produce the observation
  "
  "
    "
    "
    "
    "
  },
  "
    "
    "
    "
    "
    "
    "
    "
    "

  "specimen" : [{ Reference(SpecimenDefinition) }], // Kind of specimen used by this type of observation
  "device" : [{ Reference(Device|DeviceDefinition) }], // Measurement device or model of device
  "preferredReportName" : "<string>", // The preferred name to be used when reporting the observation results
  "permittedUnit" : [{ Coding }], // I Unit for quantitative results
  "qualifiedValue" : [{ // Set of qualified values for observation results
    "context" : { CodeableConcept }, // Context qualifier for the set of qualified values
    "appliesTo" : [{ CodeableConcept }], // Targetted population for the set of qualified values
    "gender" : "<code>", // male | female | other | unknown
    "age" : { Range }, // Applicable age range for the set of qualified values
    "gestationalAge" : { Range }, // Applicable gestational age range for the set of qualified values
    "condition" : "<string>", // Condition associated with the set of qualified values
    "rangeCategory" : "<code>", // reference | critical | absolute
    "range" : { Range }, // The range for continuous or ordinal observations
    "validCodedValueSet" : "<canonical(ValueSet)>", // Value set of valid coded values as part of this set of qualified values
    "normalCodedValueSet" : "<canonical(ValueSet)>", // Value set of normal coded values as part of this set of qualified values
    "abnormalCodedValueSet" : "<canonical(ValueSet)>", // Value set of abnormal coded values as part of this set of qualified values
    "criticalCodedValueSet" : "<canonical(ValueSet)>" // Value set of critical coded values as part of this set of qualified values

  }],
  "
  "
  "
  "

  "hasMember" : [{ Reference(ObservationDefinition|Questionnaire) }], // Definitions of related resources belonging to this kind of observation group
  "component" : [{ // Component results
    "code" : { CodeableConcept }, // R!  Type of observation
    "permittedDataType" : ["<code>"], // I Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period
    "permittedUnit" : [{ Coding }], // I Unit for quantitative results
    "qualifiedValue" : [{ Content as for ObservationDefinition.qualifiedValue }] // Set of qualified values for observation results
  }]

}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:ObservationDefinition;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
    fhir:
    fhir:
    fhir:
    fhir:
  ];
  fhir:
    fhir:
    fhir:
    fhir:
    fhir:
    fhir:
    fhir:
    fhir:
    fhir:
  ], ...;
  fhir:
  fhir:
  fhir:
  fhir:

  fhir:url [ uri ] ; # 0..1 Logical canonical URL to reference this ObservationDefinition (globally unique)
  fhir:identifier [ Identifier ] ; # 0..1 Business identifier of the ObservationDefinition
  fhir:version [ string ] ; # 0..1 Business version of the ObservationDefinition
  # versionAlgorithm[x] : 0..1 How to compare versions. One of these 2
    fhir:versionAlgorithm [  a fhir:string ; string ]
    fhir:versionAlgorithm [  a fhir:Coding ; Coding ]
  fhir:name [ string ] ; # 0..1 I Name for this ObservationDefinition (computer friendly)
  fhir:title [ string ] ; # 0..1 Name for this ObservationDefinition (human friendly)
  fhir:status [ code ] ; # 1..1 draft | active | retired | unknown
  fhir:experimental [ boolean ] ; # 0..1 If for testing purposes, not real usage
  fhir:date [ dateTime ] ; # 0..1 Date last changed
  fhir:publisher [ string ] ; # 0..1 The name of the individual or organization that published the ObservationDefinition
  fhir:contact  ( [ ContactDetail ] ... ) ; # 0..* Contact details for the publisher
  fhir:description [ markdown ] ; # 0..1 Natural language description of the ObservationDefinition
  fhir:useContext  ( [ UsageContext ] ... ) ; # 0..* Content intends to support these contexts
  fhir:jurisdiction  ( [ CodeableConcept ] ... ) ; # 0..* Intended jurisdiction for this ObservationDefinition (if applicable)
  fhir:purpose [ markdown ] ; # 0..1 Why this ObservationDefinition is defined
  fhir:copyright [ markdown ] ; # 0..1 Use and/or publishing restrictions
  fhir:copyrightLabel [ string ] ; # 0..1 Copyright holder and year(s)
  fhir:approvalDate [ date ] ; # 0..1 When ObservationDefinition was approved by publisher
  fhir:lastReviewDate [ date ] ; # 0..1 Date on which the asset content was last reviewed by the publisher
  fhir:effectivePeriod [ Period ] ; # 0..1 The effective date range for the ObservationDefinition
  fhir:derivedFromCanonical  ( [ canonical(ObservationDefinition) ] ... ) ; # 0..* Based on FHIR definition of another observation
  fhir:derivedFromUri  ( [ uri ] ... ) ; # 0..* Based on external definition
  fhir:subject  ( [ CodeableConcept ] ... ) ; # 0..* Type of subject for the defined observation
  fhir:performerType [ CodeableConcept ] ; # 0..1 Desired kind of performer for such kind of observation
  fhir:category  ( [ CodeableConcept ] ... ) ; # 0..* General type of observation
  fhir:code [ CodeableConcept ] ; # 1..1 Type of observation
  fhir:permittedDataType  ( [ code ] ... ) ; # 0..* I Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period
  fhir:multipleResultsAllowed [ boolean ] ; # 0..1 Multiple results allowed for conforming observations
  fhir:bodySite [ CodeableConcept ] ; # 0..1 Body part to be observed
  fhir:method [ CodeableConcept ] ; # 0..1 Method used to produce the observation
  fhir:specimen  ( [ Reference(SpecimenDefinition) ] ... ) ; # 0..* Kind of specimen used by this type of observation
  fhir:device  ( [ Reference(Device|DeviceDefinition) ] ... ) ; # 0..* Measurement device or model of device
  fhir:preferredReportName [ string ] ; # 0..1 The preferred name to be used when reporting the observation results
  fhir:permittedUnit  ( [ Coding ] ... ) ; # 0..* I Unit for quantitative results
  fhir:qualifiedValue ( [ # 0..* Set of qualified values for observation results
    fhir:context [ CodeableConcept ] ; # 0..1 Context qualifier for the set of qualified values
    fhir:appliesTo  ( [ CodeableConcept ] ... ) ; # 0..* Targetted population for the set of qualified values
    fhir:gender [ code ] ; # 0..1 male | female | other | unknown
    fhir:age [ Range ] ; # 0..1 Applicable age range for the set of qualified values
    fhir:gestationalAge [ Range ] ; # 0..1 Applicable gestational age range for the set of qualified values
    fhir:condition [ string ] ; # 0..1 Condition associated with the set of qualified values
    fhir:rangeCategory [ code ] ; # 0..1 reference | critical | absolute
    fhir:range [ Range ] ; # 0..1 The range for continuous or ordinal observations
    fhir:validCodedValueSet [ canonical(ValueSet) ] ; # 0..1 Value set of valid coded values as part of this set of qualified values
    fhir:normalCodedValueSet [ canonical(ValueSet) ] ; # 0..1 Value set of normal coded values as part of this set of qualified values
    fhir:abnormalCodedValueSet [ canonical(ValueSet) ] ; # 0..1 Value set of abnormal coded values as part of this set of qualified values
    fhir:criticalCodedValueSet [ canonical(ValueSet) ] ; # 0..1 Value set of critical coded values as part of this set of qualified values
  ] ... ) ;
  fhir:hasMember  ( [ Reference(ObservationDefinition|Questionnaire) ] ... ) ; # 0..* Definitions of related resources belonging to this kind of observation group
  fhir:component ( [ # 0..* Component results
    fhir:code [ CodeableConcept ] ; # 1..1 Type of observation
    fhir:permittedDataType  ( [ code ] ... ) ; # 0..* I Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period
    fhir:permittedUnit  ( [ Coding ] ... ) ; # 0..* I Unit for quantitative results
    fhir:qualifiedValue  ( [ See ObservationDefinition.qualifiedValue ] ... ) ; # 0..* Set of qualified values for observation results
  ] ... ) ;

]

Changes since R3 from both R4 and R4B

ObservationDefinition
ObservationDefinition.url
  • Added Element
ObservationDefinition.identifier
  • Max Cardinality changed from * to 1
ObservationDefinition.version
  • Added Element
ObservationDefinition.versionAlgorithm[x]
  • Added Element
ObservationDefinition.name
  • Added Element
ObservationDefinition.title
  • Added Element
ObservationDefinition.status
  • Added Mandatory Element
ObservationDefinition.experimental
  • Added Element
ObservationDefinition.date
  • Added Element
ObservationDefinition.publisher
  • Added Element
ObservationDefinition.contact
  • Added Element
ObservationDefinition.description
  • Added Element
ObservationDefinition.useContext
  • Added Element
ObservationDefinition.jurisdiction
  • Added Element
ObservationDefinition.purpose
  • Added Element
ObservationDefinition.copyright
  • Added Element
ObservationDefinition.copyrightLabel
  • Added Element
ObservationDefinition.approvalDate
  • Added Element
ObservationDefinition.lastReviewDate
  • Added Element
ObservationDefinition.effectivePeriod
  • Added Element
ObservationDefinition.derivedFromCanonical
  • Added Element
ObservationDefinition.derivedFromUri
  • Added Element
ObservationDefinition.subject
  • Added Element
ObservationDefinition.performerType
  • Added Element
ObservationDefinition.bodySite
  • Added Element
ObservationDefinition.specimen
  • Added Element
ObservationDefinition.device
  • Added Element
ObservationDefinition.permittedUnit
  • Added Element
ObservationDefinition.qualifiedValue
  • Added Element
ObservationDefinition.qualifiedValue.context
  • Added Element
ObservationDefinition.qualifiedValue.appliesTo
  • Added Element
ObservationDefinition.qualifiedValue.gender
  • Added Element
ObservationDefinition.qualifiedValue.age
  • Added Element
ObservationDefinition.qualifiedValue.gestationalAge
  • Added Element
ObservationDefinition.qualifiedValue.condition
  • Added Element
ObservationDefinition.qualifiedValue.rangeCategory
  • Added Element
ObservationDefinition.qualifiedValue.range
  • Added Element
ObservationDefinition.qualifiedValue.validCodedValueSet
  • Added Element
ObservationDefinition.qualifiedValue.normalCodedValueSet
  • Added Element
ObservationDefinition.qualifiedValue.abnormalCodedValueSet
  • Added Element
ObservationDefinition.qualifiedValue.criticalCodedValueSet
  • Added Element
ObservationDefinition.hasMember
  • Added Element
ObservationDefinition.component
  • Added Element
ObservationDefinition.component.code
  • Added Mandatory Element
ObservationDefinition.component.permittedDataType
  • Added Element
ObservationDefinition.component.permittedUnit
  • Added Element
ObservationDefinition.component.qualifiedValue
  • Added Element
ObservationDefinition.quantitativeDetails
  • Deleted
ObservationDefinition.qualifiedInterval
  • Deleted
ObservationDefinition.validCodedValueSet
  • Deleted
ObservationDefinition.normalCodedValueSet
  • Deleted
ObservationDefinition.abnormalCodedValueSet
  • Deleted
ObservationDefinition.criticalCodedValueSet
  • Deleted

This resource did not exist in Release 2 See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .

Structure

Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData reference Range
Name Flags Card. Type Description & Constraints doco
. . ObservationDefinition TU DomainResource Definition of an observation
+ Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation
+ Rule: If permittedUnit exists, then permittedDataType=Quantity must exist.

Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
Interfaces Implemented: MetadataResource
. . category . url Σ 0..* 0..1 CodeableConcept uri Category of observation Observation Category Codes ( Example ) Logical canonical URL to reference this ObservationDefinition (globally unique)
. . . code identifier Σ 1..1 0..1 CodeableConcept Identifier Type Business identifier of observation (code / type) the ObservationDefinition
LOINC Codes
. . . version Σ 0..1 string Business version of the ObservationDefinition
... versionAlgorithm[x] Σ 0..1 How to compare versions
Binding: Version Algorithm ( Example Extensible )
. . . . versionAlgorithmString string
.... versionAlgorithmCoding Coding
. . identifier . name Σ C 0..* 0..1 Identifier string Business identifier Name for this ObservationDefinition instance (computer friendly)
. . . permittedDataType title Σ T 0..* 0..1 string Name for this ObservationDefinition (human friendly)
... status ?! Σ 1..1 code draft | time active | dateTime retired | Period unknown
ObservationDataType Binding: PublicationStatus ( Required )
. . . experimental Σ 0..1 boolean If for testing purposes, not real usage
. . . multipleResultsAllowed date Σ 0..1 boolean dateTime Multiple results allowed Date last changed
. . method . publisher Σ T 0..1 CodeableConcept string Method used to produce The name of the observation individual or organization that published the ObservationDefinition
Observation Methods ( Example )
. . preferredReportName . contact Σ 0..1 0..* string ContactDetail Preferred report name Contact details for the publisher

. . quantitativeDetails . description T 0..1 BackboneElement markdown Characteristics Natural language description of quantitative results the ObservationDefinition
. . . customaryUnit useContext Σ 0..1 0..* CodeableConcept UsageContext Customary unit for quantitative results Content intends to support these contexts

UCUM Codes ( Extensible )
. . . unit jurisdiction Σ XD 0..1 0..* CodeableConcept SI unit Intended jurisdiction for quantitative results this ObservationDefinition (if applicable)
UCUM Codes Binding: Jurisdiction ValueSet ( Extensible )

. . . conversionFactor purpose T 0..1 decimal markdown SI to Customary unit conversion factor Why this ObservationDefinition is defined
. . . copyright T 0..1 markdown Use and/or publishing restrictions
... copyrightLabel T 0..1 string Copyright holder and year(s)
.. . decimalPrecision approvalDate 0..1 date When ObservationDefinition was approved by publisher
... lastReviewDate 0..1 date Date on which the asset content was last reviewed by the publisher
... effectivePeriod integer Σ Decimal precision 0..1 Period The effective date range for the ObservationDefinition
... derivedFromCanonical Σ 0..* canonical ( ObservationDefinition ) Based on FHIR definition of another observation quantitative results

. . qualifiedInterval . derivedFromUri Σ 0..* uri Based on external definition

... subject Σ 0..* BackboneElement CodeableConcept Qualified range Type of subject for continuous and ordinal the defined observation results

. . . performerType Σ 0..1 CodeableConcept Desired kind of performer for such kind of observation
. . . category Σ 0..* CodeableConcept General type of observation
Binding: Observation Category Codes ( Example )

... code Σ 0..1 1..1 CodeableConcept Type of observation
Binding: LOINC Codes ( Example )
... permittedDataType C 0..* code Quantity | critical CodeableConcept | absolute string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period
ObservationRangeCategory Binding: Observation Data Type ( Required )

. . . multipleResultsAllowed 0..1 boolean Multiple results allowed for conforming observations
. . . range bodySite 0..1 CodeableConcept Body part to be observed
Binding: SNOMED CT Body Structures ( Example )
... method 0..1 CodeableConcept Method used to produce the observation
Binding: Observation Methods ( Example )
... specimen 0..* Reference ( SpecimenDefinition ) Kind of specimen used by this type of observation

... device 0..* Reference ( DeviceDefinition | Device ) Measurement device or model of device

... preferredReportName 0..1 string The interval itself, preferred name to be used when reporting the observation results
... permittedUnit C 0..* Coding Unit for continuous or ordinal observations quantitative results
Binding: UCUM Codes ( Preferred )

. . . qualifiedValue 0..* BackboneElement Set of qualified values for observation results

. . . . context 0..1 CodeableConcept Range context Context qualifier for the set of qualified values
Binding: Observation Reference Range Meaning Codes ( Extensible )
. . . . appliesTo 0..* CodeableConcept Targetted population of for the range set of qualified values
Binding: Observation Reference Range Applies To Codes ( Example )

. . . . gender 0..1 code male | female | other | unknown
Binding: AdministrativeGender ( Required )
. . . . age 0..1 Range Applicable age range, if relevant range for the set of qualified values
. . . . gestationalAge 0..1 Range Applicable gestational age range, if relevant range for the set of qualified values
. . . . condition 0..1 string Condition associated with the set of qualified values
.... rangeCategory 0..1 code reference | critical | absolute
Binding: Observation Range Category ( Required )
.... range 0..1 Range The range for continuous or ordinal observations
. . . . validCodedValueSet 0..1 Reference canonical ( ValueSet ) Value set of valid coded values for the observations conforming to as part of this ObservationDefinition set of qualified values
. . . . normalCodedValueSet 0..1 Reference canonical ( ValueSet ) Value set of normal coded values for the observations conforming to as part of this ObservationDefinition set of qualified values
. . . . abnormalCodedValueSet 0..1 Reference canonical ( ValueSet ) Value set of abnormal coded values for the observations conforming to as part of this ObservationDefinition set of qualified values
. . . . criticalCodedValueSet 0..1 Reference canonical ( ValueSet ) Value set of critical coded values for the observations conforming to as part of this set of qualified values
... hasMember 0..* Reference ( ObservationDefinition | Questionnaire ) Definitions of related resources belonging to this kind of observation group

... component C 0..* BackboneElement Component results
+ Rule: If permittedUnit exists, then permittedDataType=Quantity must exist.

.... code 1..1 CodeableConcept Type of observation
Binding: LOINC Codes ( Example )
.... permittedDataType C 0..* code Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period
Binding: Observation Data Type ( Required )

.... permittedUnit C 0..* Coding Unit for quantitative results
Binding: UCUM Codes ( Preferred )

.... qualifiedValue 0..* see qualifiedValue Set of qualified values for observation results


doco Documentation for this format icon

See the Extensions for this resource

UML Diagram ( Legend )

ObservationDefinition ( DomainResource ) + MetadataResource An absolute URL that is used to identify this ObservationDefinition when it is referenced in a specification, model, design or an instance. This SHALL be a URL, SHOULD be globally unique, and SHOULD be an address at which this ObservationDefinition is (or will be) published. The URL SHOULD include the major version of the ObservationDefinition. For more information see Technical and Business Versions url : uri [0..1] Business identifiers assigned to this ObservationDefinition. by the performer and/or other systems. These identifiers remain constant as the resource is updated and propagates from server to server identifier : Identifier [0..1] The identifier that is used to identify this version of the ObservationDefinition when it is referenced in a specification, model, design or instance. This is an arbitrary value managed by the ObservationDefinition author and is not expected to be globally unique. For example, it might be a timestamp (e.g. yyyymmdd) if a managed version is not available. There is also no expectation that versions are orderable version : string [0..1] Indicates the mechanism used to compare versions to determine which is more current versionAlgorithm[x] : DataType [0..1] « string | Coding ; null (Strength=Extensible) VersionAlgorithm + » A natural language name identifying the ObservationDefinition. This name should be usable as an identifier for the module by machine processing applications such as code generation name : string [0..1] « This element has or is affected by some invariants C » A short, descriptive, user-friendly title for the ObservationDefinition title : string [0..1] The current state of the ObservationDefinition (this element modifies the meaning of other elements) status : code [1..1] « null (Strength=Required) PublicationStatus ! » A flag to indicate that this ObservationDefinition is authored for testing purposes (or education/evaluation/marketing), and is not intended to be used for genuine usage experimental : boolean [0..1] The date (and optionally time) when the ObservationDefinition was last significantly changed. The date must change when the business version changes and it must change if the status code changes. In addition, it should change when the substantive content of the ObservationDefinition changes date : dateTime [0..1] Helps establish the "authority/credibility" of the ObservationDefinition. May also allow for contact publisher : string [0..1] Contact details to assist a user in finding and communicating with the publisher contact : ContactDetail [0..*] A free text natural language description of the ObservationDefinition from the consumer's perspective description : markdown [0..1] The content was developed with a focus and intent of supporting the contexts that are listed. These contexts may be general categories (gender, age, ...) or may be references to specific programs (insurance plans, studies, ...) and may be used to assist with indexing and searching for appropriate ObservationDefinition instances useContext : UsageContext [0..*] A jurisdiction in which the ObservationDefinition is intended to be used jurisdiction : CodeableConcept [0..*] « null (Strength=Extensible) JurisdictionValueSet + » Explains why this ObservationDefinition is needed and why it has been designed as it has purpose : markdown [0..1] Copyright statement relating to the ObservationDefinition and/or its contents. Copyright statements are generally legal restrictions on the use and publishing of the ObservationDefinition copyright : markdown [0..1] A short string (<50 characters), suitable for inclusion in a page footer that identifies the copyright holder, effective period, and optionally whether rights are resctricted. (e.g. 'All rights reserved', 'Some rights reserved') copyrightLabel : string [0..1] The date on which the asset content was approved by the publisher. Approval happens once when the content is officially approved for usage approvalDate : date [0..1] The date on which the asset content was last reviewed. Review happens periodically after that, but doesn't change the original approval date lastReviewDate : date [0..1] The period during which the ObservationDefinition content was or is planned to be effective effectivePeriod : Period [0..1] The canonical URL pointing to another FHIR-defined ObservationDefinition that is adhered to in whole or in part by this definition derivedFromCanonical : canonical [0..*] « ObservationDefinition » The URL pointing to an externally-defined observation definition, guideline or other definition that is adhered to in whole or in part by this definition derivedFromUri : uri [0..*] A code that describes the intended kind of subject of Observation instances conforming to this ObservationDefinition subject : CodeableConcept [0..*] The type of individual/organization/device that is expected to act upon instances of this definition performerType : CodeableConcept [0..1] A code that classifies the general type of observation category : CodeableConcept [0..*] « Codes for high level observation categories. null (Strength=Example) ObservationCategoryCodes ?? » Describes what will be observed. Sometimes this is called the observation "name" code : CodeableConcept [1..1] « Codes identifying names of simple observations. null (Strength=Example) LOINCCodes ?? » A unique identifier assigned to this ObservationDefinition artifact identifier : Identifier [0..*] The data types allowed for the value element of the instance observations conforming to this ObservationDefinition permittedDataType : code [0..*] « Permitted data type for observation value. null (Strength=Required) ObservationDataType ! » « This element has or is affected by some invariants C » Multiple results allowed for observations conforming to this ObservationDefinition multipleResultsAllowed : boolean [0..1] The site on the subject's body where the observation is to be made bodySite : CodeableConcept [0..1] « null (Strength=Example) SNOMEDCTBodyStructures ?? » The method or technique used to perform the observation method : CodeableConcept [0..1] « Methods for simple observations. null (Strength=Example) ObservationMethods ?? » The preferred name to be used when reporting the results kind of observations conforming to specimen that this ObservationDefinition type of observation is produced on preferredReportName specimen : string Reference [0..1] [0..*] « SpecimenDefinition » The set measurement model of valid coded results for the observations conforming device or actual device used to produce observations of this ObservationDefinition type validCodedValueSet device : Reference [0..1] [0..*] « ValueSet DeviceDefinition | Device » The set of normal coded results for preferred name to be used when reporting the results of observations conforming to this ObservationDefinition normalCodedValueSet preferredReportName : Reference string [0..1] « ValueSet » The set of abnormal coded results Units allowed for the observation valueQuantity element in the instance observations conforming to this ObservationDefinition abnormalCodedValueSet permittedUnit : Reference Coding [0..1] [0..*] « ValueSet null (Strength=Preferred) UCUMCodes ? » « This element has or is affected by some invariants C » The This ObservationDefinition defines a group observation (e.g. a battery, a panel of tests, a set of critical coded results for vital sign measurements) that includes the observation conforming to this ObservationDefinition target as a member of the group criticalCodedValueSet hasMember : Reference [0..1] [0..*] « ValueSet ObservationDefinition | Questionnaire » QuantitativeDetails QualifiedValue Customary unit used to report quantitative results of observations conforming to A concept defining the context for this ObservationDefinition set of qualified values customaryUnit context : CodeableConcept [0..1] « Codes identifying units of measure. null (Strength=Extensible) UCUMCodes ObservationReferenceRangeMean... + » SI unit used to report quantitative results The target population this set of observations conforming qualified values applies to this ObservationDefinition unit appliesTo : CodeableConcept [0..1] [0..*] « Codes identifying units of measure. (Strength=Extensible) null (Strength=Example) UCUMCodes + ObservationReferenceRangeAppl... ?? » Factor for converting value expressed with SI unit The gender this set of qualified values applies to value expressed with customary unit conversionFactor gender : decimal code [0..1] « null (Strength=Required) AdministrativeGender ! » Number of digits after decimal separator when the results of such observations are The age range this set of type Quantity qualified values applies to decimalPrecision age : integer Range [0..1] The gestational age this set of qualified values applies to gestationalAge : Range [0..1] QualifiedInterval Text based condition for which the the set of qualified values is valid condition : string [0..1] The category of interval range of values for continuous or ordinal observations conforming to that match the criteria of this ObservationDefinition set of qualified values category rangeCategory : code [0..1] « Codes identifying the category of observation range. null (Strength=Required) ObservationRangeCategory ! » The low and high range of values determining defined for continuous or ordinal observations that match the interval. There may be only one criteria of the two this set of qualified values range : Range [0..1] Codes to indicate the health context the range applies to. For example, The set of valid coded results for qualitative observations that match the normal or therapeutic range criteria of this set of qualified values context validCodedValueSet : CodeableConcept canonical [0..1] « Code identifying the health context of a range. (Strength=Extensible) ObservationReferenceRangeMean... ValueSet + » Codes to indicate The set of normal coded results for qualitative observations that match the target population criteria of this reference range applies to set of qualified values appliesTo normalCodedValueSet : CodeableConcept canonical [0..*] [0..1] « Codes identifying the population the reference range applies to. (Strength=Example) ObservationReferenceRangeAppl... ValueSet ?? » Sex The set of abnormal coded results for qualitative observations that match the population the range applies to criteria of this set of qualified values gender abnormalCodedValueSet : code canonical [0..1] « ValueSet » The gender set of a person used critical coded results for administrative purposes. (Strength=Required) qualitative observations that match the criteria of this set of qualified values AdministrativeGender ! criticalCodedValueSet : canonical [0..1] « ValueSet » Component The age at which this reference range is applicable. This is a neonatal age (e.g. number of weeks at term) if the meaning says so Describes what will be observed age code : Range CodeableConcept [0..1] [1..1] « null (Strength=Example) LOINCCodes ?? » The gestational age to which this reference range is applicable, in data types allowed for the context value element of pregnancy the instance of this component observations gestationalAge permittedDataType : Range code [0..1] [0..*] « null (Strength=Required) ObservationDataType ! » « This element has or is affected by some invariants C » Text based condition Units allowed for which the reference range is valid valueQuantity element in the instance observations conforming to this ObservationDefinition condition permittedUnit : string Coding [0..1] [0..*] « null (Strength=Preferred) UCUMCodes ? » « This element has or is affected by some invariants C » Characteristics A set of qualified values associated with a context and a set of conditions - provides a range for quantitative results and ordinal observations and a collection of this observation value sets for qualitative observations quantitativeDetails qualifiedValue [0..1] [0..*] Multiple ranges A set of results qualified by different contexts values associated with a context and a set of conditions - provides a range for quantitative and ordinal or continuous observations conforming to this ObservationDefinition and a collection of value sets for qualitative observations qualifiedInterval qualifiedValue [0..*] Some observations have multiple component observations, expressed as separate code value pairs component [0..*]

XML Template

<ObservationDefinition xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <</category>
 <</code>
 <</identifier>
 <
 <

 <url value="[uri]"/><!-- 0..1 Logical canonical URL to reference this ObservationDefinition (globally unique) -->
 <identifier><!-- 0..1 Identifier Business identifier of the ObservationDefinition --></identifier>
 <version value="[string]"/><!-- 0..1 Business version of the ObservationDefinition -->
 <versionAlgorithm[x]><!-- 0..1 string|Coding How to compare versions --></versionAlgorithm[x]>
 <name value="[string]"/><!-- I 0..1 Name for this ObservationDefinition (computer friendly) -->
 <title value="[string]"/><!-- 0..1 Name for this ObservationDefinition (human friendly) -->
 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <experimental value="[boolean]"/><!-- 0..1 If for testing purposes, not real usage -->
 <date value="[dateTime]"/><!-- 0..1 Date last changed -->
 <publisher value="[string]"/><!-- 0..1 The name of the individual or organization that published the ObservationDefinition -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <description value="[markdown]"/><!-- 0..1 Natural language description of the ObservationDefinition -->
 <useContext><!-- 0..* UsageContext Content intends to support these contexts --></useContext>
 <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for this ObservationDefinition (if applicable) --></jurisdiction>
 <purpose value="[markdown]"/><!-- 0..1 Why this ObservationDefinition is defined -->
 <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions -->
 <copyrightLabel value="[string]"/><!-- 0..1 Copyright holder and year(s) -->
 <approvalDate value="[date]"/><!-- 0..1 When ObservationDefinition was approved by publisher -->
 <lastReviewDate value="[date]"/><!-- 0..1 Date on which the asset content was last reviewed by the publisher -->
 <effectivePeriod><!-- 0..1 Period The effective date range for the ObservationDefinition --></effectivePeriod>
 <derivedFromCanonical><!-- 0..* canonical(ObservationDefinition) Based on FHIR definition of another observation --></derivedFromCanonical>
 <derivedFromUri value="[uri]"/><!-- 0..* Based on external definition -->
 <subject><!-- 0..* CodeableConcept Type of subject for the defined observation --></subject>
 <performerType><!-- 0..1 CodeableConcept Desired kind of performer for such kind of observation --></performerType>
 <category><!-- 0..* CodeableConcept General type of observation --></category>
 <code><!-- 1..1 CodeableConcept Type of observation --></code>
 <permittedDataType value="[code]"/><!-- I 0..* Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period -->
 <multipleResultsAllowed value="[boolean]"/><!-- 0..1 Multiple results allowed for conforming observations -->
 <bodySite><!-- 0..1 CodeableConcept Body part to be observed --></bodySite>

 <method><!-- 0..1 CodeableConcept Method used to produce the observation --></method>
 <
 <
  <</customaryUnit>
  <</unit>
  <
  <
 </quantitativeDetails>
 <
  <
  <</range>
  <</context>
  <</appliesTo>
  <
  <</age>
  <</gestationalAge>
  <
 </qualifiedInterval>
 <</validCodedValueSet>
 <</normalCodedValueSet>
 <</abnormalCodedValueSet>
 <</criticalCodedValueSet>

 <specimen><!-- 0..* Reference(SpecimenDefinition) Kind of specimen used by this type of observation --></specimen>
 <device><!-- 0..* Reference(Device|DeviceDefinition) Measurement device or model of device --></device>
 <preferredReportName value="[string]"/><!-- 0..1 The preferred name to be used when reporting the observation results -->
 <permittedUnit><!-- I 0..* Coding Unit for quantitative results --></permittedUnit>
 <qualifiedValue>  <!-- 0..* Set of qualified values for observation results -->
  <context><!-- 0..1 CodeableConcept Context qualifier for the set of qualified values --></context>
  <appliesTo><!-- 0..* CodeableConcept Targetted population for the set of qualified values --></appliesTo>
  <gender value="[code]"/><!-- 0..1 male | female | other | unknown -->
  <age><!-- 0..1 Range Applicable age range for the set of qualified values --></age>
  <gestationalAge><!-- 0..1 Range Applicable gestational age range for the set of qualified values --></gestationalAge>
  <condition value="[string]"/><!-- 0..1 Condition associated with the set of qualified values -->
  <rangeCategory value="[code]"/><!-- 0..1 reference | critical | absolute -->
  <range><!-- 0..1 Range The range for continuous or ordinal observations --></range>
  <validCodedValueSet><!-- 0..1 canonical(ValueSet) Value set of valid coded values as part of this set of qualified values --></validCodedValueSet>
  <normalCodedValueSet><!-- 0..1 canonical(ValueSet) Value set of normal coded values as part of this set of qualified values --></normalCodedValueSet>
  <abnormalCodedValueSet><!-- 0..1 canonical(ValueSet) Value set of abnormal coded values as part of this set of qualified values --></abnormalCodedValueSet>
  <criticalCodedValueSet><!-- 0..1 canonical(ValueSet) Value set of critical coded values as part of this set of qualified values --></criticalCodedValueSet>
 </qualifiedValue>
 <hasMember><!-- 0..* Reference(ObservationDefinition|Questionnaire) Definitions of related resources belonging to this kind of observation group --></hasMember>
 <component>  <!-- 0..* Component results -->
  <code><!-- 1..1 CodeableConcept Type of observation --></code>
  <permittedDataType value="[code]"/><!-- I 0..* Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period -->
  <permittedUnit><!-- I 0..* Coding Unit for quantitative results --></permittedUnit>
  <qualifiedValue><!-- 0..* Content as for ObservationDefinition.qualifiedValue Set of qualified values for observation results --></qualifiedValue>
 </component>

</ObservationDefinition>

JSON Template

{doco
  "resourceType" : "ObservationDefinition",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "
  "
  "
  "
  "

  "url" : "<uri>", // Logical canonical URL to reference this ObservationDefinition (globally unique)
  "identifier" : { Identifier }, // Business identifier of the ObservationDefinition
  "version" : "<string>", // Business version of the ObservationDefinition
  // versionAlgorithm[x]: How to compare versions. One of these 2:

  "versionAlgorithmString" : "<string>",
  "versionAlgorithmCoding" : { Coding },
  "name" : "<string>", // I Name for this ObservationDefinition (computer friendly)
  "title" : "<string>", // Name for this ObservationDefinition (human friendly)
  "status" : "<code>", // R!  draft | active | retired | unknown
  "experimental" : <boolean>, // If for testing purposes, not real usage
  "date" : "<dateTime>", // Date last changed
  "publisher" : "<string>", // The name of the individual or organization that published the ObservationDefinition
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "description" : "<markdown>", // Natural language description of the ObservationDefinition
  "useContext" : [{ UsageContext }], // Content intends to support these contexts
  "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for this ObservationDefinition (if applicable)
  "purpose" : "<markdown>", // Why this ObservationDefinition is defined
  "copyright" : "<markdown>", // Use and/or publishing restrictions
  "copyrightLabel" : "<string>", // Copyright holder and year(s)
  "approvalDate" : "<date>", // When ObservationDefinition was approved by publisher
  "lastReviewDate" : "<date>", // Date on which the asset content was last reviewed by the publisher
  "effectivePeriod" : { Period }, // The effective date range for the ObservationDefinition
  "derivedFromCanonical" : ["<canonical(ObservationDefinition)>"], // Based on FHIR definition of another observation
  "derivedFromUri" : ["<uri>"], // Based on external definition
  "subject" : [{ CodeableConcept }], // Type of subject for the defined observation
  "performerType" : { CodeableConcept }, // Desired kind of performer for such kind of observation
  "category" : [{ CodeableConcept }], // General type of observation
  "code" : { CodeableConcept }, // R!  Type of observation
  "permittedDataType" : ["<code>"], // I Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period
  "multipleResultsAllowed" : <boolean>, // Multiple results allowed for conforming observations
  "bodySite" : { CodeableConcept }, // Body part to be observed

  "method" : { CodeableConcept }, // Method used to produce the observation
  "
  "
    "
    "
    "
    "
  },
  "
    "
    "
    "
    "
    "
    "
    "
    "

  "specimen" : [{ Reference(SpecimenDefinition) }], // Kind of specimen used by this type of observation
  "device" : [{ Reference(Device|DeviceDefinition) }], // Measurement device or model of device
  "preferredReportName" : "<string>", // The preferred name to be used when reporting the observation results
  "permittedUnit" : [{ Coding }], // I Unit for quantitative results
  "qualifiedValue" : [{ // Set of qualified values for observation results
    "context" : { CodeableConcept }, // Context qualifier for the set of qualified values
    "appliesTo" : [{ CodeableConcept }], // Targetted population for the set of qualified values
    "gender" : "<code>", // male | female | other | unknown
    "age" : { Range }, // Applicable age range for the set of qualified values
    "gestationalAge" : { Range }, // Applicable gestational age range for the set of qualified values
    "condition" : "<string>", // Condition associated with the set of qualified values
    "rangeCategory" : "<code>", // reference | critical | absolute
    "range" : { Range }, // The range for continuous or ordinal observations
    "validCodedValueSet" : "<canonical(ValueSet)>", // Value set of valid coded values as part of this set of qualified values
    "normalCodedValueSet" : "<canonical(ValueSet)>", // Value set of normal coded values as part of this set of qualified values
    "abnormalCodedValueSet" : "<canonical(ValueSet)>", // Value set of abnormal coded values as part of this set of qualified values
    "criticalCodedValueSet" : "<canonical(ValueSet)>" // Value set of critical coded values as part of this set of qualified values

  }],
  "
  "
  "
  "

  "hasMember" : [{ Reference(ObservationDefinition|Questionnaire) }], // Definitions of related resources belonging to this kind of observation group
  "component" : [{ // Component results
    "code" : { CodeableConcept }, // R!  Type of observation
    "permittedDataType" : ["<code>"], // I Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period
    "permittedUnit" : [{ Coding }], // I Unit for quantitative results
    "qualifiedValue" : [{ Content as for ObservationDefinition.qualifiedValue }] // Set of qualified values for observation results
  }]

}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:ObservationDefinition;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
    fhir:
    fhir:
    fhir:
    fhir:
  ];
  fhir:
    fhir:
    fhir:
    fhir:
    fhir:
    fhir:
    fhir:
    fhir:
    fhir:
  ], ...;
  fhir:
  fhir:
  fhir:
  fhir:

  fhir:url [ uri ] ; # 0..1 Logical canonical URL to reference this ObservationDefinition (globally unique)
  fhir:identifier [ Identifier ] ; # 0..1 Business identifier of the ObservationDefinition
  fhir:version [ string ] ; # 0..1 Business version of the ObservationDefinition
  # versionAlgorithm[x] : 0..1 How to compare versions. One of these 2
    fhir:versionAlgorithm [  a fhir:string ; string ]
    fhir:versionAlgorithm [  a fhir:Coding ; Coding ]
  fhir:name [ string ] ; # 0..1 I Name for this ObservationDefinition (computer friendly)
  fhir:title [ string ] ; # 0..1 Name for this ObservationDefinition (human friendly)
  fhir:status [ code ] ; # 1..1 draft | active | retired | unknown
  fhir:experimental [ boolean ] ; # 0..1 If for testing purposes, not real usage
  fhir:date [ dateTime ] ; # 0..1 Date last changed
  fhir:publisher [ string ] ; # 0..1 The name of the individual or organization that published the ObservationDefinition
  fhir:contact  ( [ ContactDetail ] ... ) ; # 0..* Contact details for the publisher
  fhir:description [ markdown ] ; # 0..1 Natural language description of the ObservationDefinition
  fhir:useContext  ( [ UsageContext ] ... ) ; # 0..* Content intends to support these contexts
  fhir:jurisdiction  ( [ CodeableConcept ] ... ) ; # 0..* Intended jurisdiction for this ObservationDefinition (if applicable)
  fhir:purpose [ markdown ] ; # 0..1 Why this ObservationDefinition is defined
  fhir:copyright [ markdown ] ; # 0..1 Use and/or publishing restrictions
  fhir:copyrightLabel [ string ] ; # 0..1 Copyright holder and year(s)
  fhir:approvalDate [ date ] ; # 0..1 When ObservationDefinition was approved by publisher
  fhir:lastReviewDate [ date ] ; # 0..1 Date on which the asset content was last reviewed by the publisher
  fhir:effectivePeriod [ Period ] ; # 0..1 The effective date range for the ObservationDefinition
  fhir:derivedFromCanonical  ( [ canonical(ObservationDefinition) ] ... ) ; # 0..* Based on FHIR definition of another observation
  fhir:derivedFromUri  ( [ uri ] ... ) ; # 0..* Based on external definition
  fhir:subject  ( [ CodeableConcept ] ... ) ; # 0..* Type of subject for the defined observation
  fhir:performerType [ CodeableConcept ] ; # 0..1 Desired kind of performer for such kind of observation
  fhir:category  ( [ CodeableConcept ] ... ) ; # 0..* General type of observation
  fhir:code [ CodeableConcept ] ; # 1..1 Type of observation
  fhir:permittedDataType  ( [ code ] ... ) ; # 0..* I Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period
  fhir:multipleResultsAllowed [ boolean ] ; # 0..1 Multiple results allowed for conforming observations
  fhir:bodySite [ CodeableConcept ] ; # 0..1 Body part to be observed
  fhir:method [ CodeableConcept ] ; # 0..1 Method used to produce the observation
  fhir:specimen  ( [ Reference(SpecimenDefinition) ] ... ) ; # 0..* Kind of specimen used by this type of observation
  fhir:device  ( [ Reference(Device|DeviceDefinition) ] ... ) ; # 0..* Measurement device or model of device
  fhir:preferredReportName [ string ] ; # 0..1 The preferred name to be used when reporting the observation results
  fhir:permittedUnit  ( [ Coding ] ... ) ; # 0..* I Unit for quantitative results
  fhir:qualifiedValue ( [ # 0..* Set of qualified values for observation results
    fhir:context [ CodeableConcept ] ; # 0..1 Context qualifier for the set of qualified values
    fhir:appliesTo  ( [ CodeableConcept ] ... ) ; # 0..* Targetted population for the set of qualified values
    fhir:gender [ code ] ; # 0..1 male | female | other | unknown
    fhir:age [ Range ] ; # 0..1 Applicable age range for the set of qualified values
    fhir:gestationalAge [ Range ] ; # 0..1 Applicable gestational age range for the set of qualified values
    fhir:condition [ string ] ; # 0..1 Condition associated with the set of qualified values
    fhir:rangeCategory [ code ] ; # 0..1 reference | critical | absolute
    fhir:range [ Range ] ; # 0..1 The range for continuous or ordinal observations
    fhir:validCodedValueSet [ canonical(ValueSet) ] ; # 0..1 Value set of valid coded values as part of this set of qualified values
    fhir:normalCodedValueSet [ canonical(ValueSet) ] ; # 0..1 Value set of normal coded values as part of this set of qualified values
    fhir:abnormalCodedValueSet [ canonical(ValueSet) ] ; # 0..1 Value set of abnormal coded values as part of this set of qualified values
    fhir:criticalCodedValueSet [ canonical(ValueSet) ] ; # 0..1 Value set of critical coded values as part of this set of qualified values
  ] ... ) ;
  fhir:hasMember  ( [ Reference(ObservationDefinition|Questionnaire) ] ... ) ; # 0..* Definitions of related resources belonging to this kind of observation group
  fhir:component ( [ # 0..* Component results
    fhir:code [ CodeableConcept ] ; # 1..1 Type of observation
    fhir:permittedDataType  ( [ code ] ... ) ; # 0..* I Quantity | CodeableConcept | string | boolean | integer | Range | Ratio | SampledData | time | dateTime | Period
    fhir:permittedUnit  ( [ Coding ] ... ) ; # 0..* I Unit for quantitative results
    fhir:qualifiedValue  ( [ See ObservationDefinition.qualifiedValue ] ... ) ; # 0..* Set of qualified values for observation results
  ] ... ) ;

]

Changes since Release 3 from both R4 and R4B

ObservationDefinition
ObservationDefinition.url
  • Added Element
ObservationDefinition.identifier
  • Max Cardinality changed from * to 1
ObservationDefinition.version
  • Added Element
ObservationDefinition.versionAlgorithm[x]
  • Added Element
ObservationDefinition.name
  • Added Element
ObservationDefinition.title
  • Added Element
ObservationDefinition.status
  • Added Mandatory Element
ObservationDefinition.experimental
  • Added Element
ObservationDefinition.date
  • Added Element
ObservationDefinition.publisher
  • Added Element
ObservationDefinition.contact
  • Added Element
ObservationDefinition.description
  • Added Element
ObservationDefinition.useContext
  • Added Element
ObservationDefinition.jurisdiction
  • Added Element
ObservationDefinition.purpose
  • Added Element
ObservationDefinition.copyright
  • Added Element
ObservationDefinition.copyrightLabel
  • Added Element
ObservationDefinition.approvalDate
  • Added Element
ObservationDefinition.lastReviewDate
  • Added Element
ObservationDefinition.effectivePeriod
  • Added Element
ObservationDefinition.derivedFromCanonical
  • Added Element
ObservationDefinition.derivedFromUri
  • Added Element
ObservationDefinition.subject
  • Added Element
ObservationDefinition.performerType
  • Added Element
ObservationDefinition.bodySite
  • Added Element
ObservationDefinition.specimen
  • Added Element
ObservationDefinition.device
  • Added Element
ObservationDefinition.permittedUnit
  • Added Element
ObservationDefinition.qualifiedValue
  • Added Element
ObservationDefinition.qualifiedValue.context
  • Added Element
ObservationDefinition.qualifiedValue.appliesTo
  • Added Element
ObservationDefinition.qualifiedValue.gender
  • Added Element
ObservationDefinition.qualifiedValue.age
  • Added Element
ObservationDefinition.qualifiedValue.gestationalAge
  • Added Element
ObservationDefinition.qualifiedValue.condition
  • Added Element
ObservationDefinition.qualifiedValue.rangeCategory
  • Added Element
ObservationDefinition.qualifiedValue.range
  • Added Element
ObservationDefinition.qualifiedValue.validCodedValueSet
  • Added Element
ObservationDefinition.qualifiedValue.normalCodedValueSet
  • Added Element
ObservationDefinition.qualifiedValue.abnormalCodedValueSet
  • Added Element
ObservationDefinition.qualifiedValue.criticalCodedValueSet
  • Added Element
ObservationDefinition.hasMember
  • Added Element
ObservationDefinition.component
  • Added Element
ObservationDefinition.component.code
  • Added Mandatory Element
ObservationDefinition.component.permittedDataType
  • Added Element
ObservationDefinition.component.permittedUnit
  • Added Element
ObservationDefinition.component.qualifiedValue
  • Added Element
ObservationDefinition.quantitativeDetails
  • Deleted
ObservationDefinition.qualifiedInterval
  • Deleted
ObservationDefinition.validCodedValueSet
  • Deleted
ObservationDefinition.normalCodedValueSet
  • Deleted
ObservationDefinition.abnormalCodedValueSet
  • Deleted
ObservationDefinition.criticalCodedValueSet
  • Deleted

This resource did not exist in Release 2 See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .

 

See the Profiles & Extensions and the alternate Additional definitions: Master Definition XML + JSON , XML Schema / Schematron + JSON Schema , ShEx (for Turtle ) + see , the extensions spreadsheet version & the dependency analysis

ObservationDefinition.qualifiedInterval.category ObservationDefinition.qualifiedInterval.context
Path Definition ValueSet Type Reference Documentation
ObservationDefinition.versionAlgorithm[x] VersionAlgorithm Extensible

Indicates the mechanism used to compare versions to determine which is more current.

ObservationDefinition.status PublicationStatus Required

The lifecycle status of an artifact.

ObservationDefinition.jurisdiction JurisdictionValueSet Extensible

This value set defines a base set of codes for country, country subdivision and region for indicating where a resource is intended to be used.

Note: The codes for countries and country subdivisions are taken from ISO 3166 icon while the codes for "supra-national" regions are from UN Standard country or area codes for statistical use (M49) icon.

ObservationDefinition.category Codes for high level observation categories. ObservationCategoryCodes Example ObservationCategoryCodes

Observation Category codes.

ObservationDefinition.code Codes identifying names of simple observations. LOINCCodes (a valid code from LOINC icon ) Example LOINCCodes

This value set includes all LOINC codes

ObservationDefinition.permittedDataType ObservationDataType Required

Permitted data type for observation value.

ObservationDefinition.bodySite SNOMEDCTBodyStructures Required Example ObservationDataType

This value set includes all codes from SNOMED CT icon where concept is-a 442083009 (Anatomical or acquired body site (body structure)).

ObservationDefinition.method Methods for simple observations. ObservationMethods Example ObservationMethods

Observation Method codes from SNOMED CT icon where concept is-a 272394005 (Technique (qualifier value)) or is-a 129264002 (Action (qualifier value)) or is-a 386053000 (Evaluation procedure(procedure))

ObservationDefinition.quantitativeDetails.customaryUnit ObservationDefinition.quantitativeDetails.unit ObservationDefinition.permittedUnit Codes identifying units UCUMCodes (a valid code from UCUM icon ) Preferred

Unified Code for Units of measure. Measure (UCUM). This value set includes all UCUM codes

ObservationDefinition.qualifiedValue.context ObservationReferenceRangeMeaningCodes Extensible UCUMCodes

This value set defines a set of codes that can be used to indicate the meaning/use of a reference range for a particular target population.

ObservationDefinition.qualifiedValue.appliesTo ObservationReferenceRangeAppliesToCodes Example

This value set defines a set of codes that can be used to indicate the particular target population the reference range applies to.

ObservationDefinition.qualifiedValue.gender AdministrativeGender Required

The gender of a person used for administrative purposes.

ObservationDefinition.qualifiedValue.rangeCategory ObservationRangeCategory Required

Codes identifying the category of observation range.

ObservationDefinition.component.code LOINCCodes (a valid code from LOINC icon ) Example

This value set includes all LOINC codes

ObservationDefinition.component.permittedDataType ObservationDataType Required ObservationRangeCategory

Permitted data type for observation value.

ObservationDefinition.component.permittedUnit UCUMCodes (a valid code from UCUM icon ) Preferred

Unified Code identifying the health context for Units of a range. Measure (UCUM). This value set includes all UCUM codes

ObservationReferenceRangeMeaningCodes ObservationDefinition.qualifiedInterval.appliesTo Codes identifying
UniqueKey Extensible Level Location Description Expression
img  cnl-0 Warning (base) Name should be usable as an identifier for the module by machine processing applications such as code generation name.exists() implies name.matches('^[A-Z]([A-Za-z0-9_]){1,254}$')
img  obd-0 Rule (base) If permittedUnit exists, then permittedDataType=Quantity must exist. permittedUnit.exists() implies (permittedDataType = 'Quantity').exists()
img  obd-1 Rule ObservationDefinition.component If permittedUnit exists, then permittedDataType=Quantity must exist. permittedUnit.exists() implies (permittedDataType = 'Quantity').exists()

Search parameters for this resource. See also the population full list of search parameters for this resource , and check the reference range applies to. Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

ObservationDefinition.qualifiedInterval.gender
Name Example Type Description Expression In Common
category ObservationReferenceRangeAppliesToCodes token Category (class) of observation ObservationDefinition.category
code token Observation code ObservationDefinition.code
experimental token Not for genuine usage (true) ObservationDefinition.experimental
identifier token The gender unique identifier associated with the specimen definition ObservationDefinition.identifier 34 Resources
method token Method of a person used for administrative purposes. observation ObservationDefinition.method Required
status AdministrativeGender token Publication status of the ObservationDefinition: draft, active, retired, unknown ObservationDefinition.status 35 Resources
title string Human-friendly name of the ObservationDefinition ObservationDefinition.title 27 Resources
url uri The uri that identifies the observation definition ObservationDefinition.url 34 Resources