us_core_test_kit 0.6.3 → 0.6.5

data/lib/us_core_test_kit/generated/v7.0.0-ballot/practitioner_role/metadata.yml

@@ -0,0 +1,160 @@
+---
+:name: us_core_practitionerrole
+:class_name: USCorev700_ballotPractitionerroleSequence
+:version: v7.0.0-ballot
+:reformatted_version: v700_ballot
+:resource: PractitionerRole
+:profile_url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole
+:profile_name: US Core PractitionerRole Profile
+:profile_version: 7.0.0-ballot
+:title: PractitionerRole
+:short_description: Verify support for the server capabilities required by the US
+  Core PractitionerRole Profile.
+:is_delayed: true
+:interactions:
+- :code: create
+  :expectation: MAY
+- :code: search-type
+  :expectation: SHALL
+- :code: read
+  :expectation: SHALL
+- :code: vread
+  :expectation: SHOULD
+- :code: update
+  :expectation: MAY
+- :code: patch
+  :expectation: MAY
+- :code: delete
+  :expectation: MAY
+- :code: history-instance
+  :expectation: SHOULD
+- :code: history-type
+  :expectation: MAY
+:operations: []
+:searches:
+- :names:
+  - practitioner
+  :expectation: SHALL
+  :names_not_must_support_or_mandatory: []
+  :must_support_or_mandatory: true
+- :names:
+  - specialty
+  :expectation: SHALL
+  :names_not_must_support_or_mandatory: []
+  :must_support_or_mandatory: true
+:search_definitions:
+  :practitioner:
+    :paths:
+    - practitioner
+    :full_paths:
+    - PractitionerRole.practitioner
+    :comparators: {}
+    :values: []
+    :type: Reference
+    :contains_multiple: false
+    :multiple_or: MAY
+    :chain:
+    - :chain: identifier
+      :expectation: SHALL
+    - :chain: name
+      :expectation: SHALL
+  :specialty:
+    :paths:
+    - specialty
+    :full_paths:
+    - PractitionerRole.specialty
+    :comparators: {}
+    :values: []
+    :type: CodeableConcept
+    :contains_multiple: true
+    :multiple_or: MAY
+:include_params:
+- PractitionerRole:endpoint
+- PractitionerRole:practitioner
+:revincludes: []
+:required_concepts: []
+:must_supports:
+  :extensions: []
+  :slices: []
+  :elements:
+  - :path: practitioner
+    :types:
+    - Reference
+    :target_profiles:
+    - http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner
+  - :path: organization
+    :types:
+    - Reference
+    :target_profiles:
+    - http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization
+  - :path: code
+  - :path: specialty
+  - :path: location
+    :types:
+    - Reference
+    :target_profiles:
+    - http://hl7.org/fhir/us/core/StructureDefinition/us-core-location
+  - :path: telecom
+  - :path: telecom.system
+  - :path: telecom.value
+  - :path: endpoint
+    :types:
+    - Reference
+:mandatory_elements:
+- PractitionerRole.telecom.system
+- PractitionerRole.telecom.value
+- PractitionerRole.notAvailable.description
+:bindings:
+- :type: code
+  :strength: required
+  :system: http://hl7.org/fhir/ValueSet/contact-point-system
+  :path: telecom.system
+- :type: code
+  :strength: required
+  :system: http://hl7.org/fhir/ValueSet/contact-point-use
+  :path: telecom.use
+- :type: code
+  :strength: required
+  :system: http://hl7.org/fhir/ValueSet/days-of-week
+  :path: availableTime.daysOfWeek
+:references:
+- :path: PractitionerRole.practitioner
+  :profiles:
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner
+- :path: PractitionerRole.organization
+  :profiles:
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization
+- :path: PractitionerRole.location
+  :profiles:
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-location
+- :path: PractitionerRole.healthcareService
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/HealthcareService
+- :path: PractitionerRole.endpoint
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Endpoint
+:tests:
+- :id: us_core_v700_ballot_practitioner_role_read_test
+  :file_name: practitioner_role_read_test.rb
+- :id: us_core_v700_ballot_practitioner_role_practitioner_search_test
+  :file_name: practitioner_role_practitioner_search_test.rb
+- :id: us_core_v700_ballot_practitioner_role_specialty_search_test
+  :file_name: practitioner_role_specialty_search_test.rb
+- :id: us_core_v700_ballot_practitioner_role_validation_test
+  :file_name: practitioner_role_validation_test.rb
+- :id: us_core_v700_ballot_practitioner_role_must_support_test
+  :file_name: practitioner_role_must_support_test.rb
+- :id: us_core_v700_ballot_practitioner_role_reference_resolution_test
+  :file_name: practitioner_role_reference_resolution_test.rb
+:id: us_core_v700_ballot_practitioner_role
+:file_name: practitioner_role_group.rb
+:delayed_references:
+- :path: practitioner
+  :resources:
+  - Practitioner
+- :path: organization
+  :resources:
+  - Organization
+- :path: location
+  :resources:
+  - Location

