us_quality_core_test_kit 0.1.0

data/lib/us_quality_core_test_kit/generated/v0.5.0/observation_clinical_result_group.rb

@@ -0,0 +1,101 @@
+require_relative 'observation_clinical_result/observation_clinical_result_patient_category_status_search_test'
+require_relative 'observation_clinical_result/observation_clinical_result_patient_category_search_test'
+require_relative 'observation_clinical_result/observation_clinical_result_patient_category_date_search_test'
+require_relative 'observation_clinical_result/observation_clinical_result_patient_code_search_test'
+require_relative 'observation_clinical_result/observation_clinical_result_read_test'
+require_relative 'observation_clinical_result/observation_clinical_result_provenance_revinclude_search_test'
+require_relative 'observation_clinical_result/observation_clinical_result_validation_test'
+require_relative 'observation_clinical_result/observation_clinical_result_must_support_test'
+require_relative 'observation_clinical_result/observation_clinical_result_reference_resolution_test'
+
+
+module USQualityCoreTestKit
+  module USQualityCoreV050
+    class ObservationClinicalResultGroup < Inferno::TestGroup
+      title 'Observation Clinical Result Tests'
+
+      short_description 'Verify support for the capabilities required by the US Quality Core Observation Clinical Result.'
+
+      description %(
+  # Background
+
+These tests verify that the system under test is able to provide correct
+responses for Observation queries. These queries must contain resources
+conforming to the US Quality Core Observation Clinical Result as specified in the US Quality Core Implementation Guide.
+
+# Testing Methodology
+## Searching
+This test sequence will first perform each required search associated
+with this resource. This sequence will perform searches with the
+following parameters:
+
+* patient + category + status
+* patient + category
+* patient + category + date
+* patient + code
+
+### Search Parameters
+The first search uses the selected patient(s) from the prior launch
+sequence. Any subsequent searches will look for its parameter values
+from the results of the first search. For example, the `identifier`
+search in the patient sequence is performed by looking for an existing
+`Patient.identifier` from any of the resources returned in the `_id`
+search. If a value cannot be found this way, the search is skipped.
+
+### Search Validation
+Inferno will retrieve up to the first 20 bundle pages of the reply for
+Observation resources and save them for subsequent tests. Each of
+these resources is then checked to see if it matches the searched
+parameters in accordance with [FHIR search
+guidelines](https://www.hl7.org/fhir/search.html). The test will fail,
+for example, if a Patient search for `gender=male` returns a `female`
+patient.
+
+
+## Must Support
+Each profile contains elements marked as "must support" or with
+"USCDI+ Quality" tags. This test sequence expects to see each of these
+elements at least once. If at least one cannot be found, the test will
+fail. The test will look through the Observation resources found
+in the first test for these elements.
+
+## Profile Validation
+Each resource returned from the first search is expected to conform to
+the [US Quality Core Observation Clinical Result Profile](http://fhir.org/guides/onc/us-quality-core/StructureDefinition/us-quality-core-observation-clinical-result). Each element is checked against
+teminology binding and cardinality requirements.
+
+Elements with a required binding are validated against their bound
+ValueSet. If the code/system in the element is not part of the ValueSet,
+then the test will fail.
+
+## Reference Validation
+At least one instance of each external reference in elements marked as
+"must support" within the resources provided by the system must resolve.
+The test will attempt to read each reference found and will fail if no
+read succeeds.
+
+      )
+
+      id :us_quality_core_v050_observation_clinical_result
+
+      run_as_group
+
+      
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'observation_clinical_result', 'metadata.yml'), aliases: true))
+      end
+
+  
+      test from: :us_quality_core_v050_observation_clinical_result_patient_category_status_search_test
+      test from: :us_quality_core_v050_observation_clinical_result_patient_category_search_test
+      test from: :us_quality_core_v050_observation_clinical_result_patient_category_date_search_test
+      test from: :us_quality_core_v050_observation_clinical_result_patient_code_search_test
+      test from: :us_quality_core_v050_observation_clinical_result_read_test
+      test from: :us_quality_core_v050_observation_clinical_result_provenance_revinclude_search_test
+      test from: :us_quality_core_v050_observation_clinical_result_validation_test
+      test from: :us_quality_core_v050_observation_clinical_result_must_support_test
+      test from: :us_quality_core_v050_observation_clinical_result_reference_resolution_test
+    end
+  end
+end

