davinci_dtr_test_kit 0.14.2 → 0.15.1

data/lib/davinci_dtr_test_kit/metadata.rb

@@ -0,0 +1,104 @@
+require_relative 'version'
+
+module DaVinciDTRTestKit
+  class Metadata < Inferno::TestKit
+    id :davinci_dtr_test_kit
+    title 'Da Vinci Documentation Templates and Rules (DTR) Test Kit'
+    description <<~DESCRIPTION
+      The Da Vinci Documentation Templates and Rules (DTR) Test Kit validates
+      the conformance of DTR SMART app client and payer server implementations to
+      [version 2.0.1 of the Da Vinci DTR Implementation
+      Guide](https://hl7.org/fhir/us/davinci-dtr/STU2/).
+
+      <!-- break -->
+
+      ## Status
+
+      These tests are a **DRAFT** intended to allow DTR implementers to perform
+      preliminary checks of their implementations against the DTR IG requirements and
+      provide feedback on the tests. Future versions of these tests may validate other
+      requirements and may change how these are tested.
+
+      ## Test Scope and Limitations
+
+      The DTR Test Kit includes suites for the following DTR actors:
+      - **DTR Payer Server**: verifies the ability of a payer server to respond
+        to requests for questionnaires.
+      - **DTR SMART App**: verifies the ability of a SMART app to launch, get questionnaires
+        from a payer server, render them, and allow users to complete them.
+      - **Full DTR EHR**: verifies the ability of a EHR to get questionnaires
+        from a payer server, render them, and allow users to complete them.
+      - **Light DTR EHR**: verifies the ability of a EHR to launch a DTR SMART
+        app and respond to FHIR data gathering requests.
+
+      Documentation of the current tests and their limitations can be found in each
+      suite's description when the tests are run and can also be viewed in the
+      source code:
+      - [SMART App Test Suite Limitations](https://github.com/inferno-framework/davinci-dtr-test-kit/blob/main/lib/davinci_dtr_test_kit/docs/dtr_smart_app_suite_description_v201.md)
+      - [Payer Server Test Suite Limitations](https://github.com/inferno-framework/davinci-dtr-test-kit/blob/main/lib/davinci_dtr_test_kit/docs/dtr_payer_server_suite_description_v201.md)
+      - [Full DTR EHR Test Suite Limitations](https://github.com/inferno-framework/davinci-dtr-test-kit/blob/main/lib/davinci_dtr_test_kit/docs/dtr_full_ehr_suite_description_v201.md)
+      - [Light DTR EHR Test Suite Limitations](https://github.com/inferno-framework/davinci-dtr-test-kit/blob/main/lib/davinci_dtr_test_kit/docs/dtr_light_ehr_suite_description_v201.md)
+
+      ### Test Scope
+
+      To validate the behavior of the system under test, Inferno will act as an
+      exchange partner. Specifically,
+
+      - **When testing a DTR SMART app client**: Inferno will simulate both a payer
+        server that can return questionnaires and a Light DTR EHR that can respond
+        to queries for clinical data used to pre-populate questionnaire responses.
+        Inferno uses the SMART App Launch framework to establish a connection with
+        the app under test, either in EHR Launch or Standalone Launch mode. The app
+        will be expected to initiate requests to Inferno and demonstrate its ability
+        to react to the returned responses. Over the course of these interactions,
+        Inferno will seek to observe the conformant completion of a questionnaire
+        including pre-population, as well as the ability of the app to correctly
+        render the questionnaire and allow users to interact with it.
+      - **When testing a DTR payer server**: Inferno will simulate a DTR app
+        by requesting questionnaires from the server under test. The server
+        will be expected to respond to these requests from Inferno. Over the course
+        of these interactions, Inferno will seek to observe the ability of the
+        server under test to return conformant questionnaires.
+      - **When testing a Full DTR EHR client**: Inferno will simulate a payer
+        server that can return questionnaires. The EHR will be expected to initiate
+        requests to Inferno and demonstrate its ability to react to the returned
+        responses. Over the course of these interactions,
+        Inferno will seek to observe the conformant completion of a questionnaire
+        including fetch, as well as the ability of the app to correctly
+        render the questionnaire and allow users to interact with it.
+      - **When testing a Light DTR EHR server**: Inferno will simulate a DTR SMART app
+        that tested servers can launch and that will request FHIR data from and create
+        and update QuestionnaireResponse and Task instances on the server under test.
+        Over the course of these interactions, Inferno will seek to observe the ability of the
+        server under test to conformantly serve as a FHIR server for a DTR SMART App.
+
+      ### Known Limitations
+
+      - **SMART app tests**:
+        - Some questionnaire features, including adaptive questionnaires, are not yet tested.
+        - Inferno uses a single FHIR endpoint to simulate both the payer and the EHR.
+      - **Payer server tests**:
+        - Inferno checks that CQL is used for pre-population in the questionnaires returned by the
+          payer server, but does not currently validate the correctness or executability of that CQL.
+      - **Full EHR tests**:
+        - Some questionnaire features are not yet tested.
+        - Non-standard approach to accessing QuestionnaireResponse instances for validation.
+      - **Light EHR tests**:
+        - `fhirContext` not tested as a part of the Light EHR's SMART App launch process.
+
+      ## Reporting Issues
+
+      Please report any issues with this set of tests in the [GitHub
+      Issues](https://github.com/inferno-framework/davinci-dtr-test-kit/issues)
+      section of the
+      [open-source code repository](https://github.com/inferno-framework/davinci-dtr-test-kit).
+    DESCRIPTION
+    suite_ids [:dtr_payer_server, :dtr_smart_app, :dtr_full_ehr, :dtr_light_ehr]
+    tags ['Da Vinci', 'DTR']
+    last_updated LAST_UPDATED
+    version VERSION
+    maturity 'Low'
+    authors ['Karl Naden', 'Tom Strassner', 'Robert Passas', 'Vanessa Fotso', 'Elsa Perelli']
+    repo 'https://github.com/inferno-framework/davinci-dtr-test-kit'
+  end
+end

data/lib/davinci_dtr_test_kit/payer_server_groups/adaptive_form_libraries_test.rb

@@ -9,10 +9,13 @@ module DaVinciDTRTestKit
       Inferno check that the payer response contains no duplicate library names
        and that libraries contain cql and elm data.
     )
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@84', 'hl7.fhir.us.davinci-dtr_2.0.1@95',
+                          'hl7.fhir.us.davinci-dtr_2.0.1@96', 'hl7.fhir.us.davinci-dtr_2.0.1@99',
+                          'hl7.fhir.us.davinci-dtr_2.0.1@101', 'hl7.fhir.us.davinci-dtr_2.0.1@102'
 
     run do
       skip_if retrieval_method == 'Static', 'Performing only static flow tests - only one flow is required.'
-      skip_if scratch[:adaptive_questionnaire_bundles].nil?, 'No questionnaire bundle returned.'
+      skip_if scratch[:adaptive_questionnaire_bundles].blank?, 'No questionnaire bundle returned.'
       check_libraries(scratch[:adaptive_questionnaire_bundles])
     end
   end

data/lib/davinci_dtr_test_kit/payer_server_groups/adaptive_form_questionnaire_expressions_test.rb

@@ -9,10 +9,11 @@ module DaVinciDTRTestKit
       Inferno checks that the payer server response has appropriate expressions and that expressions are
        written in cql.
     )
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@64'
 
     run do
       skip_if retrieval_method == 'Static', 'Performing only static flow tests - only one flow is required.'
-      skip_if scratch[:adaptive_questionnaire_bundles].nil?, 'No questionnaire bundle returned.'
+      skip_if scratch[:adaptive_questionnaire_bundles].blank?, 'No questionnaire bundle returned.'
       questionnaires = extract_questionnaires_from_bundles(scratch[:adaptive_questionnaire_bundles])
       verify_questionnaire_items(questionnaires)
       scratch[:adaptive_questionnaire_bundles] = nil

data/lib/davinci_dtr_test_kit/payer_server_groups/adaptive_form_questionnaire_extensions_test.rb

@@ -9,10 +9,13 @@ module DaVinciDTRTestKit
       Inferno checks that the payer server response has appropriate extensions and references to libraries within
       those extensions.
     )
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@57', 'hl7.fhir.us.davinci-dtr_2.0.1@62',
+                          'hl7.fhir.us.davinci-dtr_2.0.1@83', 'hl7.fhir.us.davinci-dtr_2.0.1@98',
+                          'hl7.fhir.us.davinci-dtr_2.0.1@309', 'hl7.fhir.us.davinci-dtr_2.0.1@317'
 
     run do
       skip_if retrieval_method == 'Static', 'Performing only static flow tests - only one flow is required.'
-      skip_if scratch[:adaptive_questionnaire_bundles].nil?, 'No questionnaire bundle returned.'
+      skip_if scratch[:adaptive_questionnaire_bundles].blank?, 'No questionnaire bundle returned.'
       questionnaires = extract_questionnaires_from_bundles(scratch[:adaptive_questionnaire_bundles])
       verify_questionnaire_extensions(questionnaires)
     end

data/lib/davinci_dtr_test_kit/payer_server_groups/adaptive_next_questionnaire_expressions_test.rb

@@ -9,6 +9,7 @@ module DaVinciDTRTestKit
       Inferno checks that the payer server response to $next-question operation has appropriate expressions and that
       expressions are written in cql.
     )
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@64'
 
     run do
       skip_if retrieval_method == 'Static', 'Performing only static flow tests - only one flow is required.'

data/lib/davinci_dtr_test_kit/payer_server_groups/adaptive_next_questionnaire_extensions_test.rb

@@ -9,9 +9,12 @@ module DaVinciDTRTestKit
       Inferno checks that the payer server response has appropriate extensions and references to libraries within
       those extensions.
     )
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@57', 'hl7.fhir.us.davinci-dtr_2.0.1@62',
+                          'hl7.fhir.us.davinci-dtr_2.0.1@83', 'hl7.fhir.us.davinci-dtr_2.0.1@98'
 
     run do
-      skip_if retrieval_method == 'Static', 'Performing only static flow tests - only one flow is required.'
+      skip_if retrieval_method == 'Static',
+              'Performing only static flow tests - only one flow is required.'
       skip_if scratch[:next_question_questionnaire_responses].nil?, 'No questionnaires returned.'
       questionnaires = extract_contained_questionnaires(scratch[:next_question_questionnaire_responses])
       verify_questionnaire_extensions(questionnaires)

data/lib/davinci_dtr_test_kit/payer_server_groups/payer_server_adaptive_request_test.rb

@@ -8,6 +8,8 @@ module DaVinciDTRTestKit
       Inferno will wait for a DTR questionnaire package request from the client. Upon receipt, Inferno will generate and
       send a response.
     )
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@239', 'hl7.fhir.us.davinci-dtr_2.0.1@292'
+
     id :payer_server_questionnaire_request
     config options: { accepts_multiple_requests: true }
 

data/lib/davinci_dtr_test_kit/payer_server_groups/payer_server_adaptive_response_bundles_validation_test.rb

@@ -6,7 +6,7 @@ module DaVinciDTRTestKit
     title 'Validate that the adaptive response contains valid Questionnaire Bundle resources'
     description %(
       This test ensures that the payer's response includes a resource that conforms to the the
-      [DTR Quesitonnaire Bundle](http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/DTR-QPackageBundle)
+      [DTR Questionnaire Bundle](http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/DTR-QPackageBundle)
       structure.
 
       It verifies the presence of mandatory elements and that elements with required bindings contain appropriate
@@ -17,12 +17,13 @@ module DaVinciDTRTestKit
       This test may process multiple resources, labeling messages with the corresponding tested resources
       in the order that they were received.
     )
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@303'
 
     run do
       skip_if retrieval_method == 'Static', 'Performing only static flow tests - only one flow is required.'
       test_passed = true
       profile_url = 'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/DTR-QPackageBundle|2.0.1'
-      assert !scratch[:adaptive_questionnaire_bundles].nil?, 'No resources to validate.'
+      assert scratch[:adaptive_questionnaire_bundles].present?, 'No resources to validate.'
       scratch[:adaptive_questionnaire_bundles].each_with_index do |bundle, index|
         resource_is_valid = validate_resource(bundle, :bundle, profile_url, index)
         test_passed = false unless resource_is_valid

data/lib/davinci_dtr_test_kit/payer_server_groups/payer_server_adaptive_response_search_validation_test.rb

@@ -17,15 +17,20 @@ module DaVinciDTRTestKit
       This test may process multiple resources, labeling messages with the corresponding tested resources
       in the order that they were received.
     )
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@37'
 
     run do
