cqm-reports 3.0.0.pre.alpha.2 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA256:
-  metadata.gz: 046a88f916e40e42ced139fe200c6fbd202b61583e8e52c6b0cd95e66876d719
-  data.tar.gz: 91135435b8c4793991b838440ea33414deb376fee10ff7728bb785cacc8549b8
+SHA1:
+  metadata.gz: 86b46847a0a68ecf86611dce268e5a12f6d01af6
+  data.tar.gz: 906d1984866e314876ca0d713f6b08a01a6ab8f5
 SHA512:
-  metadata.gz: edd69c08263f69d9775374749d29ebfd2d2ef73daeafc14b8b71a7c98a585c1e70fc709cc7d66300519a980e36878a3617d848068bc5b03573ecf34e2a33ced6
-  data.tar.gz: a57c164a58a8bbb1227bd4a2c3ea99bd30bc96370d598ebc3073ecd11f370501cbb9ea07393569c6317eabe8145637833cea983bc4f89672bcd9e10bfd0d2187
+  metadata.gz: cc1e458ec8496af2e20bec1068f7acf723976bdfa92610cd2f1b99f36692a5cb7ddb3c6d1648be17704d820d0002b8b32c78d52881ea1d78d71643909ae0499f
+  data.tar.gz: 9f4fa410245d83fbd1beb11183461a4cd8442859bfc391b7bffd90c5d9afeb2c91cd3ca83d54e9bc7c6a49f8ad9b6c9fe55230167161fd03cc4fc188066aec95

data/Gemfile

@@ -17,6 +17,7 @@ group :development do
 end
 
 group :test do
+  gem 'cqm-models', git: 'https://github.com/projecttacoma/cqm-models', branch: 'master'
   gem 'factory_girl', '~> 4.1.0'
   gem 'tailor', '~> 1.1.2'
   gem 'cane', '~> 2.3.0'
@@ -26,6 +27,6 @@ group :test do
   gem 'minitest', '~> 5.3'
   gem 'minitest-reporters'
   gem 'awesome_print', :require => 'ap'
-  gem 'cqm-validators'
+  gem 'cqm-validators', git: 'https://github.com/projecttacoma/cqm-validators', branch: 'master'
   gem 'nokogiri-diff'
 end

data/README.md

