us_core_test_kit 0.6.1 → 0.6.3

data/lib/us_core_test_kit/generated/v7.0.0-ballot/medication_dispense/medication_dispense_reference_resolution_test.rb

@@ -0,0 +1,44 @@
+require_relative '../../../reference_resolution_test'
+
+module USCoreTestKit
+  module USCoreV700_BALLOT
+    class MedicationDispenseReferenceResolutionTest < Inferno::Test
+      include USCoreTestKit::ReferenceResolutionTest
+
+      title 'MustSupport references within MedicationDispense 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:
+
+        * MedicationDispense.authorizingPrescription
+        * MedicationDispense.context
+        * MedicationDispense.medication[x]
+        * MedicationDispense.performer.actor
+        * MedicationDispense.subject
+      )
+
+      id :us_core_v700_ballot_medication_dispense_reference_resolution_test
+
+      def resource_type
+        'MedicationDispense'
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:medication_dispense_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/medication_dispense/medication_dispense_validation_test.rb

@@ -0,0 +1,40 @@
+require_relative '../../../validation_test'
+
+module USCoreTestKit
+  module USCoreV700_BALLOT
+    class MedicationDispenseValidationTest < Inferno::Test
+      include USCoreTestKit::ValidationTest
+
+      id :us_core_v700_ballot_medication_dispense_validation_test
+      title 'MedicationDispense resources returned during previous tests conform to the US Core MedicationDispense Profile'
+      description %(
+This test verifies resources returned from the first search conform to
+the [US Core MedicationDispense Profile](http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationdispense).
+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
+        'MedicationDispense'
+      end
+
+      def scratch_resources
+        scratch[:medication_dispense_resources] ||= {}
+      end
+
+      run do
+        perform_validation_test(scratch_resources[:all] || [],
+                                'http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationdispense',
+                                '7.0.0-ballot',
+                                skip_if_empty: true)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,241 @@
+---
+:name: us_core_medicationdispense
+:class_name: USCorev700_ballotMedicationdispenseSequence
+:version: v7.0.0-ballot
+:reformatted_version: v700_ballot
+:resource: MedicationDispense
+:profile_url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationdispense
+:profile_name: US Core MedicationDispense Profile
+:profile_version: 7.0.0-ballot
+:title: MedicationDispense
+:short_description: Verify support for the server capabilities required by the US
+  Core MedicationDispense Profile.
+:is_delayed: false
+: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:
+  - patient
+  :expectation: SHALL
+  :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
+- :expectation: SHOULD
+  :names:
+  - patient
+  - status
+  - type
+  :names_not_must_support_or_mandatory: []
+  :must_support_or_mandatory: true
+:search_definitions:
+  :patient:
+    :paths:
+    - subject
+    :full_paths:
+    - MedicationDispense.subject
+    :comparators: {}
+    :values: []
+    :type: Reference
+    :contains_multiple: false
+    :multiple_or: MAY
+  :status:
+    :paths:
+    - status
+    :full_paths:
+    - MedicationDispense.status
+    :comparators: {}
+    :values:
+    - preparation
+    - in-progress
+    - cancelled
+    - on-hold
+    - completed
+    - entered-in-error
+    - stopped
+    - declined
+    - unknown
+    :type: code
+    :contains_multiple: false
+    :multiple_or: SHALL
+  :type:
+    :paths:
+    - type
+    :full_paths:
+    - MedicationDispense.type
+    :comparators: {}
+    :values:
+    - DF
+    - EM
+    - SO
+    - FF
+    - FFC
+    - FFP
+    - FFSS
+    - TF
+    - FS
+    - MS
+    - RF
+    - UD
+    - RFC
+    - RFCS
+    - RFF
+    - RFFS
+    - RFP
+    - RFPS
+    - RFS
+    - TB
+    - TBS
+    - UDE
+    :type: CodeableConcept
+    :contains_multiple: false
+    :multiple_or: SHALL
+:include_params:
+- MedicationDispense:medication
+:revincludes:
+- Provenance:target
+:required_concepts: []
+:must_supports:
+  :extensions: []
+  :slices: []
+  :elements:
+  - :path: status
+  - :path: medication[x]
+    :types:
+    - Reference
+  - :path: subject
+    :types:
+    - Reference
+    :target_profiles:
+    - http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient
+  - :path: context
+    :types:
+    - Reference
+    :target_profiles:
+    - http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter
+  - :path: performer
+  - :path: performer.actor
+    :types:
+    - Reference
+    :target_profiles:
+    - http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner
+    - http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization
+  - :path: authorizingPrescription
+    :types:
+    - Reference
+    :target_profiles:
+    - http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationrequest
+  - :path: type
+  - :path: quantity
+  - :path: whenHandedOver
+  - :path: dosageInstruction
+  - :path: dosageInstruction.text
+  - :path: dosageInstruction.timing
+  - :path: dosageInstruction.doseAndRate
+  - :path: dosageInstruction.doseAndRate.doseQuantity
+    :original_path: dosageInstruction.doseAndRate.dose[x]
+:mandatory_elements:
+- MedicationDispense.status
+- MedicationDispense.medication[x]
+- MedicationDispense.subject
+- MedicationDispense.performer.actor
+- MedicationDispense.substitution.wasSubstituted
+:bindings:
+- :type: code
+  :strength: required
+  :system: http://hl7.org/fhir/ValueSet/medicationdispense-status
+  :path: status
+:references:
+- :path: MedicationDispense.partOf
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Procedure
+- :path: MedicationDispense.subject
+  :profiles:
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient
+  - http://hl7.org/fhir/StructureDefinition/Group
+- :path: MedicationDispense.context
+  :profiles:
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter
+  - http://hl7.org/fhir/StructureDefinition/EpisodeOfCare
+- :path: MedicationDispense.supportingInformation
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Resource
+- :path: MedicationDispense.performer.actor
+  :profiles:
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-relatedperson
+  - http://hl7.org/fhir/StructureDefinition/Device
+- :path: MedicationDispense.location
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Location
+- :path: MedicationDispense.authorizingPrescription
+  :profiles:
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationrequest
+- :path: MedicationDispense.destination
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Location
+- :path: MedicationDispense.receiver
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Patient
+  - http://hl7.org/fhir/StructureDefinition/Practitioner
+- :path: MedicationDispense.substitution.responsibleParty
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Practitioner
+  - http://hl7.org/fhir/StructureDefinition/PractitionerRole
+- :path: MedicationDispense.detectedIssue
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/DetectedIssue
+- :path: MedicationDispense.eventHistory
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Provenance
+:tests:
+- :id: us_core_v700_ballot_medication_dispense_patient_search_test
+  :file_name: medication_dispense_patient_search_test.rb
+- :id: us_core_v700_ballot_medication_dispense_patient_status_search_test
+  :file_name: medication_dispense_patient_status_search_test.rb
+- :id: us_core_v700_ballot_medication_dispense_patient_status_type_search_test
+  :file_name: medication_dispense_patient_status_type_search_test.rb
+- :id: us_core_v700_ballot_medication_dispense_read_test
+  :file_name: medication_dispense_read_test.rb
+- :id: us_core_v700_ballot_medication_dispense_provenance_revinclude_search_test
+  :file_name: medication_dispense_provenance_revinclude_search_test.rb
+- :id: us_core_v700_ballot_medication_dispense_validation_test
+  :file_name: medication_dispense_validation_test.rb
+- :id: us_core_v700_ballot_medication_dispense_must_support_test
+  :file_name: medication_dispense_must_support_test.rb
+- :id: us_core_v700_ballot_medication_dispense_reference_resolution_test
+  :file_name: medication_dispense_reference_resolution_test.rb
+:id: us_core_v700_ballot_medication_dispense
+:file_name: medication_dispense_group.rb
+:delayed_references:
+- :path: performer.actor
+  :resources:
+  - Practitioner
+  - Organization
+  - PractitionerRole
+  - RelatedPerson

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

@@ -0,0 +1,90 @@
+require_relative 'medication_dispense/medication_dispense_patient_search_test'
+require_relative 'medication_dispense/medication_dispense_patient_status_search_test'
+require_relative 'medication_dispense/medication_dispense_patient_status_type_search_test'
+require_relative 'medication_dispense/medication_dispense_read_test'
+require_relative 'medication_dispense/medication_dispense_provenance_revinclude_search_test'
+require_relative 'medication_dispense/medication_dispense_validation_test'
+require_relative 'medication_dispense/medication_dispense_must_support_test'
+require_relative 'medication_dispense/medication_dispense_reference_resolution_test'
+
+module USCoreTestKit
+  module USCoreV700_BALLOT
+    class MedicationDispenseGroup < Inferno::TestGroup
+      title 'MedicationDispense Tests'
+      short_description 'Verify support for the server capabilities required by the US Core MedicationDispense Profile.'
+      description %(
+  # Background
+
+The US Core MedicationDispense sequence verifies that the system under test is
+able to provide correct responses for MedicationDispense queries. These queries
+must contain resources conforming to the US Core MedicationDispense 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:
+
+* patient
+
+### 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
+MedicationDispense 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 MedicationDispense 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 MedicationDispense Profile](http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationdispense). 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_medication_dispense
+      run_as_group
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'medication_dispense', 'metadata.yml'), aliases: true))
+      end
+  
+      test from: :us_core_v700_ballot_medication_dispense_patient_search_test
+      test from: :us_core_v700_ballot_medication_dispense_patient_status_search_test
+      test from: :us_core_v700_ballot_medication_dispense_patient_status_type_search_test
+      test from: :us_core_v700_ballot_medication_dispense_read_test
+      test from: :us_core_v700_ballot_medication_dispense_provenance_revinclude_search_test
+      test from: :us_core_v700_ballot_medication_dispense_validation_test
+      test from: :us_core_v700_ballot_medication_dispense_must_support_test
+      test from: :us_core_v700_ballot_medication_dispense_reference_resolution_test
+    end
+  end
+end

