health-data-standards 3.6.1 → 3.7.0

data/templates/cat3/r2/_reporting_parameters.cat3.erb

@@ -0,0 +1,29 @@
+      <component>
+        <section>
+          <!-- This is the templateId for Reporting Parameters section -->
+          <templateId root="2.16.840.1.113883.10.20.17.2.1"/>
+
+          <!-- This is the templateId for the QRDA III Reporting Parameters Section -->
+          <templateId root="2.16.840.1.113883.10.20.27.2.2"/>
+
+          <code code="55187-9" codeSystem="2.16.840.1.113883.6.1"/>
+          <title>Reporting Parameters</title>
+          <text>
+            <list>
+              <item>Reporting period: <%= start_date.to_formatted_s(:long_ordinal) %> - <%= end_date.to_formatted_s(:long_ordinal) %></item>
+            </list>
+          </text>
+          <entry typeCode="DRIV">
+            <act classCode="ACT" moodCode="EVN">
+              <!-- This is the templateId for Reporting Parameters Act -->
+              <templateId root="2.16.840.1.113883.10.20.17.3.8"/>
+              <id extension="<%= identifier_for([start_date, end_date]) %>" />
+              <code code="252116004" codeSystem="2.16.840.1.113883.6.96" displayName="Observation Parameters"/>
+              <effectiveTime>
+                <low value="<%= start_date.to_formatted_s(:number) %>"/>
+                <high value="<%= end_date.to_formatted_s(:number) %>"/>
+              </effectiveTime>
+            </act>
+          </entry>
+        </section>
+      </component>

data/templates/cat3/r2/_supplemental_data.cat3.erb

@@ -0,0 +1,38 @@
+  <!--                            Supplemental Date Template                                                  -->
+
+  <entryRelationship typeCode="COMP">
+    <observation classCode="OBS" moodCode="EVN">
+      <!-- <%= template_name %> -->
+      <% template_ids.each do |tid| %>
+        <templateId root="<%= tid %>" extension="<%= extension %>"/>
+      <% end %>
+        <id nullFlavor="NA" />
+      <code code="<%= supplemental_data_code %>" 
+            codeSystem="<%= supplemental_data_code_system %>"/>
+      <statusCode code="completed"/>
+      <% if supplemental_data_value_code == "" || supplemental_data_value_code == "UNK" -%>
+      <value xsi:type="CD" 
+             nullFlavor="UNK" />
+      <% else -%>
+      
+      <value xsi:type="CD" 
+             code="<%= supplemental_data_value_code %>"
+             codeSystem="<%= supplemental_data_value_code_system %>"/>
+      <% end %>       
+      <entryRelationship typeCode="SUBJ" inversionInd="true">
+        <!-- Aggregate Count template -->
+        <observation classCode="OBS" moodCode="EVN">
+          <templateId root="2.16.840.1.113883.10.20.27.3.3"/>
+          <code code="MSRAGG" 
+                displayName="rate aggregation" 
+                codeSystem="2.16.840.1.113883.5.4" 
+                codeSystemName="ActCode"/>
+          <value xsi:type="INT" value="<%= count.round %>"/>
+          <methodCode code="COUNT" 
+                      displayName="Count" 
+                      codeSystem="2.16.840.1.113883.5.84" 
+                      codeSystemName="ObservationMethod"/>
+        </observation>
+      </entryRelationship>
+    </observation>
+  </entryRelationship> 

data/templates/cat3/r2/_telecom.cat3.erb

@@ -0,0 +1 @@
+<telecom use="<%=telecom.use%>" value="tel:+<%=telecom.value%>" />

data/templates/cat3/r2/show.cat3.erb

