Release 5 Preview #3

This page is part of the FHIR Specification (v4.5.0: R5 Preview #3). 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.12 Resource Evidence - Content

Clinical Decision Support Work GroupMaturity Level: 1 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.12.1 Scope and Usage

14.12.2 References

No resources refer to this resource directly.

This resource does not implement any patterns.

14.12.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..*UsageContextThe context that the content is intended to support
... approvalDate 0..1dateWhen the summary was approved by publisher
... lastReviewDate 0..1dateWhen the summary was last reviewed
... publisher Σ0..1stringName of the publisher (organization or individual)
... contact Σ0..*ContactDetailContact details for the publisher
... author Σ0..*ContactDetailWho authored the content
... editor 0..*ContactDetailWho edited the content
... reviewer 0..*ContactDetailWho reviewed the content
... endorser Σ0..*ContactDetailWho endorsed the content
... 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
... variableDefinition 1..*BackboneElementEvidence variable such as population, exposure, or outcome
.... description 0..1markdownA text description or summary of the variable
.... note 0..*AnnotationFootnotes and/or explanatory notes
.... variableRole Σ1..1CodeableConceptpopulation | subpopulation | exposure | referenceExposure | measuredVariable | confounder
EvidenceVariableRole (Extensible)
.... observed Σ0..1Reference(Group | EvidenceVariable)Definition of the actual variable related to the statistic(s)
.... intended 0..1Reference(Group | 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
SynthesisType (Extensible)
... studyType 0..1CodeableConceptThe type of study that produced this summary
StudyType (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..*AnnotationFootnotes and/or explanatory notes
.... rating 0..*CodeableConceptQuality or certainty of the Evidence
QualityOfEvidenceRating (Preferred)
.... certaintySubcomponent 0..*BackboneElementA domain or subdomain of certainty rating
..... description 0..1stringTextual description of certainty subcomponent
..... note 0..*AnnotationFootnotes and/or explanatory notes
..... type 0..*CodeableConceptAspect of quality or certainty being rated
CertaintySubcomponentType (Extensible)
..... rating 0..*CodeableConceptQuality or certainty of the aspect
CertaintySubcomponentRating (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]The name of the organization or individual that published the evidencepublisher : string [0..1]Contact details to assist a user in finding and communicating with the publishercontact : ContactDetail [0..*]An individiual, organization, or device primarily involved in the creation and maintenance of the contentauthor : ContactDetail [0..*]An individiual, organization, or device primarily responsible for internal coherence of the contenteditor : ContactDetail [0..*]An individiual, organization, or device primarily responsible for review of some aspect of the contentreviewer : ContactDetail [0..*]An individiual, organization, or device responsible for officially endorsing the content for use in some settingendorser : ContactDetail [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)SynthesisType+ »The type of study that produced this summarystudyType : CodeableConcept [0..1] « The type of study the evidence was derived from. (Strength=Extensible)StudyType+ »The statistic value(s)statistic : Statistic [0..*]Ordered distributiondistribution : OrderedDistribution [0..*]VariableDefinitionA text description or summary of the variabledescription : markdown [0..1]Footnotes and/or explanatory notesnote : Annotation [0..*]population | subpopulation | exposure | referenceExposure | measuredVariable | confoundervariableRole : CodeableConcept [1..1] « The role that the assertion variable plays. (Strength=Extensible)EvidenceVariableRole+ »Definition of the actual variable related to the statistic(s)observed : Reference [0..1] « Group|EvidenceVariable »Definition of the intended variable related to the Evidenceintended : Reference [0..1] « Group|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..*]Quality or certainty of the Evidencerating : CodeableConcept [0..*] « The relative quality of the statistic. (Strength=Preferred)QualityOfEvidenceRating? »CertaintySubcomponentTextual description of certainty subcomponentdescription : string [0..1]Footnotes and/or explanatory notesnote : Annotation [0..*]Aspect of quality or certainty being ratedtype : CodeableConcept [0..*] « The subcomponent classification of quality of evidence rating systems. (Strength=Extensible)CertaintySubcomponentType+ »Quality or certainty of the aspectrating : CodeableConcept [0..*] « The quality rating of the subcomponent of a quality of evidence rating. (Strength=Extensible)CertaintySubcomponentRating+ »Evidence variable such as population, exposure, or outcomevariableDefinition[1..*]A domain or subdomain of certainty ratingcertaintySubcomponent[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 The context that the content is intended to support --></useContext>
 <approvalDate value="[date]"/><!-- 0..1 When the summary was approved by publisher -->
 <lastReviewDate value="[date]"/><!-- 0..1 When the summary was last reviewed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher (organization or individual) -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <author><!-- 0..* ContactDetail Who authored the content --></author>
 <editor><!-- 0..* ContactDetail Who edited the content --></editor>
 <reviewer><!-- 0..* ContactDetail Who reviewed the content --></reviewer>
 <endorser><!-- 0..* ContactDetail Who endorsed the content --></endorser>
 <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>
 <variableDefinition>  <!-- 1..* Evidence variable such as population, exposure, or outcome -->
  <description value="[markdown]"/><!-- 0..1 A text description or summary of the variable -->
  <note><!-- 0..* Annotation Footnotes and/or explanatory notes --></note>
  <variableRole><!-- 1..1 CodeableConcept population | subpopulation | exposure | referenceExposure | measuredVariable | confounder --></variableRole>
  <observed><!-- 0..1 Reference(EvidenceVariable|Group) Definition of the actual variable related to the statistic(s) --></observed>
  <intended><!-- 0..1 Reference(EvidenceVariable|Group) Definition of the intended variable related to the Evidence --></intended>
  <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..* Annotation Footnotes and/or explanatory notes --></note>
  <rating><!-- 0..* CodeableConcept Quality or certainty of the Evidence --></rating>
  <certaintySubcomponent>  <!-- 0..* A domain or subdomain of certainty rating -->
   <description value="[string]"/><!-- 0..1 Textual description of certainty subcomponent -->
   <note><!-- 0..* Annotation Footnotes and/or explanatory notes --></note>
   <type><!-- 0..* CodeableConcept Aspect of quality or certainty being rated --></type>
   <rating><!-- 0..* CodeableConcept Quality or certainty of the aspect --></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 }], // The context that the content is intended to support
  "approvalDate" : "<date>", // When the summary was approved by publisher
  "lastReviewDate" : "<date>", // When the summary was last reviewed
  "publisher" : "<string>", // Name of the publisher (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "author" : [{ ContactDetail }], // Who authored the content
  "editor" : [{ ContactDetail }], // Who edited the content
  "reviewer" : [{ ContactDetail }], // Who reviewed the content
  "endorser" : [{ ContactDetail }], // Who endorsed the content
  "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
  "variableDefinition" : [{ // R!  Evidence variable such as population, exposure, or outcome
    "description" : "<markdown>", // A text description or summary of the variable
    "note" : [{ Annotation }], // Footnotes and/or explanatory notes
    "variableRole" : { CodeableConcept }, // R!  population | subpopulation | exposure | referenceExposure | measuredVariable | confounder
    "observed" : { Reference(EvidenceVariable|Group) }, // Definition of the actual variable related to the statistic(s)
    "intended" : { Reference(EvidenceVariable|Group) }, // 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 }], // Quality or certainty of the Evidence
    "certaintySubcomponent" : [{ // A domain or subdomain of certainty rating
      "description" : "<string>", // Textual description of certainty subcomponent
      "note" : [{ Annotation }], // Footnotes and/or explanatory notes
      "type" : [{ CodeableConcept }], // Aspect of quality or certainty being rated
      "rating" : [{ CodeableConcept }] // Quality or certainty of the aspect
    }]
  }]
}

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..* The context that the content is intended to support
  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.publisher [ string ]; # 0..1 Name of the publisher (organization or individual)
  fhir:Evidence.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher
  fhir:Evidence.author [ ContactDetail ], ... ; # 0..* Who authored the content
  fhir:Evidence.editor [ ContactDetail ], ... ; # 0..* Who edited the content
  fhir:Evidence.reviewer [ ContactDetail ], ... ; # 0..* Who reviewed the content
  fhir:Evidence.endorser [ ContactDetail ], ... ; # 0..* Who endorsed the content
  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.variableDefinition [ # 1..* Evidence variable such as population, exposure, or outcome
    fhir:Evidence.variableDefinition.description [ markdown ]; # 0..1 A text description or summary of the variable
    fhir:Evidence.variableDefinition.note [ Annotation ], ... ; # 0..* Footnotes and/or explanatory notes
    fhir:Evidence.variableDefinition.variableRole [ CodeableConcept ]; # 1..1 population | subpopulation | exposure | referenceExposure | measuredVariable | confounder
    fhir:Evidence.variableDefinition.observed [ Reference(EvidenceVariable|Group) ]; # 0..1 Definition of the actual variable related to the statistic(s)
    fhir:Evidence.variableDefinition.intended [ Reference(EvidenceVariable|Group) ]; # 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..* Footnotes and/or explanatory notes
    fhir:Evidence.certainty.rating [ CodeableConcept ], ... ; # 0..* Quality or certainty of the Evidence
    fhir:Evidence.certainty.certaintySubcomponent [ # 0..* A domain or subdomain of certainty rating
      fhir:Evidence.certainty.certaintySubcomponent.description [ string ]; # 0..1 Textual description of certainty subcomponent
      fhir:Evidence.certainty.certaintySubcomponent.note [ Annotation ], ... ; # 0..* Footnotes and/or explanatory notes
      fhir:Evidence.certainty.certaintySubcomponent.type [ CodeableConcept ], ... ; # 0..* Aspect of quality or certainty being rated
      fhir:Evidence.certainty.certaintySubcomponent.rating [ CodeableConcept ], ... ; # 0..* Quality or certainty of the aspect
    ], ...;
  ], ...;
]

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.5.0
Evidence.assertion
  • Added Element
