Release 4B

This page is part of the FHIR Specification (v4.3.0: R4B - STU). This is a downloaded version of the specification. For a full list of available versions, see the Directory of published versions

14.8 Resource EvidenceReport - Content

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

The EvidenceReport Resource is a specialized container for a collection of resources and codable concepts, adapted to support compositions of Evidence, EvidenceVariable, and Citation resources and related concepts.

14.8.1 Scope and Usage

An evidence report is a structured presentation of any combination of evidence and related concepts. Evidence reports may bundle knowledge related to a single study or citation, and may bundle knowledge spanning multiple related studies or citations. Publishing such reports are extensively used by researchers, scholars, and evaluators to advance scientific knowledge, to decide whether more research is needed, to inform policy, to determine whether the literature has reached consensus, to inform clinical decision support, to substantiate the decisions being recommended, and for many other uses.

The subject of the report defines its scope and can be expressed with one or more subject.characteristic elements (for structured definitions) or one or more subject.note elements (for human-readable expressions). Specifying a research question by the population, intervention/exposure, comparator, and outcome (PICO) could be expressed with four characteristics.

Evidence reports may be dynamic, changing as new evidence accrues. The relatesTo element supports coding the relationships between EvidenceReport Resources.

The content of the EvidenceReport Resource is contained in any number of sections that can each contain any number of sections. Each section can have its focus defined using a codeable concept or reference to another resource. Each section can have designated authors that can be distinct from authors for the EvidenceReport Resource.

The content in a section can be of different forms and can include text (which itself can be uniquely represented human-expressed content and/or machine-generated from other content), entryClassifier (to express codeable concepts), entryReference (to express other FHIR Resources), entryReason (to represent empty sections as content), and section elements.

14.8.2 Boundaries and Relationships

The EvidenceReport Resource is used for structured bundles and is not expected to replace simple lists or bundles where List and Bundle Resources can be used.

The EvidenceReport Resource is similar to a Composition Resource but the EvidenceReport is better suited for communicating reports about research and data analysis not specific to individual persons while the Composition Resource is better suited for healthcare related reports specific to individual persons as the subject.

The EvidenceReport Resource is used for data exchange for concepts beyond identification, location and contributor attribution. Where data exchange is limited to such things a Citation Resource may be used. An EvidenceReport Resource may reference a Citation Resource to itself in the citeAs element.

14.8.3 References

This resource is referenced by itself.

This resource does not implement any patterns.

14.8.4 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. EvidenceReport TUDomainResourceA EvidenceReport
+ 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 Σ0..1uriCanonical identifier for this EvidenceReport, represented as a globally unique URI
... status ?!Σ1..1codedraft | active | retired | unknown
PublicationStatus (Required)
... useContext Σ0..*UsageContextThe context that the content is intended to support
... relatedIdentifier Σ0..*IdentifierIdentifiers for articles that may relate to more than one evidence report
... citeAs[x] 0..1Citation for this report
.... citeAsReferenceReference(Citation)
.... citeAsMarkdownmarkdown
... type 0..1CodeableConceptKind of report
EvidenceReportType (Example)
... note 0..*AnnotationUsed for footnotes and annotations
... relatedArtifact 0..*RelatedArtifactLink, description or reference to artifact associated with the report
... subject Σ1..1BackboneElementFocus of the report
.... characteristic 0..*BackboneElementCharacteristic
..... code 1..1CodeableConceptCharacteristic code
FocusCharacteristicCode (Extensible)
..... value[x] 1..1Characteristic value
...... valueReferenceReference(Any)
...... valueCodeableConceptCodeableConcept
...... valueBooleanboolean
...... valueQuantityQuantity
...... valueRangeRange
..... exclude 0..1booleanIs used to express not the characteristic
..... period 0..1PeriodTimeframe for the characteristic
.... note 0..*AnnotationFootnotes and/or explanatory notes
... 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
... relatesTo 0..*BackboneElementRelationships to other compositions/documents
.... code 1..1codereplaces | amends | appends | transforms | replacedWith | amendedWith | appendedWith | transformedWith
ReportRelationshipType (Required)
.... target[x] 1..1Target of the relationship
..... targetIdentifierIdentifier
..... targetReferenceReference(EvidenceReport)
... section 0..*BackboneElementComposition is broken into sections
.... title 0..1stringLabel for section (e.g. for ToC)
.... focus 0..1CodeableConceptClassification of section (recommended)
ReportSectionType (Extensible)
.... focusReference 0..1Reference(Any)Classification of section by Resource
.... author 0..*Reference(Person | Device | Group | Organization)Who and/or what authored the section
.... text 0..1NarrativeText summary of the section, for human interpretation
.... mode 0..1codeworking | snapshot | changes
ListMode (Required)
.... orderedBy 0..1CodeableConceptOrder of section entries
List Order Codes (Preferred)
.... entryClassifier 0..*CodeableConceptExtensible classifiers as content
EvidenceClassifier (Extensible)
.... entryReference 0..*Reference(Any)Reference to resources as content
.... entryQuantity 0..*QuantityQuantity as content
.... emptyReason 0..1CodeableConceptWhy the section is empty
List Empty Reasons (Preferred)
.... section 0..*see sectionNested Section

doco Documentation for this format

 

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

14.8.4.1 Terminology Bindings

PathDefinitionTypeReference
EvidenceReport.status RequiredPublicationStatus
EvidenceReport.type ExampleEvidenceReportType
EvidenceReport.subject.characteristic.code ExtensibleFocusCharacteristicCode
EvidenceReport.relatesTo.code RequiredReportRelationshipType
EvidenceReport.section.focus ExtensibleReportSectionType
EvidenceReport.section.mode RequiredListMode
EvidenceReport.section.orderedBy PreferredListOrderCodes
EvidenceReport.section.entryClassifier ExtensibleEvidenceClassifier
EvidenceReport.section.emptyReason PreferredListEmptyReasons

14.8.4.2 Constraints

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

14.8.5 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 report(EvidenceReport.useContext.value as CodeableConcept)
context-quantityquantityA quantity- or range-valued use context assigned to the evidence report(EvidenceReport.useContext.value as Quantity) | (EvidenceReport.useContext.value as Range)
context-typetokenA type of use context assigned to the evidence reportEvidenceReport.useContext.code
context-type-quantitycompositeA use context type and quantity- or range-based value assigned to the evidence reportOn EvidenceReport.useContext:
  context-type: code
  context-quantity: value.as(Quantity) | value.as(Range)
context-type-valuecompositeA use context type and value assigned to the evidence reportOn EvidenceReport.useContext:
  context-type: code
  context: value.as(CodeableConcept)
identifiertokenExternal identifier for the evidence reportEvidenceReport.identifier
publisher NstringName of the publisher of the evidence reportEvidenceReport.publisher
status NtokenThe current status of the evidence reportEvidenceReport.status
url NuriThe uri that identifies the evidence reportEvidenceReport.url