Release 5 Preview #1

This page is part of the FHIR Specification (v4.2.0: R5 Preview #1). 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

14.10 Resource Evidence - Content

Clinical Decision Support Work GroupMaturity Level: 0 Trial UseSecurity Category: Business Compartments: Not linked to any defined compartments

This represents statistics, certainty, both the intended and actual population, and evidence variables.

14.10.1 Scope and Usage

14.10.2 References

No resources refer to this resource directly.

This resource does not implement any patterns.

14.10.3 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Evidence TUMetadataResourceSingle evidence bit
+ Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation
Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension, url, identifier, version, name, title, status, experimental, date, publisher, contact, description, useContext, jurisdiction, purpose, copyright, approvalDate, lastReviewDate, effectivePeriod
... url Σ0..1uriCanonical identifier for this evidence, represented as a globally unique URI
... identifier Σ0..*IdentifierAdditional identifier for the summary
... version Σ0..1stringBusiness version of this summary
... status ?!Σ1..1codedraft | active | retired | unknown
PublicationStatus (Required)
... date Σ0..1dateTimeDate last changed
... useContext Σ0..*UsageContextUse context
... approvalDate 0..1dateWhen the summary was approved by publisher
... lastReviewDate 0..1dateWhen the summary was last reviewed
... contributor 0..*ContributorContact detail and role for contributor to summary
... relatedArtifact 0..*RelatedArtifactLink or citation to artifact associated with the summary
... description 0..1markdownDescription of the particular summary
... assertion 0..1markdownDeclarative description of the Evidence
... note 0..*AnnotationFootnotes and/or explanatory notes
... referentGroup Σ1..1BackboneElementGroup being referenced
.... description 0..1markdownTextual description of referent group
.... note 0..*AnnotationFootnotes and/or explanatory notes
.... evidenceSource 0..1Reference(Group)Various information categories of group
.... intendedGroup 0..1Reference(Group)Non-actual group that is a set of characteristics
.... directnessMatch 0..1CodeableConceptlow | moderate | high | exact
EvidenceDirectness (Extensible)
... variableDefinition 0..*BackboneElementEvidence variable
.... description 0..1markdownDescription of the variable
.... note 0..*AnnotationFootnotes and/or explanatory notes
.... variableRole 0..1CodeableConceptexposure | referenceExposure | measuredVariable | confounder
EvidenceVariableRole (Extensible)
.... actualDefinition Σ0..1Reference(EvidenceVariable)Definition of the actual variable related to the statistic(s)
.... intendedDefinition 0..1Reference(EvidenceVariable)Definition of the intended variable related to the Evidence
.... directnessMatch 0..1CodeableConceptlow | moderate | high | exact
EvidenceDirectness (Extensible)
... synthesisType 0..1CodeableConceptThe particular type of synthesis if this is a synthesis summary
StatisticSynthesisType (Extensible)
... studyType 0..1CodeableConceptThe type of study that produced this summary
StatisticStudyType (Extensible)
... statistic 0..*StatisticValues and parameters for a single statistic
... distribution 0..*OrderedDistributionAn ordered group of statistics
... certainty 0..*BackboneElementLevel of certainty
.... description 0..1stringTextual description of certainty
.... note 0..1AnnotationFootnotes and/or explanatory notes
.... rating 0..*CodeableConceptRating of certainty
StatisticCertaintyRating (Extensible)
.... certaintySubcomponent 0..*BackboneElementSubcomponent of certainty
..... description 0..1stringTextual description of certainty subcomponent
..... note 0..1AnnotationTextual note of certainty subcomponent
..... type 0..*CodeableConceptFootnotes and/or explanatory notes
StatisticCertaintySubcomponentType (Extensible)
..... rating 0..*CodeableConceptRating of certainty subcomponent
StatisticCertaintySubcomponentRating (Extensible)

doco Documentation for this format

UML Diagram (Legend)

Evidence (MetadataResource)An absolute URI that is used to identify this evidence when it is referenced in a specification, model, design or an instance; also called its canonical identifier. This SHOULD be globally unique and SHOULD be a literal address at which at which an authoritative instance of this summary is (or will be) published. This URL can be the target of a canonical reference. It SHALL remain the same when the summary is stored on different serversurl : uri [0..1]A formal identifier that is used to identify this summary when it is represented in other formats, or referenced in a specification, model, design or an instanceidentifier : Identifier [0..*]The identifier that is used to identify this version of the summary when it is referenced in a specification, model, design or instance. This is an arbitrary value managed by the summary 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 can be placed in a lexicographical sequenceversion : string [0..1]A short, descriptive, user-friendly title for the summarytitle : string [0..1]The status of this summary. Enables tracking the life-cycle of the content (this element modifies the meaning of other elements)status : code [1..1] « The lifecycle status of an artifact. (Strength=Required)PublicationStatus! »The date (and optionally time) when the summary was published. 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 summary changesdate : dateTime [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 evidence instancesuseContext : UsageContext [0..*]The date on which the resource content was approved by the publisher. Approval happens once when the content is officially approved for usageapprovalDate : date [0..1]The date on which the resource content was last reviewed. Review happens periodically after approval but does not change the original approval datelastReviewDate : date [0..1]Contact detail and role for contributor to summarycontributor : Contributor [0..*]Link or citation to artifact associated with the summaryrelatedArtifact : RelatedArtifact [0..*]A free text natural language description of the evidence from a consumer's perspectivedescription : markdown [0..1]Declarative description of the Evidenceassertion : markdown [0..1]Footnotes and/or explanatory notesnote : Annotation [0..*]The particular type of synthesis if this is a synthesis summarysynthesisType : CodeableConcept [0..1] « Types of combining results from a body of evidence (eg. summary data meta-analysis). (Strength=Extensible)StatisticSynthesisType+ »The type of study that produced this summarystudyType : CodeableConcept [0..1] « The type of study a statistic was derived from. (Strength=Extensible)StatisticStudyType+ »The statistic value(s)statistic : Statistic [0..*]Ordered distributiondistribution : OrderedDistribution [0..*]ReferentGroupTextual description of referent groupdescription : markdown [0..1]Footnotes and/or explanatory notesnote : Annotation [0..*]Various information categories of groupevidenceSource : Reference [0..1] « Group »Non-actual group that is a set of characteristicsintendedGroup : Reference [0..1] « Group »Indication of quality of match between intended group to actual groupdirectnessMatch : CodeableConcept [0..1] « The quality of how direct the match is. (Strength=Extensible)EvidenceDirectness+ »VariableDefinitionDescription of the variabledescription : markdown [0..1]Footnotes and/or explanatory notesnote : Annotation [0..*]exposure | referenceExposure | measuredVariable | confoundervariableRole : CodeableConcept [0..1] « The role that the assertion variable plays. (Strength=Extensible)EvidenceVariableRole+ »Definition of the actual variable related to the statistic(s)actualDefinition : Reference [0..1] « EvidenceVariable »Definition of the intended variable related to the EvidenceintendedDefinition : Reference [0..1] « EvidenceVariable »Indication of quality of match between intended variable to actual variabledirectnessMatch : CodeableConcept [0..1] « The quality of how direct the match is. (Strength=Extensible)EvidenceDirectness+ »CertaintyTextual description of certaintydescription : string [0..1]Footnotes and/or explanatory notesnote : Annotation [0..1]Rating of certaintyrating : CodeableConcept [0..*] « The relative quality of the statistic. (Strength=Extensible)StatisticCertaintyRating+ »CertaintySubcomponentTextual description of certainty subcomponentdescription : string [0..1]Textual note of certainty subcomponentnote : Annotation [0..1]Footnotes and/or explanatory notestype : CodeableConcept [0..*] « The subcomponent classification of quality of evidence rating systems. (Strength=Extensible)StatisticCertaintySubcomponen...+ »Rating of certainty subcomponentrating : CodeableConcept [0..*] « The quality rating of the subcomponent of a quality of evidence rating. (Strength=Extensible)StatisticCertaintySubcomponen...+ »Group being referencedreferentGroup[1..1]Evidence variablevariableDefinition[0..*]Subcomponent of certaintycertaintySubcomponent[0..*]Level of certaintycertainty[0..*]

XML Template

<Evidence xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <url value="[uri]"/><!-- 0..1 Canonical identifier for this evidence, represented as a globally unique URI -->
 <identifier><!-- 0..* Identifier Additional identifier for the summary --></identifier>
 <version value="[string]"/><!-- 0..1 Business version of this summary -->
 <title value="[string]"/><!-- 0..1 Name for this summary (human friendly) -->
 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <date value="[dateTime]"/><!-- 0..1 Date last changed -->
 <useContext><!-- 0..* UsageContext Use context --></useContext>
 <approvalDate value="[date]"/><!-- 0..1 When the summary was approved by publisher -->
 <lastReviewDate value="[date]"/><!-- 0..1 When the summary was last reviewed -->
 <contributor><!-- 0..* Contributor Contact detail and role for contributor to summary --></contributor>
 <relatedArtifact><!-- 0..* RelatedArtifact Link or citation to artifact associated with the summary --></relatedArtifact>
 <description value="[markdown]"/><!-- 0..1 Description of the particular summary -->
 <assertion value="[markdown]"/><!-- 0..1 Declarative description of the Evidence -->
 <note><!-- 0..* Annotation Footnotes and/or explanatory notes --></note>
 <referentGroup>  <!-- 1..1 Group being referenced -->
  <description value="[markdown]"/><!-- 0..1 Textual description of referent group -->
  <note><!-- 0..* Annotation Footnotes and/or explanatory notes --></note>
  <evidenceSource><!-- 0..1 Reference(Group) Various information categories of group --></evidenceSource>
  <intendedGroup><!-- 0..1 Reference(Group) Non-actual group that is a set of characteristics --></intendedGroup>
  <directnessMatch><!-- 0..1 CodeableConcept low | moderate | high | exact --></directnessMatch>
 </referentGroup>
 <variableDefinition>  <!-- 0..* Evidence variable -->
  <description value="[markdown]"/><!-- 0..1 Description of the variable -->
  <note><!-- 0..* Annotation Footnotes and/or explanatory notes --></note>
  <variableRole><!-- 0..1 CodeableConcept exposure | referenceExposure | measuredVariable | confounder --></variableRole>
  <actualDefinition><!-- 0..1 Reference(EvidenceVariable) Definition of the actual variable related to the statistic(s) --></actualDefinition>
  <intendedDefinition><!-- 0..1 Reference(EvidenceVariable) Definition of the intended variable related to the Evidence --></intendedDefinition>
  <directnessMatch><!-- 0..1 CodeableConcept low | moderate | high | exact --></directnessMatch>
 </variableDefinition>
 <synthesisType><!-- 0..1 CodeableConcept The particular type of synthesis if this is a synthesis summary --></synthesisType>
 <studyType><!-- 0..1 CodeableConcept The type of study that produced this summary --></studyType>
 <statistic><!-- 0..* Statistic Values and parameters for a single statistic --></statistic>
 <distribution><!-- 0..* OrderedDistribution An ordered group of statistics --></distribution>
 <certainty>  <!-- 0..* Level of certainty -->
  <description value="[string]"/><!-- 0..1 Textual description of certainty -->
  <note><!-- 0..1 Annotation Footnotes and/or explanatory notes --></note>
  <rating><!-- 0..* CodeableConcept Rating of certainty --></rating>
  <certaintySubcomponent>  <!-- 0..* Subcomponent of certainty -->
   <description value="[string]"/><!-- 0..1 Textual description of certainty subcomponent -->
   <note><!-- 0..1 Annotation Textual note of certainty subcomponent --></note>
   <type><!-- 0..* CodeableConcept Footnotes and/or explanatory notes --></type>
   <rating><!-- 0..* CodeableConcept Rating of certainty subcomponent --></rating>
  </certaintySubcomponent>
 </certainty>
</Evidence>

JSON Template

{doco
  "resourceType" : "Evidence",
  // from Resource: id, meta, implicitRules, and language
  "url" : "<uri>", // Canonical identifier for this evidence, represented as a globally unique URI
  "identifier" : [{ Identifier }], // Additional identifier for the summary
  "version" : "<string>", // Business version of this summary
  "title" : "<string>", // Name for this summary (human friendly)
  "status" : "<code>", // R!  draft | active | retired | unknown
  "date" : "<dateTime>", // Date last changed
  "useContext" : [{ UsageContext }], // Use context
  "approvalDate" : "<date>", // When the summary was approved by publisher
  "lastReviewDate" : "<date>", // When the summary was last reviewed
  "contributor" : [{ Contributor }], // Contact detail and role for contributor to summary
  "relatedArtifact" : [{ RelatedArtifact }], // Link or citation to artifact associated with the summary
  "description" : "<markdown>", // Description of the particular summary
  "assertion" : "<markdown>", // Declarative description of the Evidence
  "note" : [{ Annotation }], // Footnotes and/or explanatory notes
  "referentGroup" : { // R!  Group being referenced
    "description" : "<markdown>", // Textual description of referent group
    "note" : [{ Annotation }], // Footnotes and/or explanatory notes
    "evidenceSource" : { Reference(Group) }, // Various information categories of group
    "intendedGroup" : { Reference(Group) }, // Non-actual group that is a set of characteristics
    "directnessMatch" : { CodeableConcept } // low | moderate | high | exact
  },
  "variableDefinition" : [{ // Evidence variable
    "description" : "<markdown>", // Description of the variable
    "note" : [{ Annotation }], // Footnotes and/or explanatory notes
    "variableRole" : { CodeableConcept }, // exposure | referenceExposure | measuredVariable | confounder
    "actualDefinition" : { Reference(EvidenceVariable) }, // Definition of the actual variable related to the statistic(s)
    "intendedDefinition" : { Reference(EvidenceVariable) }, // Definition of the intended variable related to the Evidence
    "directnessMatch" : { CodeableConcept } // low | moderate | high | exact
  }],
  "synthesisType" : { CodeableConcept }, // The particular type of synthesis if this is a synthesis summary
  "studyType" : { CodeableConcept }, // The type of study that produced this summary
  "statistic" : [{ Statistic }], // Values and parameters for a single statistic
  "distribution" : [{ OrderedDistribution }], // An ordered group of statistics
  "certainty" : [{ // Level of certainty
    "description" : "<string>", // Textual description of certainty
    "note" : { Annotation }, // Footnotes and/or explanatory notes
    "rating" : [{ CodeableConcept }], // Rating of certainty
    "certaintySubcomponent" : [{ // Subcomponent of certainty
      "description" : "<string>", // Textual description of certainty subcomponent
      "note" : { Annotation }, // Textual note of certainty subcomponent
      "type" : [{ CodeableConcept }], // Footnotes and/or explanatory notes
      "rating" : [{ CodeableConcept }] // Rating of certainty subcomponent
    }]
  }]
}

Turtle Template

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


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

  # from Resource: .id, .meta, .implicitRules, and .language
  fhir:Evidence.url [ uri ]; # 0..1 Canonical identifier for this evidence, represented as a globally unique URI
  fhir:Evidence.identifier [ Identifier ], ... ; # 0..* Additional identifier for the summary
  fhir:Evidence.version [ string ]; # 0..1 Business version of this summary
  fhir:Evidence.title [ string ]; # 0..1 Name for this summary (human friendly)
  fhir:Evidence.status [ code ]; # 1..1 draft | active | retired | unknown
  fhir:Evidence.date [ dateTime ]; # 0..1 Date last changed
  fhir:Evidence.useContext [ UsageContext ], ... ; # 0..* Use context
  fhir:Evidence.approvalDate [ date ]; # 0..1 When the summary was approved by publisher
  fhir:Evidence.lastReviewDate [ date ]; # 0..1 When the summary was last reviewed
  fhir:Evidence.contributor [ Contributor ], ... ; # 0..* Contact detail and role for contributor to summary
  fhir:Evidence.relatedArtifact [ RelatedArtifact ], ... ; # 0..* Link or citation to artifact associated with the summary
  fhir:Evidence.description [ markdown ]; # 0..1 Description of the particular summary
  fhir:Evidence.assertion [ markdown ]; # 0..1 Declarative description of the Evidence
  fhir:Evidence.note [ Annotation ], ... ; # 0..* Footnotes and/or explanatory notes
  fhir:Evidence.referentGroup [ # 1..1 Group being referenced
    fhir:Evidence.referentGroup.description [ markdown ]; # 0..1 Textual description of referent group
    fhir:Evidence.referentGroup.note [ Annotation ], ... ; # 0..* Footnotes and/or explanatory notes
    fhir:Evidence.referentGroup.evidenceSource [ Reference(Group) ]; # 0..1 Various information categories of group
    fhir:Evidence.referentGroup.intendedGroup [ Reference(Group) ]; # 0..1 Non-actual group that is a set of characteristics
    fhir:Evidence.referentGroup.directnessMatch [ CodeableConcept ]; # 0..1 low | moderate | high | exact
  ];
  fhir:Evidence.variableDefinition [ # 0..* Evidence variable
    fhir:Evidence.variableDefinition.description [ markdown ]; # 0..1 Description of the variable
    fhir:Evidence.variableDefinition.note [ Annotation ], ... ; # 0..* Footnotes and/or explanatory notes
    fhir:Evidence.variableDefinition.variableRole [ CodeableConcept ]; # 0..1 exposure | referenceExposure | measuredVariable | confounder
    fhir:Evidence.variableDefinition.actualDefinition [ Reference(EvidenceVariable) ]; # 0..1 Definition of the actual variable related to the statistic(s)
    fhir:Evidence.variableDefinition.intendedDefinition [ Reference(EvidenceVariable) ]; # 0..1 Definition of the intended variable related to the Evidence
    fhir:Evidence.variableDefinition.directnessMatch [ CodeableConcept ]; # 0..1 low | moderate | high | exact
  ], ...;
  fhir:Evidence.synthesisType [ CodeableConcept ]; # 0..1 The particular type of synthesis if this is a synthesis summary
  fhir:Evidence.studyType [ CodeableConcept ]; # 0..1 The type of study that produced this summary
  fhir:Evidence.statistic [ Statistic ], ... ; # 0..* Values and parameters for a single statistic
  fhir:Evidence.distribution [ OrderedDistribution ], ... ; # 0..* An ordered group of statistics
  fhir:Evidence.certainty [ # 0..* Level of certainty
    fhir:Evidence.certainty.description [ string ]; # 0..1 Textual description of certainty
    fhir:Evidence.certainty.note [ Annotation ]; # 0..1 Footnotes and/or explanatory notes
    fhir:Evidence.certainty.rating [ CodeableConcept ], ... ; # 0..* Rating of certainty
    fhir:Evidence.certainty.certaintySubcomponent [ # 0..* Subcomponent of certainty
      fhir:Evidence.certainty.certaintySubcomponent.description [ string ]; # 0..1 Textual description of certainty subcomponent
      fhir:Evidence.certainty.certaintySubcomponent.note [ Annotation ]; # 0..1 Textual note of certainty subcomponent
      fhir:Evidence.certainty.certaintySubcomponent.type [ CodeableConcept ], ... ; # 0..* Footnotes and/or explanatory notes
      fhir:Evidence.certainty.certaintySubcomponent.rating [ CodeableConcept ], ... ; # 0..* Rating of certainty subcomponent
    ], ...;
  ], ...;
]

Changes since R3

Evidence
Evidence.status
  • Change value set from http://hl7.org/fhir/ValueSet/publication-status|4.0.0 to http://hl7.org/fhir/ValueSet/publication-status|4.2.0
Evidence.contributor
  • Added Element
Evidence.assertion
  • Added Element
Evidence.referentGroup
  • Added Mandatory Element
Evidence.referentGroup.description
  • Added Element
Evidence.referentGroup.note
  • Added Element
Evidence.referentGroup.evidenceSource
  • Added Element
Evidence.referentGroup.intendedGroup
  • Added Element
Evidence.referentGroup.directnessMatch
  • Added Element
Evidence.variableDefinition
  • Added Element
Evidence.variableDefinition.description
  • Added Element
Evidence.variableDefinition.note
  • Added Element
Evidence.variableDefinition.variableRole
  • Added Element
Evidence.variableDefinition.actualDefinition
  • Added Element
Evidence.variableDefinition.intendedDefinition
  • Added Element
Evidence.variableDefinition.directnessMatch
  • Added Element
Evidence.synthesisType
  • Added Element
Evidence.studyType
  • Added Element
Evidence.statistic
  • Added Element
Evidence.distribution
  • Added Element
Evidence.certainty
  • Added Element
Evidence.certainty.description
  • Added Element
Evidence.certainty.note
  • Added Element
Evidence.certainty.rating
  • Added Element
Evidence.certainty.certaintySubcomponent
  • Added Element
Evidence.certainty.certaintySubcomponent.description
  • Added Element
Evidence.certainty.certaintySubcomponent.note
  • Added Element
Evidence.certainty.certaintySubcomponent.type
  • Added Element
Evidence.certainty.certaintySubcomponent.rating
  • Added Element
Evidence.name
  • deleted
Evidence.shortTitle
  • deleted
Evidence.subtitle
  • deleted
Evidence.publisher
  • deleted
Evidence.contact
  • deleted
Evidence.jurisdiction
  • deleted
Evidence.copyright
  • deleted
Evidence.effectivePeriod
  • deleted
Evidence.topic
  • deleted
Evidence.author
  • deleted
Evidence.editor
  • deleted
Evidence.reviewer
  • deleted
Evidence.endorser
  • deleted
Evidence.exposureBackground
  • deleted
Evidence.exposureVariant
  • deleted
Evidence.outcome
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON.

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Evidence TUMetadataResourceSingle evidence bit
+ Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation
Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension, url, identifier, version, name, title, status, experimental, date, publisher, contact, description, useContext, jurisdiction, purpose, copyright, approvalDate, lastReviewDate, effectivePeriod
... url Σ0..1uriCanonical identifier for this evidence, represented as a globally unique URI
... identifier Σ0..*IdentifierAdditional identifier for the summary
... version Σ0..1stringBusiness version of this summary
... status ?!Σ1..1codedraft | active | retired | unknown
PublicationStatus (Required)
... date Σ0..1dateTimeDate last changed
... useContext Σ0..*UsageContextUse context
... approvalDate 0..1dateWhen the summary was approved by publisher
... lastReviewDate 0..1dateWhen the summary was last reviewed
... contributor 0..*ContributorContact detail and role for contributor to summary
... relatedArtifact 0..*RelatedArtifactLink or citation to artifact associated with the summary
... description 0..1markdownDescription of the particular summary
... assertion 0..1markdownDeclarative description of the Evidence
... note 0..*AnnotationFootnotes and/or explanatory notes
... referentGroup Σ1..1BackboneElementGroup being referenced
.... description 0..1markdownTextual description of referent group
.... note 0..*AnnotationFootnotes and/or explanatory notes
.... evidenceSource 0..1Reference(Group)Various information categories of group
.... intendedGroup 0..1Reference(Group)Non-actual group that is a set of characteristics
.... directnessMatch 0..1CodeableConceptlow | moderate | high | exact
EvidenceDirectness (Extensible)
... variableDefinition 0..*BackboneElementEvidence variable
.... description 0..1markdownDescription of the variable
.... note 0..*AnnotationFootnotes and/or explanatory notes
.... variableRole 0..1CodeableConceptexposure | referenceExposure | measuredVariable | confounder
EvidenceVariableRole (Extensible)
.... actualDefinition Σ0..1Reference(EvidenceVariable)Definition of the actual variable related to the statistic(s)
.... intendedDefinition 0..1Reference(EvidenceVariable)Definition of the intended variable related to the Evidence
.... directnessMatch 0..1CodeableConceptlow | moderate | high | exact
EvidenceDirectness (Extensible)
... synthesisType 0..1CodeableConceptThe particular type of synthesis if this is a synthesis summary
StatisticSynthesisType (Extensible)
... studyType 0..1CodeableConceptThe type of study that produced this summary
StatisticStudyType (Extensible)
... statistic 0..*StatisticValues and parameters for a single statistic
... distribution 0..*OrderedDistributionAn ordered group of statistics
... certainty 0..*BackboneElementLevel of certainty
.... description 0..1stringTextual description of certainty
.... note 0..1AnnotationFootnotes and/or explanatory notes
.... rating 0..*CodeableConceptRating of certainty
StatisticCertaintyRating (Extensible)
.... certaintySubcomponent 0..*BackboneElementSubcomponent of certainty
..... description 0..1stringTextual description of certainty subcomponent
..... note 0..1AnnotationTextual note of certainty subcomponent
..... type 0..*CodeableConceptFootnotes and/or explanatory notes
StatisticCertaintySubcomponentType (Extensible)
..... rating 0..*CodeableConceptRating of certainty subcomponent
StatisticCertaintySubcomponentRating (Extensible)

doco Documentation for this format

UML Diagram (Legend)

Evidence (MetadataResource)An absolute URI that is used to identify this evidence when it is referenced in a specification, model, design or an instance; also called its canonical identifier. This SHOULD be globally unique and SHOULD be a literal address at which at which an authoritative instance of this summary is (or will be) published. This URL can be the target of a canonical reference. It SHALL remain the same when the summary is stored on different serversurl : uri [0..1]A formal identifier that is used to identify this summary when it is represented in other formats, or referenced in a specification, model, design or an instanceidentifier : Identifier [0..*]The identifier that is used to identify this version of the summary when it is referenced in a specification, model, design or instance. This is an arbitrary value managed by the summary 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 can be placed in a lexicographical sequenceversion : string [0..1]A short, descriptive, user-friendly title for the summarytitle : string [0..1]The status of this summary. Enables tracking the life-cycle of the content (this element modifies the meaning of other elements)status : code [1..1] « The lifecycle status of an artifact. (Strength=Required)PublicationStatus! »The date (and optionally time) when the summary was published. 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 summary changesdate : dateTime [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 evidence instancesuseContext : UsageContext [0..*]The date on which the resource content was approved by the publisher. Approval happens once when the content is officially approved for usageapprovalDate : date [0..1]The date on which the resource content was last reviewed. Review happens periodically after approval but does not change the original approval datelastReviewDate : date [0..1]Contact detail and role for contributor to summarycontributor : Contributor [0..*]Link or citation to artifact associated with the summaryrelatedArtifact : RelatedArtifact [0..*]A free text natural language description of the evidence from a consumer's perspectivedescription : markdown [0..1]Declarative description of the Evidenceassertion : markdown [0..1]Footnotes and/or explanatory notesnote : Annotation [0..*]The particular type of synthesis if this is a synthesis summarysynthesisType : CodeableConcept [0..1] « Types of combining results from a body of evidence (eg. summary data meta-analysis). (Strength=Extensible)StatisticSynthesisType+ »The type of study that produced this summarystudyType : CodeableConcept [0..1] « The type of study a statistic was derived from. (Strength=Extensible)StatisticStudyType+ »The statistic value(s)statistic : Statistic [0..*]Ordered distributiondistribution : OrderedDistribution [0..*]ReferentGroupTextual description of referent groupdescription : markdown [0..1]Footnotes and/or explanatory notesnote : Annotation [0..*]Various information categories of groupevidenceSource : Reference [0..1] « Group »Non-actual group that is a set of characteristicsintendedGroup : Reference [0..1] « Group »Indication of quality of match between intended group to actual groupdirectnessMatch : CodeableConcept [0..1] « The quality of how direct the match is. (Strength=Extensible)EvidenceDirectness+ »VariableDefinitionDescription of the variabledescription : markdown [0..1]Footnotes and/or explanatory notesnote : Annotation [0..*]exposure | referenceExposure | measuredVariable | confoundervariableRole : CodeableConcept [0..1] « The role that the assertion variable plays. (Strength=Extensible)EvidenceVariableRole+ »Definition of the actual variable related to the statistic(s)actualDefinition : Reference [0..1] « EvidenceVariable »Definition of the intended variable related to the EvidenceintendedDefinition : Reference [0..1] « EvidenceVariable »Indication of quality of match between intended variable to actual variabledirectnessMatch : CodeableConcept [0..1] « The quality of how direct the match is. (Strength=Extensible)EvidenceDirectness+ »CertaintyTextual description of certaintydescription : string [0..1]Footnotes and/or explanatory notesnote : Annotation [0..1]Rating of certaintyrating : CodeableConcept [0..*] « The relative quality of the statistic. (Strength=Extensible)StatisticCertaintyRating+ »CertaintySubcomponentTextual description of certainty subcomponentdescription : string [0..1]Textual note of certainty subcomponentnote : Annotation [0..1]Footnotes and/or explanatory notestype : CodeableConcept [0..*] « The subcomponent classification of quality of evidence rating systems. (Strength=Extensible)StatisticCertaintySubcomponen...+ »Rating of certainty subcomponentrating : CodeableConcept [0..*] « The quality rating of the subcomponent of a quality of evidence rating. (Strength=Extensible)StatisticCertaintySubcomponen...+ »Group being referencedreferentGroup[1..1]Evidence variablevariableDefinition[0..*]Subcomponent of certaintycertaintySubcomponent[0..*]Level of certaintycertainty[0..*]

XML Template

<Evidence xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <url value="[uri]"/><!-- 0..1 Canonical identifier for this evidence, represented as a globally unique URI -->
 <identifier><!-- 0..* Identifier Additional identifier for the summary --></identifier>
 <version value="[string]"/><!-- 0..1 Business version of this summary -->
 <title value="[string]"/><!-- 0..1 Name for this summary (human friendly) -->
 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <date value="[dateTime]"/><!-- 0..1 Date last changed -->
 <useContext><!-- 0..* UsageContext Use context --></useContext>
 <approvalDate value="[date]"/><!-- 0..1 When the summary was approved by publisher -->
 <lastReviewDate value="[date]"/><!-- 0..1 When the summary was last reviewed -->
 <contributor><!-- 0..* Contributor Contact detail and role for contributor to summary --></contributor>
 <relatedArtifact><!-- 0..* RelatedArtifact Link or citation to artifact associated with the summary --></relatedArtifact>
 <description value="[markdown]"/><!-- 0..1 Description of the particular summary -->
 <assertion value="[markdown]"/><!-- 0..1 Declarative description of the Evidence -->
 <note><!-- 0..* Annotation Footnotes and/or explanatory notes --></note>
 <referentGroup>  <!-- 1..1 Group being referenced -->
  <description value="[markdown]"/><!-- 0..1 Textual description of referent group -->
  <note><!-- 0..* Annotation Footnotes and/or explanatory notes --></note>
  <evidenceSource><!-- 0..1 Reference(Group) Various information categories of group --></evidenceSource>
  <intendedGroup><!-- 0..1 Reference(Group) Non-actual group that is a set of characteristics --></intendedGroup>
  <directnessMatch><!-- 0..1 CodeableConcept low | moderate | high | exact --></directnessMatch>
 </referentGroup>
 <variableDefinition>  <!-- 0..* Evidence variable -->
  <description value="[markdown]"/><!-- 0..1 Description of the variable -->
  <note><!-- 0..* Annotation Footnotes and/or explanatory notes --></note>
  <variableRole><!-- 0..1 CodeableConcept exposure | referenceExposure | measuredVariable | confounder --></variableRole>
  <actualDefinition><!-- 0..1 Reference(EvidenceVariable) Definition of the actual variable related to the statistic(s) --></actualDefinition>
  <intendedDefinition><!-- 0..1 Reference(EvidenceVariable) Definition of the intended variable related to the Evidence --></intendedDefinition>
  <directnessMatch><!-- 0..1 CodeableConcept low | moderate | high | exact --></directnessMatch>
 </variableDefinition>
 <synthesisType><!-- 0..1 CodeableConcept The particular type of synthesis if this is a synthesis summary --></synthesisType>
 <studyType><!-- 0..1 CodeableConcept The type of study that produced this summary --></studyType>
 <statistic><!-- 0..* Statistic Values and parameters for a single statistic --></statistic>
 <distribution><!-- 0..* OrderedDistribution An ordered group of statistics --></distribution>
 <certainty>  <!-- 0..* Level of certainty -->
  <description value="[string]"/><!-- 0..1 Textual description of certainty -->
  <note><!-- 0..1 Annotation Footnotes and/or explanatory notes --></note>
  <rating><!-- 0..* CodeableConcept Rating of certainty --></rating>
  <certaintySubcomponent>  <!-- 0..* Subcomponent of certainty -->
   <description value="[string]"/><!-- 0..1 Textual description of certainty subcomponent -->
   <note><!-- 0..1 Annotation Textual note of certainty subcomponent --></note>
   <type><!-- 0..* CodeableConcept Footnotes and/or explanatory notes --></type>
   <rating><!-- 0..* CodeableConcept Rating of certainty subcomponent --></rating>
  </certaintySubcomponent>
 </certainty>
</Evidence>

JSON Template

{doco
  "resourceType" : "Evidence",
  // from Resource: id, meta, implicitRules, and language
  "url" : "<uri>", // Canonical identifier for this evidence, represented as a globally unique URI
  "identifier" : [{ Identifier }], // Additional identifier for the summary
  "version" : "<string>", // Business version of this summary
  "title" : "<string>", // Name for this summary (human friendly)
  "status" : "<code>", // R!  draft | active | retired | unknown
  "date" : "<dateTime>", // Date last changed
  "useContext" : [{ UsageContext }], // Use context
  "approvalDate" : "<date>", // When the summary was approved by publisher
  "lastReviewDate" : "<date>", // When the summary was last reviewed
  "contributor" : [{ Contributor }], // Contact detail and role for contributor to summary
  "relatedArtifact" : [{ RelatedArtifact }], // Link or citation to artifact associated with the summary
  "description" : "<markdown>", // Description of the particular summary
  "assertion" : "<markdown>", // Declarative description of the Evidence
  "note" : [{ Annotation }], // Footnotes and/or explanatory notes
  "referentGroup" : { // R!  Group being referenced
    "description" : "<markdown>", // Textual description of referent group
    "note" : [{ Annotation }], // Footnotes and/or explanatory notes
    "evidenceSource" : { Reference(Group) }, // Various information categories of group
    "intendedGroup" : { Reference(Group) }, // Non-actual group that is a set of characteristics
    "directnessMatch" : { CodeableConcept } // low | moderate | high | exact
  },
  "variableDefinition" : [{ // Evidence variable
    "description" : "<markdown>", // Description of the variable
    "note" : [{ Annotation }], // Footnotes and/or explanatory notes
    "variableRole" : { CodeableConcept }, // exposure | referenceExposure | measuredVariable | confounder
    "actualDefinition" : { Reference(EvidenceVariable) }, // Definition of the actual variable related to the statistic(s)
    "intendedDefinition" : { Reference(EvidenceVariable) }, // Definition of the intended variable related to the Evidence
    "directnessMatch" : { CodeableConcept } // low | moderate | high | exact
  }],
  "synthesisType" : { CodeableConcept }, // The particular type of synthesis if this is a synthesis summary
  "studyType" : { CodeableConcept }, // The type of study that produced this summary
  "statistic" : [{ Statistic }], // Values and parameters for a single statistic
  "distribution" : [{ OrderedDistribution }], // An ordered group of statistics
  "certainty" : [{ // Level of certainty
    "description" : "<string>", // Textual description of certainty
    "note" : { Annotation }, // Footnotes and/or explanatory notes
    "rating" : [{ CodeableConcept }], // Rating of certainty
    "certaintySubcomponent" : [{ // Subcomponent of certainty
      "description" : "<string>", // Textual description of certainty subcomponent
      "note" : { Annotation }, // Textual note of certainty subcomponent
      "type" : [{ CodeableConcept }], // Footnotes and/or explanatory notes
      "rating" : [{ CodeableConcept }] // Rating of certainty subcomponent
    }]
  }]
}

Turtle Template

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


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

  # from Resource: .id, .meta, .implicitRules, and .language
  fhir:Evidence.url [ uri ]; # 0..1 Canonical identifier for this evidence, represented as a globally unique URI
  fhir:Evidence.identifier [ Identifier ], ... ; # 0..* Additional identifier for the summary
  fhir:Evidence.version [ string ]; # 0..1 Business version of this summary
  fhir:Evidence.title [ string ]; # 0..1 Name for this summary (human friendly)
  fhir:Evidence.status [ code ]; # 1..1 draft | active | retired | unknown
  fhir:Evidence.date [ dateTime ]; # 0..1 Date last changed
  fhir:Evidence.useContext [ UsageContext ], ... ; # 0..* Use context
  fhir:Evidence.approvalDate [ date ]; # 0..1 When the summary was approved by publisher
  fhir:Evidence.lastReviewDate [ date ]; # 0..1 When the summary was last reviewed
  fhir:Evidence.contributor [ Contributor ], ... ; # 0..* Contact detail and role for contributor to summary
  fhir:Evidence.relatedArtifact [ RelatedArtifact ], ... ; # 0..* Link or citation to artifact associated with the summary
  fhir:Evidence.description [ markdown ]; # 0..1 Description of the particular summary
  fhir:Evidence.assertion [ markdown ]; # 0..1 Declarative description of the Evidence
  fhir:Evidence.note [ Annotation ], ... ; # 0..* Footnotes and/or explanatory notes
  fhir:Evidence.referentGroup [ # 1..1 Group being referenced
    fhir:Evidence.referentGroup.description [ markdown ]; # 0..1 Textual description of referent group
    fhir:Evidence.referentGroup.note [ Annotation ], ... ; # 0..* Footnotes and/or explanatory notes
    fhir:Evidence.referentGroup.evidenceSource [ Reference(Group) ]; # 0..1 Various information categories of group
    fhir:Evidence.referentGroup.intendedGroup [ Reference(Group) ]; # 0..1 Non-actual group that is a set of characteristics
    fhir:Evidence.referentGroup.directnessMatch [ CodeableConcept ]; # 0..1 low | moderate | high | exact
  ];
  fhir:Evidence.variableDefinition [ # 0..* Evidence variable
    fhir:Evidence.variableDefinition.description [ markdown ]; # 0..1 Description of the variable
    fhir:Evidence.variableDefinition.note [ Annotation ], ... ; # 0..* Footnotes and/or explanatory notes
    fhir:Evidence.variableDefinition.variableRole [ CodeableConcept ]; # 0..1 exposure | referenceExposure | measuredVariable | confounder
    fhir:Evidence.variableDefinition.actualDefinition [ Reference(EvidenceVariable) ]; # 0..1 Definition of the actual variable related to the statistic(s)
    fhir:Evidence.variableDefinition.intendedDefinition [ Reference(EvidenceVariable) ]; # 0..1 Definition of the intended variable related to the Evidence
    fhir:Evidence.variableDefinition.directnessMatch [ CodeableConcept ]; # 0..1 low | moderate | high | exact
  ], ...;
  fhir:Evidence.synthesisType [ CodeableConcept ]; # 0..1 The particular type of synthesis if this is a synthesis summary
  fhir:Evidence.studyType [ CodeableConcept ]; # 0..1 The type of study that produced this summary
  fhir:Evidence.statistic [ Statistic ], ... ; # 0..* Values and parameters for a single statistic
  fhir:Evidence.distribution [ OrderedDistribution ], ... ; # 0..* An ordered group of statistics
  fhir:Evidence.certainty [ # 0..* Level of certainty
    fhir:Evidence.certainty.description [ string ]; # 0..1 Textual description of certainty
    fhir:Evidence.certainty.note [ Annotation ]; # 0..1 Footnotes and/or explanatory notes
    fhir:Evidence.certainty.rating [ CodeableConcept ], ... ; # 0..* Rating of certainty
    fhir:Evidence.certainty.certaintySubcomponent [ # 0..* Subcomponent of certainty
      fhir:Evidence.certainty.certaintySubcomponent.description [ string ]; # 0..1 Textual description of certainty subcomponent
      fhir:Evidence.certainty.certaintySubcomponent.note [ Annotation ]; # 0..1 Textual note of certainty subcomponent
      fhir:Evidence.certainty.certaintySubcomponent.type [ CodeableConcept ], ... ; # 0..* Footnotes and/or explanatory notes
      fhir:Evidence.certainty.certaintySubcomponent.rating [ CodeableConcept ], ... ; # 0..* Rating of certainty subcomponent
    ], ...;
  ], ...;
]

Changes since Release 3

Evidence
Evidence.status
  • Change value set from http://hl7.org/fhir/ValueSet/publication-status|4.0.0 to http://hl7.org/fhir/ValueSet/publication-status|4.2.0
Evidence.contributor
  • Added Element
Evidence.assertion
  • Added Element
Evidence.referentGroup
  • Added Mandatory Element
Evidence.referentGroup.description
  • Added Element
Evidence.referentGroup.note
  • Added Element
Evidence.referentGroup.evidenceSource
  • Added Element
Evidence.referentGroup.intendedGroup
  • Added Element
Evidence.referentGroup.directnessMatch
  • Added Element
Evidence.variableDefinition
  • Added Element
Evidence.variableDefinition.description
  • Added Element
Evidence.variableDefinition.note
  • Added Element
Evidence.variableDefinition.variableRole
  • Added Element
Evidence.variableDefinition.actualDefinition
  • Added Element
Evidence.variableDefinition.intendedDefinition
  • Added Element
Evidence.variableDefinition.directnessMatch
  • Added Element
Evidence.synthesisType
  • Added Element
Evidence.studyType
  • Added Element
Evidence.statistic
  • Added Element
Evidence.distribution
  • Added Element
Evidence.certainty
  • Added Element
Evidence.certainty.description
  • Added Element
Evidence.certainty.note
  • Added Element
Evidence.certainty.rating
  • Added Element
Evidence.certainty.certaintySubcomponent
  • Added Element
Evidence.certainty.certaintySubcomponent.description
  • Added Element
Evidence.certainty.certaintySubcomponent.note
  • Added Element
Evidence.certainty.certaintySubcomponent.type
  • Added Element
Evidence.certainty.certaintySubcomponent.rating
  • Added Element
Evidence.name
  • deleted
Evidence.shortTitle
  • deleted
Evidence.subtitle
  • deleted
Evidence.publisher
  • deleted
Evidence.contact
  • deleted
Evidence.jurisdiction
  • deleted
Evidence.copyright
  • deleted
Evidence.effectivePeriod
  • deleted
Evidence.topic
  • deleted
Evidence.author
  • deleted
Evidence.editor
  • deleted
Evidence.reviewer
  • deleted
Evidence.endorser
  • deleted
Evidence.exposureBackground
  • deleted
Evidence.exposureVariant
  • deleted
Evidence.outcome
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON.

 

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

14.10.3.1 Terminology Bindings

PathDefinitionTypeReference
Evidence.status The lifecycle status of an artifact.RequiredPublicationStatus
Evidence.referentGroup.directnessMatch
Evidence.variableDefinition.directnessMatch 		The quality of how direct the match is.ExtensibleEvidenceDirectness
Evidence.variableDefinition.variableRole The role that the assertion variable plays.ExtensibleEvidenceVariableRole
Evidence.synthesisType Types of combining results from a body of evidence (eg. summary data meta-analysis).ExtensibleStatisticSynthesisType
Evidence.studyType The type of study a statistic was derived from.ExtensibleStatisticStudyType
Evidence.certainty.rating The relative quality of the statistic.ExtensibleStatisticCertaintyRating
Evidence.certainty.certaintySubcomponent.type The subcomponent classification of quality of evidence rating systems.ExtensibleStatisticCertaintySubcomponentType
Evidence.certainty.certaintySubcomponent.rating The quality rating of the subcomponent of a quality of evidence rating.ExtensibleStatisticCertaintySubcomponentRating

14.10.3.2 Constraints

idLevelLocationDescriptionExpression
cnl-0Warning (base)Name should be usable as an identifier for the module by machine processing applications such as code generationname.matches('[A-Z]([A-Za-z0-9_]){0,254}')

14.10.4 Search Parameters

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionExpressionIn Common
contexttokenA use context assigned to the evidence(Evidence.useContext.value as CodeableConcept)
context-quantityquantityA quantity- or range-valued use context assigned to the evidence(Evidence.useContext.value as Quantity) | (Evidence.useContext.value as Range)
context-typetokenA type of use context assigned to the evidenceEvidence.useContext.code
context-type-quantitycompositeA use context type and quantity- or range-based value assigned to the evidenceOn Evidence.useContext:
  context-type: code
  context-quantity: value.as(Quantity) | value.as(Range)
context-type-valuecompositeA use context type and value assigned to the evidenceOn Evidence.useContext:
  context-type: code
  context: value.as(CodeableConcept)
date NdateThe evidence publication dateEvidence.date
description NstringThe description of the evidenceEvidence.description
identifiertokenExternal identifier for the evidenceEvidence.identifier
status NtokenThe current status of the evidenceEvidence.status
title NstringThe human-friendly name of the evidenceEvidence.title
url NuriThe uri that identifies the evidenceEvidence.url
version NtokenThe business version of the evidenceEvidence.version