davinci_pdex_test_kit 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 318708e3bf373fe0429d145f0bec49fe07739eea1a296dff8b6aedef2769b361
-  data.tar.gz: d2ab19dc58bc8734324f60b6eda28350df3e999c94e15218ba614df630fc02e2
+  metadata.gz: 156bd66077651d476dcdcd5702adb592e87633dbcd60f705d4dc3f636757ff94
+  data.tar.gz: 989ee31b122e338cde2612a58c208c20052bb4485da560d1c8ab71773cb6c493
 SHA512:
-  metadata.gz: 57c7352a6207c74197bf2511a7e1305fca155c2d0135456aa725cc209f89cedb5ef8733daffa2f546042a12b6c2f91f94bb1fe9f58c4f3aa6a3253c051d58896
-  data.tar.gz: 7cbb1b8afee0ddc8e04fe6e19853b0a13f82981feff200d3197b92597fd248104c49cb3570a3ce0e0b4a183350a8c78a8d0c3a7feca16cf42ab8f201edbe08e6
+  metadata.gz: 5fe2f9b6f7ef8b42d1ac3869a1a844e6a68392da6d6ea545355046a56a0d879377d5f8ab0075cb16eebab113dbeea4232d135cfa3fba3574cbf7336ae0393ac4
+  data.tar.gz: 76b2d345ea43cd1529362ba300d60c1fe1ac26cd4e2b0bbd529ada0cb7b50852904bebfd502dd7282177a33004583e909301261e56b98079a01ac7b4ba719474

data/config/presets/pdex_payer_server_fhir_foundry_ri_preset.json