@@ -0,0 +1,150 @@
+<?xml version="1.0" encoding="utf-8"?>
+<ClinicalDocument xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xmlns="urn:hl7-org:v3"
+ xmlns:cda="urn:hl7-org:v3">
+
+  <!--
+    ********************************************************
+    CDA Header
+    ********************************************************
+  -->
+  <realmCode code="US"/>
+  <typeId root="2.16.840.1.113883.1.3" extension="POCD_HD000040"/>
+  <!-- QRDA Category III template ID (this template ID differs from QRDA III comment only template ID). -->
+  <templateId root="2.16.840.1.113883.10.20.27.1.1" extension="2016-09-01"/>
+  <%== render :partial=>"id", :locals=>{identifier: header.identifier} %>
+
+  <!-- SHALL QRDA III document type code -->
+  <code code="55184-6" codeSystem="2.16.840.1.113883.6.1" codeSystemName="LOINC"
+    displayName="Quality Reporting Document Architecture Calculated Summary Report"/>
+  <!-- SHALL Title, SHOULD have this content -->
+  <title>QRDA Calculated Summary Report</title>
+  <!-- SHALL  -->
+  <effectiveTime value="<%= Time.now.utc.to_formatted_s(:number) %>"/>
+  <confidentialityCode codeSystem="2.16.840.1.113883.5.25" code="N"/>
+  <languageCode code="en"/>
+  <!-- SHOULD The version of the file being submitted. -->
+  <versionNumber value="1"/>
+  <!-- SHALL contain recordTarget and ID - but ID is nulled to NA. This is an aggregate summary report. Therefore CDA's required patient identifier is nulled. -->
+  <recordTarget>
+    <patientRole>
+      <id nullFlavor="NA"/>
+    </patientRole>
+  </recordTarget>
+
+  <%== render :partial=>"author", :collection=>header.authors %>
+  <!-- SHALL have 1..* author. MAY be device or person.
+    The author of the CDA document in this example is a device at a data submission vendor/registry. -->
+
+  <!-- The custodian of the CDA document is the same as the legal authenticator in this
+  example and represents the reporting organization. -->
+  <!-- SHALL -->
+  <custodian>
+    <assignedCustodian>
+      <%== render :partial=>"organization", :locals=>{organization: header.custodian.organization, tag_name: "representedCustodianOrganization"} %>
+    </assignedCustodian>
+  </custodian>
+  <!-- The legal authenticator of the CDA document is a single person who is at the
+    same organization as the custodian in this example. This element must be present. -->
+  <!-- SHALL -->
+  <legalAuthenticator>
+    <!-- SHALL -->
+    <time value="<%= header.legal_authenticator.time.utc.to_formatted_s(:number) %>"/>
+    <!-- SHALL -->
+    <signatureCode code="S"/>
+    <assignedEntity>
+      <!-- SHALL ID -->
+      <%== render :partial=>"id", :collection=>header.legal_authenticator.ids, :id=>"identifier" %>
+      <%== render :partial=>"address" , :collection=>header.legal_authenticator.addresses %>
+      <assignedPerson>
+        <name>
+           <given><%= header.legal_authenticator.person.given %></given>
+           <family><%= header.legal_authenticator.person.family %></family>
+        </name>
+     </assignedPerson>
+
+      <%== render :partial=>"organization", :locals=>{organization: header.legal_authenticator.organization, tag_name: "representedOrganization"} %>
+    </assignedEntity>
+  </legalAuthenticator>
+
+  <%== render :partial=>"providers", :locals=>{providers: header.performers, start_date: start_date, end_date: end_date} %>
+
+
+  <!--
+********************************************************
+CDA Body
+********************************************************
+-->
+  <component>
+    <structuredBody>
+      <!--
+********************************************************
+QRDA Category III Reporting Parameters
+********************************************************
+-->
+<%== render :partial => 'reporting_parameters', :locals => {:start_date => start_date, :end_date => end_date} %>
+      <!--
+********************************************************
+Measure Section
+********************************************************
+-->
+      <component>
+        <section>
+          <!-- Implied template Measure Section templateId -->
+          <templateId root="2.16.840.1.113883.10.20.24.2.2"/>
+          <!-- In this case the query is using an eMeasure -->
+          <!-- QRDA Category III Measure Section template -->
+          <templateId root="2.16.840.1.113883.10.20.27.2.1" extension="2016-09-01"/>
+          <code code="55186-1" codeSystem="2.16.840.1.113883.6.1"/>
+          <title>Measure Section</title>
+          <text>
+
+          </text>
+          <% measures.each do |measure| %>
+          <entry>
+            <organizer classCode="CLUSTER" moodCode="EVN">
+              <!-- Implied template Measure Reference templateId -->
+              <templateId root="2.16.840.1.113883.10.20.24.3.98"/>
+              <!-- SHALL 1..* (one for each referenced measure) Measure Reference and Results template -->
+              <templateId root="2.16.840.1.113883.10.20.27.3.1" extension="2016-09-01"/>
+              <id extension="<%= measure['id'] || UUID.generate %>"/>
+              <statusCode code="completed"/>
+              <reference typeCode="REFR">
+                <externalDocument classCode="DOC" moodCode="EVN">
+                  <!-- SHALL: required Id but not restricted to the eMeasure Document/Id-->
+                  <!-- QualityMeasureDocument/id This is the version specific identifier for eMeasure -->
+                  <id root="2.16.840.1.113883.4.738" extension="<%= measure['hqmf_id'] %>"/>
+
+                  <!-- SHOULD This is the title of the eMeasure -->
+                  <text><%= measure['name'] %></text>
+                  <!-- SHOULD: setId is the eMeasure version neutral id  -->
+                  <setId root="<%= measure['hqmf_set_id'] %>"/>
+                  <!-- This is the sequential eMeasure Version number -->
+                  <versionNumber value="1"/>
+                </externalDocument>
+              </reference>
+
+              <% result = results[measure['hqmf_id']]
+                 unless result.is_cv?
+                  result.population_groups.each do |pg|
+              -%>
+              <component>
+              <%== render :partial => 'performance_rate', :locals => {:population_group => pg, :qrda3_version => qrda3_version} %>
+              </component>
+              <% end
+                end -%>
+              <% result.populations.each do |pop|
+                   unless pop.type == 'OBSERV' -%>
+              <component>
+              <%== render :partial => 'measure_data', :locals => {:aggregate_count => result, :population => pop, :qrda3_version => qrda3_version} %>
+              </component>
+              <%   end
+                 end -%>
+            </organizer>
+          </entry>
+          <% end %>
+        </section>
+      </component>
+    </structuredBody>
+  </component>
+</ClinicalDocument>