data/lib/us_core_test_kit/generated/v7.0.0-ballot/medication_request/medication_request_must_support_test.rb

@@ -0,0 +1,59 @@
+require_relative '../../../must_support_test'
+
+module USCoreTestKit
+  module USCoreV700_BALLOT
+    class MedicationRequestMustSupportTest < Inferno::Test
+      include USCoreTestKit::MustSupportTest
+
+      title 'All must support elements are provided in the MedicationRequest 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 MedicationRequest resources
+        found previously for the following must support elements:
+
+        * MedicationRequest.authoredOn
+        * MedicationRequest.category
+        * MedicationRequest.category:us-core
+        * MedicationRequest.dispenseRequest
+        * MedicationRequest.dispenseRequest.numberOfRepeatsAllowed
+        * MedicationRequest.dispenseRequest.quantity
+        * MedicationRequest.dosageInstruction
+        * MedicationRequest.dosageInstruction.doseAndRate
+        * MedicationRequest.dosageInstruction.doseAndRate.doseQuantity
+        * MedicationRequest.dosageInstruction.text
+        * MedicationRequest.dosageInstruction.timing
+        * MedicationRequest.encounter
+        * MedicationRequest.intent
+        * MedicationRequest.medication[x]
+        * MedicationRequest.reportedBoolean or MedicationRequest.reportedReference
+        * MedicationRequest.requester
+        * MedicationRequest.status
+        * MedicationRequest.subject
+
+        For ONC USCDI requirements, each MedicationRequest must support the following additional elements:
+
+        * MedicationRequest.extension:medicationAdherence
+        * MedicationRequest.reasonCode or MedicationRequest.reasonReference
+      )
+
+      id :us_core_v700_ballot_medication_request_must_support_test
+
+      def resource_type
+        'MedicationRequest'
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:medication_request_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/medication_request/medication_request_patient_intent_authoredon_search_test.rb

