--- type: "resource" title: "ArtifactAssessment" resource: "ArtifactAssessment" --- # ArtifactAssessment ## Introduction ## 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. ## 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. ## 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. ## StructureDefinition ### Elements (Simplified) - **[ArtifactAssessment](/artifactassessment-definitions#ArtifactAssessment)** [0..*]: - Adds metadata-supported comments, classifiers or ratings related to a Resource - **[ArtifactAssessment.identifier](/artifactassessment-definitions#ArtifactAssessment.identifier)** [0..*]: [Identifier](/Identifier) Additional identifier for the artifact assessment - **[ArtifactAssessment.title](/artifactassessment-definitions#ArtifactAssessment.title)** [0..1]: [string](/string) A label for use in displaying and selecting the artifact assessment - **[ArtifactAssessment.citeAs](/artifactassessment-definitions#ArtifactAssessment.citeAs)** [0..1]: [markdown](/markdown) How to cite the comment or rating - **[ArtifactAssessment.artifact[x]](/artifactassessment-definitions#ArtifactAssessment.artifact%5Bx%5D)** [1..1]: Reference([Any](/Any)), [canonical](/canonical), [uri](/uri) The artifact assessed, commented upon or rated - **[ArtifactAssessment.relatesTo](/artifactassessment-definitions#ArtifactAssessment.relatesTo)** [0..*]: [BackboneElement](/BackboneElement) Relationship to other Resources - **[ArtifactAssessment.relatesTo.type](/artifactassessment-definitions#ArtifactAssessment.relatesTo.type)** [1..1]: [CodeableConcept](/CodeableConcept) extensible:[artifact-relationship-type](/valueset-artifact-relationship-type) documentation | justification | citation | 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 | documents | specification-of | created-with | cite-as | reprint | reprint-of | summarizes - **[ArtifactAssessment.relatesTo.target[x]](/artifactassessment-definitions#ArtifactAssessment.relatesTo.target%5Bx%5D)** [1..1]: [uri](/uri), [Attachment](/Attachment), [canonical](/canonical), Reference([Resource](/Resource)), [markdown](/markdown) The artifact that is related to this ArtifactAssessment - **[ArtifactAssessment.date](/artifactassessment-definitions#ArtifactAssessment.date)** [0..1]: [dateTime](/dateTime) Date last changed - **[ArtifactAssessment.copyright](/artifactassessment-definitions#ArtifactAssessment.copyright)** [0..1]: [markdown](/markdown) Notice about intellectual property ownership, can include restrictions on use - **[ArtifactAssessment.approvalDate](/artifactassessment-definitions#ArtifactAssessment.approvalDate)** [0..1]: [date](/date) When the artifact assessment was approved by publisher - **[ArtifactAssessment.lastReviewDate](/artifactassessment-definitions#ArtifactAssessment.lastReviewDate)** [0..1]: [date](/date) When the artifact assessment was last reviewed by the publisher - **[ArtifactAssessment.content](/artifactassessment-definitions#ArtifactAssessment.content)** [0..*]: [BackboneElement](/BackboneElement) Comment, classifier, or rating content - **[ArtifactAssessment.content.summary](/artifactassessment-definitions#ArtifactAssessment.content.summary)** [0..1]: [markdown](/markdown) Brief summary of the content - **[ArtifactAssessment.content.type](/artifactassessment-definitions#ArtifactAssessment.content.type)** [0..1]: [CodeableConcept](/CodeableConcept) example:[certainty-type](/valueset-certainty-type) What type of content - **[ArtifactAssessment.content.classifier](/artifactassessment-definitions#ArtifactAssessment.content.classifier)** [0..*]: [CodeableConcept](/CodeableConcept) example:[certainty-rating](/valueset-certainty-rating) Rating, classifier, or assessment - **[ArtifactAssessment.content.quantity](/artifactassessment-definitions#ArtifactAssessment.content.quantity)** [0..1]: [Quantity](/Quantity) Quantitative rating - **[ArtifactAssessment.content.author](/artifactassessment-definitions#ArtifactAssessment.content.author)** [0..*]: [Reference(Patient](/Reference(Patient), [Practitioner](/Practitioner), [PractitionerRole](/PractitionerRole), [Organization](/Organization), [Device)](/Device)) Who authored the content - **[ArtifactAssessment.content.path](/artifactassessment-definitions#ArtifactAssessment.content.path)** [0..*]: [uri](/uri) What the comment is directed to - **[ArtifactAssessment.content.relatesTo](/artifactassessment-definitions#ArtifactAssessment.content.relatesTo)** [0..*]: - Relationship to other Resources - **[ArtifactAssessment.content.freeToShare](/artifactassessment-definitions#ArtifactAssessment.content.freeToShare)** [0..1]: [boolean](/boolean) Acceptable to publicly share the content - **[ArtifactAssessment.content.component](/artifactassessment-definitions#ArtifactAssessment.content.component)** [0..*]: - Comment, classifier, or rating content - **[ArtifactAssessment.workflowStatus](/artifactassessment-definitions#ArtifactAssessment.workflowStatus)** [0..1]: [code](/code) required:[artifactassessment-workflow-status](/valueset-artifactassessment-workflow-status) submitted | triaged | waiting-for-input | resolved-no-change | resolved-change-required | deferred | duplicate | applied | published | entered-in-error - **[ArtifactAssessment.disposition](/artifactassessment-definitions#ArtifactAssessment.disposition)** [0..1]: [code](/code) required:[artifactassessment-disposition](/valueset-artifactassessment-disposition) unresolved | not-persuasive | persuasive | persuasive-with-modification | not-persuasive-with-modification ## Mappings - [ArtifactAssessment Mappings](/artifactassessment-mappings) — 14 mapping entries ## Resource Packs ### list-ArtifactAssessment-packs.xml ```xml ``` ## Search Parameters - [date](/artifactassessment-search#date) — **date** — The artifact assessment publication date — `ArtifactAssessment.date` - [identifier](/artifactassessment-search#identifier) — **token** — The artifact assessment identifier — `ArtifactAssessment.identifier` [Full Search Parameters](/artifactassessment-search) ## Examples - [artifactassessment-example-certainty-rating](/artifactassessment-example-artifactassessment-example-certainty-rating) — artifactassessment-example-certainty-rating - [artifactassessment-example-justification-for-recommendation](/artifactassessment-example-artifactassessment-example-justification-for-recommendation) — artifactassessment-example-justification-for-recommendation - [artifactassessment-example-risk-of-bias-assessment-of-parachute-trial](/artifactassessment-example-artifactassessment-example-risk-of-bias-assessment-of-parachute-trial) — artifactassessment-example-risk-of-bias-assessment-of-parachute-trial - [artifactassessment-examples-header](/artifactassessment-example-artifactassessment-examples-header) — artifactassessment-examples-header - [example-certainty-rating](/artifactassessment-example-example-certainty-rating) — artifactassessment-example-certainty-rating — Certainty Rating of all-cause mortality in meta-analysis of RCTs of heparin for moderately ill patients with COVID-19 - [example-justification-for-recommendation](/artifactassessment-example-example-justification-for-recommendation) — artifactassessment-example-justification-for-recommendation — Justification for Recommendation: ADA Obesity Management Recommendation - [example-risk-of-bias-assessment-of-parachute-trial](/artifactassessment-example-example-risk-of-bias-assessment-of-parachute-trial) — artifactassessment-example-risk-of-bias-assessment-of-parachute-trial — This is an example of the RiskOfBias Profile. - [risk-of-bias-example](/artifactassessment-example-risk-of-bias-example) — artifactassessment-risk-of-bias-example — ArtifactAssessment that contains a series of nested ratings to document the risk of bias assessment of an Evidence resource [Full Examples](/artifactassessment-examples) ## Mapping Exceptions ### artifactassessment-fivews-mapping-exceptions.xml ### Unmapped Elements - **FiveWs.author** — Unknown - **FiveWs.actor** — Unknown - **FiveWs.cause** — Unknown - **FiveWs.version** — Unknown - **FiveWs.witness** — Unknown - **FiveWs.class** — Unknown - **FiveWs.where** — Unknown - **FiveWs.context** — Unknown - **FiveWs.init** — Unknown - **FiveWs.why** — Unknown - **FiveWs.source** — Unknown - **FiveWs.who** — Unknown - **FiveWs.grade** — Unknown - **FiveWs.status** — Unknown - **FiveWs.planned** — Unknown - **FiveWs.done** — Unknown - **FiveWs.subject** — Unknown