health-data-standards 3.7.0 → 4.0.0

data/lib/hqmf-parser/cql/data_criteria_helpers/dc_post_processing.rb

@@ -0,0 +1,43 @@
+module HQMF2CQL
+  # Processing on data criteria after the initial extractions have taken place
+  module DataCriteriaPostProcessing
+    extend HQMF2::DataCriteriaPostProcessing
+
+    # Handles settings values after (most) values have been setup
+    def post_processing
+      extract_code_list_path_and_result_value
+
+      # Prefix ids that start with numerical values, and strip tokens from others
+      @id = strip_tokens(@id)
+      @children_criteria.map! { |cc| strip_tokens(cc) }
+
+      # append "_source" to the criteria since all the source criteria are separated from the non-source with the "_source" identifier
+      # "_source" is added to the SDC ids so that we are not duplicating ids between source and non source data criteria lists
+      # the derived source data criteria maintain their original ids since they are duplicated in the data criteria and source data criteria lists from the simple xml
+      @source_data_criteria = "#{@id}_source" unless (@definition == 'derived' || @definition == 'satisfies_all' || @definition == 'satisfies_any')
+      @source_data_criteria = strip_tokens(@source_data_criteria) unless @source_data_criteria.nil?
+    end
+
+    # Extract the code_list_xpath and the criteria's value from any of the
+    # template ids (if multiple exist)
+    def extract_code_list_path_and_result_value
+      @template_ids.each do |t|
+        # NOTE! (Adam 6/14): The following logic should absolutely be changed
+        # when Bonnie CQL support goes production. The "try this then try
+        # that" approach is an artifact of the template oids changing as of
+        # MAT 5.3; we want to support measures exported using 5.3, but also
+        # measures that were exported using previous versions of the MAT.
+
+        # Try a lookup using the newer template oids.
+        mapping = HQMF2CQL::ValueSetHelper.get_mapping_for_template(t)
+
+        # If the new template oids didn't work, try a lookup using the older
+        # template oids.
+        mapping = HQMF2::ValueSetHelper.get_mapping_for_template(t)unless mapping
+
+        handle_mapping_template(mapping)
+        break if mapping # Quit if one template id with a mapping has set these values
+      end
+    end
+  end
+end

data/lib/hqmf-parser/cql/document.rb

@@ -0,0 +1,78 @@
+module HQMF2CQL
+
+  # Class representing a HQMF v2 document that uses CQL for measure logic.
+  class Document < HQMF2::Document
+
+    # Create a new HQMF2CQL::Document instance by parsing the given HQMF contents.
+    def initialize(hqmf_contents, use_default_measure_period = true)
+      # Set up basic measure values
+      setup_default_values(hqmf_contents, use_default_measure_period)
+
+      # Extract data criteria
+      extract_criteria
+
+      # Extract the population criteria and population collections
+      pop_helper = HQMF2CQL::DocumentPopulationHelper.new(@entry, @doc, self, @id_generator, @reference_ids)
+      # @populations_cql_map and @observations are needed by the frontend
+      @populations, @population_criteria, @populations_cql_map, @observations = pop_helper.extract_populations
+      @cql_measure_library = pop_helper.extract_main_library
+    end
+
+    # Generates this classes hqmf-model equivalent.
+    def to_model
+      dcs = all_data_criteria.compact.collect(&:to_model)
+      sdc = source_data_criteria.compact.collect(&:to_model)
+      pcs = all_population_criteria.compact.collect(&:to_model)
+      HQMF::Document.new(@id, @id, @hqmf_set_id, @hqmf_version_number, @cms_id,
+                         title, description, pcs, dcs, sdc,
+                         @attributes, @measure_period, @populations,
+                         populations_cql_map=@populations_cql_map, cql_measure_library=@cql_measure_library, observations=@observations)
+    end
+
+    # Extracts data criteria from the HQMF document.
+    def extract_criteria
+      # Grab each data criteria entry from the HQMF
+      extracted_data_criteria = []
+      @doc.xpath('cda:QualityMeasureDocument/cda:component/cda:dataCriteriaSection/cda:entry', NAMESPACES).each do |entry|
+        extracted_data_criteria << entry
+        dc = HQMF2CQL::DataCriteria.new(entry) # Create new data criteria
+        sdc = dc.clone # Clone data criteria
+        sdc.id += '_source' # Make it a source
+
+        @data_criteria << dc
+        @source_data_criteria << sdc
+      end
+      make_positive_entry
+    end
+
+    # This method is needed for situations when there is a only
+    # a negated version of a data criteria.  Bonnie will only
+    # show the affirmative version of data criteria.  This method
+    # will create an affirmative version of a data criteria when there
+    # is only the negative one in the HQMF.
+    def make_positive_entry
+      negated_criteria = []
+      data_criteria_index_lookup = []
+      # Find the criteria that are negated
+      # At the same time build a hash of all criteria and their code_list_id, definition, status, and negation status
+      @data_criteria.each_with_index do |criterion, source_index|
+        negated_criteria << criterion if criterion.negation
+        data_criteria_index_lookup << [criterion.code_list_id, criterion.definition, criterion.status, criterion.negation]
+      end
+
+      negated_criteria.each do |criterion|
+        # Check if there is a criterion with the same OID, definition and status BUT that isn't negated
+        unless data_criteria_index_lookup.include?([criterion.code_list_id, criterion.definition, criterion.status, false])
+          spoofed_positive_instance = criterion.clone
+          spoofed_positive_instance.make_criterion_positive
+          @data_criteria << spoofed_positive_instance
+          sdc = spoofed_positive_instance.clone
+          sdc.id += '_source'
+          @source_data_criteria << sdc
+        end
+      end
+
+    end
+
+  end
+end