-      skip_if retrieval_method == 'Static', 'Performing only static flow tests - only one flow is required.'
+      skip_if retrieval_method == 'Static',
+              'Performing only static flow tests - only one flow is required.'
       test_passed = true
       profile_url = 'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/dtr-questionnaire-adapt-search|2.0.1'
-      assert !scratch[:adaptive_questionnaire_bundles].nil?, 'No questionnaire bundles to validate.'
+      assert scratch[:adaptive_questionnaire_bundles].present?,
+             'No questionnaire bundles to validate.'
 
       questionnaires = scratch[:adaptive_questionnaire_bundles].filter_map do |bundle|
-        bundle.entry&.filter_map { |entry| entry.resource if entry.resource&.resourceType == 'Questionnaire' }
+        bundle.entry&.filter_map do |entry|
+          entry.resource if entry.resource&.resourceType == 'Questionnaire'
+        end
       end&.flatten&.compact
 
       assert questionnaires&.any?, 'No adaptive questionnaires to validate.'

data/lib/davinci_dtr_test_kit/payer_server_groups/payer_server_adaptive_response_validation_test.rb

@@ -1,7 +1,9 @@
 require_relative '../validation_test'
+require_relative '../cql_test'
 module DaVinciDTRTestKit
   class PayerAdaptiveFormQuestionnaireResponseTest < Inferno::Test
     include DaVinciDTRTestKit::ValidationTest
