From 5482fd364f504c27b57eaebfee0a9ae43af04f9f Mon Sep 17 00:00:00 2001
From: khalid_shahin <khalid@evidence.report>
Date: Tue, 7 May 2024 15:57:27 -0400
Subject: [PATCH] J#45094 Added comment to Evidence.relatedArtifact about
 quotation and added and example for it

---
 .../evidence-example-quoted-source.xml        | 85 +++++++++++++++++++
 source/evidence/list-Evidence-examples.xml    | 12 +++
 .../evidence/structuredefinition-Evidence.xml |  1 +
 3 files changed, 98 insertions(+)
 create mode 100644 source/evidence/evidence-example-quoted-source.xml

diff --git a/source/evidence/evidence-example-quoted-source.xml b/source/evidence/evidence-example-quoted-source.xml
new file mode 100644
index 0000000000..50be042a94
--- /dev/null
+++ b/source/evidence/evidence-example-quoted-source.xml
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<Evidence xmlns="http://hl7.org/fhir">.
+    <id value="example-quoted-source"/>
+	<title value="Quoted Source: Prevalence of PASC at 30 days"/>
+	<status value="active"/>
+	<relatedArtifact>
+		<type value="derived-from"/>
+		<classifier>
+			<coding>
+				<system value="http://hl7.org/fhir/provenance-entity-role"/>
+				<code value="quotation"/>
+				<display value="Quotation"/>
+			</coding>
+			<text value="Prevalence of PASC at 30 days post-infection was 68.7% (95% confidence interval: 63.4, 73.9)."/>
+		</classifier>
+		<resourceReference>
+			<reference value="Citation/238142"/>
+			<type value="Citation"/>
+			<display value="34347785 Post-acute sequelae of COVID-19 in a non-hospitalized cohort: Results from the Arizona CoVHORT"/>
+		</resourceReference>
+	</relatedArtifact>
+	<description value="An example of using the relatedArtifact element to quote a line of text from the evidence source."/>
+	<variableDefinition>
+		<description value="People with a history of COVID-19 who were not hospitalized (Arizona CoVHORT)"/>
+		<variableRole value="population"/>
+	</variableDefinition>
+	<variableDefinition>
+		<description value="Post-acute sequelae of COVID-19"/>
+		<variableRole value="outcome"/>
+	</variableDefinition>
+	<studyDesign>
+		<coding>
+			<system value="https://fevir.net/sevco"/>
+			<code value="SEVCO:01002"/>
+			<display value="Observational research"/>
+		</coding>
+		<coding>
+			<system value="https://fevir.net/sevco"/>
+			<code value="SEVCO:01028"/>
+			<display value="Longitudinal data collection"/>
+		</coding>
+	</studyDesign>
+	<statistic>
+		<description value="Prevalence 68.7% (95% Confidence interval 63.4% to 73.9%)"/>
+		<statisticType>
+			<coding>
+				<system value="https://fevir.net/resources/CodeSystem/27270"/>
+				<code value="STATO:0000412"/>
+				<display value="prevalence"/>
+			</coding>
+		</statisticType>
+		<quantity>
+			<value value="68.7"/>
+			<unit value="%"/>
+			<system value="http://unitsofmeasure.org"/>
+			<code value="%"/>
+		</quantity>
+		<attributeEstimate>
+			<description value="95% Confidence interval 63.4% to 73.9%"/>
+			<type>
+				<coding>
+					<system value="https://fevir.net/resources/CodeSystem/27270"/>
+					<code value="TBD:0000059"/>
+					<display value="Confidence interval"/>
+				</coding>
+			</type>
+			<level value="0.95"/>
+			<range>
+				<low>
+					<value value="63.4"/>
+					<unit value="%"/>
+					<system value="http://unitsofmeasure.org"/>
+					<code value="%"/>
+				</low>
+				<high>
+					<value value="73.9"/>
+					<unit value="%"/>
+					<system value="http://unitsofmeasure.org"/>
+					<code value="%"/>
+				</high>
+			</range>
+		</attributeEstimate>
+	</statistic>
+</Evidence>
\ No newline at end of file
diff --git a/source/evidence/list-Evidence-examples.xml b/source/evidence/list-Evidence-examples.xml
index 123cf1eefe..b689b5f6f1 100644
--- a/source/evidence/list-Evidence-examples.xml
+++ b/source/evidence/list-Evidence-examples.xml
@@ -64,4 +64,16 @@
       <display value="Effect of Alteplase vs No alteplase on mRS 0-2 at 90 days in Stroke 3-4.5 hours prior"/>
     </item>
   </entry>
+  <entry>
+    <extension url="http://hl7.org/fhir/build/StructureDefinition/description">
+      <valueString value="An example of using the relatedArtifact element to quote a line of text from the evidence source."/>
+    </extension>
+    <extension url="http://hl7.org/fhir/build/StructureDefinition/title">
+      <valueString value="evidence-example-quoted-source"/>
+    </extension>
+    <item>
+      <reference value="Evidence/example-quoted-source"/>
+      <display value="Quoted Source: Prevalence of PASC at 30 days"/>
+    </item>
+  </entry>
 </List>
\ No newline at end of file
diff --git a/source/evidence/structuredefinition-Evidence.xml b/source/evidence/structuredefinition-Evidence.xml
index 3f3b1e569b..167f3a3efd 100644
--- a/source/evidence/structuredefinition-Evidence.xml
+++ b/source/evidence/structuredefinition-Evidence.xml
@@ -455,6 +455,7 @@
 			<path value="Evidence.relatedArtifact"/>
 			<short value="Link or citation to artifact associated with the summary"/>
 			<definition value="Link or citation to artifact associated with the summary."/>
+			<comment value="Use type value 'derived-from' to denote the source for the Evidence content. To express exact phrasing in the source material, use a classifier instance with a coding value of 'Quotation' and a text value of the quoted content. The coding value of 'Quotation' can be expressed with a system value of 'http://hl7.org/fhir/provenance-entity-role', a code value of 'quotation' and a display value of 'Quotation'."/>
 			<min value="0"/>
 			<max value="*"/>
 			<type>