data/lib/hqmf-parser/cql/document_helpers/doc_population_helper.rb

@@ -0,0 +1,124 @@
+module HQMF2CQL
+  # Handles generation of populations for the main document
+  class DocumentPopulationHelper < HQMF2::DocumentPopulationHelper
+    include HQMF2::Utilities
+
+    def extract_populations
+      @populations_cql_map = extract_populations_cql_map
+      extract_populations_and_criteria
+      # Return via destructuring
+      [@populations, @population_criteria, @populations_cql_map, @observations]
+    end
+
+    # Extracts potential measure observations from the CQL based HQMF.
+    # This function needs to return a boolean so that it will continue to work with 
+    # HQMF2::DocumentPopulationHelper::extract_populations_and_criteria
+    # This function is being overridden because in CQL the observations are no longer data criteria in the HQMF.
+    def extract_observations
+      @observations = []
+
+      # Look for observations in the measureObservationSection of the CQL based HQMF document, and if they exist extract the name of the CQL statement that calculates the observation. This is the name of the "define function" statement in the CQL.
+      # In addition to the function name we also need to retreive the parameter for the function.
+      observation_section = @doc.xpath('/cda:QualityMeasureDocument/cda:component/cda:measureObservationSection',
+                                       HQMF2::Document::NAMESPACES)
+      unless observation_section.empty?
+        observation_section.each do |entry|
+          # Need to add population criteria for observations
+          criteria_id = 'OBSERV'
+          criteria = HQMF2::PopulationCriteria.new(entry.xpath('cda:definition'), @document, @id_generator)
+          criteria.type = 'OBSERV'
+          if @ids_by_hqmf_id["#{criteria.hqmf_id}"]
+            criteria.create_human_readable_id(@ids_by_hqmf_id[criteria.hqmf_id])
+          else
+            criteria.create_human_readable_id(population_id_with_counter(criteria_id))
+            @ids_by_hqmf_id["#{criteria.hqmf_id}"] = criteria.id
+          end
+          @population_criteria << criteria
+
+          # Extract CQL function specific details
+          cql_define_function = {}
+          # The at_xpath(...).values returns an array of a single element.
+          # The match returns an array and since we don't want the double quotes we take the second element
+          cql_define_function[:function_name] = entry.at_xpath("*/cda:measureObservationDefinition/cda:value/cda:expression").values.first.match('\\"([A-Za-z0-9 ]+)\\"')[1]
+          cql_define_function[:parameter] = entry.at_xpath("*/cda:measureObservationDefinition/cda:component/cda:criteriaReference/cda:id").attributes['extension'].value.match('\\"([A-Za-z0-9 ]+)\\"')[1]
+          @observations << cql_define_function
+        end
+      end
+      !@observations.empty?
+    end
+
+    # Generate the stratifications of populations, if any exist
+    # for CQL, adds 'population_index' and 'stratification_index'
+    def handle_stratifications(population_def, number_of_populations, population, id_def, population_index)
+      # handle stratifications (EP137, EP155)
+      stratifier_criteria_xpath = "cda:component/cda:stratifierCriteria[not(cda:component/cda:measureAttribute/cda:code[@code  = 'SDE'])]/.."
+      population_def.xpath(stratifier_criteria_xpath, HQMF2::Document::NAMESPACES)
+        .each_with_index do |criteria_def, criteria_def_index|
+        # Skip this Stratification if any precondition doesn't contain any preconditions
+        next unless HQMF2::PopulationCriteria.new(criteria_def, @document, @id_generator)
+                    .preconditions.all? { |prcn| prcn.preconditions.length > 0 }
+        index = number_of_populations + ((population_index - 1) * criteria_def.xpath('./*/cda:precondition').length) +
+                criteria_def_index
+        criteria_id = HQMF::PopulationCriteria::STRAT
+        stratified_population = population.dup
+        stratified_population['stratification'] = criteria_def.at_xpath('./*/cda:id/@root').try(:value) ||
+                                                  "#{criteria_id}-#{criteria_def_index}"
+        build_population_criteria(criteria_def, criteria_id, stratified_population)
+
+        stratified_population['id'] = id_def ? "#{id_def.value} - Stratification #{criteria_def_index + 1}" : "Population#{index}"
+        title_def = population_def.at_xpath('cda:title/@value', HQMF2::Document::NAMESPACES)
+        stratified_population['title'] = title_def ? "#{title_def.value} - Stratification #{criteria_def_index + 1}" : "Population #{index}"
+        stratified_population['population_index'] = population_index
+        stratified_population['stratification_index'] = criteria_def_index
+        @stratifications << stratified_population
+      end
+    end
+
+    # Extracts the mappings between actual HQMF populations and their
+    # corresponding CQL define statements.
+    def extract_populations_cql_map
+      populations_cql_map = {}
+      @doc.xpath("//cda:populationCriteriaSection/cda:component[@typeCode='COMP']", HQMF2::Document::NAMESPACES).each do |population_def|
+        {
+          HQMF::PopulationCriteria::IPP => 'initialPopulationCriteria',
+          HQMF::PopulationCriteria::DENOM => 'denominatorCriteria',
+          HQMF::PopulationCriteria::NUMER => 'numeratorCriteria',
+          HQMF::PopulationCriteria::NUMEX => 'numeratorExclusionCriteria',
+          HQMF::PopulationCriteria::DENEXCEP => 'denominatorExceptionCriteria',
+          HQMF::PopulationCriteria::DENEX => 'denominatorExclusionCriteria',
+          HQMF::PopulationCriteria::MSRPOPL => 'measurePopulationCriteria',
+          HQMF::PopulationCriteria::MSRPOPLEX => 'measurePopulationExclusionCriteria',
+          HQMF::PopulationCriteria::STRAT => 'stratifierCriteria'
+        }.each_pair do |criteria_id, criteria_element_name|
+          criteria_def = population_def.at_xpath("cda:#{criteria_element_name}", HQMF2::Document::NAMESPACES)
+          if criteria_def
+            # Ignore Supplemental Data Elements
+            next if HQMF::PopulationCriteria::STRAT == criteria_id &&
+                !criteria_def.xpath("cda:component[@typeCode='COMP']/cda:measureAttribute/cda:code[@code='SDE']").empty?
+            cql_statement = criteria_def.at_xpath("*/*/cda:id", HQMF2::Document::NAMESPACES).attribute('extension').to_s.match(/"([^"]*)"/)
+            if populations_cql_map[criteria_id].nil?
+              populations_cql_map[criteria_id] = []
+            end
+            cql_statement = cql_statement.to_s.delete('\\"')
+            populations_cql_map[criteria_id].push cql_statement
+          end
+        end
+      end
+      populations_cql_map
+    end
+
+    # Extracts the name of the main cql library from the Population Criteria Section.
+    def extract_main_library
+      population_criteria_sections = @doc.xpath("//cda:populationCriteriaSection/cda:component[@typeCode='COMP']", HQMF2::Document::NAMESPACES)
+      criteria_section = population_criteria_sections.at_xpath("cda:initialPopulationCriteria", HQMF2::Document::NAMESPACES)
+      if criteria_section
+        # Example: the full name for the population criteria section is "BonnieNesting01.\"Initial Population\""
+        # The regex returns everything before the "."  (BonnieNesting01), which is the file name of the cql measure
+        cql_main_library_name = criteria_section.at_xpath("*/*/cda:id", HQMF2::Document::NAMESPACES).attribute('extension').to_s.match(/[^.]*/).to_s
+      else
+        nil
+      end
+    end
+
+  end
+end