+    include DaVinciDTRTestKit::CQLTest
     id :payer_server_adaptive_response_validation_test
     title 'Validate that the adaptive response conforms to the DTR Questionnaire Package operation definition'
     # output :questionnaire_response
@@ -22,6 +24,8 @@ module DaVinciDTRTestKit
       This test may process multiple resources, labeling messages with the corresponding tested resources
       in the order that they were received.
     )
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@169', 'hl7.fhir.us.davinci-dtr_2.0.1@294',
+                          'hl7.fhir.us.davinci-dtr_2.0.1@303', 'hl7.fhir.us.davinci-dtr_2.0.1@306'
 
     run do
       skip_if retrieval_method == 'Static', 'Performing only static flow tests - only one flow is required.'
@@ -38,21 +42,8 @@ module DaVinciDTRTestKit
       assert_response_status([200, 201], response: req.response)
 
       resource = FHIR.from_contents(req.response_body)
-      if resource&.resourceType == 'Parameters'
-        scratch[:adaptive_questionnaire_bundles] = resource.parameter.filter_map do |param|
-          param.resource if param.resource&.resourceType == 'Bundle'
-        end
-        assert_valid_resource(resource:,
-                              profile_url: 'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/dtr-qpackage-output-parameters|2.0.1')
-        questionnaire_bundle = resource.parameter.find { |param| param.resource.resourceType == 'Bundle' }&.resource
-        assert questionnaire_bundle, 'No questionnaire bundle found in the response'
-      elsif resource&.resourceType == 'Bundle'
-        scratch[:adaptive_questionnaire_bundles] = [resource]
-        assert_valid_resource(resource:,
-                              profile_url: 'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/DTR-QPackageBundle|2.0.1')
-      else
-        assert(false, "Unexpected resourceType: #{resource&.resourceType}. Expected Parameters or Bundle")
-      end
+
+      perform_questionnaire_package_validation(resource, 'adaptive')
     end
   end
 end