data/templates/cat3/r2_1/_address.cat3.erb

@@ -0,0 +1,9 @@
+<addr use="<%= address.use %>">
+  <% address.street.each do |street| %>
+  <streetAddressLine><%= street %></streetAddressLine>
+  <% end %>
+  <city><%= address.city %></city>
+  <state><%= address.state %></state>
+  <postalCode><%= address.zip %></postalCode>
+  <country><%= address.country %></country>
+</addr>

data/templates/cat3/r2_1/_author.cat3.erb

@@ -0,0 +1,28 @@
+ <!-- SHALL have 1..* author. MAY be device or person. 
+    The author of the CDA document in this example is a device at a data submission vendor/registry. -->
+  <author>
+    <time value="<%= author.time.to_formatted_s(:number) %>"/>
+    <assignedAuthor>
+      <!-- Registry author ID -->
+      <%== render :partial=>"id", :collection=>author.ids, :id=>"identifier" %>
+      <%== render :partial=>"address" , :collection=>author.addresses %>
+      <%== render :partial=>"telecom" , :collection=>author.telecoms %>
+
+      <% if author.person %>
+        <assignedPerson>
+        <name>
+           <given><%= author.person.given %></given>
+           <family><%= author.person.family %></family>
+        </name>
+        </assignedPerson> 
+      <% elsif author.device %>
+       <assignedAuthoringDevice>
+         <manufacturerModelName><%= author.device.model %></manufacturerModelName>
+         <softwareName><%= author.device.name %></softwareName>
+       </assignedAuthoringDevice>
+      <% end %> 
+     
+     <%== render :partial=>"organization", :locals=>{organization: author.organization, tag_name: "representedOrganization"} %>
+
+    </assignedAuthor>
+  </author>

data/templates/cat3/r2_1/_continuous_variable_value.cat3.erb

@@ -0,0 +1,20 @@
+<entryRelationship typeCode="COMP">
+  <observation classCode="OBS" moodCode="EVN">
+    <templateId root="2.16.840.1.113883.10.20.27.3.2"/>
+    <code nullFlavor="OTH">
+      <originalText>Time Difference</originalText>
+    </code>
+    <statusCode code="completed"/>
+    <value xsi:type="PQ" value="<%= value %>" unit="min"/>
+    <methodCode code="MEDIAN" 
+                displayName="Median" 
+                codeSystem="2.16.840.1.113883.5.84" 
+                codeSystemName="ObservationMethod"/>
+    <reference typeCode="REFR">
+      <!-- reference to the relevant measure observation in the eMeasure -->
+      <externalObservation classCode="OBS" moodCode="EVN">
+        <id root="<%= id %>"/>
+      </externalObservation>
+    </reference>
+  </observation>
+</entryRelationship>  

data/templates/cat3/r2_1/_id.cat3.erb

@@ -0,0 +1 @@
+<id <%== identifier.root.nil? ? "" : "root='#{identifier.root}'" -%> extension="<%= identifier.extension %>"/>

data/templates/cat3/r2_1/_measure_data.cat3.erb