data/lib/hqmf-parser/cql/value_set_helper.rb

@@ -0,0 +1,103 @@
+module HQMF2CQL
+  # Class containing value set information
+  class ValueSetHelper
+    # rubocop:disable Metrics/LineLength
+    VALUESET_MAP = {
+      '2.16.840.1.113883.10.20.28.4.7' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.8' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.9' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.10' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.11' => { valueset_path: "./*/cda:participation[@typeCode='PRD']/cda:role[@classCode='MANU']/cda:playingDevice[@classCode='DEV']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.12' => { valueset_path: "./*/cda:participation[@typeCode='PRD']/cda:role[@classCode='MANU']/cda:playingDevice[@classCode='DEV']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.13' => { valueset_path: "./*/cda:participation[@typeCode='DEV']/cda:role[@classCode='MANU']/cda:playingDevice[@classCode='DEV']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.14' => { valueset_path: "./*/cda:participation[@typeCode='PRD']/cda:role[@classCode='MANU']/cda:playingDevice[@classCode='DEV']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.15' => { valueset_path: "./*/cda:participation[@typeCode='DEV']/cda:role[@classCode='MANU']/cda:playingDevice[@classCode='DEV']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.16' => { valueset_path: "./*/cda:participation[@typeCode='DEV']/cda:role[@classCode='MANU']/cda:playingDevice[@classCode='DEV']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.1' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.17' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.18' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.19' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.20' => { valueset_path: "./*/cda:outboundRelationship[@typeCode='CAUS']/cda:observationCriteria/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.21' => { valueset_path: "./*/cda:outboundRelationship[@typeCode='CAUS']/cda:observationCriteria/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.22' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.23' => { valueset_path: './*/cda:code', result_path: './*/cda:value' },
+      '2.16.840.1.113883.10.20.28.4.24' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.26' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.27' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.5' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.28' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.29' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.30' => { valueset_path: './*/cda:code', result_path: './*/cda:value' },
+      '2.16.840.1.113883.10.20.28.4.31' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.33' => { valueset_path: "./*/cda:outboundRelationship[@typeCode='CAUS' and @inversionInd='true']/cda:procedureCriteria/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.34' => { valueset_path: "./*/cda:outboundRelationship[@typeCode='CAUS']/cda:actCriteria/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.35' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.36' => { valueset_path: './*/cda:code', result_path: "./*/cda:outboundRelationship[@typeCode='REFR']//cda:code[@code='394617004']/../cda:value" },
+      '2.16.840.1.113883.10.20.28.4.37' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.39' => { valueset_path: "./*/cda:outboundRelationship[@typeCode='CAUS']/cda:observationCriteria/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.40' => { valueset_path: "./*/cda:outboundRelationship[@typeCode='CAUS']/cda:observationCriteria/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.41' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.42' => { valueset_path: './*/cda:code', result_path: './*/cda:value' },
+      '2.16.840.1.113883.10.20.28.4.43' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.44' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role/cda:playingMaterial[@classCode='MMAT']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.45' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role[@classCode='MANU']/cda:playingManufacturedMaterial[@classCode='MMAT']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.46' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role[@classCode='MANU']/cda:playingEntity[@classCode='MMAT']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.47' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role[@classCode='MANU']/cda:playingEntity[@classCode='MMAT']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.48' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role[@classCode='MANU']/cda:playingManufacturedMaterial[@classCode='MMAT']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.49' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role[@classCode='MANU']/cda:playingMaterial[@classCode='MMAT']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.50' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role[@classCode='MANU']/cda:playingMaterial[@classCode='MMAT']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.51' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role[@classCode='MANU']/cda:playingMaterial[@classCode='MMAT']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.52' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.53' => { valueset_path: './*/cda:code', result_path: './*/cda:value' },
+      '2.16.840.1.113883.10.20.28.4.6' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.54' => { valueset_path: nil, result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.56' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.57' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.58' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.59' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.55' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.86' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.61' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.62' => { valueset_path: './*/cda:value', result_path: "./*/cda:outboundRelationship[@typeCode='REFR']//cda:code[@code='394617004']/../cda:value" },
+      '2.16.840.1.113883.10.20.28.4.63' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.64' => { valueset_path: "./*/cda:outboundRelationship[@typeCode='CAUS' and @inversionInd='true']/cda:procedureCriteria/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.65' => { valueset_path: "./*/cda:outboundRelationship[@typeCode='CAUS' and @inversionInd='true']/cda:procedureCriteria/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.66' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.67' => { valueset_path: './*/cda:code', result_path: "./*/cda:outboundRelationship[@typeCode='REFR']//cda:code[@code='394617004']/../cda:value" },
+      '2.16.840.1.113883.10.20.28.4.68' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.70' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.71' => { valueset_path: "./*/cda:participation/cda:role[@classCode='ASSIGNED']/cda:playingDevice[@classCode='DEV' and @determinerCode='KIND']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.87' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.72' => { valueset_path: './*/cda:code', result_path: './*/cda:value' },
+      '2.16.840.1.113883.10.20.28.4.93' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.73' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role[@classCode='ADMM']/cda:playingMaterial[@classCode='MAT' and @determinerCode='KIND']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.74' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role[@classCode='ADMM']/cda:playingMaterial[@classCode='MAT' and @determinerCode='KIND']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.75' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role[@classCode='ADMM']/cda:playingMaterial[@classCode='MAT' and @determinerCode='KIND']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.76' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role[@classCode='ADMM']/cda:playingMaterial[@classCode='MAT' and @determinerCode='KIND']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.77' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role[@classCode='ADMM']/cda:playingMaterial[@classCode='MAT' and @determinerCode='KIND']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.78' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role[@classCode='MANU']/cda:playingMaterial[@classCode='MMAT' and @determinerCode='KIND']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.79' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.80' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.81' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.82' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.84' => { valueset_path: "./*/cda:participation[@typeCode='ORG']/cda:role[@classCode='LOCE']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.85' => { valueset_path: "./*/cda:participation[@typeCode='ORG']/cda:role[@classCode='LOCE']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.110' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.111' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.112' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role/cda:playingManufacturedMaterial[@classCode='MMAT']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.113' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role/cda:playingManufacturedMaterial[@classCode='MMAT']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.114' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role/cda:playingEntity[@classCode='MMAT']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.115' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role/cda:playingMaterial[@classCode='MMAT']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.116' => { valueset_path: './*/cda:value', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.117' => { valueset_path: './*/cda:code', result_path: './*/cda:value' },
+      '2.16.840.1.113883.10.20.28.4.118' => { valueset_path: './*/cda:code', result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.119' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role[@classCode='MANU']/cda:playingEntity[@classCode='MMAT']/cda:code", result_path: nil },
+      '2.16.840.1.113883.10.20.28.4.120' => { valueset_path: "./*/cda:participation[@typeCode='CSM']/cda:role[@classCode='MANU']/cda:playingEntity[@classCode='MMAT']/cda:code", result_path: nil }
+    }
+    # rubocop:enable Metrics/LineLength
+
+    def self.get_mapping_for_template(template)
+      VALUESET_MAP[template]
+    end
+  end
+end

data/lib/hqmf-parser/parser.rb

@@ -4,6 +4,7 @@ module HQMF
     HQMF_VERSION_1 = "1.0"
     HQMF_VERSION_2 = "2.0"
 
+    # HQMF v2 Parser for measures that use QDM for measure logic
     class V2Parser
       def initialize
       end
@@ -13,7 +14,7 @@ module HQMF
         HQMF2::Document.new(xml_contents).to_model
       end
 
-      def parse_fileds(xml_contents)
+      def parse_fields(xml_contents)
         result = {}
         doc = HQMF2::Document.parse(xml_contents)
         type = doc.at_xpath('/cda:QualityMeasureDocument/cda:code/@code').value
@@ -39,6 +40,28 @@ module HQMF
 
     end
 
+    # HQMF v2 Parser for measures that use CQL for measure logic
+    class V2CQLParser < V2Parser
+
+      def parse(xml_contents, codes=nil)
+        HQMF::Counter.instance.reset()
+        HQMF2CQL::Document.new(xml_contents).to_model
+      end
+
+      def self.valid?(xml_contents)
+        doc = HQMF2::Document.parse(xml_contents)
+        hqmf2 = !doc.at_xpath("/cda:QualityMeasureDocument/cda:typeId[@root='2.16.840.1.113883.1.3' and @extension='POQM_HD000001UV02']").nil?
+        cql = !doc.at_xpath("/cda:QualityMeasureDocument/cda:relatedDocument/cda:expressionDocument/cda:text[@mediaType='application/cql']").nil?
+        if !cql
+          # The media type changed for MAT version 5.3
+          cql = !doc.at_xpath("/cda:QualityMeasureDocument/cda:relatedDocument/cda:expressionDocument/cda:text[@mediaType='text/cql']").nil?
+        end
+        hqmf2 && cql
+      end
+
+    end
+
+    # HQMF v1 Parser for measures that use QDM for measure logic
     class V1Parser
 
       def parse(xml_contents, codes=nil)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: health-data-standards
 version: !ruby/object:Gem::Version
-  version: 3.7.0
+  version: 4.0.0
 platform: ruby
 authors:
 - The MITRE Corporation
@@ -304,6 +304,8 @@ files:
 - lib/health-data-standards/import/hdata/metadata_importer.rb
 - lib/health-data-standards/import/provider_import_utils.rb
 - lib/health-data-standards/models/address.rb
+- lib/health-data-standards/models/admission_source.rb
+- lib/health-data-standards/models/adverse_event.rb
 - lib/health-data-standards/models/allergy.rb
 - lib/health-data-standards/models/assessment.rb
 - lib/health-data-standards/models/care_experience.rb
@@ -311,6 +313,7 @@ files:
 - lib/health-data-standards/models/cda_identifier.rb
 - lib/health-data-standards/models/coded_result_value.rb
 - lib/health-data-standards/models/communication.rb
+- lib/health-data-standards/models/component.rb
 - lib/health-data-standards/models/condition.rb
 - lib/health-data-standards/models/cqm/aggregate_objects.rb
 - lib/health-data-standards/models/cqm/bundle.rb
@@ -373,6 +376,7 @@ files:
 - lib/health-data-standards/util/hqmf_template_helper.rb
 - lib/health-data-standards/util/hqmf_template_oid_map.json
 - lib/health-data-standards/util/hqmfr2_template_oid_map.json
+- lib/health-data-standards/util/hqmfr2cql_template_oid_map.json
 - lib/health-data-standards/util/nlm_helper.rb
 - lib/health-data-standards/util/vs_api.rb
 - lib/health-data-standards/validate/base_validator.rb
@@ -467,6 +471,12 @@ files:
 - lib/hqmf-parser/converter/pass1/simple_restriction.rb
 - lib/hqmf-parser/converter/pass2/comparison_converter.rb
 - lib/hqmf-parser/converter/pass2/operator_converter.rb
+- lib/hqmf-parser/cql/data_criteria.rb
+- lib/hqmf-parser/cql/data_criteria_helpers/dc_definition_from_template_or_type_extract.rb
+- lib/hqmf-parser/cql/data_criteria_helpers/dc_post_processing.rb
+- lib/hqmf-parser/cql/document.rb
+- lib/hqmf-parser/cql/document_helpers/doc_population_helper.rb
+- lib/hqmf-parser/cql/value_set_helper.rb
 - lib/hqmf-parser/parser.rb
 - lib/util/counter.rb
 - resources/schema/infrastructure/cda/CDA_SDTC.xsd