data/lib/us_quality_core_test_kit/generated/v0.5.0/observation_lab/metadata.yml

@@ -0,0 +1,251 @@
+---
+:name: us_quality_core_observation_lab
+:class_name: USQualityCorev050ObservationLabSequence
+:version: v0.5.0
+:reformatted_version: v050
+:resource: Observation
+:profile_url: http://fhir.org/guides/onc/us-quality-core/StructureDefinition/us-quality-core-observation-lab
+:profile_name: US Quality Core Laboratory Result Observation
+:profile_version: 0.5.0
+:title: Observation Laboratory Result
+:short_description: Verify support for the capabilities required by the US Quality
+  Core Laboratory Result Observation.
+:is_delayed: false
+:interactions:
+- :code: read
+  :expectation: SHALL
+- :code: search-type
+  :expectation: SHALL
+:operations: []
+:searches:
+- :expectation: SHALL
+  :names:
+  - patient
+  - category
+  - status
+  :names_not_must_support_or_mandatory: []
+  :must_support_or_mandatory: true
+- :expectation: SHALL
+  :names:
+  - patient
+  - category
+  :names_not_must_support_or_mandatory: []
+  :must_support_or_mandatory: true
+- :expectation: SHALL
+  :names:
+  - patient
+  - category
+  - date
+  :names_not_must_support_or_mandatory: []
+  :must_support_or_mandatory: true
+- :expectation: SHALL
+  :names:
+  - patient
+  - code
+  :names_not_must_support_or_mandatory: []
+  :must_support_or_mandatory: true
+:search_definitions:
+  :patient:
+    :paths:
+    - subject
+    :full_paths:
+    - Observation.subject
+    :comparators: {}
+    :values: []
+    :type: Reference
+    :contains_multiple: false
+    :multiple_or: MAY
+  :category:
+    :paths:
+    - category
+    :full_paths:
+    - Observation.category
+    :comparators: {}
+    :values:
+    - laboratory
+    :type: CodeableConcept
+    :contains_multiple: true
+    :multiple_or: MAY
+  :status:
+    :paths:
+    - status
+    :full_paths:
+    - Observation.status
+    :comparators: {}
+    :values:
+    - registered
+    - preliminary
+    - final
+    - amended
+    - corrected
+    - entered-in-error
+    - unknown
+    :type: code
+    :contains_multiple: false
+    :multiple_or: MAY
+  :date:
+    :paths:
+    - effective
+    :full_paths:
+    - Observation.effective
+    :comparators:
+      :eq: MAY
+      :ne: MAY
+      :gt: SHALL
+      :ge: SHALL
+      :lt: SHALL
+      :le: SHALL
+      :sa: MAY
+      :eb: MAY
+      :ap: MAY
+    :values: []
+    :type: date
+    :contains_multiple: false
+    :multiple_or: MAY
+  :code:
+    :paths:
+    - code
+    :full_paths:
+    - Observation.code
+    :comparators: {}
+    :values: []
+    :type: CodeableConcept
+    :contains_multiple: false
+    :multiple_or: MAY
+:include_params: []
+:revincludes:
+- Provenance:target
+:required_concepts: []
+:must_supports:
+  :extensions: []
+  :slices:
+  - :slice_id: Observation.category:us-core
+    :slice_name: us-core
+    :path: category
+    :discriminator:
+      :type: patternCodeableConcept
+      :path: ''
+      :code: laboratory
+      :system: http://terminology.hl7.org/CodeSystem/observation-category
+  :elements:
+  - :path: status
+  - :path: category
+  - :path: code
+  - :path: subject
+    :types:
+    - Reference
+    :target_profiles:
+    - http://fhir.org/guides/onc/us-quality-core/StructureDefinition/us-quality-core-patient
+  - :path: effectiveDateTime
+    :original_path: effective[x]
+  - :path: issued
+    :us_quality_coreuscdi_plus_quality: true
+  - :path: valueQuantity
+    :original_path: value[x]
+  - :path: valueCodeableConcept
+    :original_path: value[x]
+  - :path: valueString
+    :original_path: value[x]
+  - :path: interpretation
+    :us_quality_coreuscdi_plus_quality: true
+  - :path: specimen
+    :types:
+    - Reference
+    :target_profiles:
+    - http://hl7.org/fhir/us/core/StructureDefinition/us-core-specimen
+:mandatory_elements:
+- Observation.status
+- Observation.category
+- Observation.code
+- Observation.subject
+- Observation.component.code
+:bindings:
+- :type: code
+  :strength: required
+  :system: http://fhir.org/guides/onc/us-quality-core/ValueSet/us-quality-core-non-negative-observation-status
+  :path: status
+- :type: CodeableConcept
+  :strength: required
+  :system: http://hl7.org/fhir/us/core/ValueSet/us-core-clinical-result-observation-category
+  :path: category
+  :required_binding_slice: true
+:references:
+- :path: Observation.basedOn
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/CarePlan
+  - http://hl7.org/fhir/StructureDefinition/DeviceRequest
+  - http://hl7.org/fhir/StructureDefinition/ImmunizationRecommendation
+  - http://hl7.org/fhir/StructureDefinition/MedicationRequest
+  - http://hl7.org/fhir/StructureDefinition/NutritionOrder
+  - http://hl7.org/fhir/StructureDefinition/ServiceRequest
+- :path: Observation.partOf
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/MedicationAdministration
+  - http://hl7.org/fhir/StructureDefinition/MedicationDispense
+  - http://hl7.org/fhir/StructureDefinition/MedicationStatement
+  - http://hl7.org/fhir/StructureDefinition/Procedure
+  - http://hl7.org/fhir/StructureDefinition/Immunization
+  - http://hl7.org/fhir/StructureDefinition/ImagingStudy
+- :path: Observation.subject
+  :profiles:
+  - http://fhir.org/guides/onc/us-quality-core/StructureDefinition/us-quality-core-patient
+- :path: Observation.focus
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Resource
+- :path: Observation.encounter
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Encounter
+- :path: Observation.performer
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Practitioner
+  - http://hl7.org/fhir/StructureDefinition/PractitionerRole
+  - http://hl7.org/fhir/StructureDefinition/Organization
+  - http://hl7.org/fhir/StructureDefinition/CareTeam
+  - http://hl7.org/fhir/StructureDefinition/Patient
+  - http://hl7.org/fhir/StructureDefinition/RelatedPerson
+- :path: Observation.specimen
+  :profiles:
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-specimen
+- :path: Observation.device
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Device
+  - http://hl7.org/fhir/StructureDefinition/DeviceMetric
+- :path: Observation.hasMember
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Observation
+  - http://hl7.org/fhir/StructureDefinition/QuestionnaireResponse
+  - http://hl7.org/fhir/StructureDefinition/MolecularSequence
+- :path: Observation.derivedFrom
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/DocumentReference
+  - http://hl7.org/fhir/StructureDefinition/ImagingStudy
+  - http://hl7.org/fhir/StructureDefinition/Media
+  - http://hl7.org/fhir/StructureDefinition/QuestionnaireResponse
+  - http://hl7.org/fhir/StructureDefinition/Observation
+  - http://hl7.org/fhir/StructureDefinition/MolecularSequence
+:tests:
+- :id: us_quality_core_v050_observation_lab_patient_category_status_search_test
+  :file_name: observation_lab_patient_category_status_search_test.rb
+- :id: us_quality_core_v050_observation_lab_patient_category_search_test
+  :file_name: observation_lab_patient_category_search_test.rb
+- :id: us_quality_core_v050_observation_lab_patient_category_date_search_test
+  :file_name: observation_lab_patient_category_date_search_test.rb
+- :id: us_quality_core_v050_observation_lab_patient_code_search_test
+  :file_name: observation_lab_patient_code_search_test.rb
+- :id: us_quality_core_v050_observation_lab_read_test
+  :file_name: observation_lab_read_test.rb
+- :id: us_quality_core_v050_observation_lab_provenance_revinclude_search_test
+  :file_name: observation_lab_provenance_revinclude_search_test.rb
+- :id: us_quality_core_v050_observation_lab_validation_test
+  :file_name: observation_lab_validation_test.rb
+- :id: us_quality_core_v050_observation_lab_must_support_test
+  :file_name: observation_lab_must_support_test.rb
+- :id: us_quality_core_v050_observation_lab_reference_resolution_test
+  :file_name: observation_lab_reference_resolution_test.rb
+:id: us_quality_core_v050_observation_lab
+:file_name: observation_lab_group.rb
+:delayed_references:
+- :path: specimen
+  :resources:
+  - Specimen
+:resource_conformance_expectation: SHALL

