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: Evidence Data Set

Defining URL:https://www.netzwerk-universitaetsmedizin.de/fhir/cpg-on-ebm-on-fhir/StructureDefinition/evidence-data-set
Version:0.1.1
Name:EvidenceDataSet
Title:Evidence Data Set
Status:Draft as of 2022-05-15
Definition:

Definition of the outcome used as the observed measured variable for an evidence synthesis.

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/evidence-data-set

Guidance

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 Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... language 0..1 code Language of the resource content
Binding: 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 0..1 boolean Whether the characteristic is an inclusion criterion or exclusion criterion
Required Pattern: false
.... definitionByCombination SC 1..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)
Required Pattern: dataset
..... threshold 0..1 positiveInt Provides the value of "n" when "at-least" or "at-most" codes are used
..... characteristic SC 1..* BackboneElement A defining factor of the characteristic
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 0..1 boolean Whether the characteristic is an inclusion criterion or exclusion criterion
Required Pattern: false
...... definitionReference SΣC 1..1 Reference(Study Outcome Evidence) Defines the characteristic (without using type and value) by a Reference
...... 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
.... 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 0..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
... 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.

... characteristic Σ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
.... definitionByCombination C 1..1 BackboneElement Used to specify how two or more characteristics are combined
..... characteristic C 1..* BackboneElement A defining factor of the characteristic
evidence-variable-unique-definition: For each characteristic, one and only one type of definition must exist
...... definitionReference ΣC 1..1 Reference(Study Outcome Evidence) Defines the characteristic (without using type and value) by a Reference

doco Documentation for this format

This structure is derived from PICOEvidenceVariable

NameFlagsCard.TypeDescription & Constraintsdoco
.. EvidenceVariable 0..* PICOEvidenceVariable A definition of an exposure, outcome, or other variable
... 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 0..1 boolean Whether the characteristic is an inclusion criterion or exclusion criterion
Required Pattern: false
.... definitionReference 0..0
.... definitionCanonical 0..0
.... definitionCodeableConcept 0..0
.... definitionExpression 0..0
.... definitionId 0..0
.... definitionByTypeAndValue 0..0
.... definitionByCombination S 1..1 BackboneElement Used to specify how two or more characteristics are combined
..... code 1..1 code all-of | any-of | at-least | at-most | statistical | net-effect | dataset
Required Pattern: dataset
..... characteristic C 1..* BackboneElement A defining factor of the characteristic
evidence-variable-unique-definition: For each characteristic, one and only one type of definition must exist
...... exclude 0..1 boolean Whether the characteristic is an inclusion criterion or exclusion criterion
Required Pattern: false
...... definitionReference S 1..1 Reference(Study Outcome Evidence) Defines the characteristic (without using type and value) by a Reference
...... definitionCanonical 0..0
...... definitionCodeableConcept 0..0
...... definitionExpression 0..0
...... definitionId 0..0
...... definitionByTypeAndValue 0..0
...... definitionByCombination 0..0

doco Documentation for this format

This structure is derived from PICOEvidenceVariable

Summary

Mandatory: 2 elements
Must-Support: 2 elements
Prohibited: 12 elements

Structures

This structure refers to these other structures:

 

Other representations of profile: CSV, Excel, Schematron

Terminology Bindings

PathConformanceValueSet / CodeURI
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.coderequiredPattern: dataset
http://hl7.org/fhir/ValueSet/characteristic-combination|5.0.0
from the FHIR Standard
EvidenceVariable.characteristic.definitionByCombination.characteristic.definitionByTypeAndValue.typeexampleUsageContextType
http://terminology.hl7.org/ValueSet/usage-context-type
EvidenceVariable.characteristic.definitionByCombination.characteristic.definitionByTypeAndValue.methodexampleDefinitionMethod
http://hl7.org/fhir/ValueSet/definition-method
from the FHIR Standard
EvidenceVariable.characteristic.definitionByCombination.characteristic.definitionByTypeAndValue.offsetexampleCharacteristicOffset
http://hl7.org/fhir/ValueSet/characteristic-offset
from the FHIR Standard
EvidenceVariable.characteristic.definitionByCombination.characteristic.definitionByCombination.coderequiredCharacteristicCombination
http://hl7.org/fhir/ValueSet/characteristic-combination|5.0.0
from the FHIR Standard
EvidenceVariable.characteristic.definitionByCombination.characteristic.timeFromEvent.event[x]exampleEvidenceVariableEvent
http://hl7.org/fhir/ValueSet/evidence-variable-event
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