data/lib/davinci_dtr_test_kit/payer_server_groups/payer_server_next_response_complete_test.rb

@@ -5,6 +5,7 @@ module DaVinciDTRTestKit
     description %(
       This test validates that in the sequence of adaptive responses, one includes a "completed" status.
     )
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@219'
 
     run do
       skip_if retrieval_method == 'Static', 'Performing only static flow tests - only one flow is required.'

data/lib/davinci_dtr_test_kit/payer_server_groups/payer_server_static_group.rb

@@ -43,7 +43,7 @@ module DaVinciDTRTestKit
                 :access_token,
                 :initial_static_questionnaire_request
 
-    test from: :dtr_v201_payer_static_questionnaire_request_test, receives_request: :static_questionnaire_request
+    test from: :dtr_v201_payer_static_request_test, receives_request: :static_questionnaire_request
     test from: :dtr_v201_payer_static_form_request_validation_test
     test from: :dtr_v201_payer_static_form_response_test
     test from: :dtr_v201_payer_static_form_libraries_test

data/lib/davinci_dtr_test_kit/payer_server_groups/static_form_libraries_test.rb

@@ -9,10 +9,13 @@ module DaVinciDTRTestKit
       Inferno check that the payer response contains no duplicate library names
        and that libraries contain cql and elm data.
     )
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@84', 'hl7.fhir.us.davinci-dtr_2.0.1@95',
+                          'hl7.fhir.us.davinci-dtr_2.0.1@96', 'hl7.fhir.us.davinci-dtr_2.0.1@99',
+                          'hl7.fhir.us.davinci-dtr_2.0.1@101', 'hl7.fhir.us.davinci-dtr_2.0.1@102'
 
     run do
       skip_if retrieval_method == 'Adaptive', 'Performing only adaptive flow tests - only one flow is required.'