data/lib/us_quality_core_test_kit/generated/v0.5.0/observation_lab/observation_lab_must_support_test.rb

@@ -0,0 +1,50 @@
+require_relative '../../../must_support_test'
+
+module USQualityCoreTestKit
+  module USQualityCoreV050
+    class ObservationLabMustSupportTest < Inferno::Test
+      include USQualityCoreTestKit::MustSupportTest
+
+      title 'All must support elements are provided in the Observation resources returned'
+
+      description %(
+        This test will look through the Observation resources
+        found previously for the following Must Support and USCDI-flagged elements:
+
+        * Observation.category
+        * Observation.category:us-core
+        * Observation.code
+        * Observation.effectiveDateTime
+        * Observation.specimen
+        * Observation.status
+        * Observation.subject
+        * Observation.valueCodeableConcept
+        * Observation.valueQuantity
+        * Observation.valueString
+
+        For ONC USCDI+ Quality requirements, each Observation must support the following additional elements:
+
+        * Observation.interpretation
+        * Observation.issued
+      )
+
+      id :us_quality_core_v050_observation_lab_must_support_test
+
+      def resource_type
+        'Observation'
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:observation_lab_resources] ||= {}
+      end
+
+      run do
+        perform_must_support_test(all_scratch_resources)
+      end
+    end
+  end
+end