Evidence.variableDefinition
  • Added Mandatory Element
Evidence.variableDefinition.description
  • Added Element
Evidence.variableDefinition.note
  • Added Element
Evidence.variableDefinition.variableRole
  • Added Mandatory Element
Evidence.variableDefinition.observed
  • Added Element
Evidence.variableDefinition.intended
  • 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.jurisdiction
  • deleted
Evidence.copyright
  • deleted
Evidence.effectivePeriod
  • deleted
Evidence.topic
  • 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..*UsageContextThe context that the content is intended to support
... approvalDate 0..1dateWhen the summary was approved by publisher
... lastReviewDate 0..1dateWhen the summary was last reviewed
... publisher Σ0..1stringName of the publisher (organization or individual)
... contact Σ0..*ContactDetailContact details for the publisher
... author Σ0..*ContactDetailWho authored the content
... editor 0..*ContactDetailWho edited the content
... reviewer 0..*ContactDetailWho reviewed the content
... endorser Σ0..*ContactDetailWho endorsed the content
... 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
... variableDefinition 1..*BackboneElementEvidence variable such as population, exposure, or outcome
.... description 0..1markdownA text description or summary of the variable
.... note 0..*AnnotationFootnotes and/or explanatory notes
.... variableRole Σ1..1CodeableConceptpopulation | subpopulation | exposure | referenceExposure | measuredVariable | confounder
EvidenceVariableRole (Extensible)
.... observed Σ0..1Reference(Group | EvidenceVariable)Definition of the actual variable related to the statistic(s)
.... intended 0..1Reference(Group | 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
SynthesisType (Extensible)
... studyType 0..1CodeableConceptThe type of study that produced this summary
StudyType (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..*AnnotationFootnotes and/or explanatory notes
.... rating 0..*CodeableConceptQuality or certainty of the Evidence
QualityOfEvidenceRating (Preferred)
.... certaintySubcomponent 0..*BackboneElementA domain or subdomain of certainty rating
..... description 0..1stringTextual description of certainty subcomponent
..... note 0..*AnnotationFootnotes and/or explanatory notes
..... type 0..*CodeableConceptAspect of quality or certainty being rated
CertaintySubcomponentType (Extensible)
..... rating 0..*CodeableConceptQuality or certainty of the aspect
CertaintySubcomponentRating (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]The name of the organization or individual that published the evidencepublisher : string [0..1]Contact details to assist a user in finding and communicating with the publishercontact : ContactDetail [0..*]An individiual, organization, or device primarily involved in the creation and maintenance of the contentauthor : ContactDetail [0..*]An individiual, organization, or device primarily responsible for internal coherence of the contenteditor : ContactDetail [0..*]An individiual, organization, or device primarily responsible for review of some aspect of the contentreviewer : ContactDetail [0..*]An individiual, organization, or device responsible for officially endorsing the content for use in some settingendorser : ContactDetail [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)SynthesisType+ »The type of study that produced this summarystudyType : CodeableConcept [0..1] « The type of study the evidence was derived from. (Strength=Extensible)StudyType+ »The statistic value(s)statistic : Statistic [0..*]Ordered distributiondistribution : OrderedDistribution [0..*]VariableDefinitionA text description or summary of the variabledescription : markdown [0..1]Footnotes and/or explanatory notesnote : Annotation [0..*]population | subpopulation | exposure | referenceExposure | measuredVariable | confoundervariableRole : CodeableConcept [1..1] « The role that the assertion variable plays. (Strength=Extensible)EvidenceVariableRole+ »Definition of the actual variable related to the statistic(s)observed : Reference [0..1] « Group|EvidenceVariable »Definition of the intended variable related to the Evidenceintended : Reference [0..1] « Group|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..*]Quality or certainty of the Evidencerating : CodeableConcept [0..*] « The relative quality of the statistic. (Strength=Preferred)QualityOfEvidenceRating? »CertaintySubcomponentTextual description of certainty subcomponentdescription : string [0..1]Footnotes and/or explanatory notesnote : Annotation [0..*]Aspect of quality or certainty being ratedtype : CodeableConcept [0..*] « The subcomponent classification of quality of evidence rating systems. (Strength=Extensible)CertaintySubcomponentType+ »Quality or certainty of the aspectrating : CodeableConcept [0..*] « The quality rating of the subcomponent of a quality of evidence rating. (Strength=Extensible)CertaintySubcomponentRating+ »Evidence variable such as population, exposure, or outcomevariableDefinition[1..*]A domain or subdomain of certainty ratingcertaintySubcomponent[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 The context that the content is intended to support --></useContext>
 <approvalDate value="[date]"/><!-- 0..1 When the summary was approved by publisher -->
 <lastReviewDate value="[date]"/><!-- 0..1 When the summary was last reviewed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher (organization or individual) -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <author><!-- 0..* ContactDetail Who authored the content --></author>
 <editor><!-- 0..* ContactDetail Who edited the content --></editor>
 <reviewer><!-- 0..* ContactDetail Who reviewed the content --></reviewer>
 <endorser><!-- 0..* ContactDetail Who endorsed the content --></endorser>
 <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>
 <variableDefinition>  <!-- 1..* Evidence variable such as population, exposure, or outcome -->
  <description value="[markdown]"/><!-- 0..1 A text description or summary of the variable -->
  <note><!-- 0..* Annotation Footnotes and/or explanatory notes --></note>
  <variableRole><!-- 1..1 CodeableConcept population | subpopulation | exposure | referenceExposure | measuredVariable | confounder --></variableRole>
  <observed><!-- 0..1 Reference(EvidenceVariable|Group) Definition of the actual variable related to the statistic(s) --></observed>
  <intended><!-- 0..1 Reference(EvidenceVariable|Group) Definition of the intended variable related to the Evidence --></intended>
  <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..* Annotation Footnotes and/or explanatory notes --></note>
  <rating><!-- 0..* CodeableConcept Quality or certainty of the Evidence --></rating>
  <certaintySubcomponent>  <!-- 0..* A domain or subdomain of certainty rating -->
   <description value="[string]"/><!-- 0..1 Textual description of certainty subcomponent -->
   <note><!-- 0..* Annotation Footnotes and/or explanatory notes --></note>
   <type><!-- 0..* CodeableConcept Aspect of quality or certainty being rated --></type>
   <rating><!-- 0..* CodeableConcept Quality or certainty of the aspect --></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 }], // The context that the content is intended to support
  "approvalDate" : "<date>", // When the summary was approved by publisher
  "lastReviewDate" : "<date>", // When the summary was last reviewed
  "publisher" : "<string>", // Name of the publisher (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "author" : [{ ContactDetail }], // Who authored the content
  "editor" : [{ ContactDetail }], // Who edited the content
  "reviewer" : [{ ContactDetail }], // Who reviewed the content
  "endorser" : [{ ContactDetail }], // Who endorsed the content
  "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
  "variableDefinition" : [{ // R!  Evidence variable such as population, exposure, or outcome
    "description" : "<markdown>", // A text description or summary of the variable
    "note" : [{ Annotation }], // Footnotes and/or explanatory notes
    "variableRole" : { CodeableConcept }, // R!  population | subpopulation | exposure | referenceExposure | measuredVariable | confounder
    "observed" : { Reference(EvidenceVariable|Group) }, // Definition of the actual variable related to the statistic(s)
    "intended" : { Reference(EvidenceVariable|Group) }, // 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 }], // Quality or certainty of the Evidence
    "certaintySubcomponent" : [{ // A domain or subdomain of certainty rating
      "description" : "<string>", // Textual description of certainty subcomponent
      "note" : [{ Annotation }], // Footnotes and/or explanatory notes
      "type" : [{ CodeableConcept }], // Aspect of quality or certainty being rated
      "rating" : [{ CodeableConcept }] // Quality or certainty of the aspect
    }]
  }]
}

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..* The context that the content is intended to support
  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.publisher [ string ]; # 0..1 Name of the publisher (organization or individual)
  fhir:Evidence.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher
  fhir:Evidence.author [ ContactDetail ], ... ; # 0..* Who authored the content
  fhir:Evidence.editor [ ContactDetail ], ... ; # 0..* Who edited the content
  fhir:Evidence.reviewer [ ContactDetail ], ... ; # 0..* Who reviewed the content
  fhir:Evidence.endorser [ ContactDetail ], ... ; # 0..* Who endorsed the content
  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.variableDefinition [ # 1..* Evidence variable such as population, exposure, or outcome
    fhir:Evidence.variableDefinition.description [ markdown ]; # 0..1 A text description or summary of the variable
    fhir:Evidence.variableDefinition.note [ Annotation ], ... ; # 0..* Footnotes and/or explanatory notes
    fhir:Evidence.variableDefinition.variableRole [ CodeableConcept ]; # 1..1 population | subpopulation | exposure | referenceExposure | measuredVariable | confounder
    fhir:Evidence.variableDefinition.observed [ Reference(EvidenceVariable|Group) ]; # 0..1 Definition of the actual variable related to the statistic(s)
    fhir:Evidence.variableDefinition.intended [ Reference(EvidenceVariable|Group) ]; # 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..* Footnotes and/or explanatory notes
    fhir:Evidence.certainty.rating [ CodeableConcept ], ... ; # 0..* Quality or certainty of the Evidence
    fhir:Evidence.certainty.certaintySubcomponent [ # 0..* A domain or subdomain of certainty rating
      fhir:Evidence.certainty.certaintySubcomponent.description [ string ]; # 0..1 Textual description of certainty subcomponent
      fhir:Evidence.certainty.certaintySubcomponent.note [ Annotation ], ... ; # 0..* Footnotes and/or explanatory notes
      fhir:Evidence.certainty.certaintySubcomponent.type [ CodeableConcept ], ... ; # 0..* Aspect of quality or certainty being rated
      fhir:Evidence.certainty.certaintySubcomponent.rating [ CodeableConcept ], ... ; # 0..* Quality or certainty of the aspect
    ], ...;
  ], ...;
]

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.5.0
Evidence.assertion
  • Added Element
Evidence.variableDefinition
  • Added Mandatory Element
Evidence.variableDefinition.description
  • Added Element
Evidence.variableDefinition.note
  • Added Element
Evidence.variableDefinition.variableRole
  • Added Mandatory Element
Evidence.variableDefinition.observed
  • Added Element
Evidence.variableDefinition.intended
  • 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.jurisdiction
  • deleted
Evidence.copyright
  • deleted
Evidence.effectivePeriod
  • deleted
Evidence.topic
  • 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.12.3.1 Terminology Bindings

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

14.12.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.12.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
publisher NstringName of the publisher of the evidenceEvidence.publisher
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