LinuxForHealth FHIR Implementation Guide
8.0.0 - draft United States of America flag

LinuxForHealth FHIR Implementation Guide - Local Development build (v8.0.0). See the Directory of published versions

Extension: Insight - Detailed Descriptions

Active as of 2022-11-10

Definitions for the insight extension.

1. Extension
Definition

Element level insights relating to the element values in the contained resource instance

Optional Extension Element - found in all resources.

2. Extension.extension:path
SliceNamepath
Definition

Path to the FHIR element that the insight pertains to; Multiple array instances for path should only be created when the same set of insight results pertain to more than one path. If insight results are different for each path, then multiple insight elements at the top level insight array should be created instead.

Control0..*
TypeExtension(Path) (Extension Type: string)
3. Extension.extension:insightId
SliceNameinsightId
Definition

ID for the insight as it is known by the source (or source system) that this insight was provided from.

Control0..1
TypeExtension(InsightId) (Extension Type: Identifier)
4. Extension.extension:sourceId
SliceNamesourceId
Definition

The ID of the source of the insight, such as an individual, algorithm, etc. that generated the insight.

Control0..1
TypeExtension(SourceId) (Extension Type: Identifier)
5. Extension.extension:detected
SliceNamedetected
Definition

When the insight evaluation occurred

Control0..1
TypeExtension(Detected) (Extension Type: dateTime)
6. Extension.extension:category
SliceNamecategory
Definition

Top level category classifying the type of insight, such as Natural Language Processing, Data Quality, etc.

Control0..1
TypeExtension(Category) (Extension Type: CodeableConcept)
7. Extension.extension:category.valueCodeableConcept
Control0..1
BindingFor example codes, see Insight Category ValueSet
8. Extension.extension:insightType
SliceNameinsightType
Definition

Code for the specific insight type, such as Phone Number Inconsistent with Area Code

Control0..1
TypeExtension(InsightType) (Extension Type: CodeableConcept)
9. Extension.extension:insightDetail
SliceNameinsightDetail
Definition

Information leveraged to produce the insight results and information specific scoring breakdown when appropriate

Control0..*
TypeExtension(InsightDetail) (Complex Extension)
10. Extension.extension:result
SliceNameresult
Definition

Value specific final insight results

Control0..*
TypeExtension(InsightResultSummary) (Complex Extension)
11. Extension.url
Fixed Valuehttp://linuxforhealth.org/fhir/cdm/StructureDefinition/insight
12. Extension.value[x]
Control0..01
[x] NoteSee Choice of Data Types for further information about how to use [x]
1. Extension
Definition

Element level insights relating to the element values in the contained resource instance

Optional Extension Element - found in all resources.

Control0..* This element is affected by the following invariants: ele-1
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
2. Extension.extension:path
SliceNamepath
Definition

Path to the FHIR element that the insight pertains to; Multiple array instances for path should only be created when the same set of insight results pertain to more than one path. If insight results are different for each path, then multiple insight elements at the top level insight array should be created instead.

Control0..*
TypeExtension(Path) (Extension Type: string)
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
3. Extension.extension:insightId
SliceNameinsightId
Definition

ID for the insight as it is known by the source (or source system) that this insight was provided from.

Control0..1
TypeExtension(InsightId) (Extension Type: Identifier)
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
4. Extension.extension:sourceId
SliceNamesourceId
Definition

The ID of the source of the insight, such as an individual, algorithm, etc. that generated the insight.

Control0..1
TypeExtension(SourceId) (Extension Type: Identifier)
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
5. Extension.extension:detected
SliceNamedetected
Definition

When the insight evaluation occurred

Control0..1
TypeExtension(Detected) (Extension Type: dateTime)
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
6. Extension.extension:category
SliceNamecategory
Definition

Top level category classifying the type of insight, such as Natural Language Processing, Data Quality, etc.

Control0..1
TypeExtension(Category) (Extension Type: CodeableConcept)
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
7. Extension.extension:category.extension
Definition