@@ -10,10 +10,10 @@
       "_type": "text"
     },
     {
-      "name": "credentials",
+      "name": "smart_auth_info",
       "value": null,
       "_title": "OAuth Credentials",
-      "_type": "oauth_credentials",
+      "_type": "auth_info",
       "_optional": true
     },
     {

data/config/presets/pdex_payer_server_inferno_ri_preset.json

@@ -10,10 +10,10 @@
       "_type": "text"
     },
     {
-      "name": "credentials",
+      "name": "smart_auth_info",
       "value": null,
       "_title": "OAuth Credentials",
-      "_type": "oauth_credentials",
+      "_type": "auth_info",
       "_optional": true
     },
     {

data/lib/davinci_pdex_test_kit/pdex_payer_client/client_member_match_tests/client_member_match_validation_test.rb

@@ -1,10 +1,10 @@
-require_relative '../client_validation_test.rb'
+require_relative '../client_validation_test'
 
 module DaVinciPDexTestKit
   module PDexPayerClient
     class PDexInitialMemberMatchValidationTest < Inferno::Test
       include ClientValidationTest
-  
+
       id :pdex_initial_member_match_validation
       title 'Client provides a valid $member-match request'
       description %(
@@ -12,10 +12,12 @@ module DaVinciPDexTestKit
         [HRex member-match-in profile](http://hl7.org/fhir/us/davinci-hrex/StructureDefinition/hrex-parameters-member-match-in).
       )
       input :access_token
-  
+
+      verifies_requirements 'hl7.fhir.us.davinci-pdex_2.0.0@29'
+
       run do
-        skip_if !member_match_request.present?, "No previous $member-match request received"
-        
+        skip_if !member_match_request.present?, 'No previous $member-match request received'
+
         parameters = FHIR.from_contents(member_match_request.request_body)
         assert_resource_type(:parameters, resource: parameters)
         assert_valid_resource(resource: parameters, profile_url: 'http://hl7.org/fhir/us/davinci-hrex/StructureDefinition/hrex-parameters-member-match-in')

data/lib/davinci_pdex_test_kit/pdex_payer_client/client_workflow_interaction_test.rb

@@ -1,7 +1,6 @@
 module DaVinciPDexTestKit
   module PDexPayerClient
     class PDexClientWorkflowInteractionTest < Inferno::Test
-  
       id :pdex_client_workflow_interaction
       title 'Client makes requests to Inferno'
       description %(
@@ -13,21 +12,23 @@ module DaVinciPDexTestKit
       )
       input :access_token
       config options: { accepts_multiple_requests: true }
-  
+
+      verifies_requirements 'hl7.fhir.us.davinci-pdex_2.0.0@27', 'hl7.fhir.us.davinci-pdex_2.0.0@41'
+
       run do
         wait(
           identifier: access_token,
           message: %(
             Submit PDex requests to find a matching member and retrieve clinical data covering the
-            complete scope of [member health history data defined by 
+            complete scope of [member health history data defined by
             PDex](https://hl7.org/fhir/us/davinci-pdex/STU2/introduction.html#member-health-history).
-            Available APIs under the Inferno base FHIR include: 
+            Available APIs under the Inferno base FHIR include:
             * Single patient $member-match: `#{member_match_url}`
-            * Single Resource read and search API: `#{submit_url}`, with `:endpoint` replaced with 
+            * Single Resource read and search API: `#{submit_url}`, with `:endpoint` replaced with
               the target resource type.
             * Patient-level $everything: `#{everything_url}`, with `:patient` replaced with the
               id for the target patient.
-            * All Patients $export: see workflow process at 
+            * All Patients $export: see workflow process at
               the [Bulk Data IG](https://hl7.org/fhir/uv/bulkdata/STU2/export.html#sequence-overview)
               * Kick-off requests: `#{export_url}`.
               * Export status requests: `#{export_status_url}?_jobId=:job` as returned in the `content-location`
@@ -35,7 +36,7 @@ module DaVinciPDexTestKit
               * Retrieval file Requests: `#{binary_url}` with `:id` replaced with an actual id as indicated
                 in the JSON manifest returned with the export status request when the job is completed.
                 Note that the `Accept` header should be `application/fhir+ndjson` on these requests.
-            
+
             All requests must include the `Authorization` header with value `Bearer #{access_token}`.
 
             [Click here](#{resume_clinical_data_url}?token=#{access_token}) when finished making requests

data/lib/davinci_pdex_test_kit/pdex_payer_client_suite.rb

@@ -1,4 +1,3 @@
-require 'inferno/dsl/oauth_credentials'
 require_relative 'pdex_payer_client/urls'
 require_relative 'pdex_payer_client/tags'
 require_relative 'pdex_payer_client/collection'
@@ -41,7 +40,7 @@ module DaVinciPDexTestKit
     id :pdex_payer_client
     title 'Da Vinci PDex Payer Client Test Suite'
     description File.read(File.join(__dir__, 'docs', 'payer_client_suite_description_v200.md'))
-    
+
     links [
       {
         label: 'Report Issue',
@@ -78,32 +77,32 @@ module DaVinciPDexTestKit
     resume_test_route :get, RESUME_CLINICAL_DATA_PATH do |request|
       PDexPayerClientSuite.extract_token_from_query_params(request)
     end
-  
+
     resume_test_route :get, RESUME_FAIL_PATH, result: 'fail' do |request|
       PDexPayerClientSuite.extract_token_from_query_params(request)
     end
 
     group do
       run_as_group
-      title "Workflow Tests"
+      title 'Workflow Tests'
       id :payer_to_payer_workflow
 
       group do
-        title "Interaction Tests"
+        title 'Interaction Tests'
         id :client_workflow_interaction
 
         test from: :pdex_client_workflow_interaction
       end
 
       group do
-        title "$member-match validation"
+        title '$member-match validation'
         id :member_match_validation
 
         test from: :pdex_initial_member_match_validation
       end
 
       group do
-        title "Clinical data request validation"
+        title 'Clinical data request validation'
         id :clinical_data_validation
 
         test from: :pdex_clinical_data_request_check
@@ -130,8 +129,8 @@ module DaVinciPDexTestKit
         test from: :pdex_procedure_clinical_data_request
       end
     end
-    
-    # TODO must support validation
+
+    # TODO: must support validation
 
     private
 
@@ -140,4 +139,3 @@ module DaVinciPDexTestKit
     end
   end
 end
-  

data/lib/davinci_pdex_test_kit/pdex_payer_server/device/device_must_support_test.rb

@@ -0,0 +1,50 @@
+require 'us_core_test_kit/must_support_test'
+require 'us_core_test_kit/generator/group_metadata'
+
+module DaVinciPDexTestKit
+  module PDexPayerServer
+    class DeviceMustSupportTest < Inferno::Test
+      include USCoreTestKit::MustSupportTest
+
+      title 'All must support elements are provided in the Device resources returned'
+      description %(
+        PDex Responders SHALL be capable of populating all data elements as
+        part of the query results as specified by the PDex Server Capability
+        Statement. This test will look through the Device resources
+        found previously for the following must support elements:
+
+        * Device.distinctIdentifier
+        * Device.expirationDate
+        * Device.lotNumber
+        * Device.patient
+        * Device.serialNumber
+        * Device.status
+        * Device.type
+        * Device.udiCarrier
+        * Device.udiCarrier.carrierAIDC
+        * Device.udiCarrier.carrierHRF
+        * Device.udiCarrier.deviceIdentifier
+        * Device.url
+      )
+
+      id :pdex_device_must_support
+
+      def resource_type
+        'Device'
+      end
+
+      def self.metadata
+        @metadata ||= USCoreTestKit::Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'),
+                                                                                 aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:device_resources] ||= {}
+      end
+
+      run do
+        perform_must_support_test(all_scratch_resources)
+      end
+    end
+  end
+end

data/lib/davinci_pdex_test_kit/pdex_payer_server/device/device_patient_search_test.rb

@@ -0,0 +1,68 @@
+require 'us_core_test_kit/search_test'
+require 'us_core_test_kit/search_test_properties'
+require 'us_core_test_kit/generator/group_metadata'
+
+module DaVinciPDexTestKit
+  module PDexPayerServer
+    class DevicePatientSearchTest < Inferno::Test
+      include USCoreTestKit::SearchTest
+
+      title 'Server returns valid results for Device search by patient'
+      description %(
+        A server SHALL support searching by
+        patient on the Device 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 PDex responders.
+
+        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, and these tests interpret search by GET as a
+        requirement of PDex v2.0.0.
+
+        [PDex Server CapabilityStatement](https://hl7.org/fhir/us/davinci-pdex/STU2/CapabilityStatement-pdex-server.html)
+      )
+
+      id :pdex_device_patient_search
+      input :patient_ids,
+            title: 'Patient IDs',
+            description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+
+      input :implantable_device_codes,
+            title: 'Implantable Device Type Code',
+            description: 'Enter the code for an Implantable Device type, or multiple codes separated by commas. ' \
+                         'If blank, Inferno will validate all Device resources against the Implantable Device profile',
+            optional: true
+
+      def self.properties
+        @properties ||= USCoreTestKit::SearchTestProperties.new(
+          first_search: true,
+          resource_type: 'Device',
+          search_param_names: ['patient'],
+          test_reference_variants: true,
+          test_post_search: true
+        )
+      end
+
+      def self.metadata
+        @metadata ||= USCoreTestKit::Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'),
+                                                                                 aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:device_resources] ||= {}
+      end
+
+      run do
+        run_search_test
+      end
+    end
+  end
+end

data/lib/davinci_pdex_test_kit/pdex_payer_server/device/device_patient_type_search_test.rb

@@ -0,0 +1,54 @@
+require 'us_core_test_kit/search_test'
+require 'us_core_test_kit/generator/group_metadata'
+
+module DaVinciPDexTestKit
+  module PDexPayerServer
+    class DevicePatientTypeSearchTest < Inferno::Test
+      include USCoreTestKit::SearchTest
+
+      title 'Server returns valid results for Device search by patient + type'
+      description %(
+        A server SHOULD support searching by
+        patient + type on the Device resource. This test
+        will pass if resources are returned and match the search criteria. If
+        none are returned, the test is skipped.
+
+        [PDex Server CapabilityStatement](https://hl7.org/fhir/us/davinci-pdex/STU2/CapabilityStatement-pdex-server.html)
+      )
+
+      id :pdex_device_patient_type_search
+      optional
+
+      input :patient_ids,
+            title: 'Patient IDs',
+            description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+
+      input :implantable_device_codes,
+            title: 'Implantable Device Type Code',
+            description: 'Enter the code for an Implantable Device type, or multiple codes separated by commas. ' \
+                         'If blank, Inferno will validate all Device resources against the Implantable Device profile',
+            optional: true
+
+      def self.properties
+        @properties ||= USCoreTestKit::SearchTestProperties.new(
+          resource_type: 'Device',
+          search_param_names: ['patient', 'type'],
+          token_search_params: ['type']
+        )
+      end
+
+      def self.metadata
+        @metadata ||= USCoreTestKit::Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'),
+                                                                                 aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:device_resources] ||= {}
+      end
+
+      run do
+        run_search_test
+      end
+    end
+  end
+end

data/lib/davinci_pdex_test_kit/pdex_payer_server/{explanation_of_benefit/explanation_of_benefit_provenance_revinclude_search_test.rb → device/device_provenance_revinclude_search_test.rb}

@@ -2,12 +2,12 @@ require 'us_core_test_kit/search_test'
 require 'us_core_test_kit/search_test_properties'
 require 'us_core_test_kit/generator/group_metadata'
 
-module USCoreTestKit
-  module USCoreV311
-    class ExplanationOfBenefitProvenanceRevincludeSearchTest < Inferno::Test
+module DaVinciPDexTestKit
+  module PDexPayerServer
+    class DeviceProvenanceRevincludeSearchTest < Inferno::Test
       include USCoreTestKit::SearchTest
 
-      title 'Server returns Provenance resources from ExplanationOfBenefit search by patient + revInclude:Provenance:target'
+      title 'Server returns Provenance resources from Device search by patient + revInclude:Provenance:target'
       description %(
         A server SHALL be capable of supporting _revIncludes:Provenance:target.
 
@@ -15,7 +15,7 @@ module USCoreTestKit
         will pass if a Provenance resource is found in the response.
       %)
 
-      id :pdex_eob_provenance_revinclude_search
+      id :pdex_device_provenance_revinclude_search
 
       input :patient_ids,
             title: 'Patient IDs',
@@ -23,7 +23,7 @@ module USCoreTestKit
 
       def properties
         @properties ||= USCoreTestKit::SearchTestProperties.new(
-          resource_type: 'ExplanationOfBenefit',
+          resource_type: 'Device',
           search_param_names: ['patient']
         )
       end
@@ -40,7 +40,7 @@ module USCoreTestKit
       end
 
       def scratch_resources
-        scratch[:explanation_of_benefit_resources] ||= {}
+        scratch[:device_resources] ||= {}
       end
 
       def scratch_provenance_resources

data/lib/davinci_pdex_test_kit/pdex_payer_server/device/device_read_test.rb

@@ -0,0 +1,26 @@
+require 'us_core_test_kit/read_test'
+
+module DaVinciPDexTestKit
+  module PDexPayerServer
+    class DeviceReadTest < Inferno::Test
+      include USCoreTestKit::ReadTest
+
+      title 'Server returns correct Device resource from Device read interaction'
+      description 'A server SHALL support the Device read interaction.'
+
+      id :pdex_device_read
+
+      def resource_type
+        'Device'
+      end
+
+      def scratch_resources
+        scratch[:device_resources] ||= {}
+      end
+
+      run do
+        perform_read_test(all_scratch_resources)
+      end
+    end
+  end
+end

data/lib/davinci_pdex_test_kit/pdex_payer_server/device/device_reference_resolution_test.rb

@@ -0,0 +1,42 @@
+require 'us_core_test_kit/reference_resolution_test'
+require 'us_core_test_kit/generator/group_metadata'
+
+module DaVinciPDexTestKit
+  module PDexPayerServer
+    class DeviceReferenceResolutionTest < Inferno::Test
+      include USCoreTestKit::ReferenceResolutionTest
+
+      title 'MustSupport references within Device 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 PDex profile.
+
+        Elements which may provide external references include:
+
+        * Device.patient
+      )
+
+      id :pdex_device_ref_resolution
+
+      def resource_type
+        'Device'
+      end
+
+      def self.metadata
+        @metadata ||= USCoreTestKit::Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'),
+                                                                                 aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:device_resources] ||= {}
+      end
+
+      run do
+        perform_reference_resolution_test(scratch_resources[:all])
+      end
+    end
+  end
+end

data/lib/davinci_pdex_test_kit/pdex_payer_server/device/device_validation_test.rb

@@ -0,0 +1,39 @@
+require 'us_core_test_kit/validation_test'
+
+module DaVinciPDexTestKit
+  module PDexPayerServer
+    class DeviceValidationTest < Inferno::Test
+      include USCoreTestKit::ValidationTest
+
+      id :pdex_device_validation
+      title 'Device resources returned during previous tests conform to the PDex Device'
+      description %(
+        This test verifies resources returned from the first search conform to
+        the [PDex Device](http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/pdex-device).
+        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
+        'Device'
+      end
+
+      def scratch_resources
+        scratch[:device_resources] ||= {}
+      end
+
+      run do
+        perform_validation_test(scratch_resources[:all] || [],
+                                'http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/pdex-device',
+                                '2.0.0',
+                                skip_if_empty: true)
+      end
+    end
+  end
+end

data/lib/davinci_pdex_test_kit/pdex_payer_server/device/metadata.yml

@@ -0,0 +1,154 @@
+---
+:name: pdex_device
+:class_name: PdexDeviceSequence
+:version: v2.0.0
+:reformatted_version: v200
+:resource: Device
+:profile_url: http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/pdex-device
+:profile_name: PDex Device
+:profile_version: 2.0.0
+:title: PDex Device
+:short_description: Verify support for the server capabilities required by the PDex
+  Device.
+:is_delayed: false
+:interactions:
+- :code: search-type
+  :expectation: SHALL
+- :code: read
+  :expectation: SHALL
+- :code: vread
+  :expectation: SHOULD
+- :code: history-instance
+  :expectation: SHOULD
+- :code: history-type
+  :expectation: MAY
+:operations: []
+:searches:
+- :names:
+  - patient
+  :expectation: SHALL
+  :names_not_must_support_or_mandatory: []
+  :must_support_or_mandatory: true
+- :expectation: SHOULD
+  :names:
+  - patient
+  - type
+  :names_not_must_support_or_mandatory: []
+  :must_support_or_mandatory: true
+- :expectation: SHOULD
+  :names:
+  - patient
+  - status
+  :names_not_must_support_or_mandatory: []
+  :must_support_or_mandatory: true
+:search_definitions:
+  :patient:
+    :paths:
+    - patient
+    :full_paths:
+    - Device.patient
+    :comparators: {}
+    :values: []
+    :type: Reference
+    :contains_multiple: false
+    :multiple_or: MAY
+  :type:
+    :paths:
+    - type
+    :full_paths:
+    - Device.type
+    :comparators: {}
+    :values: []
+    :type: CodeableConcept
+    :contains_multiple: false
+    :multiple_or: MAY
+  :status:
+    :paths:
+    - status
+    :full_paths:
+    - Device.status
+    :comparators: {}
+    :values: []
+    :type: CodeableConcept
+    :contains_multiple: false
+    :multiple_or: MAY
+:include_params: []
+:revincludes:
+- Provenance:target
+:required_concepts: []
+:must_supports:
+  :extensions: []
+  :slices: []
+  :elements:
+  - :path: udiCarrier
+  - :path: udiCarrier.deviceIdentifier
+  - :path: udiCarrier.carrierAIDC
+  - :path: udiCarrier.carrierHRF
+  - :path: status
+  - :path: distinctIdentifier
+  - :path: expirationDate
+  - :path: lotNumber
+  - :path: serialNumber
+  - :path: type
+  - :path: patient
+    :types:
+    - Reference
+    :target_profiles:
+    - http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient
+  - :path: url
+:mandatory_elements:
+- Device.udiCarrier.deviceIdentifier
+- Device.deviceName.name
+- Device.deviceName.type
+- Device.type
+- Device.specialization.systemType
+- Device.version.value
+- Device.property.type
+- Device.patient
+:bindings:
+- :type: code
+  :strength: required
+  :system: http://hl7.org/fhir/ValueSet/udi-entry-type
+  :path: udiCarrier.entryType
+- :type: code
+  :strength: required
+  :system: http://hl7.org/fhir/ValueSet/device-status
+  :path: status
+- :type: code
+  :strength: required
+  :system: http://hl7.org/fhir/ValueSet/device-nametype
+  :path: deviceName.type
+:references:
+- :path: Device.definition
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/DeviceDefinition
+- :path: Device.patient
+  :profiles:
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient
+- :path: Device.owner
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Organization
+- :path: Device.location
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Location
+- :path: Device.parent
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Device
+:tests:
+- :id: pdex_device_patient_search
+  :file_name: device_patient_search_test.rb
+- :id: pdex_device_patient_type_search
+  :file_name: device_patient_type_search_test.rb
+- :id: pdex_device_read
+  :file_name: device_read_test.rb
+- :id: pdex_device_provenance_revinclude_search
+  :file_name: device_provenance_revinclude_search_test.rb
+- :id: pdex_device_validation
+  :file_name: device_validation_test.rb
+- :id: pdex_device_must_support
+  :file_name: device_must_support_test.rb
+- :id: pdex_device_ref_resolution
+  :file_name: device_reference_resolution_test.rb
+:id: pdex_device
+:file_name: device_group.rb
+:delayed_references: []