@@ -0,0 +1,55 @@
+require_relative '../../../search_test'
+require_relative '../../../generator/group_metadata'
+
+module USCoreTestKit
+  module USCoreV700_BALLOT
+    class MedicationRequestPatientIntentAuthoredonSearchTest < Inferno::Test
+      include USCoreTestKit::SearchTest
+
+      title 'Server returns valid results for MedicationRequest search by patient + intent + authoredon'
+      description %(
+A server SHOULD support searching by
+patient + intent + authoredon on the MedicationRequest resource. This test
+will pass if resources are returned and match the search criteria. If
+none are returned, the test is skipped.
+
+If any MedicationRequest resources use external references to
+Medications, the search will be repeated with
+`_include=MedicationRequest:medication`.
+
+[US Core Server CapabilityStatement](http://hl7.org/fhir/us/core//CapabilityStatement-us-core-server.html)
+
+      )
+
+      id :us_core_v700_ballot_medication_request_patient_intent_authoredon_search_test
+      optional
+  
+      input :patient_ids,
+        title: 'Patient IDs',
+        description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+  
+      def self.properties
+        @properties ||= SearchTestProperties.new(
+          resource_type: 'MedicationRequest',
+        search_param_names: ['patient', 'intent', 'authoredon'],
+        possible_status_search: true,
+        test_medication_inclusion: true,
+        params_with_comparators: ['authoredon'],
+        multiple_or_search_params: ['intent']
+        )
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:medication_request_resources] ||= {}
+      end
+
+      run do
+        run_search_test
+      end
+    end
+  end
+end

