davinci_dtr_test_kit 0.12.0 → 0.14.0

data/lib/davinci_dtr_test_kit/profiles/medication_request/medication_request_validation.rb

@@ -0,0 +1,35 @@
+require_relative '../../validation_test'
+
+module DaVinciDTRTestKit
+  class MedicationRequestValidationTest < Inferno::Test
+    include DaVinciDTRTestKit::ValidationTest
+
+    title 'MedicationRequest resources returned during previous tests conform to the CRD MedicationRequest'
+    description %(
+This test verifies resources returned from the read step conform to
+the [CRD MedicationRequest](https://hl7.org/fhir/us/davinci-crd/STU2/StructureDefinition-profile-medicationrequest).
+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.
+
+    )
+
+    id :medication_request_validation
+    input :medication_request_resources,
+          optional: true
+
+    def resource_type
+      'MedicationRequest'
+    end
+
+    run do
+      skip_if(medication_request_ids.nil?, "No `#{resource_type}` IDs provided, skipping test.")
+      perform_profile_validation_test(medication_request_resources, resource_type,
+                                      'http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-medicationrequest|2.0.1')
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/medication_request_group.rb

@@ -0,0 +1,39 @@
+require_relative 'medication_request/medication_request_read'
+require_relative 'medication_request/medication_request_validation'
+
+module DaVinciDTRTestKit
+  class MedicationRequestGroup < Inferno::TestGroup
+    title 'CRD MedicationRequest Tests'
+    short_description 'Verify support for the server capabilities required by the CRD MedicationRequest Profile'
+    description %(
+      # Background
+
+    The CRD MedicationRequest sequence verifies that the system under test is
+    able to provide correct responses for MedicationRequest queries. These queries
+    must return resources conforming to the [CRD MedicationRequest Profile](https://hl7.org/fhir/us/davinci-crd/STU2/StructureDefinition-profile-medicationrequest.html).
+
+    # Testing Methodology
+    ## Read
+    First, Inferno will attempt to read each MedicationRequest resource id provided in
+    the MedicationRequest IDs input. The server SHOULD be capable of returning a
+    MedicationRequest resource using the read interaction.
+
+    ## Profile Validation
+    Each resource returned from the read step SHALL conform to
+    the [CRD MedicationRequest Profile](https://hl7.org/fhir/us/davinci-crd/STU2/StructureDefinition-profile-medicationrequest.html).
+    Each element is checked against terminology binding and cardinality requirements.
+
+    )
+    id :medication_request_group
+    optional
+    run_as_group
+
+    input :medication_request_ids,
+          title: 'Medication Request IDs',
+          description: 'Comma separated list of MedicationRequest IDs',
+          optional: true
+
+    test from: :medication_request_read
+    test from: :medication_request_validation
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/nutrition_order/nutrition_order_read.rb

@@ -0,0 +1,29 @@
+require_relative '../../read_test'
+
+module DaVinciDTRTestKit
+  class NutritionOrderReadTest < Inferno::Test
+    include DaVinciDTRTestKit::ReadTest
+
+    title 'Server returns correct NutritionOrder resource from NutritionOrder read interaction'
+    description 'A server SHOULD support the NutritionOrder read interaction.'
+
+    id :nutrition_order_read
+    output :nutrition_order_resources
+
+    def resource_type
+      'NutritionOrder'
+    end
+
+    def nutrition_order_id_list
+      return [nil] unless respond_to? :nutrition_order_ids
+
+      nutrition_order_ids&.split(',')&.map(&:strip)
+    end
+
+    run do
+      resources = perform_read_test(nutrition_order_id_list, resource_type)
+
+      output nutrition_order_resources: resources.to_json
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/nutrition_order/nutrition_order_validation.rb

@@ -0,0 +1,35 @@
+require_relative '../../validation_test'
+
+module DaVinciDTRTestKit
+  class NutritionOrderValidationTest < Inferno::Test
+    include DaVinciDTRTestKit::ValidationTest
+
+    title 'NutritionOrder resources returned during previous tests conform to the CRD NutritionOrder'
+    description %(
+This test verifies resources returned from the read step conform to
+the [CRD NutritionOrder](https://hl7.org/fhir/us/davinci-crd/STU2/StructureDefinition-profile-nutritionorder).
+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.
+
+    )
+
+    id :nutrition_order_validation
+    input :nutrition_order_resources,
+          optional: true
+
+    def resource_type
+      'NutritionOrder'
+    end
+
+    run do
+      skip_if(nutrition_order_ids.nil?, "No `#{resource_type}` IDs provided, skipping test.")
+      perform_profile_validation_test(nutrition_order_resources, resource_type,
+                                      'http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-nutritionorder|2.0.1')
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/nutrition_order_group.rb

@@ -0,0 +1,39 @@
+require_relative 'nutrition_order/nutrition_order_read'
+require_relative 'nutrition_order/nutrition_order_validation'
+
+module DaVinciDTRTestKit
+  class NutritionOrderGroup < Inferno::TestGroup
+    title 'CRD NutritionOrder Tests'
+    short_description 'Verify support for the server capabilities required by the CRD NutritionOrder Profile'
+    description %(
+      # Background
+
+    The CRD NutritionOrder sequence verifies that the system under test is
+    able to provide correct responses for NutritionOrder queries. These queries
+    must return resources conforming to the [CRD NutritionOrder Profile](https://hl7.org/fhir/us/davinci-crd/STU2/StructureDefinition-profile-nutritionorder.html).
+
+    # Testing Methodology
+    ## Read
+    First, Inferno will attempt to read each NutritionOrder resource id provided in
+    the NutritionOrder IDs input. The server SHOULD be capable of returning a
+    NutritionOrder resource using the read interaction.
+
+    ## Profile Validation
+    Each resource returned from the read step SHALL conform to
+    the [CRD NutritionOrder Profile](https://hl7.org/fhir/us/davinci-crd/STU2/StructureDefinition-profile-communicationrequest.html).
+    Each element is checked against terminology binding and cardinality requirements.
+
+    )
+    id :nutrition_order_group
+    optional
+    run_as_group
+
+    input :nutrition_order_ids,
+          title: 'Nutrition Order IDs',
+          description: 'Comma separated list of NutritionOrder IDs',
+          optional: true
+
+    test from: :nutrition_order_read
+    test from: :nutrition_order_validation
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/questionnaire_response/questionnaire_response_context_search.rb

@@ -0,0 +1,35 @@
+module DaVinciDTRTestKit
+  class QuestionnaireResponseContextSearchTest < Inferno::Test
+    include USCoreTestKit::SearchTest
+
+    title 'Server returns valid results for QuestionnaireResponse search by context'
+    description %(
+A server SHALL support searching by
+context on the QuestionnaireResponse resource. This test
+will pass if resources are returned and match the search criteria. If
+none are returned, the test is skipped.
+    )
+
+    id :questionnaire_response_context_search
+
+    def self.properties
+      @properties ||= USCoreTestKit::SearchTestProperties.new(
+        resource_type: 'QuestionnaireResponse',
+        search_param_names: ['context']
+      )
+    end
+
+    def self.metadata
+      @metadata ||= USCoreTestKit::Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'),
+                                                                               aliases: true))
+    end
+
+    def scratch_resources
+      scratch[:questionnaire_response_resources] ||= {}
+    end
+
+    run do
+      run_search_test
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/questionnaire_response/questionnaire_response_create.rb

@@ -0,0 +1,26 @@
+require_relative '../../create_test'
+
+module DaVinciDTRTestKit
+  class QuestionnaireResponseCreateTest < Inferno::Test
+    include DaVinciDTRTestKit::CreateTest
+
+    title 'Server is capable of creating a QuestionnaireResponse resource from QuestionnaireResponse create interaction'
+    description 'A sever SHALL support the QuestionnaireResponse create interaction'
+
+    id :questionnaire_response_create
+    input :create_questionnaire_resources,
+          type: 'textarea',
+          title: 'Create QuestionnaireResponse Resources',
+          description:
+          'Provide a list of QuestionnaireResponse resources to create. e.g., [json_resource_1, json_resource_2]',
+          optional: true
+
+    def resource_type
+      'QuestionnaireResponse'
+    end
+
+    run do
+      perform_create_test(create_questionnaire_resources, resource_type)
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/questionnaire_response/questionnaire_response_patient_search.rb

@@ -0,0 +1,55 @@
+module DaVinciDTRTestKit
+  class QuestionnaireResponsePatientSearchTest < Inferno::Test
+    include USCoreTestKit::SearchTest
+
+    title 'Server returns valid results for QuestionnaireResponse search by patient'
+    description %(
+A server SHALL support searching by
+patient on the QuestionnaireResponse 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.
+
+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 US Core v3.1.1.
+      )
+
+    id :questionnaire_response_patient_search
+    input :patient_ids,
+          title: 'Patient IDs',
+          description: 'Comma separated list of Patient IDs used to search for QuestionnaireResponses'
+
+    def self.properties
+      @properties ||= USCoreTestKit::SearchTestProperties.new(
+        first_search: true,
+        resource_type: 'QuestionnaireResponse',
+        search_param_names: ['patient'],
+        saves_delayed_references: true,
+        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[:questionnaire_response_resources] ||= {}
+    end
+
+    run do
+      run_search_test
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/questionnaire_response/questionnaire_response_read.rb

@@ -0,0 +1,22 @@
+module DaVinciDTRTestKit
+  class QuestionnaireResponseReadTest < Inferno::Test
+    include USCoreTestKit::ReadTest
+
+    title 'Server returns correct QuestionnaireResponse resource from QuestionnaireResponse read interaction'
+    description 'A server SHALL support the QuestionnaireResponse read interaction'
+
+    id :questionnaire_response_read
+
+    def resource_type
+      'QuestionnaireResponse'
+    end
+
+    def scratch_resources
+      scratch[:questionnaire_response_resources] ||= {}
+    end
+
+    run do
+      perform_read_test(all_scratch_resources)
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/questionnaire_response/questionnaire_response_update.rb

@@ -0,0 +1,26 @@
+require_relative '../../update_test'
+
+module DaVinciDTRTestKit
+  class QuestionnaireResponseUpdateTest < Inferno::Test
+    include DaVinciDTRTestKit::UpdateTest
+
+    title 'Server is capable of updating a QuestionnaireResponse resource from QuestionnaireResponse update interaction'
+    description 'A server SHALL support the QuestionnaireResponse update interaction'
+
+    id :questionnaire_response_update
+    input :update_questionnaire_resources,
+          type: 'textarea',
+          title: 'Update QuestionnaireResponse Resources',
+          description:
+          'Provide a list of QuestionnaireResponse resources to update. e.g., [json_resource_1, json_resource_2]',
+          optional: true
+
+    def resource_type
+      'QuestionnaireResponse'
+    end
+
+    run do
+      perform_update_test(update_questionnaire_resources, resource_type)
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/questionnaire_response/questionnaire_response_validation.rb

@@ -0,0 +1,37 @@
+module DaVinciDTRTestKit
+  class QuestionnaireResponseValidationTest < Inferno::Test
+    include USCoreTestKit::ValidationTest
+
+    id :questionnaire_response_validation
+    title 'QuestionnaireResponse resources returned during previous tests conform to the DTR Questionnaire Response'
+    description %(
+This test verifies resources returned from the first search conform to
+the [DTR Questionnaire Response](https://hl7.org/fhir/us/davinci-dtr/STU2/StructureDefinition-dtr-questionnaireresponse).
+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
+      'QuestionnaireResponse'
+    end
+
+    def scratch_resources
+      scratch[:questionnaire_response_resources] ||= {}
+    end
+
+    run do
+      perform_validation_test(scratch_resources[:all] || [],
+                              'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/dtr-questionnaireresponse',
+                              '2.0.1',
+                              skip_if_empty: true)
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/questionnaire_response_group.rb

@@ -0,0 +1,66 @@
+require_relative 'questionnaire_response/questionnaire_response_patient_search'
+require_relative 'questionnaire_response/questionnaire_response_context_search'
+require_relative 'questionnaire_response/questionnaire_response_read'
+require_relative 'questionnaire_response/questionnaire_response_validation'
+require_relative 'questionnaire_response/questionnaire_response_create'
+require_relative 'questionnaire_response/questionnaire_response_update'
+
+module DaVinciDTRTestKit
+  class QuestionnaireResponseGroup < Inferno::TestGroup
+    title 'DTR QuestionnaireResponse Tests'
+    short_description 'Verify support for the server capabilities required by the DTR QuestionnaireResponse Profile'
+    description %(
+      # Background
+
+    The DTR QuestionnaireResponse sequences verifies that the system under test is able to create and update
+    QuestionnaireResponse instances and provide correct responses for QuestionnaireResponse queries. These queries must
+    return resources conforming to the [DTR QuestionnaireResponse Profile](http://hl7.org/fhir/us/davinci-dtr/STU2/StructureDefinition-dtr-questionnaireresponse.html).
+
+    # 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`
+    * `context`
+
+    ### Search Parameters
+    The first search uses the patient(s) from the *Patient IDs* input. Subsequent searches will look for its parameter
+    values from the results of the first search. For example, the `context` search in this sequence is performed by
+    looking for an existing `context` extension from any of the resources returned in the `patient` 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 QuestionnaireResponse 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 search for `context=Coverage/cov015` returns a QuestionnaireResponse without a link to Coverage `cov015` in the
+    `context` extension.
+
+    ## Read
+    The ids of each resource returned from the searches are then used to verify that the system under test is able to
+    return the correct QuestionnaireResponse resource using the read interaction.
+
+    ## Profile Validation
+    Each resource returned from the search step SHALL conform to the [DTR QuestionnaireResponse Profile](http://hl7.org/fhir/us/davinci-dtr/STU2/StructureDefinition-dtr-questionnaireresponse.html).
+    Each element is checked against terminology binding and cardinality requirements.
+
+    ## Create
+    This test sequence will perform create interactions with the provided json QuestionnaireResponse resources. The
+    server SHALL be capable of creating a QuestionnaireResponse resource using the create interaction.
+
+    ## Update
+    This test sequence will perform update interactions with the provided json QuestionnaireResponse resources. The
+    server SHALL be capable of creating a QuestionnaireResponse resource using the update interaction.
+          )
+    id :questionnaire_response_group
+    run_as_group
+
+    test from: :questionnaire_response_patient_search
+    test from: :questionnaire_response_context_search
+    test from: :questionnaire_response_read
+    test from: :questionnaire_response_validation
+    test from: :questionnaire_response_create
+    test from: :questionnaire_response_update
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/service_request/service_request_read.rb

@@ -0,0 +1,29 @@
+require_relative '../../read_test'
+
+module DaVinciDTRTestKit
+  class ServiceRequestReadTest < Inferno::Test
+    include DaVinciDTRTestKit::ReadTest
+
+    title 'Server returns correct ServiceRequest resource from ServiceRequest read interaction'
+    description 'A server SHOULD support the ServiceRequest read interaction.'
+
+    id :service_request_read
+    output :service_request_resources
+
+    def resource_type
+      'ServiceRequest'
+    end
+
+    def service_request_id_list
+      return [nil] unless respond_to? :service_request_ids
+
+      service_request_ids&.split(',')&.map(&:strip)
+    end
+
+    run do
+      resources = perform_read_test(service_request_id_list, resource_type)
+
+      output service_request_resources: resources.to_json
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/service_request/service_request_validation.rb

@@ -0,0 +1,35 @@
+require_relative '../../validation_test'
+
+module DaVinciDTRTestKit
+  class ServiceRequestValidationTest < Inferno::Test
+    include DaVinciDTRTestKit::ValidationTest
+
+    title 'ServiceRequest resources returned during previous tests conform to the CRD ServiceRequest'
+    description %(
+This test verifies resources returned from the read step conform to
+the [CRD ServiceRequest](https://hl7.org/fhir/us/davinci-crd/STU2/StructureDefinition-profile-servicerequest).
+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.
+
+    )
+
+    id :service_request_validation
+    input :service_request_resources,
+          optional: true
+
+    def resource_type
+      'ServiceRequest'
+    end
+
+    run do
+      skip_if(service_request_ids.nil?, "No `#{resource_type}` IDs provided, skipping test.")
+      perform_profile_validation_test(service_request_resources, resource_type,
+                                      'http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-servicerequest|2.0.1')
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/service_request_group.rb

@@ -0,0 +1,39 @@
+require_relative 'service_request/service_request_read'
+require_relative 'service_request/service_request_validation'
+
+module DaVinciDTRTestKit
+  class ServiceRequestGroup < Inferno::TestGroup
+    title 'CRD ServiceRequest Tests'
+    short_description 'Verify support for the server capabilities required by the CRD ServiceRequest Profile'
+    description %(
+      # Background
+
+    The CRD ServiceRequest sequence verifies that the system under test is
+    able to provide correct responses for ServiceRequest queries. These queries
+    must return resources conforming to the [CRD ServiceRequest Profile](https://hl7.org/fhir/us/davinci-crd/STU2/StructureDefinition-profile-servicerequest.html).
+
+    # Testing Methodology
+    ## Read
+    First, Inferno will attempt to read each ServiceRequest resource id provided in
+    the ServiceRequest IDs input. The server SHOULD be capable of returning a
+    ServiceRequest resource using the read interaction.
+
+    ## Profile Validation
+    Each resource returned from the read step SHALL conform to
+    the [CRD ServiceRequest Profile](https://hl7.org/fhir/us/davinci-crd/STU2/StructureDefinition-profile-servicerequest.html).
+    Each element is checked against terminology binding and cardinality requirements.
+
+    )
+    id :service_request_group
+    optional
+    run_as_group
+
+    input :service_request_ids,
+          title: 'Service Request IDs',
+          description: 'Comma separated list of ServiceRequest IDs',
+          optional: true
+
+    test from: :service_request_read
+    test from: :service_request_validation
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/task/task_create.rb

@@ -0,0 +1,26 @@
+require_relative '../../create_test'
+
+module DaVinciDTRTestKit
+  class TaskCreateTest < Inferno::Test
+    include DaVinciDTRTestKit::CreateTest
+
+    title 'Server is capable of creating a Task resource from Task create interaction'
+    description 'A server SHOULD support the Task create interaction'
+
+    id :task_create
+    input :create_task_resources,
+          type: 'textarea',
+          title: 'Create Task Resources',
+          description:
+          'Provide a list of Task resources to create. e.g., [json_resource_1, json_resource_2]',
+          optional: true
+
+    def resource_type
+      'Task'
+    end
+
+    run do
+      perform_create_test(create_task_resources, resource_type)
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/task/task_read.rb

@@ -0,0 +1,29 @@
+require_relative '../../read_test'
+
+module DaVinciDTRTestKit
+  class TaskReadTest < Inferno::Test
+    include DaVinciDTRTestKit::ReadTest
+
+    title 'Server returns correct Task resource from Task read interaction'
+    description 'A server SHOULD support the Task read interaction.'
+
+    id :task_read
+    output :task_resources
+
+    def resource_type
+      'Task'
+    end
+
+    def task_id_list
+      return [nil] unless respond_to? :task_ids
+
+      task_ids&.split(',')&.map(&:strip)
+    end
+
+    run do
+      resources = perform_read_test(task_id_list, resource_type)
+
+      output task_resources: resources.to_json
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/task/task_update.rb

@@ -0,0 +1,26 @@
+require_relative '../../update_test'
+
+module DaVinciDTRTestKit
+  class TaskUpdateTest < Inferno::Test
+    include DaVinciDTRTestKit::UpdateTest
+
+    title 'Server is capable of updating a Task resource from Task update interaction'
+    description 'A server SHOULD support the Task update interaction'
+
+    id :task_update
+    input :update_task_resources,
+          type: 'textarea',
+          title: 'Update Task Resources',
+          description:
+          'Provide a list of Task resources to update. e.g., [json_resource_1, json_resource_2]',
+          optional: true
+
+    def resource_type
+      'Task'
+    end
+
+    run do
+      perform_update_test(update_task_resources, resource_type)
+    end
+  end
+end