data/lib/us_quality_core_test_kit/generated/v0.5.0/observation_lab/observation_lab_patient_category_date_search_test.rb

@@ -0,0 +1,54 @@
+require_relative '../../../search_test'
+require_relative '../../../generator/group_metadata'
+require_relative '../../../search_test_properties'
+
+module USQualityCoreTestKit
+  module USQualityCoreV050
+    class ObservationLabPatientCategoryDateSearchTest < Inferno::Test
+      include USQualityCoreTestKit::SearchTest
+
+      title 'Server returns valid results for Observation search by patient + category + date'
+
+      description %(
+A server SHALL support searching by
+patient + category + date on the Observation resource. This test
+will pass if resources are returned and match the search criteria. If
+none are returned, the test is skipped.
+
+
+      )
+
+      id :us_quality_core_v050_observation_lab_patient_category_date_search_test
+
+  
+
+  
+      input :patient_ids,
+        title: 'Patient IDs',
+        description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+  
+
+      def self.properties
+        @properties ||= SearchTestProperties.new(
+          resource_type: 'Observation',
+        search_param_names: ['patient', 'category', 'date'],
+        possible_status_search: true,
+        token_search_params: ['category'],
+        params_with_comparators: ['date']
+        )
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:observation_lab_resources] ||= {}
+      end
+
+      run do
+        run_search_test
+      end
+    end
+  end
+end

data/lib/us_quality_core_test_kit/generated/v0.5.0/observation_lab/observation_lab_patient_category_search_test.rb

@@ -0,0 +1,53 @@
+require_relative '../../../search_test'
+require_relative '../../../generator/group_metadata'
+require_relative '../../../search_test_properties'
+
+module USQualityCoreTestKit
+  module USQualityCoreV050
+    class ObservationLabPatientCategorySearchTest < Inferno::Test
+      include USQualityCoreTestKit::SearchTest
+
+      title 'Server returns valid results for Observation search by patient + category'
+
+      description %(
+A server SHALL support searching by
+patient + category on the Observation resource. This test
+will pass if resources are returned and match the search criteria. If
+none are returned, the test is skipped.
+
+
+      )
+
+      id :us_quality_core_v050_observation_lab_patient_category_search_test
+
+  
+
+  
+      input :patient_ids,
+        title: 'Patient IDs',
+        description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+  
+
+      def self.properties
+        @properties ||= SearchTestProperties.new(
+          resource_type: 'Observation',
+        search_param_names: ['patient', 'category'],
+        possible_status_search: true,
+        token_search_params: ['category']
+        )
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:observation_lab_resources] ||= {}
+      end
+
+      run do
+        run_search_test
+      end
+    end
+  end
+end

data/lib/us_quality_core_test_kit/generated/v0.5.0/observation_lab/observation_lab_patient_category_status_search_test.rb