data/lib/us_core_test_kit/generated/v7.0.0-ballot/practitioner_role/practitioner_role_must_support_test.rb

@@ -0,0 +1,45 @@
+require_relative '../../../must_support_test'
+
+module USCoreTestKit
+  module USCoreV700_BALLOT
+    class PractitionerRoleMustSupportTest < Inferno::Test
+      include USCoreTestKit::MustSupportTest
+
+      title 'All must support elements are provided in the PractitionerRole resources returned'
+      description %(
+        US Core Responders SHALL be capable of populating all data elements as
+        part of the query results as specified by the US Core Server Capability
+        Statement. This test will look through the PractitionerRole resources
+        found previously for the following must support elements:
+
+        * PractitionerRole.code
+        * PractitionerRole.endpoint
+        * PractitionerRole.location
+        * PractitionerRole.organization
+        * PractitionerRole.practitioner
+        * PractitionerRole.specialty
+        * PractitionerRole.telecom
+        * PractitionerRole.telecom.system
+        * PractitionerRole.telecom.value
+      )
+
+      id :us_core_v700_ballot_practitioner_role_must_support_test
+
+      def resource_type
+        'PractitionerRole'
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:practitioner_role_resources] ||= {}
+      end
+
+      run do
+        perform_must_support_test(all_scratch_resources)
+      end
+    end
+  end
+end

data/lib/us_core_test_kit/generated/v7.0.0-ballot/{vital_signs/vital_signs_patient_code_search_test.rb → practitioner_role/practitioner_role_practitioner_search_test.rb}

@@ -3,21 +3,16 @@ require_relative '../../../generator/group_metadata'
 
 module USCoreTestKit
   module USCoreV700_BALLOT
-    class VitalSignsPatientCodeSearchTest < Inferno::Test
+    class PractitionerRolePractitionerSearchTest < Inferno::Test
       include USCoreTestKit::SearchTest
 
-      title 'Server returns valid results for Observation search by patient + code'
+      title 'Server returns valid results for PractitionerRole search by practitioner'
       description %(
 A server SHALL support searching by
-patient + code on the Observation resource. This test
+practitioner on the PractitionerRole 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. US
-Core requires that both forms are supported by US Core responders.
-
 Because this is the first search of the sequence, resources in the
 response will be used for subsequent tests.
 
@@ -30,20 +25,13 @@ requirement of US Core v7.0.0-ballot.
 
       )
 
-      id :us_core_v700_ballot_vital_signs_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'
-  
+      id :us_core_v700_ballot_practitioner_role_practitioner_search_test
       def self.properties
         @properties ||= SearchTestProperties.new(
           first_search: true,
-        fixed_value_search: true,
-        resource_type: 'Observation',
-        search_param_names: ['patient', 'code'],
-        possible_status_search: true,
-        token_search_params: ['code'],
-        test_reference_variants: true,
+        resource_type: 'PractitionerRole',
+        search_param_names: ['practitioner'],
+        saves_delayed_references: true,
         test_post_search: true
         )
       end
@@ -53,7 +41,7 @@ requirement of US Core v7.0.0-ballot.
       end
 
       def scratch_resources