-      skip_if scratch[:static_questionnaire_bundles].nil?, 'No questionnaire bundle returned.'
+      skip_if scratch[:static_questionnaire_bundles].blank?, 'No questionnaire bundle returned.'
       check_libraries(scratch[:static_questionnaire_bundles])
     end
   end

data/lib/davinci_dtr_test_kit/payer_server_groups/static_form_questionnaire_expressions_test.rb

@@ -9,10 +9,11 @@ module DaVinciDTRTestKit
       Inferno checks that the payer server response has appropriate expressions and that expressions are
        written in cql.
     )
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@64'
 
     run do
       skip_if retrieval_method == 'Adaptive', 'Performing only adaptive flow tests - only one flow is required.'
-      skip_if scratch[:static_questionnaire_bundles].nil?, 'No questionnaire bundle returned.'
+      skip_if scratch[:static_questionnaire_bundles].blank?, 'No questionnaire bundle returned.'
       questionnaires = extract_questionnaires_from_bundles(scratch[:static_questionnaire_bundles])
       verify_questionnaire_items(questionnaires, final_cql_test: true)
       scratch[:static_questionnaire_bundles] = nil

data/lib/davinci_dtr_test_kit/payer_server_groups/static_form_questionnaire_extensions_test.rb

@@ -9,10 +9,13 @@ module DaVinciDTRTestKit
       Inferno checks that the payer server response has appropriate extensions and references to libraries within
       those extensions.
     )
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@57', 'hl7.fhir.us.davinci-dtr_2.0.1@62',
+                          'hl7.fhir.us.davinci-dtr_2.0.1@83', 'hl7.fhir.us.davinci-dtr_2.0.1@98',
+                          'hl7.fhir.us.davinci-dtr_2.0.1@309', 'hl7.fhir.us.davinci-dtr_2.0.1@317'
 
     run do
       skip_if retrieval_method == 'Adaptive', 'Performing only adaptive flow tests - only one flow is required.'