@@ -0,0 +1,68 @@
+require_relative '../../../search_test'
+require_relative '../../../generator/group_metadata'
+require_relative '../../../search_test_properties'
+
+module USQualityCoreTestKit
+  module USQualityCoreV050
+    class ObservationLabPatientCategoryStatusSearchTest < Inferno::Test
+      include USQualityCoreTestKit::SearchTest
+
+      title 'Server returns valid results for Observation search by patient + category + status'
+
+      description %(
+A server SHALL support searching by
+patient + category + status on the Observation resource. This test
+will pass if resources are returned and match the search criteria. If
+none are returned, the test is skipped.
+
+This test verifies that the server supports searching by reference using
+the form `patient=[id]` as well as `patient=Patient/[id]`. The two
+different forms are expected to return the same number of results.
+
+Because this is the first search of the sequence, resources in the
+response will be used for subsequent tests.
+
+Additionally, this test will check that GET and POST search methods
+return the same number of results. Search by POST is required by the
+FHIR R4 specification.
+
+
+      )
+
+      id :us_quality_core_v050_observation_lab_patient_category_status_search_test
+
+  
+
+  
+      input :patient_ids,
+        title: 'Patient IDs',
+        description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+  
+
+      def self.properties
+        @properties ||= SearchTestProperties.new(
+          first_search: true,
+        fixed_value_search: true,
+        resource_type: 'Observation',
+        search_param_names: ['patient', 'category', 'status'],
+        saves_delayed_references: true,
+        token_search_params: ['category'],
+        test_reference_variants: true,
+        test_post_search: true
+        )
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:observation_lab_resources] ||= {}
+      end
+
+      run do
+        run_search_test
+      end
+    end
+  end
+end

data/lib/us_quality_core_test_kit/generated/v0.5.0/observation_lab/observation_lab_patient_code_search_test.rb

@@ -0,0 +1,53 @@
+require_relative '../../../search_test'
+require_relative '../../../generator/group_metadata'
+require_relative '../../../search_test_properties'
+
+module USQualityCoreTestKit
+  module USQualityCoreV050
+    class ObservationLabPatientCodeSearchTest < Inferno::Test
+      include USQualityCoreTestKit::SearchTest
+
+      title 'Server returns valid results for Observation search by patient + code'
+
+      description %(
+A server SHALL support searching by
+patient + code on the Observation resource. This test
+will pass if resources are returned and match the search criteria. If
+none are returned, the test is skipped.
+
+
+      )
+
+      id :us_quality_core_v050_observation_lab_patient_code_search_test
+
+  
+
+  
+      input :patient_ids,
+        title: 'Patient IDs',
+        description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+  
+
+      def self.properties
+        @properties ||= SearchTestProperties.new(
+          resource_type: 'Observation',
+        search_param_names: ['patient', 'code'],
+        possible_status_search: true,
+        token_search_params: ['code']
+        )
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:observation_lab_resources] ||= {}
+      end
+
+      run do
+        run_search_test
+      end
+    end
+  end
+end

data/lib/us_quality_core_test_kit/generated/v0.5.0/observation_lab/observation_lab_provenance_revinclude_search_test.rb

@@ -0,0 +1,52 @@
+require_relative '../../../search_test'
+require_relative '../../../generator/group_metadata'
+
+module USQualityCoreTestKit
+  module USQualityCoreV050
+    class ObservationLabProvenanceRevincludeSearchTest < Inferno::Test
+      include USQualityCoreTestKit::SearchTest
+
+      title 'Server returns Provenance resources from Observation search by patient + category + status + revInclude:Provenance:target'
+      description %(
+        A server SHALL be capable of supporting _revIncludes:Provenance:target.
+
+        This test will perform a search by patient + category + status + revInclude:Provenance:target and
+        will pass if a Provenance resource is found in the response.
+      %)
+
+      id :us_quality_core_v050_observation_lab_provenance_revinclude_search_test
+  
+      input :patient_ids,
+        title: 'Patient IDs',
+        description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+  
+      def properties
+        @properties ||= SearchTestProperties.new(
+          fixed_value_search: true,
+        resource_type: 'Observation',
+        search_param_names: ['patient', 'category', 'status']
+        )
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml')))
+      end
+
+      def self.provenance_metadata
+        @provenance_metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, '..', 'provenance', 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:observation_lab_resources] ||= {}
+      end
+
+      def scratch_provenance_resources
+        scratch[:provenance_resources] ||= {}
+      end
+
+      run do
+        run_provenance_revinclude_search_test
+      end
+    end
+  end
+end