-        scratch[:vital_signs_resources] ||= {}
+        scratch[:practitioner_role_resources] ||= {}
       end
 
       run do

data/lib/us_core_test_kit/generated/v7.0.0-ballot/practitioner_role/practitioner_role_read_test.rb

@@ -0,0 +1,26 @@
+require_relative '../../../read_test'
+
+module USCoreTestKit
+  module USCoreV700_BALLOT
+    class PractitionerRoleReadTest < Inferno::Test
+      include USCoreTestKit::ReadTest
+
+      title 'Server returns correct PractitionerRole resource from PractitionerRole read interaction'
+      description 'A server SHALL support the PractitionerRole read interaction.'
+
+      id :us_core_v700_ballot_practitioner_role_read_test
+
+      def resource_type
+        'PractitionerRole'
+      end
+
+      def scratch_resources
+        scratch[:practitioner_role_resources] ||= {}
+      end
+
+      run do
+        perform_read_test(scratch.dig(:references, 'PractitionerRole'))
+      end
+    end
+  end
+end

data/lib/us_core_test_kit/generated/v7.0.0-ballot/practitioner_role/practitioner_role_reference_resolution_test.rb

@@ -0,0 +1,43 @@
+require_relative '../../../reference_resolution_test'
+
+module USCoreTestKit
+  module USCoreV700_BALLOT
+    class PractitionerRoleReferenceResolutionTest < Inferno::Test
+      include USCoreTestKit::ReferenceResolutionTest
+
+      title 'MustSupport references within PractitionerRole resources are valid'
+      description %(
+        This test will attempt to read external references provided within elements
+        marked as 'MustSupport', if any are available.
+
+        It verifies that at least one external reference for each MustSupport Reference element
+        can be accessed by the test client, and conforms to corresponding US Core profile.
+
+        Elements which may provide external references include:
+
+        * PractitionerRole.endpoint
+        * PractitionerRole.location
+        * PractitionerRole.organization
+        * PractitionerRole.practitioner
+      )
+
+      id :us_core_v700_ballot_practitioner_role_reference_resolution_test
+
+      def resource_type
+        'PractitionerRole'
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:practitioner_role_resources] ||= {}
+      end
+
+      run do
+        perform_reference_resolution_test(scratch_resources[:all])
+      end
+    end
+  end
+end

data/lib/us_core_test_kit/generated/v7.0.0-ballot/{vital_signs/vital_signs_patient_category_date_search_test.rb → practitioner_role/practitioner_role_specialty_search_test.rb}

@@ -3,13 +3,13 @@ require_relative '../../../generator/group_metadata'
 
 module USCoreTestKit
   module USCoreV700_BALLOT
-    class VitalSignsPatientCategoryDateSearchTest < Inferno::Test
+    class PractitionerRoleSpecialtySearchTest < Inferno::Test
       include USCoreTestKit::SearchTest
 
-      title 'Server returns valid results for Observation search by patient + category + date'
+      title 'Server returns valid results for PractitionerRole search by specialty'
       description %(
 A server SHALL support searching by
-patient + category + date on the Observation resource. This test
+specialty on the PractitionerRole resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.
 
@@ -17,18 +17,12 @@ none are returned, the test is skipped.
 
       )
 
-      id :us_core_v700_ballot_vital_signs_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'
-  
+      id :us_core_v700_ballot_practitioner_role_specialty_search_test
       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']
+          resource_type: 'PractitionerRole',
+        search_param_names: ['specialty'],
+        token_search_params: ['specialty']
         )
       end
 
@@ -37,7 +31,7 @@ none are returned, the test is skipped.
       end
 
       def scratch_resources
-        scratch[:vital_signs_resources] ||= {}
+        scratch[:practitioner_role_resources] ||= {}
       end
 
       run do

data/lib/us_core_test_kit/generated/v7.0.0-ballot/practitioner_role/practitioner_role_validation_test.rb