-      skip_if scratch[:static_questionnaire_bundles].nil?, 'No questionnaire bundle returned.'
+      skip_if scratch[:static_questionnaire_bundles].blank?, 'No questionnaire bundle returned.'
       questionnaires = extract_questionnaires_from_bundles(scratch[:static_questionnaire_bundles])
       verify_questionnaire_extensions(questionnaires)
     end

data/lib/davinci_dtr_test_kit/payer_server_groups/static_form_request_test.rb

@@ -7,7 +7,9 @@ module DaVinciDTRTestKit
     description %(
       Inferno will validate questionnaires returned by the payer server.
     )
-    id :dtr_v201_payer_static_questionnaire_request_test
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@239', 'hl7.fhir.us.davinci-dtr_2.0.1@292'
+
+    id :dtr_v201_payer_static_request_test
     config options: { accepts_multiple_requests: false }
     input :initial_static_questionnaire_request, :access_token, :retrieval_method, :url
 

data/lib/davinci_dtr_test_kit/payer_server_groups/static_form_response_validation_test.rb

@@ -1,9 +1,11 @@
 require_relative '../urls'
 require_relative '../validation_test'
+require_relative '../cql_test'
 module DaVinciDTRTestKit
   class PayerStaticFormResponseTest < Inferno::Test
     include URLs
     include DaVinciDTRTestKit::ValidationTest
+    include DaVinciDTRTestKit::CQLTest
     id :dtr_v201_payer_static_form_response_test
     title 'Validate that the static response conforms to the DTR Questionnaire Package operation definition.'
     description %(
@@ -20,6 +22,8 @@ module DaVinciDTRTestKit
       to the bound ValueSet. Quantity, Coding, and code element bindings will fail if their code/system are not found in
       the valueset.
     )
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@169', 'hl7.fhir.us.davinci-dtr_2.0.1@294',
+                          'hl7.fhir.us.davinci-dtr_2.0.1@303', 'hl7.fhir.us.davinci-dtr_2.0.1@306'
     input :url
 
     run do
@@ -36,21 +40,8 @@ module DaVinciDTRTestKit
       assert_response_status([200, 201], response: req.response)
 
       resource = FHIR.from_contents(req.response_body)
-      if resource&.resourceType == 'Parameters'
-        scratch[:static_questionnaire_bundles] = resource.parameter&.filter_map do |param|
-          param.resource if param.resource&.resourceType == 'Bundle'
-        end
-        assert_valid_resource(resource:,
-                              profile_url: 'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/dtr-qpackage-output-parameters|2.0.1')
-        questionnaire_bundle = resource.parameter.find { |param| param.resource.resourceType == 'Bundle' }&.resource
-        assert questionnaire_bundle, 'No questionnaire bundle found in the response'
-      elsif resource&.resourceType == 'Bundle'
-        scratch[:static_questionnaire_bundles] = [resource]
-        assert_valid_resource(resource:,
-                              profile_url: 'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/DTR-QPackageBundle|2.0.1')
-      else
-        assert(false, "Unexpected resourceType: #{resource&.resourceType}. Expected Parameters or Bundle")
-      end
+
+      perform_questionnaire_package_validation(resource, 'static')
     end
   end
 end

data/lib/davinci_dtr_test_kit/profiles/communication_request/communication_request_must_support_test.rb

