Clinical Practice Guidelines (CPG) on EBMonFHIR
1.0.2 - qa-preview

This page is part of the CPG-on-EBMonFHIR Implementation Guide (1.0.2).

Resource Profile: Outcome Definition

Defining URL:https://www.netzwerk-universitaetsmedizin.de/fhir/cpg-on-ebm-on-fhir/StructureDefinition/outcome-definition
Version:0.1.1
Name:OutcomeDefinition
Title:Outcome Definition
Status:Draft as of 2022-05-15
Definition:

Description of the outcome element of a PICO construct that evidence is about.

Publisher:Netzwerk Universitätsmedizin (NUM),
Source Resource:XML / JSON / Turtle

The official URL for this profile is: 

https://www.netzwerk-universitaetsmedizin.de/fhir/cpg-on-ebm-on-fhir/StructureDefinition/outcome-definition

Guidance

This profile describe the metadata of the outcome for a specific Recommendation and references or specifies the (expected) outcomes of the intervention on the population.

Field Description
characteristicCombination Fixed to #all-of, implying that this recommendation leads to all of the described outcomes.
characteristic.type Type of outcome.
characteristic.definition CodeableConcept or Reference to a resource describing the (expected) outcome.
characteristic.exclude Fixed to false.

This profile of a FHIR EvidenceVariable is derived from the pico-evidence-variable FHIR resource.

Formal Views of Profile Content

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

NameFlagsCard.TypeDescription & Constraintsdoco
.. EvidenceVariable C 0..* PICOEvidenceVariable A definition of an exposure, outcome, or other variable
cnl-0: Name should be usable as an identifier for the module by machine processing applications such as code generation
... id Σ 0..1 id Logical id of this artifact
... meta SΣ 1..1 Meta Metadata about the resource
.... id 0..1 id Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... versionId Σ 0..1 id Version specific identifier
.... lastUpdated Σ 0..1 instant When the resource version last changed
.... source SΣ 0..1 uri Identifies where the resource comes from
.... profile SΣ 1..* canonical(StructureDefinition) Profiles this resource claims to conform to
.... security Σ 0..* Coding Security Labels applied to this resource
Binding: AllSecurityLabels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.


.... tag Σ 0..* Coding Tags applied to this resource
Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".


... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... language 0..1 code Language of the resource content
Binding: AllLanguages (required): IETF language tag for a human language

Additional BindingsPurpose
CommonLanguages Starter Set
... text 0..1 Narrative Text summary of the resource, for human interpretation
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
... url ΣC 0..1 uri Canonical identifier for this evidence variable, represented as a URI (globally unique)
cnl-1: URL should not contain | or # - these characters make processing canonical references problematic
... identifier Σ 0..* Identifier Additional identifier for the evidence variable
... version Σ 0..1 string Business version of the evidence variable
... versionAlgorithm[x] Σ 0..1 How to compare versions
Binding: VersionAlgorithm (extensible)
.... versionAlgorithmString string
.... versionAlgorithmCoding Coding
... name SΣC 1..1 string Name for this evidence variable (computer friendly)
... title Σ 0..1 string Name for this evidence variable (human friendly)
... shortTitle Σ 0..1 string Title for use in informal contexts
... status ?!SΣ 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... experimental 0..1 boolean For testing purposes, not real usage
... date Σ 0..1 dateTime Date last changed
... publisher Σ 0..1 string Name of the publisher/steward (organization or individual)
... contact Σ 0..* ContactDetail Contact details for the publisher
... description Σ 0..1 markdown Natural language description of the evidence variable
... note 0..* Annotation Used for footnotes or explanatory notes
... useContext Σ 0..* UsageContext The context that the content is intended to support
... purpose 0..1 markdown Why this EvidenceVariable is defined
... copyright 0..1 markdown Use and/or publishing restrictions
... copyrightLabel 0..1 string Copyright holder and year(s)
... approvalDate 0..1 date When the resource was approved by publisher
... lastReviewDate 0..1 date When the resource was last reviewed by the publisher
... effectivePeriod 0..1 Period When the resource is expected to be used
... author 0..* ContactDetail Who authored the content
... editor 0..* ContactDetail Who edited the content
... reviewer 0..* ContactDetail Who reviewed the content
... endorser 0..* ContactDetail Who endorsed the content
... relatedArtifact 0..* RelatedArtifact Additional documentation, citations, etc
... actual 0..1 boolean Actual or conceptual
... characteristic SΣC 1..* BackboneElement A defining factor of the EvidenceVariable
evv-1: In a characteristic, at most one of these six elements shall be used: definitionReference or definitionCanonical or definitionCodeableConcept or definitionId or definitionByTypeAndValue or definitionByCombination
evidence-variable-unique-definition: For each characteristic, one and only one type of definition must exist
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... linkId 0..1 id Label for internal linking
.... description 0..1 markdown Natural language description of the characteristic
.... note 0..* Annotation Used for footnotes or explanatory notes
.... exclude 1..1 boolean Whether the characteristic is an inclusion criterion or exclusion criterion
.... definitionCodeableConcept ΣC 0..1 CodeableConcept Defines the characteristic (without using type and value) by a CodeableConcept
.... definitionByTypeAndValue ΣC 0..1 BackboneElement Defines the characteristic using type and value
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... type Σ 1..1 CodeableConcept Expresses the type of characteristic
Binding: UsageContextType (example)
..... method 0..* CodeableConcept Method for how the characteristic value was determined
Binding: DefinitionMethod (example)
..... device 0..1 Reference(Device | DeviceMetric) Device used for determining characteristic
..... value[x] Σ 1..1 Defines the characteristic when coupled with characteristic.type
...... valueCodeableConcept CodeableConcept
...... valueBoolean boolean
...... valueQuantity Quantity
...... valueRange Range
...... valueReference Reference(Any)
...... valueId id
..... offset 0..1 CodeableConcept Reference point for valueQuantity or valueRange
Binding: CharacteristicOffset (example)
.... definitionByCombination C 0..1 BackboneElement Used to specify how two or more characteristics are combined
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... code 1..1 code all-of | any-of | at-least | at-most | statistical | net-effect | dataset
Binding: CharacteristicCombination (required)
..... threshold 0..1 positiveInt Provides the value of "n" when "at-least" or "at-most" codes are used
..... characteristic SC 1..* See characteristic (EvidenceVariable) A defining factor of the characteristic
evidence-variable-unique-definition: For each characteristic, one and only one type of definition must exist
.... instances[x] 0..1 Number of occurrences meeting the characteristic
..... instancesQuantity Quantity
..... instancesRange Range
.... duration[x] 0..1 Length of time in which the characteristic is met
..... durationQuantity Quantity
..... durationRange Range
.... timeFromEvent 0..* BackboneElement Timing in which the characteristic is determined
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... description 0..1 markdown Human readable description
..... note 0..* Annotation Used for footnotes or explanatory notes
..... event[x] 0..1 The event used as a base point (reference point) in time
Binding: EvidenceVariableEvent (example)
...... eventCodeableConcept CodeableConcept
...... eventReference Reference(Any)
...... eventDateTime dateTime
...... eventId id
..... quantity 0..1 Quantity Used to express the observation at a defined amount of time before or after the event
..... range 0..1 Range Used to express the observation within a period before and/or after the event
... handling S 1..1 code continuous | dichotomous | ordinal | polychotomous
Binding: EvidenceVariableHandling (required)
... category 0..* BackboneElement A grouping for ordinal or polychotomous variables
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... name 0..1 string Description of the grouping
.... value[x] 0..1 Definition of the grouping
..... valueCodeableConcept CodeableConcept
..... valueQuantity Quantity
..... valueRange Range

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. EvidenceVariable 0..* PICOEvidenceVariable A definition of an exposure, outcome, or other variable
... meta Σ 1..1 Meta Metadata about the resource
.... source Σ 0..1 uri Identifies where the resource comes from
.... profile Σ 1..* canonical(StructureDefinition) Profiles this resource claims to conform to
... name ΣC 1..1 string Name for this evidence variable (computer friendly)
... status ?!Σ 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