@@ -0,0 +1,136 @@
+
+<!--   MEASURE DATA REPORTING FOR    <%= population.type %>  <%= population.id %>  -->
+<observation classCode="OBS" moodCode="EVN">
+  <!-- Measure Data template -->
+  <templateId root="2.16.840.1.113883.10.20.27.3.5" extension="2016-09-01"/>
+  <code code="ASSERTION" 
+        codeSystem="2.16.840.1.113883.5.4" 
+        displayName="Assertion" 
+        codeSystemName="ActCode"/>
+  <statusCode code="completed"/>
+  <value xsi:type="CD" code="<%= population.type == 'IPP' ? 'IPOP' : population.type %>"
+         codeSystem="2.16.840.1.113883.5.4"  
+         codeSystemName="ActCode"/>
+  <!-- Aggregate Count -->
+  <entryRelationship typeCode="SUBJ" inversionInd="true">
+    <observation classCode="OBS" moodCode="EVN">
+      <templateId root="2.16.840.1.113883.10.20.27.3.3"/>
+      <code code="MSRAGG" 
+        displayName="rate aggregation" 
+        codeSystem="2.16.840.1.113883.5.4" 
+        codeSystemName="ActCode"/>
+      <value xsi:type="INT" value="<%= population.value.round %>"/>
+      <methodCode code="COUNT" 
+        displayName="Count" 
+        codeSystem="2.16.840.1.113883.5.84" 
+        codeSystemName="ObservationMethod"/>
+    </observation>
+  </entryRelationship>
+  <% population.stratifications.each do |strat| -%>
+
+  <!--  Stratification Reporting Template for <%= population.type %>  <%= population.id %>  Stratification <%= strat.id %>   -->
+
+  <entryRelationship typeCode="COMP">
+    <observation classCode="OBS" moodCode="EVN">
+      <templateId root="2.16.840.1.113883.10.20.27.3.4"/>
+      <code code="ASSERTION" 
+            codeSystem="2.16.840.1.113883.5.4" 
+            displayName="Assertion" 
+            codeSystemName="ActCode"/>
+      <statusCode code="completed"/>
+      <value xsi:type="CD" nullFlavor="OTH">
+       <originalText>Stratum</originalText>
+      </value>
+      <entryRelationship typeCode="SUBJ" inversionInd="true">
+        <observation classCode="OBS" moodCode="EVN">
+          <templateId root="2.16.840.1.113883.10.20.27.3.3"/>
+          <code code="MSRAGG" 
+                displayName="rate aggregation" 
+                codeSystem="2.16.840.1.113883.5.4" 
+                codeSystemName="ActCode"/>
+          <value xsi:type="INT" value="<%= strat.value.round %>"/>
+          <methodCode code="COUNT" 
+                      displayName="Count" 
+                      codeSystem="2.16.840.1.113883.5.84" 
+                      codeSystemName="ObservationMethod"/>
+        </observation>
+      </entryRelationship>
+      <% if population.type == 'MSRPOPL' -%>
+      <% 
+      #need to lookup the observation population entry and then find the stratification entry for it
+      observ = aggregate_count.populations.find{|p| p.type == "OBSERV"}
+      obs_strat = observ.stratifications.find{|s| s.id == strat.id}
+        if obs_strat
+      %>
+      <%== render :partial => 'continuous_variable_value', :locals => {:id => observ.id, :value=>obs_strat.value } %>
+      <% 
+        end
+      end -%>
+      <reference typeCode="REFR">
+        <externalObservation classCode="OBS" moodCode="EVN">
+          <id root="<%= strat.id %>"/>
+        </externalObservation>
+      </reference>
+    </observation>
+  </entryRelationship>
+  <% end -%>
+  <% if population.supplemental_data.present? -%>
+  <%   sex_supplimental_data = population.supplemental_data["SEX"]
+       if sex_supplimental_data.present?
+         sex_supplimental_data.each do |sex, count| -%>
+   
+   <!--    SEX Supplemental Data Reporting for <%= population.type %>  <%= population.id %>      --> 
+         
+  <%== render :partial => 'supplemental_data', :locals => {:template_name => 'Sex Supplemental Data', 
+                :template_ids => ['2.16.840.1.113883.10.20.27.3.6'], :extension => '2016-09-01', :supplemental_data_code => '76689-9',
+                :supplemental_data_code_system => '2.16.840.1.113883.6.1', :supplemental_data_value_code => sex,
+                :supplemental_data_value_code_system => '2.16.840.1.113883.5.1', :count => count, :qrda3_version => qrda3_version} %>   
+      <% end -%>
+    <% end -%>
+  <%   ethnicity_supplimental_data = population.supplemental_data["ETHNICITY"]
+       if ethnicity_supplimental_data.present?
+         ethnicity_supplimental_data.each do |ethnicity, count| -%>
+
+    <!--     ETHNICITY Supplemental Data Reporting  for <%= population.type %>  <%= population.id %>     --> 
+
+  <%== render :partial => 'supplemental_data', :locals => {:template_name => 'Ethnicity Supplemental Data', 
+                :template_ids => ['2.16.840.1.113883.10.20.27.3.7'], :extension => '2016-09-01', :supplemental_data_code => '69490-1',
+                :supplemental_data_code_system => '2.16.840.1.113883.6.1', :supplemental_data_value_code => ethnicity,
+                :supplemental_data_value_code_system => '2.16.840.1.113883.6.238', :count => count, :qrda3_version => qrda3_version} %>   
+      <% end -%>
+    <% end -%>
+  <%   race_supplimental_data = population.supplemental_data["RACE"]
+       if race_supplimental_data.present?
+         race_supplimental_data.each do |race, count| -%>
+
+   <!--      RACE Supplemental Data Reporting  for <%= population.type %>  <%= population.id %> --> 
+
+  <%== render :partial => 'supplemental_data', :locals => {:template_name => 'Race Supplemental Data', 
+                :template_ids => ['2.16.840.1.113883.10.20.27.3.8'], :extension => '2016-09-01',  :supplemental_data_code => '72826-1',
+                :supplemental_data_code_system => '2.16.840.1.113883.6.1', :supplemental_data_value_code => race,
+                :supplemental_data_value_code_system => '2.16.840.1.113883.6.238', :count => count, :qrda3_version => qrda3_version} %>   
+      <% end -%>
+    <% end -%>
+  <%   payer_supplimental_data = population.supplemental_data["PAYER"]
+       if payer_supplimental_data.present?
+         payer_supplimental_data.each do |payer, count| -%>
+
+ <!--         PAYER Supplemental Data Reporting   for <%= population.type %>  <%= population.id %>   -->
+ <% payer_templates_ids = ['2.16.840.1.113883.10.20.27.3.9'] %>
+ <%== render :partial => 'supplemental_data', :locals => {:template_name => 'Payer Supplemental Data', 
+                :template_ids => payer_templates_ids, :extension => '2016-02-01',  :supplemental_data_code => '48768-6',
+                :supplemental_data_code_system => '2.16.840.1.113883.6.1', :supplemental_data_value_code => payer,
+                :supplemental_data_value_code_system => '2.16.840.1.113883.3.221.5', :count => count, :qrda3_version => qrda3_version} %>   
+      <% end -%>
+    <% end -%>
+  <% end -%>
+  <% if population.type == 'MSRPOPL' -%>
+  <%  observ = aggregate_count.populations.find{|p| p.type == "OBSERV"} %>
+  <%== render :partial => 'continuous_variable_value', :locals => {:id => observ.id, :value=>observ.value}%>
+  <% end -%>
+  <reference typeCode="REFR">
+     <externalObservation classCode="OBS" moodCode="EVN">
+        <id root="<%= population.id %>"/>
+     </externalObservation>
+  </reference>
+</observation>