@@ -0,0 +1,40 @@
+require_relative '../../../validation_test'
+
+module USCoreTestKit
+  module USCoreV700_BALLOT
+    class PractitionerRoleValidationTest < Inferno::Test
+      include USCoreTestKit::ValidationTest
+
+      id :us_core_v700_ballot_practitioner_role_validation_test
+      title 'PractitionerRole resources returned during previous tests conform to the US Core PractitionerRole Profile'
+      description %(
+This test verifies resources returned from the first search conform to
+the [US Core PractitionerRole Profile](http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole).
+Systems must demonstrate at least one valid example in order to pass this test.
+
+It verifies the presence of mandatory elements and that elements with
+required bindings contain appropriate values. CodeableConcept element
+bindings will fail if none of their codings have a code/system belonging
+to the bound ValueSet. Quantity, Coding, and code element bindings will
+fail if their code/system are not found in the valueset.
+
+      )
+      output :dar_code_found, :dar_extension_found
+
+      def resource_type
+        'PractitionerRole'
+      end
+
+      def scratch_resources
+        scratch[:practitioner_role_resources] ||= {}
+      end
+
+      run do
+        perform_validation_test(scratch_resources[:all] || [],
+                                'http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole',
+                                '7.0.0-ballot',
+                                skip_if_empty: true)
+      end
+    end
+  end
+end

data/lib/us_core_test_kit/generated/v7.0.0-ballot/practitioner_role_group.rb

@@ -0,0 +1,89 @@
+require_relative 'practitioner_role/practitioner_role_read_test'
+require_relative 'practitioner_role/practitioner_role_practitioner_search_test'
+require_relative 'practitioner_role/practitioner_role_specialty_search_test'
+require_relative 'practitioner_role/practitioner_role_validation_test'
+require_relative 'practitioner_role/practitioner_role_must_support_test'
+require_relative 'practitioner_role/practitioner_role_reference_resolution_test'
+
+module USCoreTestKit
+  module USCoreV700_BALLOT
+    class PractitionerRoleGroup < Inferno::TestGroup
+      title 'PractitionerRole Tests'
+      short_description 'Verify support for the server capabilities required by the US Core PractitionerRole Profile.'
+      description %(
+  # Background
+
+The US Core PractitionerRole sequence verifies that the system under test is
+able to provide correct responses for PractitionerRole queries. These queries
+must contain resources conforming to the US Core PractitionerRole Profile as
+specified in the US Core v7.0.0-ballot 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:
+
+* practitioner
+* specialty
+
+### 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
+PractitionerRole 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". 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 PractitionerRole 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 Core PractitionerRole Profile](http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole). 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_core_v700_ballot_practitioner_role
+      run_as_group
+      optional
+      
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'practitioner_role', 'metadata.yml'), aliases: true))
+      end
+  
+      test from: :us_core_v700_ballot_practitioner_role_read_test
+      test from: :us_core_v700_ballot_practitioner_role_practitioner_search_test
+      test from: :us_core_v700_ballot_practitioner_role_specialty_search_test
+      test from: :us_core_v700_ballot_practitioner_role_validation_test
+      test from: :us_core_v700_ballot_practitioner_role_must_support_test
+      test from: :us_core_v700_ballot_practitioner_role_reference_resolution_test
+    end
+  end
+end

data/lib/us_core_test_kit/generated/v7.0.0-ballot/us_core_test_suite.rb

@@ -48,12 +48,13 @@ require_relative 'observation_clinical_result_group'
 require_relative 'pediatric_bmi_for_age_group'
 require_relative 'head_circumference_percentile_group'
 require_relative 'body_weight_group'
-require_relative 'vital_signs_group'
 require_relative 'procedure_group'
 require_relative 'questionnaire_response_group'
 require_relative 'service_request_group'
+require_relative 'location_group'
 require_relative 'organization_group'
 require_relative 'practitioner_group'
+require_relative 'practitioner_role_group'
 require_relative 'provenance_group'
 require_relative 'related_person_group'
 require_relative 'specimen_group'