@@ -0,0 +1,46 @@
+module DaVinciDTRTestKit
+  class CommunicationRequestMustSupportTest < Inferno::Test
+    include USCoreTestKit::MustSupportTest
+
+    title 'All must support elements are provided in the CommunicationRequest resources returned'
+    description %(
+      This test will look through the CommunicationRequest resources
+      found previously for the following must support elements:\n
+
+      * CommunicationRequest.authoredOn
+      * CommunicationRequest.basedOn
+      * CommunicationRequest.extension:Coverage-Information
+      * CommunicationRequest.identifier
+      * CommunicationRequest.occurrence[x]
+      * CommunicationRequest.payload
+      * CommunicationRequest.payload.extension:codeableConcept
+      * CommunicationRequest.reasonCode
+      * CommunicationRequest.reasonReference
+      * CommunicationRequest.recipient
+      * CommunicationRequest.requester
+      * CommunicationRequest.sender
+      * CommunicationRequest.status
+      * CommunicationRequest.subject
+    )
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@355'
+    id :communication_request_must_support_test
+
+    def resource_type
+      'CommunicationRequest'
+    end
+
+    def self.metadata
+      @metadata ||= USCoreTestKit::Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'),
+                                                                               aliases: true))
+    end
+
+    def scratch_resources
+      scratch[:communication_requests] ||= {}
+    end
+
+    run do
+      skip_if(communication_request_ids.nil?, "No `#{resource_type}` IDs provided, skipping test.")
+      perform_must_support_test(all_scratch_resources)
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/communication_request/communication_request_read.rb

@@ -6,6 +6,7 @@ module DaVinciDTRTestKit
 
     title 'Server returns correct CommunicationRequest resource from CommunicationRequest read interaction'
     description 'A server SHOULD support the CommunicationRequest read interaction.'
+    verifies_requirements 'hl7.fhir.us.davinci-dtr_2.0.1@275'
 
     id :communication_request_read
     output :communication_request_resources
@@ -14,6 +15,10 @@ module DaVinciDTRTestKit
       'CommunicationRequest'
     end
 
+    def scratch_resources
+      scratch[:communication_requests] ||= {}
+    end
+
     def communication_request_id_list
       return [nil] unless respond_to? :communication_request_ids
 
@@ -21,9 +26,7 @@ module DaVinciDTRTestKit
     end
 
     run do
-      resources = perform_read_test(communication_request_id_list, resource_type)
-
-      output communication_request_resources: resources.to_json
+      perform_read_test(communication_request_id_list, resource_type)
     end
   end
 end

data/lib/davinci_dtr_test_kit/profiles/communication_request/communication_request_validation.rb

@@ -1,8 +1,6 @@
-require_relative '../../validation_test'
-
 module DaVinciDTRTestKit
   class CommunicationRequestValidationTest < Inferno::Test
-    include DaVinciDTRTestKit::ValidationTest
+    include USCoreTestKit::ValidationTest
 
     title 'CommunicationRequest resources returned during previous tests conform to the CRD CommunicationRequest'
     description %(
@@ -19,17 +17,20 @@ fail if their code/system are not found in the valueset.
     )
 
     id :communication_request_validation
-    input :communication_request_resources,
-          optional: true
 
     def resource_type
       'CommunicationRequest'
     end
 
+    def scratch_resources
+      scratch[:communication_requests] ||= {}
+    end
+
     run do
-      skip_if(communication_request_ids.nil?, "No `#{resource_type}` IDs provided, skipping test.")
-      perform_profile_validation_test(communication_request_resources, resource_type,
-                                      'http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-communicationrequest|2.0.1')
+      perform_validation_test(scratch_resources[:all] || [],
+                              'http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-communicationrequest',
+                              '2.0.1',
+                              skip_if_empty: true)
     end
   end
 end

data/lib/davinci_dtr_test_kit/profiles/communication_request/metadata.yml

