us_core_test_kit 0.2.0 → 0.2.3

data/lib/us_core_test_kit/generated/v4.0.0/condition/condition_patient_onset_date_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for Condition search by patient + onset-date'
       description %(
-  A server SHOULD support searching by
+A server SHOULD support searching by
 patient + onset-date on the Condition resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/condition/condition_patient_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for Condition search by patient'
       description %(
-  A server SHALL support searching by
+A server SHALL support searching by
 patient on the Condition resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/condition/condition_reference_resolution_test.rb

@@ -9,11 +9,11 @@ module USCoreTestKit
 
       title 'MustSupport references within Condition resources can be read'
       description %(
-        This test will attempt to read MustSupport references found in the
-        resources from the first search. This test will look through the Condition resources
-        found previously for the following must support elements:
+        This test will attempt to read external references provided within elements
+        marked as 'MustSupport', if any are available.  Elements which may provide
+        external references include:
 
-  
+        * Condition.subject
       )
 
       id :us_core_v400_condition_reference_resolution_test

data/lib/us_core_test_kit/generated/v4.0.0/condition/condition_validation_test.rb

@@ -8,8 +8,9 @@ module USCoreTestKit
       id :us_core_v400_condition_validation_test
       title 'Condition resources returned during previous tests conform to the US Core Condition Profile'
       description %(
-  This test verifies resources returned from the first search conform to
+This test verifies resources returned from the first search conform to
 the [US Core Condition Profile](http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition).
+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
@@ -29,7 +30,9 @@ fail if their code/system are not found in the valueset.
       end
 
       run do
-        perform_validation_test(scratch_resources[:all] || [], 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition')
+        perform_validation_test(scratch_resources[:all] || [],
+                                'http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition',
+                                skip_if_empty: true)
       end
     end
   end

data/lib/us_core_test_kit/generated/v4.0.0/condition_group.rb

@@ -65,9 +65,10 @@ ValueSet. If the code/system in the element is not part of the ValueSet,
 then the test will fail.
 
 ## Reference Validation
-Each reference within the resources found from the previous tests must
-resolve. The test will attempt to read each reference found and will
-fail if any attempted read fails.
+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.
 
       )
 

data/lib/us_core_test_kit/generated/v4.0.0/device/device_must_support_test.rb

@@ -13,15 +13,15 @@ module USCoreTestKit
         found previously for the following must support elements:
 
         * Device.distinctIdentifier
-      * Device.expirationDate
-      * Device.lotNumber
-      * Device.manufactureDate
-      * Device.patient
-      * Device.serialNumber
-      * Device.type
-      * Device.udiCarrier
-      * Device.udiCarrier.carrierHRF
-      * Device.udiCarrier.deviceIdentifier
+        * Device.expirationDate
+        * Device.lotNumber
+        * Device.manufactureDate
+        * Device.patient
+        * Device.serialNumber
+        * Device.type
+        * Device.udiCarrier
+        * Device.udiCarrier.carrierHRF
+        * Device.udiCarrier.deviceIdentifier
       )
 
       id :us_core_v400_device_must_support_test

data/lib/us_core_test_kit/generated/v4.0.0/device/device_patient_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for Device search by patient'
       description %(
-  A server SHALL support searching by
+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.

data/lib/us_core_test_kit/generated/v4.0.0/device/device_patient_type_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for Device search by patient + type'
       description %(
-  A server SHOULD support searching by
+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.

data/lib/us_core_test_kit/generated/v4.0.0/device/device_reference_resolution_test.rb

@@ -9,11 +9,11 @@ module USCoreTestKit
 
       title 'MustSupport references within Device resources can be read'
       description %(
-        This test will attempt to read MustSupport references found in the
-        resources from the first search. This test will look through the Device resources
-        found previously for the following must support elements:
+        This test will attempt to read external references provided within elements
+        marked as 'MustSupport', if any are available.  Elements which may provide
+        external references include:
 
-  
+        * Device.patient
       )
 
       id :us_core_v400_device_reference_resolution_test

data/lib/us_core_test_kit/generated/v4.0.0/device/device_validation_test.rb

@@ -8,8 +8,9 @@ module USCoreTestKit
       id :us_core_v400_device_validation_test
       title 'Device resources returned during previous tests conform to the US Core Implantable Device Profile'
       description %(
-  This test verifies resources returned from the first search conform to
+This test verifies resources returned from the first search conform to
 the [US Core Implantable Device Profile](http://hl7.org/fhir/us/core/StructureDefinition/us-core-implantable-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
@@ -29,7 +30,9 @@ fail if their code/system are not found in the valueset.
       end
 
       run do
-        perform_validation_test(scratch_resources[:all] || [], 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-implantable-device')
+        perform_validation_test(scratch_resources[:all] || [],
+                                'http://hl7.org/fhir/us/core/StructureDefinition/us-core-implantable-device',
+                                skip_if_empty: true)
       end
     end
   end

data/lib/us_core_test_kit/generated/v4.0.0/device_group.rb

@@ -63,9 +63,10 @@ ValueSet. If the code/system in the element is not part of the ValueSet,
 then the test will fail.
 
 ## Reference Validation
-Each reference within the resources found from the previous tests must
-resolve. The test will attempt to read each reference found and will
-fail if any attempted read fails.
+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.
 
       )
 

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_lab/diagnostic_report_lab_must_support_test.rb

@@ -13,14 +13,14 @@ module USCoreTestKit
         found previously for the following must support elements:
 
         * DiagnosticReport.category
-      * DiagnosticReport.category:LaboratorySlice
-      * DiagnosticReport.code
-      * DiagnosticReport.effectiveDateTime
-      * DiagnosticReport.issued
-      * DiagnosticReport.performer
-      * DiagnosticReport.result
-      * DiagnosticReport.status
-      * DiagnosticReport.subject
+        * DiagnosticReport.category:LaboratorySlice
+        * DiagnosticReport.code
+        * DiagnosticReport.effectiveDateTime
+        * DiagnosticReport.issued
+        * DiagnosticReport.performer
+        * DiagnosticReport.result
+        * DiagnosticReport.status
+        * DiagnosticReport.subject
       )
 
       id :us_core_v400_diagnostic_report_lab_must_support_test

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_lab/diagnostic_report_lab_patient_category_date_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DiagnosticReport search by patient + category + date'
       description %(
-  A server SHALL support searching by
+A server SHALL support searching by
 patient + category + date on the DiagnosticReport resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_lab/diagnostic_report_lab_patient_category_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DiagnosticReport search by patient + category'
       description %(
-  A server SHALL support searching by
+A server SHALL support searching by
 patient + category on the DiagnosticReport resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_lab/diagnostic_report_lab_patient_code_date_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DiagnosticReport search by patient + code + date'
       description %(
-  A server SHOULD support searching by
+A server SHOULD support searching by
 patient + code + date on the DiagnosticReport resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_lab/diagnostic_report_lab_patient_code_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DiagnosticReport search by patient + code'
       description %(
-  A server SHALL support searching by
+A server SHALL support searching by
 patient + code on the DiagnosticReport resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_lab/diagnostic_report_lab_patient_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DiagnosticReport search by patient'
       description %(
-  A server SHALL support searching by
+A server SHALL support searching by
 patient on the DiagnosticReport resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_lab/diagnostic_report_lab_patient_status_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DiagnosticReport search by patient + status'
       description %(
-  A server SHOULD support searching by
+A server SHOULD support searching by
 patient + status on the DiagnosticReport resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_lab/diagnostic_report_lab_reference_resolution_test.rb

@@ -9,11 +9,13 @@ module USCoreTestKit
 
       title 'MustSupport references within DiagnosticReport resources can be read'
       description %(
-        This test will attempt to read MustSupport references found in the
-        resources from the first search. This test will look through the DiagnosticReport resources
-        found previously for the following must support elements:
+        This test will attempt to read external references provided within elements
+        marked as 'MustSupport', if any are available.  Elements which may provide
+        external references include:
 
-  
+        * DiagnosticReport.performer
+        * DiagnosticReport.result
+        * DiagnosticReport.subject
       )
 
       id :us_core_v400_diagnostic_report_lab_reference_resolution_test

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_lab/diagnostic_report_lab_validation_test.rb

@@ -8,8 +8,9 @@ module USCoreTestKit
       id :us_core_v400_diagnostic_report_lab_validation_test
       title 'DiagnosticReport resources returned during previous tests conform to the US Core DiagnosticReport Profile for Laboratory Results Reporting'
       description %(
-  This test verifies resources returned from the first search conform to
+This test verifies resources returned from the first search conform to
 the [US Core DiagnosticReport Profile for Laboratory Results Reporting](http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-lab).
+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
@@ -29,7 +30,9 @@ fail if their code/system are not found in the valueset.
       end
 
       run do
-        perform_validation_test(scratch_resources[:all] || [], 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-lab')
+        perform_validation_test(scratch_resources[:all] || [],
+                                'http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-lab',
+                                skip_if_empty: true)
       end
     end
   end

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_lab_group.rb

@@ -69,9 +69,10 @@ ValueSet. If the code/system in the element is not part of the ValueSet,
 then the test will fail.
 
 ## Reference Validation
-Each reference within the resources found from the previous tests must
-resolve. The test will attempt to read each reference found and will
-fail if any attempted read fails.
+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.
 
       )
 

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_note/diagnostic_report_note_must_support_test.rb

@@ -13,14 +13,14 @@ module USCoreTestKit
         found previously for the following must support elements:
 
         * DiagnosticReport.category
-      * DiagnosticReport.code
-      * DiagnosticReport.effectiveDateTime
-      * DiagnosticReport.encounter
-      * DiagnosticReport.issued
-      * DiagnosticReport.performer
-      * DiagnosticReport.presentedForm
-      * DiagnosticReport.status
-      * DiagnosticReport.subject
+        * DiagnosticReport.code
+        * DiagnosticReport.effectiveDateTime
+        * DiagnosticReport.encounter
+        * DiagnosticReport.issued
+        * DiagnosticReport.performer
+        * DiagnosticReport.presentedForm
+        * DiagnosticReport.status
+        * DiagnosticReport.subject
       )
 
       id :us_core_v400_diagnostic_report_note_must_support_test

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_note/diagnostic_report_note_patient_category_date_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DiagnosticReport search by patient + category + date'
       description %(
-  A server SHALL support searching by
+A server SHALL support searching by
 patient + category + date on the DiagnosticReport resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_note/diagnostic_report_note_patient_category_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DiagnosticReport search by patient + category'
       description %(
-  A server SHALL support searching by
+A server SHALL support searching by
 patient + category on the DiagnosticReport resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_note/diagnostic_report_note_patient_code_date_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DiagnosticReport search by patient + code + date'
       description %(
-  A server SHOULD support searching by
+A server SHOULD support searching by
 patient + code + date on the DiagnosticReport resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_note/diagnostic_report_note_patient_code_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DiagnosticReport search by patient + code'
       description %(
-  A server SHALL support searching by
+A server SHALL support searching by
 patient + code on the DiagnosticReport resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_note/diagnostic_report_note_patient_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DiagnosticReport search by patient'
       description %(
-  A server SHALL support searching by
+A server SHALL support searching by
 patient on the DiagnosticReport resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_note/diagnostic_report_note_patient_status_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DiagnosticReport search by patient + status'
       description %(
-  A server SHOULD support searching by
+A server SHOULD support searching by
 patient + status on the DiagnosticReport resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_note/diagnostic_report_note_reference_resolution_test.rb

@@ -9,11 +9,13 @@ module USCoreTestKit
 
       title 'MustSupport references within DiagnosticReport resources can be read'
       description %(
-        This test will attempt to read MustSupport references found in the
-        resources from the first search. This test will look through the DiagnosticReport resources
-        found previously for the following must support elements:
+        This test will attempt to read external references provided within elements
+        marked as 'MustSupport', if any are available.  Elements which may provide
+        external references include:
 
-  
+        * DiagnosticReport.encounter
+        * DiagnosticReport.performer
+        * DiagnosticReport.subject
       )
 
       id :us_core_v400_diagnostic_report_note_reference_resolution_test

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_note/diagnostic_report_note_validation_test.rb

@@ -8,8 +8,9 @@ module USCoreTestKit
       id :us_core_v400_diagnostic_report_note_validation_test
       title 'DiagnosticReport resources returned during previous tests conform to the US Core DiagnosticReport Profile for Report and Note exchange'
       description %(
-  This test verifies resources returned from the first search conform to
+This test verifies resources returned from the first search conform to
 the [US Core DiagnosticReport Profile for Report and Note exchange](http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note).
+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
@@ -29,7 +30,9 @@ fail if their code/system are not found in the valueset.
       end
 
       run do
-        perform_validation_test(scratch_resources[:all] || [], 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note')
+        perform_validation_test(scratch_resources[:all] || [],
+                                'http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note',
+                                skip_if_empty: true)
       end
     end
   end

data/lib/us_core_test_kit/generated/v4.0.0/diagnostic_report_note_group.rb

@@ -69,9 +69,10 @@ ValueSet. If the code/system in the element is not part of the ValueSet,
 then the test will fail.
 
 ## Reference Validation
-Each reference within the resources found from the previous tests must
-resolve. The test will attempt to read each reference found and will
-fail if any attempted read fails.
+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.
 
       )
 

data/lib/us_core_test_kit/generated/v4.0.0/document_reference/document_reference_id_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DocumentReference search by _id'
       description %(
-  A server SHALL support searching by
+A server SHALL support searching by
 _id on the DocumentReference resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/document_reference/document_reference_must_support_test.rb

@@ -13,21 +13,20 @@ module USCoreTestKit
         found previously for the following must support elements:
 
         * DocumentReference.author
-      * DocumentReference.category
-      * DocumentReference.content
-      * DocumentReference.content.attachment
-      * DocumentReference.content.attachment.contentType
-      * DocumentReference.content.attachment.data
-      * DocumentReference.content.attachment.url
-      * DocumentReference.content.format
-      * DocumentReference.context
-      * DocumentReference.context.encounter
-      * DocumentReference.context.period
-      * DocumentReference.date
-      * DocumentReference.identifier
-      * DocumentReference.status
-      * DocumentReference.subject
-      * DocumentReference.type
+        * DocumentReference.category
+        * DocumentReference.content
+        * DocumentReference.content.attachment
+        * DocumentReference.content.attachment.contentType
+        * DocumentReference.content.attachment.data or DocumentReference.content.attachment.url
+        * DocumentReference.content.format
+        * DocumentReference.context
+        * DocumentReference.context.encounter
+        * DocumentReference.context.period
+        * DocumentReference.date
+        * DocumentReference.identifier
+        * DocumentReference.status
+        * DocumentReference.subject
+        * DocumentReference.type
       )
 
       id :us_core_v400_document_reference_must_support_test

data/lib/us_core_test_kit/generated/v4.0.0/document_reference/document_reference_patient_category_date_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DocumentReference search by patient + category + date'
       description %(
-  A server SHALL support searching by
+A server SHALL support searching by
 patient + category + date on the DocumentReference resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/document_reference/document_reference_patient_category_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DocumentReference search by patient + category'
       description %(
-  A server SHALL support searching by
+A server SHALL support searching by
 patient + category on the DocumentReference resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/document_reference/document_reference_patient_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DocumentReference search by patient'
       description %(
-  A server SHALL support searching by
+A server SHALL support searching by
 patient on the DocumentReference resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/document_reference/document_reference_patient_status_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DocumentReference search by patient + status'
       description %(
-  A server SHOULD support searching by
+A server SHOULD support searching by
 patient + status on the DocumentReference resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/document_reference/document_reference_patient_type_period_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DocumentReference search by patient + type + period'
       description %(
-  A server SHOULD support searching by
+A server SHOULD support searching by
 patient + type + period on the DocumentReference resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/document_reference/document_reference_patient_type_search_test.rb

@@ -8,7 +8,7 @@ module USCoreTestKit
 
       title 'Server returns valid results for DocumentReference search by patient + type'
       description %(
-  A server SHALL support searching by
+A server SHALL support searching by
 patient + type on the DocumentReference resource. This test
 will pass if resources are returned and match the search criteria. If
 none are returned, the test is skipped.

data/lib/us_core_test_kit/generated/v4.0.0/document_reference/document_reference_reference_resolution_test.rb

@@ -9,11 +9,13 @@ module USCoreTestKit
 
       title 'MustSupport references within DocumentReference resources can be read'
       description %(
-        This test will attempt to read MustSupport references found in the
-        resources from the first search. This test will look through the DocumentReference resources
-        found previously for the following must support elements:
+        This test will attempt to read external references provided within elements
+        marked as 'MustSupport', if any are available.  Elements which may provide
+        external references include:
 
-  
+        * DocumentReference.author
+        * DocumentReference.context.encounter
+        * DocumentReference.subject
       )
 
       id :us_core_v400_document_reference_reference_resolution_test

data/lib/us_core_test_kit/generated/v4.0.0/document_reference/document_reference_validation_test.rb

@@ -8,8 +8,9 @@ module USCoreTestKit
       id :us_core_v400_document_reference_validation_test
       title 'DocumentReference resources returned during previous tests conform to the US Core DocumentReference Profile'
       description %(
-  This test verifies resources returned from the first search conform to
+This test verifies resources returned from the first search conform to
 the [US Core DocumentReference Profile](http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference).
+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
@@ -29,7 +30,9 @@ fail if their code/system are not found in the valueset.
       end
 
       run do
-        perform_validation_test(scratch_resources[:all] || [], 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference')
+        perform_validation_test(scratch_resources[:all] || [],
+                                'http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference',
+                                skip_if_empty: true)
       end
     end
   end