An Extension

May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

Control0..0*
TypeExtension
Alternate Namesextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
SlicingThis element introduces a set of slices on Extension.extension.extension. The slices are unordered and Open, and can be differentiated using the following discriminators:
  • value @ url
8. Extension.extension:category.url
Definition

Source of the definition for the extension code - a logical name or a URL.

Control1..1
Typeuri
XML RepresentationIn the XML format, this property is represented as an attribute.
Comments

The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

Fixed Valuehttp://linuxforhealth.org/fhir/cdm/StructureDefinition/category
9. Extension.extension:category.value[x]
Definition

Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).

Control0..1
TypeChoice of: CodeableConcept, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, ParameterDefinition, dateTime, code, string, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time
[x] NoteSee Choice of Data Types for further information about how to use [x]
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
SlicingThis element introduces a set of slices on Extension.extension.value[x]. The slices are unordered and Closed, and can be differentiated using the following discriminators:
  • type @ $this
10. Extension.extension:category.value[x]:valueCodeableConcept
SliceNamevalueCodeableConcept
Definition

Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).

Control0..1
BindingFor example codes, see Insight Category ValueSetFor codes, see (unbound)
TypeChoice of: CodeableConcept, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, ParameterDefinition, dateTime, code, string, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time
[x] NoteSee Choice of Data Types for further information about how to use [x]
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
11. Extension.extension:insightType
SliceNameinsightType
Definition

Code for the specific insight type, such as Phone Number Inconsistent with Area Code

Control0..1
TypeExtension(InsightType) (Extension Type: CodeableConcept)
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
12. Extension.extension:insightDetail
SliceNameinsightDetail
Definition

Information leveraged to produce the insight results and information specific scoring breakdown when appropriate

May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

TypeExtension(InsightDetail) (Complex Extension)
InvariantsDefined on this element
ele-1: (: )
ext-1: (: )
13. Extension.extension:result
SliceNameresult
Definition

Value specific final insight results

May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

TypeExtension(InsightResultSummary) (Complex Extension)
InvariantsDefined on this element
ele-1: (: )
ext-1: (: )
14. Extension.url
Definition

Source of the definition for the extension code - a logical name or a URL.

Control1..1
Typeuri
XML RepresentationIn the XML format, this property is represented as an attribute.
Comments

The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

Fixed Valuehttp://linuxforhealth.org/fhir/cdm/StructureDefinition/insight
15. Extension.value[x]
Definition

Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).

Control0..01
TypeChoice of: base64Binary, boolean, canonical, code, date, dateTime, decimal, id, instant, integer, markdown, oid, positiveInt, string, time, unsignedInt, uri, url, uuid, Address, Age, Annotation, Attachment, CodeableConcept, Coding, ContactPoint, Count, Distance, Duration, HumanName, Identifier, Money, Period, Quantity, Range, Ratio, Reference, SampledData, Signature, Timing, ContactDetail, Contributor, DataRequirement, Expression, ParameterDefinition, RelatedArtifact, TriggerDefinition, UsageContext, Dosage, Meta
[x] NoteSee Choice of Data Types for further information about how to use [x]
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
1. Extension
Definition

Element level insights relating to the element values in the contained resource instance

Control0..* This element is affected by the following invariants: ele-1
2. Extension.id
Definition

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

Control0..1
Typestring
XML RepresentationIn the XML format, this property is represented as an attribute.
3. Extension.extension
Definition

May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

Control0..*
TypeExtension
Alternate Namesextensionsuser content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
SlicingThis element introduces a set of slices on Extension.extension. The slices are unordered and Open, and can be differentiated using the following discriminators:
  • value @ url
4. Extension.extension:path
SliceNamepath
Definition

Path to the FHIR element that the insight pertains to; Multiple array instances for path should only be created when the same set of insight results pertain to more than one path. If insight results are different for each path, then multiple insight elements at the top level insight array should be created instead.