@@ -18,6 +18,32 @@ Starting with version **2.0.0** released on 6/20/2019, cqm-reports versioning ha
 
 For the versions available, see [tags on this repository](https://github.com/projecttacoma/cqm-validators/tags).
 
+Importing QRDA
+==========
+
+A QRDA document can be imported into a CQM::Patient (defined in [cqm-models](https://github.com/projecttacoma/cqm-models)) using the following commands.
+
+        doc = Nokogiri::XML(file)
+        patient = QRDA::Cat1::PatientImporter.instance.parse_cat1(doc)
+
+Exporting QRDA Category I
+==========
+
+Exporting a QRDA document from a CQM::Patient (defined in [cqm-models](https://github.com/projecttacoma/cqm-models)) using the following command.
+
+        Qrda1R5.new(patient, measures, options).render
+* patient is a [CQM::Patient](https://github.com/projecttacoma/cqm-models/blob/master/app/models/cqm/patient.rb)
+* measures is an array of [CQM::Measure](https://github.com/projecttacoma/cqm-models/blob/master/app/models/cqm/measure.rb)
+* options is a hash that can be used to pass in:
+  * provider
+  * patient_addresses
+  * patient_telecoms
+  * start_time
+  * end_time
+  * submission_program 
+
+QRDA export requires the [mustache](https://github.com/mustache/mustache) gem 
+
 ## License
 
 Copyright 2019 The MITRE Corporation

data/lib/cqm-reports.rb

@@ -5,6 +5,7 @@ require 'ostruct'
 require_relative 'util/code_system_helper'
 require_relative 'util/hqmf_template_helper'
 require_relative 'util/qrda_template_helper'
+require_relative 'util/entity_helper.rb'
 
 require_relative 'qrda-export/helper/frequency_helper.rb'
 require_relative 'qrda-export/helper/aggregate_object_helper.rb'
@@ -66,11 +67,11 @@ require_relative 'qrda-import/data-element-importers/physical_exam_recommended_i
 require_relative 'qrda-import/data-element-importers/procedure_order_importer.rb'
 require_relative 'qrda-import/data-element-importers/procedure_performed_importer.rb'
 require_relative 'qrda-import/data-element-importers/procedure_recommended_importer.rb'
+require_relative 'qrda-import/data-element-importers/program_participation_importer.rb'
 require_relative 'qrda-import/data-element-importers/provider_care_experience_importer.rb'
+require_relative 'qrda-import/data-element-importers/related_person_importer.rb'
 require_relative 'qrda-import/data-element-importers/substance_administered_importer.rb'
 require_relative 'qrda-import/data-element-importers/substance_order_importer.rb'
 require_relative 'qrda-import/data-element-importers/substance_recommended_importer.rb'
 require_relative 'qrda-import/data-element-importers/symptom_importer.rb'
 require_relative 'qrda-import/patient_importer.rb'
-require_relative 'ext/data_element.rb'
-require_relative 'ext/code.rb'

data/lib/html-export/qdm-patient/data_element/_data_element_other_fields.mustache

@@ -15,8 +15,18 @@
 		<div class="div-table-head--no-border"><span class="criteria-heading">Anatomical Location Site:</span>  {{{code_code_system_string}}}</div>
 	</div>
 {{/anatomicalLocationSite}}
+{{#cause}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Cause:</span>  {{{code_code_system_string}}}</div>
+	</div>
+{{/cause}}
+{{#category}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Category:</span>  {{{code_code_system_string}}}</div>
+	</div>
+{{/category}}
 {{#components}}
-	{{#code}}	
+	{{#code}}
 		<div class="div-head-row">
 			<div class="div-table-head--no-border"><span class="criteria-heading">Component Code:</span>  {{{code_code_system_string}}}</div>
 		</div>
@@ -27,9 +37,14 @@
 		</div>
 	{{/result}}
 {{/components}}
+{{#daysSupplied}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Days Supplied:</span>  {{{daysSupplied}}}</div>
+	</div>
+{{/daysSupplied}}
 {{#diagnoses}}
 	<div class="div-head-row">
-		<div class="div-table-head--no-border"><span class="criteria-heading">Diagnosis:</span>  {{{code_code_system_string}}}</div>
+		<div class="div-table-head--no-border"><span class="criteria-heading">Diagnosis:</span>  {{{nested_code_string}}}</div>
 	</div>
 {{/diagnoses}}
 {{#dischargeDisposition}}
@@ -37,14 +52,24 @@
 		<div class="div-table-head--no-border"><span class="criteria-heading">Discharge Disposition:</span>  {{{code_code_system_string}}}</div>
 	</div>
 {{/dischargeDisposition}}
+{{#dispenser}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Dispenser:</span>  {{{entity_string}}}</div>
+	</div>
+{{/dispenser}}
+{{#dosage}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Dosage:</span>  {{{unit_string}}}</div>
+	</div>
+{{/dosage}}
 {{#facilityLocation}}
 	<div class="div-head-row">
-		<div class="div-table-head--no-border"><span class="criteria-heading">Facility Location:</span>  {{{code_code_system_string}}}</div>
+		<div class="div-table-head--no-border"><span class="criteria-heading">Facility Location:</span>  {{{nested_code_string}}}</div>
 	</div>
 {{/facilityLocation}}
 {{#facilityLocations}}
 	<div class="div-head-row">
-		<div class="div-table-head--no-border"><span class="criteria-heading">Facility:</span>  {{{facility_string}}}</div>
+		<div class="div-table-head--no-border"><span class="criteria-heading">Facility:</span>  {{{nested_code_string}}}</div>
 	</div>
 {{/facilityLocations}}
 {{#frequency}}
@@ -52,11 +77,31 @@
 		<div class="div-table-head--no-border"><span class="criteria-heading">Frequency:</span>  {{{code_code_system_string}}}</div>
 	</div>
 {{/frequency}}
+{{#identifier}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Identifier:</span>  {{{identifier_string}}}</div>
+	</div>
+{{/identifier}}
 {{#lengthOfStay}}
 	<div class="div-head-row">
 		<div class="div-table-head--no-border"><span class="criteria-heading">Length Of Stay:</span>  {{{unit_string}}}</div>
 	</div>
 {{/lengthOfStay}}
+{{#linkedPatientId}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Linked Patient Id:</span>  {{{linkedPatientId}}}</div>
+	</div>
+{{/linkedPatientId}}
+{{#medium}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Medium:</span>  {{{code_code_system_string}}}</div>
+	</div>
+{{/medium}}
+{{#methodCode}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Method:</span>  {{{code_code_system_string}}}</div>
+	</div>
+{{/methodCode}}
 {{#negationRationale}}
 	<div class="div-head-row">
 		<div class="div-table-head--no-border"><span class="criteria-heading">Negation Reason:</span>  {{{code_code_system_string}}}</div>
@@ -67,26 +112,105 @@
 		<div class="div-table-head--no-border"><span class="criteria-heading">Ordinality:</span>  {{{code_code_system_string}}}</div>
 	</div>
 {{/ordinality}}
+{{#participant}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Participant:</span>  {{{entity_string}}}</div>
+	</div>
+{{/participant}}
+{{#performer}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Performer:</span>  {{{entity_string}}}</div>
+	</div>
+{{/performer}}
+{{#prescriber}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Prescriber:</span>  {{{entity_string}}}</div>
+	</div>
+{{/prescriber}}
 {{#principalDiagnosis}}
 	<div class="div-head-row">
 		<div class="div-table-head--no-border"><span class="criteria-heading">Principal Diagnosis:</span>  {{{code_code_system_string}}}</div>
 	</div>
 {{/principalDiagnosis}}
+{{#priority}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Priority:</span>  {{{code_code_system_string}}}</div>
+	</div>
+{{/priority}}
+{{#rank}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Rank:</span>  {{{rank}}}</div>
+	</div>
+{{/rank}}
 {{#reason}}
 	<div class="div-head-row">
 		<div class="div-table-head--no-border"><span class="criteria-heading">Reason:</span>  {{{code_code_system_string}}}</div>
 	</div>
 {{/reason}}
+{{#recipient}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Recipient:</span>  {{{entity_string}}}</div>
+	</div>
+{{/recipient}}
+{{#recorder}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Recorder:</span>  {{{entity_string}}}</div>
+	</div>
+{{/recorder}}
+{{#referenceRange}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Reference Range Start:</span>  {{{low}}}</div>
+	</div>
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Reference Range End:</span>  {{{high}}}</div>
+	</div>
+{{/referenceRange}}
+{{#refills}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Refills:</span>  {{{refills}}}</div>
+	</div>
+{{/refills}}
+{{#relatedTo}}
+{{! TODO: relatedTo is an array of strings, which are ids of dataElements, and not very useful to the user}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Related To:</span>  {{{relatedTo}}}</div>
+	</div>
+{{/relatedTo}}
+{{#relationship}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Relationship:</span>  {{{code_code_system_string}}}</div>
+	</div>
+{{/relationship}}
+{{#requester}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Requester:</span>  {{{entity_string}}}</div>
+	</div>
+{{/requester}}
 {{#route}}
 	<div class="div-head-row">
 		<div class="div-table-head--no-border"><span class="criteria-heading">Route:</span>  {{{code_code_system_string}}}</div>
 	</div>
 {{/route}}
+{{#sender}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Sender:</span>  {{{entity_string}}}</div>
+	</div>
+{{/sender}}
+{{#setting}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Setting:</span>  {{{code_code_system_string}}}</div>
+	</div>
+{{/setting}}
 {{#severity}}
 	<div class="div-head-row">
 		<div class="div-table-head--no-border"><span class="criteria-heading">Severity:</span>  {{{code_code_system_string}}}</div>
 	</div>
 {{/severity}}
+{{#supply}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Supply:</span>  {{{unit_string}}}</div>
+	</div>
+{{/supply}}
 {{#status}}
 	<div class="div-head-row">
 		<div class="div-table-head--no-border"><span class="criteria-heading">Status:</span>  {{{code_code_system_string}}}</div>
@@ -103,4 +227,4 @@
 	</div>
 {{/result}}
 </div>
-</div>
+</div>

data/lib/html-export/qdm-patient/data_element/_data_element_times.mustache

@@ -10,6 +10,11 @@
 		</div>
 	{{/end_time?}}
 {{/relevantPeriod}}
+{{#relevantDatetime}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Relevant Date/Time:</span>  {{{relevantDatetime}}}</div>
+	</div>
+{{/relevantDatetime}}
 {{#prevalencePeriod}}
 	<div class="div-head-row">
 	    <div class="div-table-head--no-border"><span class="criteria-heading">Prevalence Period Start:</span>  {{{low}}}</div>
@@ -20,6 +25,16 @@
 		</div>
 	{{/end_time?}}
 {{/prevalencePeriod}}
+{{#participationPeriod}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Participation Period Start:</span>  {{{low}}}</div>
+	</div>
+	{{#end_time?}}
+		<div class="div-head-row">
+			<div class="div-table-head--no-border"><span class="criteria-heading">Participation Period End:</span>  {{{high}}}</div>
+		</div>
+	{{/end_time?}}
+{{/participationPeriod}}
 {{#authorDatetime}}
 	<div class="div-head-row">
 		<div class="div-table-head--no-border"><span class="criteria-heading">Author Date/Time:</span>  {{{authorDatetime}}}</div>
@@ -40,5 +55,25 @@
 		<div class="div-table-head--no-border"><span class="criteria-heading">Incision Date/Time:</span>  {{{incisionDatetime}}}</div>
 	</div>
 {{/incisionDatetime}}
+{{#receivedDatetime}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Received Date/Time:</span>  {{{receivedDatetime}}}</div>
+	</div>
+{{/receivedDatetime}}
+{{#sentDatetime}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Sent Date/Time:</span>  {{{sentDatetime}}}</div>
+	</div>
+{{/sentDatetime}}
+{{#birthDatetime}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Birth Date/Time:</span>  {{{birthDatetime}}}</div>
+	</div>
+{{/birthDatetime}}
+{{#expiredDatetime}}
+	<div class="div-head-row">
+		<div class="div-table-head--no-border"><span class="criteria-heading">Expired Date/Time:</span>  {{{expiredDatetime}}}</div>
+	</div>
+{{/expiredDatetime}}
+</div>
 </div>
-</div>

data/lib/html-export/qdm-patient/qdm_patient.rb

@@ -1,6 +1,7 @@
 require 'mustache'
 class QdmPatient < Mustache
   include Qrda::Export::Helper::PatientViewHelper
+  include HQMF::Util::EntityHelper
 
   self.template_path = __dir__
 
@@ -17,17 +18,50 @@ class QdmPatient < Mustache
   def data_elements
     de_hash = {}
     @qdmPatient.dataElements.each do |data_element|
+      data_element['methodCode'] = data_element['method'] if data_element['method']
       de_hash[data_element._type] ? de_hash[data_element._type][:element_list] << data_element : de_hash[data_element._type] = { title: data_element._type, element_list: [data_element] }
     end
     JSON.parse(de_hash.values.to_json)
   end
 
   def unit_string
+    return "#{self['value']} " unless self['unit']
     "#{self['value']} #{self['unit']}"
   end
 
+  def entity_string
+    if care_partner_entity?
+      "</br>&nbsp; Care Partner: #{identifier_for_element(self['identifier'])}
+      </br>&nbsp; Care Partner Relationship: #{code_for_element(self['relationship'])}"
+    elsif organization_entity?
+      "</br>&nbsp; Organization: #{identifier_for_element(self['identifier'])}
+      </br>&nbsp; Organization Type: #{code_for_element(self['type'])}"
+    elsif patient_entity?
+      "</br>&nbsp; Patient: #{identifier_for_element(self['identifier'])}"
+    elsif practitioner_entity?
+      "</br>&nbsp; Practitioner: #{identifier_for_element(self['identifier'])}
+      </br>&nbsp; Practitioner Role: #{code_for_element(self['role'])},
+      </br>&nbsp; Practitioner Specialty: #{code_for_element(self['specialty'])},
+      </br>&nbsp; Practitioner Qualification: #{code_for_element(self['qualification'])}"
+    else
+      "</br>&nbsp; Entity: #{identifier_for_element(self['identifier'])}"
+    end
+  end
+
+  def identifier_string
+    identifier_for_element(self)
+  end
+
+  def identifier_for_element(identifier)
+    "#{identifier['value']} (#{identifier['namingSystem']})"
+  end
+
   def code_code_system_string
-    "#{self['code']} (#{HQMF::Util::CodeSystemHelper.code_system_for(self['system'])})"
+    code_for_element(self)
+  end
+
+  def code_for_element(element)
+    "#{element['code']} (#{HQMF::Util::CodeSystemHelper.code_system_for(element['system'])})"
   end
 
   def code_system_name
@@ -35,14 +69,14 @@ class QdmPatient < Mustache
   end
 
   def result_string
-    return unit_string if self['unit']
+    return unit_string if self['value']
     return code_code_system_string if self['code']
 
-    ''
+    self['result']
   end
 
-  def facility_string
-    "#{self['code']['code']} (#{self['code']['codeSystem']})"
+  def nested_code_string
+    code_for_element(self['code'])
   end
 
   def end_time?

data/lib/qrda-export/catI-r5/_header.mustache

@@ -6,9 +6,9 @@
 <!-- QRDA templateId -->
 <templateId root="2.16.840.1.113883.10.20.24.1.1" extension="2017-08-01"/>
 <!-- QDM-based QRDA templateId -->
-<templateId root="2.16.840.1.113883.10.20.24.1.2" extension="2017-08-01"/>
+<templateId root="2.16.840.1.113883.10.20.24.1.2" extension="2019-12-01"/>
 <!-- CMS QRDA templateId -->
-<templateId root="2.16.840.1.113883.10.20.24.1.3" extension="2018-02-01"/>
+<templateId root="2.16.840.1.113883.10.20.24.1.3" extension="2020-02-01"/>
 <!-- This is the globally unique identifier for this QRDA document -->
 <id root="{{random_id}}"/>
 <!-- QRDA document type code -->

data/lib/qrda-export/catI-r5/qrda1_r5.mustache

@@ -12,8 +12,8 @@
           <!-- This is the templateId for Patient Data section -->
           <templateId root="2.16.840.1.113883.10.20.17.2.4"/>
           <!-- This is the templateId for Patient Data QDM section -->
-          <templateId extension="2017-08-01" root="2.16.840.1.113883.10.20.24.2.1"/>
-          <templateId extension="2018-02-01" root="2.16.840.1.113883.10.20.24.2.1.1"/>
+          <templateId extension="2019-12-01" root="2.16.840.1.113883.10.20.24.2.1"/>
+          <templateId extension="2020-02-01" root="2.16.840.1.113883.10.20.24.2.1.1"/>
           <code code="55188-7" codeSystem="2.16.840.1.113883.6.1"/>
           <title>Patient Data</title>
           <text/>
@@ -174,10 +174,18 @@
             {{> qrda_templates/procedure_recommended}}
           {{/procedure_recommended}}
 
+          {{#program_participation}}
+            {{> qrda_templates/program_participation}}
+          {{/program_participation}}
+
           {{#provider_care_experience}}
             {{> qrda_templates/provider_care_experience}}
           {{/provider_care_experience}}
 
+          {{#related_person}}
+            {{> qrda_templates/related_person}}
+          {{/related_person}}
+
           {{#substance_administered}}
             {{> qrda_templates/medication_administered}}
           {{/substance_administered}}