data/templates/cat3/r2_1/_organization.cat3.erb

@@ -0,0 +1,6 @@
+<<%=tag_name %>>
+  <!-- Represents unique registry organization TIN -->
+   <%== render :partial=>"id", :collection=>organization.ids, :id=> "identifier" %>
+  <!-- Contains name - specific registry not required-->
+  <name><%= organization.name %></name>
+</<%=tag_name %>>

data/templates/cat3/r2_1/_performance_rate.cat3.erb

@@ -0,0 +1,19 @@
+<observation classCode="OBS" moodCode="EVN">
+  <templateId root="2.16.840.1.113883.10.20.27.3.14" extension="2016-09-01"/>
+  <templateId root="2.16.840.1.113883.10.20.27.3.30" extension="2016-09-01"/>
+  <code code="72510-1" codeSystem="2.16.840.1.113883.6.1"
+    displayName="Performance Rate" 
+    codeSystemName="2.16.840.1.113883.6.1"/>
+  <statusCode code="completed"/>
+  <% if population_group.performance_rate_denominator > 0 %>
+  <value xsi:type="REAL" value="<%= population_group.performance_rate.round(6) %>"/>
+  <% else %>
+    <value xsi:type="REAL" nullFlavor="NA"/>
+  <% end %>
+  <reference typeCode="REFR">
+     <externalObservation classCode="OBS" moodCode="EVN">
+       <id root="<%= population_group.numerator.id %>"/>
+       <code code="NUMER" displayName="Numerator" codeSystem="2.16.840.1.113883.5.4" codeSystemName="ObservationValue"/>
+    </externalObservation>
+  </reference>
+</observation>