Control0..*
TypeExtension(Path) (Extension Type: string)
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
5. Extension.extension:insightId
SliceNameinsightId
Definition

ID for the insight as it is known by the source (or source system) that this insight was provided from.

Control0..1
TypeExtension(InsightId) (Extension Type: Identifier)
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
6. Extension.extension:sourceId
SliceNamesourceId
Definition

The ID of the source of the insight, such as an individual, algorithm, etc. that generated the insight.

Control0..1
TypeExtension(SourceId) (Extension Type: Identifier)
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
7. Extension.extension:detected
SliceNamedetected
Definition

When the insight evaluation occurred

Control0..1
TypeExtension(Detected) (Extension Type: dateTime)
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
8. Extension.extension:category
SliceNamecategory
Definition

Top level category classifying the type of insight, such as Natural Language Processing, Data Quality, etc.

Control0..1
TypeExtension(Category) (Extension Type: CodeableConcept)
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
9. Extension.extension:category.id
Definition

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

Control0..1
Typestring
XML RepresentationIn the XML format, this property is represented as an attribute.
10. Extension.extension:category.extension
Definition

An Extension

Control0..0
TypeExtension
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
SlicingThis element introduces a set of slices on Extension.extension.extension. The slices are unordered and Open, and can be differentiated using the following discriminators:
  • value @ url
11. Extension.extension:category.url
Definition

Source of the definition for the extension code - a logical name or a URL.

Control1..1
Typeuri
XML RepresentationIn the XML format, this property is represented as an attribute.
Comments

The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

Fixed Valuehttp://linuxforhealth.org/fhir/cdm/StructureDefinition/category
12. Extension.extension:category.value[x]
Definition

Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).

Control0..1
TypeCodeableConcept
[x] NoteSee Choice of Data Types for further information about how to use [x]
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
SlicingThis element introduces a set of slices on Extension.extension.value[x]. The slices are unordered and Closed, and can be differentiated using the following discriminators:
  • type @ $this
13. Extension.extension:category.value[x]:valueCodeableConcept
SliceNamevalueCodeableConcept
Definition

Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).

Control0..1
BindingFor example codes, see Insight Category ValueSet
TypeCodeableConcept
[x] NoteSee Choice of Data Types for further information about how to use [x]
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
14. Extension.extension:insightType
SliceNameinsightType
Definition

Code for the specific insight type, such as Phone Number Inconsistent with Area Code

Control0..1
TypeExtension(InsightType) (Extension Type: CodeableConcept)
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
15. Extension.extension:insightDetail
SliceNameinsightDetail
Definition

Information leveraged to produce the insight results and information specific scoring breakdown when appropriate

Control0..*
TypeExtension(InsightDetail) (Complex Extension)
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
16. Extension.extension:result
SliceNameresult
Definition

Value specific final insight results

Control0..*
TypeExtension(InsightResultSummary) (Complex Extension)
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (: extension.exists() != value.exists())
17. Extension.url
Definition

Source of the definition for the extension code - a logical name or a URL.

Control1..1
Typeuri
XML RepresentationIn the XML format, this property is represented as an attribute.
Comments

The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

Fixed Valuehttp://linuxforhealth.org/fhir/cdm/StructureDefinition/insight
18. Extension.value[x]
Definition

Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).

Control0..0
TypeChoice of: base64Binary, boolean, canonical, code, date, dateTime, decimal, id, instant, integer, markdown, oid, positiveInt, string, time, unsignedInt, uri, url, uuid, Address, Age, Annotation, Attachment, CodeableConcept, Coding, ContactPoint, Count, Distance, Duration, HumanName, Identifier, Money, Period, Quantity, Range, Ratio, Reference, SampledData, Signature, Timing, ContactDetail, Contributor, DataRequirement, Expression, ParameterDefinition, RelatedArtifact, TriggerDefinition, UsageContext, Dosage, Meta
[x] NoteSee Choice of Data Types for further information about how to use [x]
InvariantsDefined on this element
ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count()))