@@ -85,7 +86,8 @@ module USCoreTestKit
         /Observation\.effective\.ofType\(Period\): .*us-core-1:/, # Invalid invariant in US Core v3.1.1
         /Provenance.agent\[\d*\]: Rule provenance-1/, #Invalid invariant in US Core v5.0.1
         %r{Unknown Code System 'http://hl7.org/fhir/us/core/CodeSystem/us-core-tags'}, # Validator has an issue with this US Core 5 code system in US Core 6 resource
-        %r{URL value 'http://hl7.org/fhir/us/core/CodeSystem/us-core-tags' does not resolve} # Validator has an issue with this US Core 5 code system in US Core 6 resource
+        %r{URL value 'http://hl7.org/fhir/us/core/CodeSystem/us-core-tags' does not resolve}, # Validator has an issue with this US Core 5 code system in US Core 6 resource
+        %r{Observation.component\[\d+\].value.ofType\(Quantity\): The code provided \(http://unitsofmeasure.org#L/min\) was not found in the value set 'Vital Signs Units'} # Known issue with the Pulse Oximetry Profile
       ].freeze
 
       VERSION_SPECIFIC_MESSAGE_FILTERS = [].freeze
@@ -193,12 +195,13 @@ module USCoreTestKit
         group from: :us_core_v700_ballot_pediatric_bmi_for_age
         group from: :us_core_v700_ballot_head_circumference_percentile
         group from: :us_core_v700_ballot_body_weight
-        group from: :us_core_v700_ballot_vital_signs
         group from: :us_core_v700_ballot_procedure
         group from: :us_core_v700_ballot_questionnaire_response
         group from: :us_core_v700_ballot_service_request
+        group from: :us_core_v700_ballot_location
         group from: :us_core_v700_ballot_organization
         group from: :us_core_v700_ballot_practitioner
+        group from: :us_core_v700_ballot_practitioner_role
         group from: :us_core_v700_ballot_provenance
         group from: :us_core_v700_ballot_related_person
         group from: :us_core_v700_ballot_specimen

data/lib/us_core_test_kit/generator/group_generator.rb

@@ -95,8 +95,8 @@ module USCoreTestKit
 
 
       def optional?
-        resource_type == 'QuestionnaireResponse' ||
-        profile_url == 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-simple-observation'
+        SpecialCases::OPTIONAL_RESOURCES.include?(resource_type) ||
+        SpecialCases::OPTIONAL_PROFILES.include?(profile_url)
       end
 
       def generate

data/lib/us_core_test_kit/generator/group_metadata.rb

@@ -1,3 +1,5 @@
+require_relative 'special_cases'
+
 module USCoreTestKit
   class Generator
     class GroupMetadata
@@ -50,7 +52,7 @@ module USCoreTestKit
       end
 
       def exclude_search_tests?
-        delayed? && !searchable_delayed_resource
+        delayed? && !searchable_delayed_resource?
       end
 
       def no_patient_searches?

data/lib/us_core_test_kit/generator/ig_metadata_extractor.rb

@@ -9,6 +9,7 @@ module USCoreTestKit
       def initialize(ig_resources)
         self.ig_resources = ig_resources
         add_missing_supported_profiles
+        remove_version_from_supported_profiles
         remove_extra_supported_profiles
         self.metadata = IGMetadata.new
       end
@@ -52,6 +53,12 @@ module USCoreTestKit
         end
       end
 
+      def remove_version_from_supported_profiles
+        resources_in_capability_statement.each do |resource|
+          resource.supportedProfile.map! { |profile_url| profile_url.split('|').first }
+        end
+      end
+
       def remove_extra_supported_profiles
         ig_resources.capability_statement.rest.first.resource
             .find { |resource| resource.type == 'Observation' }
@@ -64,7 +71,7 @@ module USCoreTestKit
         metadata.groups =
           resources_in_capability_statement.flat_map do |resource|
             resource.supportedProfile&.map do |supported_profile|
-              supported_profile = supported_profile.split('|').first
+              #supported_profile = supported_profile.split('|').first
               next if supported_profile == 'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire'
 
               GroupMetadataExtractor.new(resource, supported_profile, metadata, ig_resources).group_metadata