.... definitionByCombination C 0..1 BackboneElement Used to specify how two or more characteristics are combined
..... characteristic C 1..* See characteristic (EvidenceVariable) A defining factor of the characteristic
evidence-variable-unique-definition: For each characteristic, one and only one type of definition must exist
... handling 1..1 code continuous | dichotomous | ordinal | polychotomous
Binding: EvidenceVariableHandling (required)

doco Documentation for this format

This structure is derived from PICOEvidenceVariable

NameFlagsCard.TypeDescription & Constraintsdoco
.. EvidenceVariable PICOEvidenceVariable
... meta S 1..1 Meta Metadata about the resource
.... source S 0..1 uri Identifies where the resource comes from
.... profile S 1..* canonical(StructureDefinition) Profiles this resource claims to conform to
... characteristic C 1..* BackboneElement A defining factor of the EvidenceVariable
evidence-variable-unique-definition: For each characteristic, one and only one type of definition must exist
.... exclude 1..1 boolean Whether the characteristic is an inclusion criterion or exclusion criterion
.... definitionReference 0..0
.... definitionCanonical 0..0
.... definitionExpression 0..0
.... definitionId 0..0
... handling S 1..1 code continuous | dichotomous | ordinal | polychotomous

doco Documentation for this format

This structure is derived from PICOEvidenceVariable

Summary

Mandatory: 4 elements
Must-Support: 4 elements
Prohibited: 4 elements

 

Other representations of profile: CSV, Excel, Schematron

Terminology Bindings

PathConformanceValueSetURI
EvidenceVariable.meta.securityextensibleAllSecurityLabels
http://hl7.org/fhir/ValueSet/security-labels
from the FHIR Standard
EvidenceVariable.meta.tagexampleCommonTags
http://hl7.org/fhir/ValueSet/common-tags
from the FHIR Standard
EvidenceVariable.languagerequiredAllLanguages
http://hl7.org/fhir/ValueSet/all-languages|5.0.0
from the FHIR Standard
EvidenceVariable.versionAlgorithm[x]extensibleVersionAlgorithm
http://hl7.org/fhir/ValueSet/version-algorithm
from the FHIR Standard
EvidenceVariable.statusrequiredPublicationStatus
http://hl7.org/fhir/ValueSet/publication-status|5.0.0
from the FHIR Standard
EvidenceVariable.characteristic.definitionByTypeAndValue.typeexampleUsageContextType
http://terminology.hl7.org/ValueSet/usage-context-type
EvidenceVariable.characteristic.definitionByTypeAndValue.methodexampleDefinitionMethod
http://hl7.org/fhir/ValueSet/definition-method
from the FHIR Standard
EvidenceVariable.characteristic.definitionByTypeAndValue.offsetexampleCharacteristicOffset
http://hl7.org/fhir/ValueSet/characteristic-offset
from the FHIR Standard
EvidenceVariable.characteristic.definitionByCombination.coderequiredCharacteristicCombination
http://hl7.org/fhir/ValueSet/characteristic-combination|5.0.0
from the FHIR Standard
EvidenceVariable.characteristic.timeFromEvent.event[x]exampleEvidenceVariableEvent
http://hl7.org/fhir/ValueSet/evidence-variable-event
from the FHIR Standard
EvidenceVariable.handlingrequiredEvidenceVariableHandling
http://hl7.org/fhir/ValueSet/variable-handling|5.0.0
from the FHIR Standard