data/lib/us_core_test_kit/generated/v7.0.0-ballot/medication_request/medication_request_patient_intent_encounter_search_test.rb

@@ -0,0 +1,54 @@
+require_relative '../../../search_test'
+require_relative '../../../generator/group_metadata'
+
+module USCoreTestKit
+  module USCoreV700_BALLOT
+    class MedicationRequestPatientIntentEncounterSearchTest < Inferno::Test
+      include USCoreTestKit::SearchTest
+
+      title 'Server returns valid results for MedicationRequest search by patient + intent + encounter'
+      description %(
+A server SHOULD support searching by
+patient + intent + encounter on the MedicationRequest resource. This test
+will pass if resources are returned and match the search criteria. If
+none are returned, the test is skipped.
+
+If any MedicationRequest resources use external references to
+Medications, the search will be repeated with
+`_include=MedicationRequest:medication`.
+
+[US Core Server CapabilityStatement](http://hl7.org/fhir/us/core//CapabilityStatement-us-core-server.html)
+
+      )
+
+      id :us_core_v700_ballot_medication_request_patient_intent_encounter_search_test
+      optional
+  
+      input :patient_ids,
+        title: 'Patient IDs',
+        description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+  
+      def self.properties
+        @properties ||= SearchTestProperties.new(
+          resource_type: 'MedicationRequest',
+        search_param_names: ['patient', 'intent', 'encounter'],
+        possible_status_search: true,
+        test_medication_inclusion: true,
+        multiple_or_search_params: ['intent']
+        )
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:medication_request_resources] ||= {}
+      end
+
+      run do
+        run_search_test
+      end
+    end
+  end
+end

data/lib/us_core_test_kit/generated/v7.0.0-ballot/medication_request/medication_request_patient_intent_search_test.rb

@@ -0,0 +1,70 @@
+require_relative '../../../search_test'
+require_relative '../../../generator/group_metadata'
+
+module USCoreTestKit
+  module USCoreV700_BALLOT
+    class MedicationRequestPatientIntentSearchTest < Inferno::Test
+      include USCoreTestKit::SearchTest
+
+      title 'Server returns valid results for MedicationRequest search by patient + intent'
+      description %(
+A server SHALL support searching by
+patient + intent on the MedicationRequest resource. This test
+will pass if resources are returned and match the search criteria. If
+none are returned, the test is skipped.
+
+If any MedicationRequest resources use external references to
+Medications, the search will be repeated with
+`_include=MedicationRequest:medication`.
+
+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 v7.0.0-ballot.
+
+[US Core Server CapabilityStatement](http://hl7.org/fhir/us/core//CapabilityStatement-us-core-server.html)
+
+      )
+
+      id :us_core_v700_ballot_medication_request_patient_intent_search_test
+      input :patient_ids,
+        title: 'Patient IDs',
+        description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+  
+      def self.properties
+        @properties ||= SearchTestProperties.new(
+          first_search: true,
+        fixed_value_search: true,
+        resource_type: 'MedicationRequest',
+        search_param_names: ['patient', 'intent'],
+        saves_delayed_references: true,
+        possible_status_search: true,
+        test_medication_inclusion: true,
+        test_reference_variants: true,
+        multiple_or_search_params: ['intent'],
+        test_post_search: true
+        )
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:medication_request_resources] ||= {}
+      end
+
+      run do
+        run_search_test
+      end
+    end
+  end
+end