@@ -0,0 +1,135 @@
+---
+:name: profile_communicationrequest
+:class_name: ProfileCommunicationrequestSequence
+:version: v3.1.1
+:reformatted_version: v311
+:resource: CommunicationRequest
+:profile_url: http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-communicationrequest
+:profile_name: CRD Communication Request
+:profile_version: 2.0.1
+:title: CRD Communication Request
+:short_description: Verify support for the server capabilities required by the CRD
+  Communication Request.
+:is_delayed: true
+:interactions:
+- :code: read
+  :expectation: SHOULD
+:operations: []
+:searches: []
+:search_definitions: {}
+:include_params: []
+:revincludes: []
+:required_concepts: []
+:must_supports:
+  :extensions:
+  - :id: CommunicationRequest.extension:Coverage-Information
+    :path: extension
+    :url: http://hl7.org/fhir/us/davinci-crd/StructureDefinition/ext-coverage-information
+  - :id: CommunicationRequest.payload.extension:codeableConcept
+    :path: payload.extension
+    :url: http://hl7.org/fhir/5.0/StructureDefinition/extension-CommunicationRequest.payload.content[x]
+  :slices: []
+  :elements:
+  - :path: identifier
+  - :path: basedOn
+    :types:
+    - Reference
+  - :path: status
+    :fixed_value: draft
+  - :path: subject
+    :types:
+    - Reference
+    :target_profiles:
+    - http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-patient
+  - :path: payload
+  - :path: occurrence[x]
+  - :path: authoredOn
+  - :path: requester
+    :types:
+    - Reference
+  - :path: recipient
+    :types:
+    - Reference
+  - :path: sender
+    :types:
+    - Reference
+  - :path: reasonCode
+  - :path: reasonReference
+    :types:
+    - Reference
+:mandatory_elements:
+- CommunicationRequest.basedOn
+- CommunicationRequest.status
+- CommunicationRequest.subject
+- CommunicationRequest.payload
+- CommunicationRequest.payload.extension
+- CommunicationRequest.payload.extension.url
+- CommunicationRequest.payload.extension.value[x]
+- CommunicationRequest.payload.content[x]
+- CommunicationRequest.authoredOn
+- CommunicationRequest.requester
+:bindings:
+- :type: code
+  :strength: required
+  :system: http://hl7.org/fhir/ValueSet/request-priority
+  :path: priority
+:references:
+- :path: CommunicationRequest.basedOn
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Resource
+- :path: CommunicationRequest.replaces
+  :profiles:
+  - http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-communicationrequest
+- :path: CommunicationRequest.subject
+  :profiles:
+  - http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-patient
+- :path: CommunicationRequest.about
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Resource
+- :path: CommunicationRequest.encounter
+  :profiles:
+  - http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-encounter
+- :path: CommunicationRequest.requester
+  :profiles:
+  - http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-practitioner
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole
+- :path: CommunicationRequest.recipient
+  :profiles:
+  - http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-practitioner
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization
+- :path: CommunicationRequest.sender
+  :profiles:
+  - http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-practitioner
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization
+- :path: CommunicationRequest.reasonReference
+  :profiles:
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-lab
+:tests:
+- :id: us_core_v311_communication_request_read_test
+  :file_name: communication_request_read_test.rb
+- :id: us_core_v311_communication_request_validation_test
+  :file_name: communication_request_validation_test.rb
+- :id: us_core_v311_communication_request_must_support_test
+  :file_name: communication_request_must_support_test.rb
+- :id: us_core_v311_communication_request_reference_resolution_test
+  :file_name: communication_request_reference_resolution_test.rb
+:id: us_core_v311_communication_request
+:file_name: communication_request_group.rb
+:delayed_references:
+- :path: replaces
+  :resources:
+  - CommunicationRequest
+- :path: requester
+  :resources:
+  - PractitionerRole
+- :path: recipient
+  :resources:
+  - PractitionerRole
+  - Organization
+- :path: sender
+  :resources:
+  - PractitionerRole
+  - Organization