FHIR CI-Build

This is the Continuous Integration Build of FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions icon

14.8 Resource ArtifactAssessment - Content

Clinical Decision Support icon Work GroupMaturity Level: 1 Trial UseSecurity Category: Not Classified Compartments: No defined compartments

This Resource provides one or more comments, classifiers or ratings about a Resource and supports attribution and rights management metadata for the added content.

14.8.1 Scope and Usage

The ArtifactAssessment Resource represents one or more assessments of another record or resource. The resource captures metadata about the assessment, as well as the data for the results of the assessment which might include comments, classifications, ratings, questions, and responses.

The ArtifactAssessment Resource provides a structure to communicate judgments or qualitative data about a record (a resource or other set of data with a known identity or URL by which it can be accessed), including comments, corrections, classifications, and ratings. The ArtifactAssessment Resource is used when the content attribution and management rights differ from the record being commented upon, or the commenter desires to separate the comments from the target record. The scope is intended to cover assessments (added information) regarding clinical records about individual human subjects, assessments (added information) regarding healthcare provision for individual persons (such as care plans), and assessments (added information) regarding records related to community knowledge such as scientific evidence and group-oriented guidance.

14.8.2 Boundaries and Relationships

ArtifactAssessment may by referenced by ArtifactAssessment and by Task.

ArtifactAssessment may reference any resource of 'community knowledge' and will likely reference Evidence, EvidenceVariable, PlanDefinition, ActivityDefinition, Library, Measure, and Citation. ArtifactAssessment may reference any resource of a 'medical record' and will likely reference DocumentReference, Composition, CarePlan, and DiagnosticReport.

ArtifactAssessment is about the content of a Resource and not about the provenance of the Resource so should not be confused with Provenance.

ArtifactAssessment is not used for communications that are not about a Resource so should not be confused with Communication or Composition (or profiles of Composition) which may be used for the primary communication about the subject matter.

Observation Resource is used extensively for observations about people, groups, devices, locations, substances, and procedures – not about the record describing these entities. ArtifiactAssessment is used for observations where the subject is the artifact or record, not the entity described by the artifact. Simple "assessments" about an Observation such as status, dataAbsentReason, interpretation and note would use the Observation Resource where this is already structured. ArtifactAssessment Resource may be used for complex assessments of an Observation such as justifications for reasons to correct the record.

14.8.3 Background and Context

Across healthcare communities, there are an extensive number of comments and corrections regarding resources where the commenter is not able or permitted to modify the resource content, and there are many situations in which assessments with classifications and ratings of medical record content are made by parties who would not include the assessments in the medical record. Across the academic, scientific, quality measurement development, and clinical decision support communities there is an extensive need to report assessments and feedback about resources and records. These artifact assessments may take multiple forms (including text, classifications, ratings or measurements) and might or might not be created, queried and maintained independently from the artifact being rated or commented upon.

14.8.4 References to this Resource

14.8.5 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. ArtifactAssessment TU DomainResource Adds metadata-supported comments, classifiers or ratings related to a Resource

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ 0..* Identifier Additional identifier for the artifact assessment

... title ΣT 0..1 string A label for use in displaying and selecting the artifact assessment
... citeAs 0..1 markdown How to cite the comment or rating
.... artifactReference Reference(Any)
.... artifactCanonical canonical()
.... artifactUri uri
... relatesTo 0..* BackboneElement Relationship to other Resources

.... type 1..1 code documentation | justification | predecessor | successor | derived-from | depends-on | composed-of | part-of | amends | amended-with | appends | appended-with | cites | cited-by | comments-on | comment-in | contains | contained-in | corrects | correction-in | replaces | replaced-with | retracts | retracted-by | signs | similar-to | supports | supported-with | transforms | transformed-into | transformed-with | specification-of | created-with | cite-as | summarizes
Binding: Artifact Relationship Type (Required)
.... target[x] 1..1 The artifact that is related to this ArtifactAssessment
..... targetUri uri
..... targetAttachment Attachment
..... targetCanonical canonical(Any)
..... targetReference Reference(Any)
..... targetMarkdown markdown
... date Σ 0..1 dateTime Date last changed
... copyright 0..1 markdown Use and/or publishing restrictions
... approvalDate 0..1 date When the artifact assessment was approved by publisher
... lastReviewDate Σ 0..1 date When the artifact assessment was last reviewed by the publisher
... content 0..* BackboneElement Comment, classifier, or rating content

.... summary 0..1 markdown Brief summary of the content
.... type 0..1 CodeableConcept What type of content
Binding: Evidence Certainty Type (Example)
.... classifier 0..* CodeableConcept Rating, classifier, or assessment
Binding: Evidence Certainty Rating (Example)

.... quantity 0..1 Quantity Quantitative rating
.... author 0..* Reference(Patient | Practitioner | PractitionerRole | Organization | Device) Who authored the content

.... path 0..* uri What the comment is directed to

.... relatesTo 0..* see relatesTo Relationship to other Resources

.... freeToShare 0..1 boolean Acceptable to publicly share the content
.... component 0..* see content Comment, classifier, or rating content

... workflowStatus Σ 0..1 code submitted | triaged | waiting-for-input | resolved-no-change | resolved-change-required | deferred | duplicate | applied | published | entered-in-error
Binding: Artifact Assessment Workflow Status (Required)
... disposition Σ 0..1 code unresolved | not-persuasive | persuasive | persuasive-with-modification | not-persuasive-with-modification
Binding: Artifact Assessment Disposition (Required)

doco Documentation for this format icon

See the Extensions for this resource

 

Additional definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions, the spreadsheet version & the dependency analysis

14.8.5.1 Terminology Bindings

Path ValueSet Type Documentation
ArtifactAssessment.relatesTo.type ArtifactRelationshipType Required

Type of relationship to the related artifact.
ArtifactAssessment.content.type EvidenceCertaintyType Example

The aspect of quality, confidence, or certainty.
ArtifactAssessment.content.classifier EvidenceCertaintyRating Example

The assessment of quality, confidence, or certainty.
ArtifactAssessment.workflowStatus ArtifactAssessmentWorkflowStatus Required

Possible values for the workflow status of the comment or assessment, typically used to coordinate workflow around the process of accepting and rejecting changes and comments on the artifact.
ArtifactAssessment.disposition ArtifactAssessmentDisposition Required

Possible values for the disposition of a comment or change request, typically used for comments and change requests, to indicate the disposition of the responsible party towards the changes suggested by the comment or change request.

14.8.6 Search Parameters

Search parameters for this resource. See also the full list of search parameters for this resource, and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

Name Type Description Expression In Common
date date The artifact assessment publication date ArtifactAssessment.date
identifier token The artifact assessment identifier ArtifactAssessment.identifier