This page is part of the FHIR Specification (v3.5.0: R4 Ballot #2). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2
FHIR Infrastructure Work Group | Maturity Level: 2 | Trial Use | Compartments: Not linked to any defined compartments |
A structured set of tests against a FHIR server or client implementation to determine compliance against the FHIR specification.
The TestScript resource is used to define tests that can be executed on one or more FHIR servers. The TestScript resource would typically contain
For example, one TestScript might feature a set of tests focusing on searching Patients and validating the Bundle responses. The fixtures for such a test would contain a list of Patient resources that are required for the test to complete successfully. The setup procedures create the fixtures on the FHIR server being tested. A series of tests execute various search parameters and search for the fixtures in the results. The teardown procedures would then clean up (delete) the fixtures on FHIR server that were created during the setup procedures.
The purpose of the TestScript is to encode in an executable representation tests that can be used to
The TestScript resource should NOT be used to represent Clinical tests, Prescriptions, or any other Healthcare related concept. The TestScript resource is an infrastructure support resource used to represent standardized tests to determine an implementation's level of adherence to the FHIR specification.
TestScript is a part of the conformance framework and is used to validate the behavior of FHIR systems, specifically their correct implementation of StructureDefinition, ValueSet, OperationDefinition, CapabilityStatement and other FHIR resources that govern system behavior. TestScript instances may be included as part of ImplementationGuides to help define and test the desired behavior of systems that choose to comply with the implementation guide.
The following resources represent the FHIR conformance framework that are used to express the expected behavior of a FHIR compliant system:
The TestScript resource is designed to establish testing as a first class artifact within the FHIR specification. This resource allows defining a suite of tests that can be executed on one or more FHIR servers and clients.
Implementers should be familiar with the testing concepts and descriptions found in Testing FHIR before working with this resource.
This resource is referenced by TestReport
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
TestScript | ITU | DomainResource | Describes a set of tests + Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension | |
url | Σ | 1..1 | uri | Canonical identifier for this test script, represented as a URI (globally unique) |
identifier | Σ | 0..1 | Identifier | Additional identifier for the test script |
version | Σ | 0..1 | string | Business version of the test script |
name | ΣI | 1..1 | string | Name for this test script (computer friendly) |
title | Σ | 0..1 | string | Name for this test script (human friendly) |
status | ?!Σ | 1..1 | code | draft | active | retired | unknown PublicationStatus (Required) |
experimental | Σ | 0..1 | boolean | For testing purposes, not real usage |
date | Σ | 0..1 | dateTime | Date last changed |
publisher | Σ | 0..1 | string | Name of the publisher (organization or individual) |
contact | Σ | 0..* | ContactDetail | Contact details for the publisher |
description | 0..1 | markdown | Natural language description of the test script | |
useContext | Σ | 0..* | UsageContext | The context that the content is intended to support |
jurisdiction | Σ | 0..* | CodeableConcept | Intended jurisdiction for test script (if applicable) Jurisdiction (Extensible) |
purpose | 0..1 | markdown | Why this test script is defined | |
copyright | 0..1 | markdown | Use and/or publishing restrictions | |
origin | 0..* | BackboneElement | An abstract server representing a client or sender in a message exchange | |
index | 1..1 | integer | The index of the abstract origin server starting at 1 | |
profile | 1..1 | Coding | FHIR-Client | FHIR-SDC-FormFiller Test script profile origin type (Extensible) | |
destination | 0..* | BackboneElement | An abstract server representing a destination or receiver in a message exchange | |
index | 1..1 | integer | The index of the abstract destination server starting at 1 | |
profile | 1..1 | Coding | FHIR-Server | FHIR-SDC-FormManager | FHIR-SDC-FormReceiver | FHIR-SDC-FormProcessor Test script profile destination type (Extensible) | |
metadata | I | 0..1 | BackboneElement | Required capability that is assumed to function correctly on the FHIR server being tested + Rule: TestScript metadata capability SHALL contain required or validated or both. |
link | 0..* | BackboneElement | Links to the FHIR specification | |
url | 1..1 | uri | URL to the specification | |
description | 0..1 | string | Short description | |
capability | 1..* | BackboneElement | Capabilities that are assumed to function correctly on the FHIR server being tested | |
required | 1..1 | boolean | Are the capabilities required? | |
validated | 1..1 | boolean | Are the capabilities validated? | |
description | 0..1 | string | The expected capabilities of the server | |
origin | 0..* | integer | Which origin server these requirements apply to | |
destination | 0..1 | integer | Which server these requirements apply to | |
link | 0..* | uri | Links to the FHIR specification | |
capabilities | 1..1 | canonical(CapabilityStatement) | Required Capability Statement | |
fixture | 0..* | BackboneElement | Fixture in the test script - by reference (uri) | |
autocreate | 1..1 | boolean | Whether or not to implicitly create the fixture during setup | |
autodelete | 1..1 | boolean | Whether or not to implicitly delete the fixture during teardown | |
resource | 0..1 | Reference(Any) | Reference of the resource | |
profile | 0..* | Reference(Any) | Reference of the validation profile | |
variable | I | 0..* | BackboneElement | Placeholder for evaluated elements + Rule: Variable can only contain one of expression, headerField or path. |
name | 1..1 | string | Descriptive name for this variable | |
defaultValue | 0..1 | string | Default, hard-coded, or user-defined value for this variable | |
description | 0..1 | string | Natural language description of the variable | |
expression | 0..1 | string | The FHIRPath expression against the fixture body | |
headerField | 0..1 | string | HTTP header field name for source | |
hint | 0..1 | string | Hint help text for default value to enter | |
path | 0..1 | string | XPath or JSONPath against the fixture body | |
sourceId | 0..1 | id | Fixture Id of source expression or headerField within this variable | |
rule | 0..* | BackboneElement | Assert rule used within the test script | |
resource | 1..1 | Reference(Any) | Assert rule resource reference | |
param | 0..* | BackboneElement | Rule parameter template | |
name | 1..1 | string | Parameter name matching external assert rule parameter | |
value | 0..1 | string | Parameter value defined either explicitly or dynamically | |
ruleset | 0..* | BackboneElement | Assert ruleset used within the test script | |
resource | 1..1 | Reference(Any) | Assert ruleset resource reference | |
rule | 1..* | BackboneElement | The referenced rule within the ruleset | |
ruleId | 1..1 | id | Id of referenced rule within the ruleset | |
param | 0..* | BackboneElement | Ruleset rule parameter template | |
name | 1..1 | string | Parameter name matching external assert ruleset rule parameter | |
value | 0..1 | string | Parameter value defined either explicitly or dynamically | |
setup | 0..1 | BackboneElement | A series of required setup operations before tests are executed | |
action | I | 1..* | BackboneElement | A setup operation or assert to perform + Rule: Setup action SHALL contain either an operation or assert but not both. |
operation | I | 0..1 | BackboneElement | The setup operation to perform + Rule: Setup operation SHALL contain either sourceId or targetId or params or url. |
type | 0..1 | Coding | The operation code type that will be executed Test script operation code (Extensible) | |
resource | 0..1 | code | Resource type FHIRDefinedType (Required) | |
label | 0..1 | string | Tracking/logging operation label | |
description | 0..1 | string | Tracking/reporting operation description | |
accept | 0..1 | code | Mime type to accept in the payload of the response, with charset etc. MimeType (Required) | |
contentType | 0..1 | code | Mime type of the request payload contents, with charset etc. MimeType (Required) | |
destination | 0..1 | integer | Server responding to the request | |
encodeRequestUrl | 1..1 | boolean | Whether or not to send the request url in encoded format | |
origin | 0..1 | integer | Server initiating the request | |
params | 0..1 | string | Explicitly defined path parameters | |
requestHeader | 0..* | BackboneElement | Each operation can have one or more header elements | |
field | 1..1 | string | HTTP header field name | |
value | 1..1 | string | HTTP headerfield value | |
requestId | 0..1 | id | Fixture Id of mapped request | |
responseId | 0..1 | id | Fixture Id of mapped response | |
sourceId | 0..1 | id | Fixture Id of body for PUT and POST requests | |
targetId | 0..1 | id | Id of fixture used for extracting the [id], [type], and [vid] for GET requests | |
url | 0..1 | string | Request URL | |
assert | I | 0..1 | BackboneElement | The assertion to perform + Rule: Only a single assertion SHALL be present within setup action assert element. + Rule: Setup action assert SHALL contain either compareToSourceId and compareToSourceExpression, compareToSourceId and compareToSourcePath or neither. + Rule: Setup action assert response and responseCode SHALL be empty when direction equals request |
label | 0..1 | string | Tracking/logging assertion label | |
description | 0..1 | string | Tracking/reporting assertion description | |
direction | 0..1 | code | response | request AssertionDirectionType (Required) | |
compareToSourceId | 0..1 | string | Id of the source fixture to be evaluated | |
compareToSourceExpression | 0..1 | string | The FHIRPath expression to evaluate against the source fixture | |
compareToSourcePath | 0..1 | string | XPath or JSONPath expression to evaluate against the source fixture | |
contentType | 0..1 | code | Mime type to compare against the 'Content-Type' header MimeType (Required) | |
expression | 0..1 | string | The FHIRPath expression to be evaluated | |
headerField | 0..1 | string | HTTP header field name | |
minimumId | 0..1 | string | Fixture Id of minimum content resource | |
navigationLinks | 0..1 | boolean | Perform validation on navigation links? | |
operator | 0..1 | code | equals | notEquals | in | notIn | greaterThan | lessThan | empty | notEmpty | contains | notContains | eval AssertionOperatorType (Required) | |
path | 0..1 | string | XPath or JSONPath expression | |
requestMethod | 0..1 | code | delete | get | options | patch | post | put TestScriptRequestMethodCode (Required) | |
requestURL | 0..1 | string | Request URL comparison value | |
resource | 0..1 | code | Resource type FHIRDefinedType (Required) | |
response | 0..1 | code | okay | created | noContent | notModified | bad | forbidden | notFound | methodNotAllowed | conflict | gone | preconditionFailed | unprocessable AssertionResponseTypes (Required) | |
responseCode | 0..1 | string | HTTP response code to test | |
rule | 0..1 | BackboneElement | The reference to a TestScript.rule | |
ruleId | 1..1 | id | Id of the TestScript.rule | |
param | 0..* | BackboneElement | Rule parameter template | |
name | 1..1 | string | Parameter name matching external assert rule parameter | |
value | 1..1 | string | Parameter value defined either explicitly or dynamically | |
ruleset | 0..1 | BackboneElement | The reference to a TestScript.ruleset | |
rulesetId | 1..1 | id | Id of the TestScript.ruleset | |
rule | 0..* | BackboneElement | The referenced rule within the ruleset | |
ruleId | 1..1 | id | Id of referenced rule within the ruleset | |
param | 0..* | BackboneElement | Rule parameter template | |
name | 1..1 | string | Parameter name matching external assert ruleset rule parameter | |
value | 1..1 | string | Parameter value defined either explicitly or dynamically | |
sourceId | 0..1 | id | Fixture Id of source expression or headerField | |
validateProfileId | 0..1 | id | Profile Id of validation profile reference | |
value | 0..1 | string | The value to compare to | |
warningOnly | 1..1 | boolean | Will this assert produce a warning only on error? | |
test | 0..* | BackboneElement | A test in this script | |
name | 0..1 | string | Tracking/logging name of this test | |
description | 0..1 | string | Tracking/reporting short description of the test | |
action | I | 1..* | BackboneElement | A test operation or assert to perform + Rule: Test action SHALL contain either an operation or assert but not both. |
operation | I | 0..1 | see operation | The setup operation to perform + Rule: Test operation SHALL contain either sourceId or targetId or params or url. |
assert | I | 0..1 | see assert | The setup assertion to perform + Rule: Only a single assertion SHALL be present within test action assert element. + Rule: Test action assert SHALL contain either compareToSourceId and compareToSourceExpression, compareToSourceId and compareToSourcePath or neither. + Rule: Test action assert response and response and responseCode SHALL be empty when direction equals request |
teardown | 0..1 | BackboneElement | A series of required clean up steps | |
action | 1..* | BackboneElement | One or more teardown operations to perform | |
operation | I | 1..1 | see operation | The teardown operation to perform + Rule: Teardown operation SHALL contain either sourceId or targetId or params or url. |
Documentation for this format |
UML Diagram (Legend)
XML Template
<TestScript xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <url value="[uri]"/><!-- 1..1 Canonical identifier for this test script, represented as a URI (globally unique) --> <identifier><!-- 0..1 Identifier Additional identifier for the test script --></identifier> <version value="[string]"/><!-- 0..1 Business version of the test script --> <name value="[string]"/><!-- 1..1 Name for this test script (computer friendly) --> <title value="[string]"/><!-- 0..1 Name for this test script (human friendly) --> <status value="[code]"/><!-- 1..1 draft | active | retired | unknown --> <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage --> <date value="[dateTime]"/><!-- 0..1 Date last changed --> <publisher value="[string]"/><!-- 0..1 Name of the publisher (organization or individual) --> <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact> <description value="[markdown]"/><!-- 0..1 Natural language description of the test script --> <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext> <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for test script (if applicable) --></jurisdiction> <purpose value="[markdown]"/><!-- 0..1 Why this test script is defined --> <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions --> <origin> <!-- 0..* An abstract server representing a client or sender in a message exchange --> <index value="[integer]"/><!-- 1..1 The index of the abstract origin server starting at 1 --> <profile><!-- 1..1 Coding FHIR-Client | FHIR-SDC-FormFiller --></profile> </origin> <destination> <!-- 0..* An abstract server representing a destination or receiver in a message exchange --> <index value="[integer]"/><!-- 1..1 The index of the abstract destination server starting at 1 --> <profile><!-- 1..1 Coding FHIR-Server | FHIR-SDC-FormManager | FHIR-SDC-FormReceiver | FHIR-SDC-FormProcessor --></profile> </destination> <metadata> <!-- 0..1 Required capability that is assumed to function correctly on the FHIR server being tested --> <link> <!-- 0..* Links to the FHIR specification --> <url value="[uri]"/><!-- 1..1 URL to the specification --> <description value="[string]"/><!-- 0..1 Short description --> </link> <capability> <!-- 1..* Capabilities that are assumed to function correctly on the FHIR server being tested --> <required value="[boolean]"/><!-- 1..1 Are the capabilities required? --> <validated value="[boolean]"/><!-- 1..1 Are the capabilities validated? --> <description value="[string]"/><!-- 0..1 The expected capabilities of the server --> <origin value="[integer]"/><!-- 0..* Which origin server these requirements apply to --> <destination value="[integer]"/><!-- 0..1 Which server these requirements apply to --> <link value="[uri]"/><!-- 0..* Links to the FHIR specification --> <capabilities><!-- 1..1 canonical(CapabilityStatement) Required Capability Statement --></capabilities> </capability> </metadata> <fixture> <!-- 0..* Fixture in the test script - by reference (uri) --> <autocreate value="[boolean]"/><!-- 1..1 Whether or not to implicitly create the fixture during setup --> <autodelete value="[boolean]"/><!-- 1..1 Whether or not to implicitly delete the fixture during teardown --> <resource><!-- 0..1 Reference(Any) Reference of the resource --></resource> </fixture> <profile><!-- 0..* Reference(Any) Reference of the validation profile --></profile> <variable> <!-- 0..* Placeholder for evaluated elements --> <name value="[string]"/><!-- 1..1 Descriptive name for this variable --> <defaultValue value="[string]"/><!-- 0..1 Default, hard-coded, or user-defined value for this variable --> <description value="[string]"/><!-- 0..1 Natural language description of the variable --> <expression value="[string]"/><!-- 0..1 The FHIRPath expression against the fixture body --> <headerField value="[string]"/><!-- 0..1 HTTP header field name for source --> <hint value="[string]"/><!-- 0..1 Hint help text for default value to enter --> <path value="[string]"/><!-- 0..1 XPath or JSONPath against the fixture body --> <sourceId value="[id]"/><!-- 0..1 Fixture Id of source expression or headerField within this variable --> </variable> <rule> <!-- 0..* Assert rule used within the test script --> <resource><!-- 1..1 Reference(Any) Assert rule resource reference --></resource> <param> <!-- 0..* Rule parameter template --> <name value="[string]"/><!-- 1..1 Parameter name matching external assert rule parameter --> <value value="[string]"/><!-- 0..1 Parameter value defined either explicitly or dynamically --> </param> </rule> <ruleset> <!-- 0..* Assert ruleset used within the test script --> <resource><!-- 1..1 Reference(Any) Assert ruleset resource reference --></resource> <rule> <!-- 1..* The referenced rule within the ruleset --> <ruleId value="[id]"/><!-- 1..1 Id of referenced rule within the ruleset --> <param> <!-- 0..* Ruleset rule parameter template --> <name value="[string]"/><!-- 1..1 Parameter name matching external assert ruleset rule parameter --> <value value="[string]"/><!-- 0..1 Parameter value defined either explicitly or dynamically --> </param> </rule> </ruleset> <setup> <!-- 0..1 A series of required setup operations before tests are executed --> <action> <!-- 1..* A setup operation or assert to perform --> <operation> <!-- 0..1 The setup operation to perform --> <type><!-- 0..1 Coding The operation code type that will be executed --></type> <resource value="[code]"/><!-- 0..1 Resource type --> <label value="[string]"/><!-- 0..1 Tracking/logging operation label --> <description value="[string]"/><!-- 0..1 Tracking/reporting operation description --> <accept value="[code]"/><!-- 0..1 Mime type to accept in the payload of the response, with charset etc. --> <contentType value="[code]"/><!-- 0..1 Mime type of the request payload contents, with charset etc. --> <destination value="[integer]"/><!-- 0..1 Server responding to the request --> <encodeRequestUrl value="[boolean]"/><!-- 1..1 Whether or not to send the request url in encoded format --> <origin value="[integer]"/><!-- 0..1 Server initiating the request --> <params value="[string]"/><!-- 0..1 Explicitly defined path parameters --> <requestHeader> <!-- 0..* Each operation can have one or more header elements --> <field value="[string]"/><!-- 1..1 HTTP header field name --> <value value="[string]"/><!-- 1..1 HTTP headerfield value --> </requestHeader> <requestId value="[id]"/><!-- 0..1 Fixture Id of mapped request --> <responseId value="[id]"/><!-- 0..1 Fixture Id of mapped response --> <sourceId value="[id]"/><!-- 0..1 Fixture Id of body for PUT and POST requests --> <targetId value="[id]"/><!-- 0..1 Id of fixture used for extracting the [id], [type], and [vid] for GET requests --> <url value="[string]"/><!-- 0..1 Request URL --> </operation> <assert> <!-- 0..1 The assertion to perform --> <label value="[string]"/><!-- 0..1 Tracking/logging assertion label --> <description value="[string]"/><!-- 0..1 Tracking/reporting assertion description --> <direction value="[code]"/><!-- 0..1 response | request --> <compareToSourceId value="[string]"/><!-- 0..1 Id of the source fixture to be evaluated --> <compareToSourceExpression value="[string]"/><!-- 0..1 The FHIRPath expression to evaluate against the source fixture --> <compareToSourcePath value="[string]"/><!-- 0..1 XPath or JSONPath expression to evaluate against the source fixture --> <contentType value="[code]"/><!-- 0..1 Mime type to compare against the 'Content-Type' header --> <expression value="[string]"/><!-- 0..1 The FHIRPath expression to be evaluated --> <headerField value="[string]"/><!-- 0..1 HTTP header field name --> <minimumId value="[string]"/><!-- 0..1 Fixture Id of minimum content resource --> <navigationLinks value="[boolean]"/><!-- 0..1 Perform validation on navigation links? --> <operator value="[code]"/><!-- 0..1 equals | notEquals | in | notIn | greaterThan | lessThan | empty | notEmpty | contains | notContains | eval --> <path value="[string]"/><!-- 0..1 XPath or JSONPath expression --> <requestMethod value="[code]"/><!-- 0..1 delete | get | options | patch | post | put --> <requestURL value="[string]"/><!-- 0..1 Request URL comparison value --> <resource value="[code]"/><!-- 0..1 Resource type --> <response value="[code]"/><!-- 0..1 okay | created | noContent | notModified | bad | forbidden | notFound | methodNotAllowed | conflict | gone | preconditionFailed | unprocessable --> <responseCode value="[string]"/><!-- 0..1 HTTP response code to test --> <rule> <!-- 0..1 The reference to a TestScript.rule --> <ruleId value="[id]"/><!-- 1..1 Id of the TestScript.rule --> <param> <!-- 0..* Rule parameter template --> <name value="[string]"/><!-- 1..1 Parameter name matching external assert rule parameter --> <value value="[string]"/><!-- 1..1 Parameter value defined either explicitly or dynamically --> </param> </rule> <ruleset> <!-- 0..1 The reference to a TestScript.ruleset --> <rulesetId value="[id]"/><!-- 1..1 Id of the TestScript.ruleset --> <rule> <!-- 0..* The referenced rule within the ruleset --> <ruleId value="[id]"/><!-- 1..1 Id of referenced rule within the ruleset --> <param> <!-- 0..* Rule parameter template --> <name value="[string]"/><!-- 1..1 Parameter name matching external assert ruleset rule parameter --> <value value="[string]"/><!-- 1..1 Parameter value defined either explicitly or dynamically --> </param> </rule> </ruleset> <sourceId value="[id]"/><!-- 0..1 Fixture Id of source expression or headerField --> <validateProfileId value="[id]"/><!-- 0..1 Profile Id of validation profile reference --> <value value="[string]"/><!-- 0..1 The value to compare to --> <warningOnly value="[boolean]"/><!-- 1..1 Will this assert produce a warning only on error? --> </assert> </action> </setup> <test> <!-- 0..* A test in this script --> <name value="[string]"/><!-- 0..1 Tracking/logging name of this test --> <description value="[string]"/><!-- 0..1 Tracking/reporting short description of the test --> <action> <!-- 1..* A test operation or assert to perform --> <operation><!-- 0..1 Content as for TestScript.setup.action.operation The setup operation to perform --></operation> <assert><!-- 0..1 Content as for TestScript.setup.action.assert The setup assertion to perform --></assert> </action> </test> <teardown> <!-- 0..1 A series of required clean up steps --> <action> <!-- 1..* One or more teardown operations to perform --> <operation><!-- 1..1 Content as for TestScript.setup.action.operation The teardown operation to perform --></operation> </action> </teardown> </TestScript>
JSON Template
{ "resourceType" : "TestScript", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "url" : "<uri>", // R! Canonical identifier for this test script, represented as a URI (globally unique) "identifier" : { Identifier }, // Additional identifier for the test script "version" : "<string>", // Business version of the test script "name" : "<string>", // C? R! Name for this test script (computer friendly) "title" : "<string>", // Name for this test script (human friendly) "status" : "<code>", // R! draft | active | retired | unknown "experimental" : <boolean>, // For testing purposes, not real usage "date" : "<dateTime>", // Date last changed "publisher" : "<string>", // Name of the publisher (organization or individual) "contact" : [{ ContactDetail }], // Contact details for the publisher "description" : "<markdown>", // Natural language description of the test script "useContext" : [{ UsageContext }], // The context that the content is intended to support "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for test script (if applicable) "purpose" : "<markdown>", // Why this test script is defined "copyright" : "<markdown>", // Use and/or publishing restrictions "origin" : [{ // An abstract server representing a client or sender in a message exchange "index" : <integer>, // R! The index of the abstract origin server starting at 1 "profile" : { Coding } // R! FHIR-Client | FHIR-SDC-FormFiller }], "destination" : [{ // An abstract server representing a destination or receiver in a message exchange "index" : <integer>, // R! The index of the abstract destination server starting at 1 "profile" : { Coding } // R! FHIR-Server | FHIR-SDC-FormManager | FHIR-SDC-FormReceiver | FHIR-SDC-FormProcessor }], "metadata" : { // Required capability that is assumed to function correctly on the FHIR server being tested "link" : [{ // Links to the FHIR specification "url" : "<uri>", // R! URL to the specification "description" : "<string>" // Short description }], "capability" : [{ // R! Capabilities that are assumed to function correctly on the FHIR server being tested "required" : <boolean>, // R! Are the capabilities required? "validated" : <boolean>, // R! Are the capabilities validated? "description" : "<string>", // The expected capabilities of the server "origin" : [<integer>], // Which origin server these requirements apply to "destination" : <integer>, // Which server these requirements apply to "link" : ["<uri>"], // Links to the FHIR specification "capabilities" : { canonical(CapabilityStatement) } // R! Required Capability Statement }] }, "fixture" : [{ // Fixture in the test script - by reference (uri) "autocreate" : <boolean>, // R! Whether or not to implicitly create the fixture during setup "autodelete" : <boolean>, // R! Whether or not to implicitly delete the fixture during teardown "resource" : { Reference(Any) } // Reference of the resource }], "profile" : [{ Reference(Any) }], // Reference of the validation profile "variable" : [{ // Placeholder for evaluated elements "name" : "<string>", // R! Descriptive name for this variable "defaultValue" : "<string>", // Default, hard-coded, or user-defined value for this variable "description" : "<string>", // Natural language description of the variable "expression" : "<string>", // The FHIRPath expression against the fixture body "headerField" : "<string>", // HTTP header field name for source "hint" : "<string>", // Hint help text for default value to enter "path" : "<string>", // XPath or JSONPath against the fixture body "sourceId" : "<id>" // Fixture Id of source expression or headerField within this variable }], "rule" : [{ // Assert rule used within the test script "resource" : { Reference(Any) }, // R! Assert rule resource reference "param" : [{ // Rule parameter template "name" : "<string>", // R! Parameter name matching external assert rule parameter "value" : "<string>" // Parameter value defined either explicitly or dynamically }] }], "ruleset" : [{ // Assert ruleset used within the test script "resource" : { Reference(Any) }, // R! Assert ruleset resource reference "rule" : [{ // R! The referenced rule within the ruleset "ruleId" : "<id>", // R! Id of referenced rule within the ruleset "param" : [{ // Ruleset rule parameter template "name" : "<string>", // R! Parameter name matching external assert ruleset rule parameter "value" : "<string>" // Parameter value defined either explicitly or dynamically }] }] }], "setup" : { // A series of required setup operations before tests are executed "action" : [{ // R! A setup operation or assert to perform "operation" : { // The setup operation to perform "type" : { Coding }, // The operation code type that will be executed "resource" : "<code>", // Resource type "label" : "<string>", // Tracking/logging operation label "description" : "<string>", // Tracking/reporting operation description "accept" : "<code>", // Mime type to accept in the payload of the response, with charset etc. "contentType" : "<code>", // Mime type of the request payload contents, with charset etc. "destination" : <integer>, // Server responding to the request "encodeRequestUrl" : <boolean>, // R! Whether or not to send the request url in encoded format "origin" : <integer>, // Server initiating the request "params" : "<string>", // Explicitly defined path parameters "requestHeader" : [{ // Each operation can have one or more header elements "field" : "<string>", // R! HTTP header field name "value" : "<string>" // R! HTTP headerfield value }], "requestId" : "<id>", // Fixture Id of mapped request "responseId" : "<id>", // Fixture Id of mapped response "sourceId" : "<id>", // Fixture Id of body for PUT and POST requests "targetId" : "<id>", // Id of fixture used for extracting the [id], [type], and [vid] for GET requests "url" : "<string>" // Request URL }, "assert" : { // The assertion to perform "label" : "<string>", // Tracking/logging assertion label "description" : "<string>", // Tracking/reporting assertion description "direction" : "<code>", // response | request "compareToSourceId" : "<string>", // Id of the source fixture to be evaluated "compareToSourceExpression" : "<string>", // The FHIRPath expression to evaluate against the source fixture "compareToSourcePath" : "<string>", // XPath or JSONPath expression to evaluate against the source fixture "contentType" : "<code>", // Mime type to compare against the 'Content-Type' header "expression" : "<string>", // The FHIRPath expression to be evaluated "headerField" : "<string>", // HTTP header field name "minimumId" : "<string>", // Fixture Id of minimum content resource "navigationLinks" : <boolean>, // Perform validation on navigation links? "operator" : "<code>", // equals | notEquals | in | notIn | greaterThan | lessThan | empty | notEmpty | contains | notContains | eval "path" : "<string>", // XPath or JSONPath expression "requestMethod" : "<code>", // delete | get | options | patch | post | put "requestURL" : "<string>", // Request URL comparison value "resource" : "<code>", // Resource type "response" : "<code>", // okay | created | noContent | notModified | bad | forbidden | notFound | methodNotAllowed | conflict | gone | preconditionFailed | unprocessable "responseCode" : "<string>", // HTTP response code to test "rule" : { // The reference to a TestScript.rule "ruleId" : "<id>", // R! Id of the TestScript.rule "param" : [{ // Rule parameter template "name" : "<string>", // R! Parameter name matching external assert rule parameter "value" : "<string>" // R! Parameter value defined either explicitly or dynamically }] }, "ruleset" : { // The reference to a TestScript.ruleset "rulesetId" : "<id>", // R! Id of the TestScript.ruleset "rule" : [{ // The referenced rule within the ruleset "ruleId" : "<id>", // R! Id of referenced rule within the ruleset "param" : [{ // Rule parameter template "name" : "<string>", // R! Parameter name matching external assert ruleset rule parameter "value" : "<string>" // R! Parameter value defined either explicitly or dynamically }] }] }, "sourceId" : "<id>", // Fixture Id of source expression or headerField "validateProfileId" : "<id>", // Profile Id of validation profile reference "value" : "<string>", // The value to compare to "warningOnly" : <boolean> // R! Will this assert produce a warning only on error? } }] }, "test" : [{ // A test in this script "name" : "<string>", // Tracking/logging name of this test "description" : "<string>", // Tracking/reporting short description of the test "action" : [{ // R! A test operation or assert to perform "operation" : { Content as for TestScript.setup.action.operation }, // The setup operation to perform "assert" : { Content as for TestScript.setup.action.assert } // The setup assertion to perform }] }], "teardown" : { // A series of required clean up steps "action" : [{ // R! One or more teardown operations to perform "operation" : { Content as for TestScript.setup.action.operation } // R! The teardown operation to perform }] } }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:TestScript; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:TestScript.url [ uri ]; # 1..1 Canonical identifier for this test script, represented as a URI (globally unique) fhir:TestScript.identifier [ Identifier ]; # 0..1 Additional identifier for the test script fhir:TestScript.version [ string ]; # 0..1 Business version of the test script fhir:TestScript.name [ string ]; # 1..1 Name for this test script (computer friendly) fhir:TestScript.title [ string ]; # 0..1 Name for this test script (human friendly) fhir:TestScript.status [ code ]; # 1..1 draft | active | retired | unknown fhir:TestScript.experimental [ boolean ]; # 0..1 For testing purposes, not real usage fhir:TestScript.date [ dateTime ]; # 0..1 Date last changed fhir:TestScript.publisher [ string ]; # 0..1 Name of the publisher (organization or individual) fhir:TestScript.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher fhir:TestScript.description [ markdown ]; # 0..1 Natural language description of the test script fhir:TestScript.useContext [ UsageContext ], ... ; # 0..* The context that the content is intended to support fhir:TestScript.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for test script (if applicable) fhir:TestScript.purpose [ markdown ]; # 0..1 Why this test script is defined fhir:TestScript.copyright [ markdown ]; # 0..1 Use and/or publishing restrictions fhir:TestScript.origin [ # 0..* An abstract server representing a client or sender in a message exchange fhir:TestScript.origin.index [ integer ]; # 1..1 The index of the abstract origin server starting at 1 fhir:TestScript.origin.profile [ Coding ]; # 1..1 FHIR-Client | FHIR-SDC-FormFiller ], ...; fhir:TestScript.destination [ # 0..* An abstract server representing a destination or receiver in a message exchange fhir:TestScript.destination.index [ integer ]; # 1..1 The index of the abstract destination server starting at 1 fhir:TestScript.destination.profile [ Coding ]; # 1..1 FHIR-Server | FHIR-SDC-FormManager | FHIR-SDC-FormReceiver | FHIR-SDC-FormProcessor ], ...; fhir:TestScript.metadata [ # 0..1 Required capability that is assumed to function correctly on the FHIR server being tested fhir:TestScript.metadata.link [ # 0..* Links to the FHIR specification fhir:TestScript.metadata.link.url [ uri ]; # 1..1 URL to the specification fhir:TestScript.metadata.link.description [ string ]; # 0..1 Short description ], ...; fhir:TestScript.metadata.capability [ # 1..* Capabilities that are assumed to function correctly on the FHIR server being tested fhir:TestScript.metadata.capability.required [ boolean ]; # 1..1 Are the capabilities required? fhir:TestScript.metadata.capability.validated [ boolean ]; # 1..1 Are the capabilities validated? fhir:TestScript.metadata.capability.description [ string ]; # 0..1 The expected capabilities of the server fhir:TestScript.metadata.capability.origin [ integer ], ... ; # 0..* Which origin server these requirements apply to fhir:TestScript.metadata.capability.destination [ integer ]; # 0..1 Which server these requirements apply to fhir:TestScript.metadata.capability.link [ uri ], ... ; # 0..* Links to the FHIR specification fhir:TestScript.metadata.capability.capabilities [ canonical(CapabilityStatement) ]; # 1..1 Required Capability Statement ], ...; ]; fhir:TestScript.fixture [ # 0..* Fixture in the test script - by reference (uri) fhir:TestScript.fixture.autocreate [ boolean ]; # 1..1 Whether or not to implicitly create the fixture during setup fhir:TestScript.fixture.autodelete [ boolean ]; # 1..1 Whether or not to implicitly delete the fixture during teardown fhir:TestScript.fixture.resource [ Reference(Any) ]; # 0..1 Reference of the resource ], ...; fhir:TestScript.profile [ Reference(Any) ], ... ; # 0..* Reference of the validation profile fhir:TestScript.variable [ # 0..* Placeholder for evaluated elements fhir:TestScript.variable.name [ string ]; # 1..1 Descriptive name for this variable fhir:TestScript.variable.defaultValue [ string ]; # 0..1 Default, hard-coded, or user-defined value for this variable fhir:TestScript.variable.description [ string ]; # 0..1 Natural language description of the variable fhir:TestScript.variable.expression [ string ]; # 0..1 The FHIRPath expression against the fixture body fhir:TestScript.variable.headerField [ string ]; # 0..1 HTTP header field name for source fhir:TestScript.variable.hint [ string ]; # 0..1 Hint help text for default value to enter fhir:TestScript.variable.path [ string ]; # 0..1 XPath or JSONPath against the fixture body fhir:TestScript.variable.sourceId [ id ]; # 0..1 Fixture Id of source expression or headerField within this variable ], ...; fhir:TestScript.rule [ # 0..* Assert rule used within the test script fhir:TestScript.rule.resource [ Reference(Any) ]; # 1..1 Assert rule resource reference fhir:TestScript.rule.param [ # 0..* Rule parameter template fhir:TestScript.rule.param.name [ string ]; # 1..1 Parameter name matching external assert rule parameter fhir:TestScript.rule.param.value [ string ]; # 0..1 Parameter value defined either explicitly or dynamically ], ...; ], ...; fhir:TestScript.ruleset [ # 0..* Assert ruleset used within the test script fhir:TestScript.ruleset.resource [ Reference(Any) ]; # 1..1 Assert ruleset resource reference fhir:TestScript.ruleset.rule [ # 1..* The referenced rule within the ruleset fhir:TestScript.ruleset.rule.ruleId [ id ]; # 1..1 Id of referenced rule within the ruleset fhir:TestScript.ruleset.rule.param [ # 0..* Ruleset rule parameter template fhir:TestScript.ruleset.rule.param.name [ string ]; # 1..1 Parameter name matching external assert ruleset rule parameter fhir:TestScript.ruleset.rule.param.value [ string ]; # 0..1 Parameter value defined either explicitly or dynamically ], ...; ], ...; ], ...; fhir:TestScript.setup [ # 0..1 A series of required setup operations before tests are executed fhir:TestScript.setup.action [ # 1..* A setup operation or assert to perform fhir:TestScript.setup.action.operation [ # 0..1 The setup operation to perform fhir:TestScript.setup.action.operation.type [ Coding ]; # 0..1 The operation code type that will be executed fhir:TestScript.setup.action.operation.resource [ code ]; # 0..1 Resource type fhir:TestScript.setup.action.operation.label [ string ]; # 0..1 Tracking/logging operation label fhir:TestScript.setup.action.operation.description [ string ]; # 0..1 Tracking/reporting operation description fhir:TestScript.setup.action.operation.accept [ code ]; # 0..1 Mime type to accept in the payload of the response, with charset etc. fhir:TestScript.setup.action.operation.contentType [ code ]; # 0..1 Mime type of the request payload contents, with charset etc. fhir:TestScript.setup.action.operation.destination [ integer ]; # 0..1 Server responding to the request fhir:TestScript.setup.action.operation.encodeRequestUrl [ boolean ]; # 1..1 Whether or not to send the request url in encoded format fhir:TestScript.setup.action.operation.origin [ integer ]; # 0..1 Server initiating the request fhir:TestScript.setup.action.operation.params [ string ]; # 0..1 Explicitly defined path parameters fhir:TestScript.setup.action.operation.requestHeader [ # 0..* Each operation can have one or more header elements fhir:TestScript.setup.action.operation.requestHeader.field [ string ]; # 1..1 HTTP header field name fhir:TestScript.setup.action.operation.requestHeader.value [ string ]; # 1..1 HTTP headerfield value ], ...; fhir:TestScript.setup.action.operation.requestId [ id ]; # 0..1 Fixture Id of mapped request fhir:TestScript.setup.action.operation.responseId [ id ]; # 0..1 Fixture Id of mapped response fhir:TestScript.setup.action.operation.sourceId [ id ]; # 0..1 Fixture Id of body for PUT and POST requests fhir:TestScript.setup.action.operation.targetId [ id ]; # 0..1 Id of fixture used for extracting the [id], [type], and [vid] for GET requests fhir:TestScript.setup.action.operation.url [ string ]; # 0..1 Request URL ]; fhir:TestScript.setup.action.assert [ # 0..1 The assertion to perform fhir:TestScript.setup.action.assert.label [ string ]; # 0..1 Tracking/logging assertion label fhir:TestScript.setup.action.assert.description [ string ]; # 0..1 Tracking/reporting assertion description fhir:TestScript.setup.action.assert.direction [ code ]; # 0..1 response | request fhir:TestScript.setup.action.assert.compareToSourceId [ string ]; # 0..1 Id of the source fixture to be evaluated fhir:TestScript.setup.action.assert.compareToSourceExpression [ string ]; # 0..1 The FHIRPath expression to evaluate against the source fixture fhir:TestScript.setup.action.assert.compareToSourcePath [ string ]; # 0..1 XPath or JSONPath expression to evaluate against the source fixture fhir:TestScript.setup.action.assert.contentType [ code ]; # 0..1 Mime type to compare against the 'Content-Type' header fhir:TestScript.setup.action.assert.expression [ string ]; # 0..1 The FHIRPath expression to be evaluated fhir:TestScript.setup.action.assert.headerField [ string ]; # 0..1 HTTP header field name fhir:TestScript.setup.action.assert.minimumId [ string ]; # 0..1 Fixture Id of minimum content resource fhir:TestScript.setup.action.assert.navigationLinks [ boolean ]; # 0..1 Perform validation on navigation links? fhir:TestScript.setup.action.assert.operator [ code ]; # 0..1 equals | notEquals | in | notIn | greaterThan | lessThan | empty | notEmpty | contains | notContains | eval fhir:TestScript.setup.action.assert.path [ string ]; # 0..1 XPath or JSONPath expression fhir:TestScript.setup.action.assert.requestMethod [ code ]; # 0..1 delete | get | options | patch | post | put fhir:TestScript.setup.action.assert.requestURL [ string ]; # 0..1 Request URL comparison value fhir:TestScript.setup.action.assert.resource [ code ]; # 0..1 Resource type fhir:TestScript.setup.action.assert.response [ code ]; # 0..1 okay | created | noContent | notModified | bad | forbidden | notFound | methodNotAllowed | conflict | gone | preconditionFailed | unprocessable fhir:TestScript.setup.action.assert.responseCode [ string ]; # 0..1 HTTP response code to test fhir:TestScript.setup.action.assert.rule [ # 0..1 The reference to a TestScript.rule fhir:TestScript.setup.action.assert.rule.ruleId [ id ]; # 1..1 Id of the TestScript.rule fhir:TestScript.setup.action.assert.rule.param [ # 0..* Rule parameter template fhir:TestScript.setup.action.assert.rule.param.name [ string ]; # 1..1 Parameter name matching external assert rule parameter fhir:TestScript.setup.action.assert.rule.param.value [ string ]; # 1..1 Parameter value defined either explicitly or dynamically ], ...; ]; fhir:TestScript.setup.action.assert.ruleset [ # 0..1 The reference to a TestScript.ruleset fhir:TestScript.setup.action.assert.ruleset.rulesetId [ id ]; # 1..1 Id of the TestScript.ruleset fhir:TestScript.setup.action.assert.ruleset.rule [ # 0..* The referenced rule within the ruleset fhir:TestScript.setup.action.assert.ruleset.rule.ruleId [ id ]; # 1..1 Id of referenced rule within the ruleset fhir:TestScript.setup.action.assert.ruleset.rule.param [ # 0..* Rule parameter template fhir:TestScript.setup.action.assert.ruleset.rule.param.name [ string ]; # 1..1 Parameter name matching external assert ruleset rule parameter fhir:TestScript.setup.action.assert.ruleset.rule.param.value [ string ]; # 1..1 Parameter value defined either explicitly or dynamically ], ...; ], ...; ]; fhir:TestScript.setup.action.assert.sourceId [ id ]; # 0..1 Fixture Id of source expression or headerField fhir:TestScript.setup.action.assert.validateProfileId [ id ]; # 0..1 Profile Id of validation profile reference fhir:TestScript.setup.action.assert.value [ string ]; # 0..1 The value to compare to fhir:TestScript.setup.action.assert.warningOnly [ boolean ]; # 1..1 Will this assert produce a warning only on error? ]; ], ...; ]; fhir:TestScript.test [ # 0..* A test in this script fhir:TestScript.test.name [ string ]; # 0..1 Tracking/logging name of this test fhir:TestScript.test.description [ string ]; # 0..1 Tracking/reporting short description of the test fhir:TestScript.test.action [ # 1..* A test operation or assert to perform fhir:TestScript.test.action.operation [ See TestScript.setup.action.operation ]; # 0..1 The setup operation to perform fhir:TestScript.test.action.assert [ See TestScript.setup.action.assert ]; # 0..1 The setup assertion to perform ], ...; ], ...; fhir:TestScript.teardown [ # 0..1 A series of required clean up steps fhir:TestScript.teardown.action [ # 1..* One or more teardown operations to perform fhir:TestScript.teardown.action.operation [ See TestScript.setup.action.operation ]; # 1..1 The teardown operation to perform ], ...; ]; ]
Changes since R3
TestScript | |
TestScript.experimental |
|
TestScript.metadata.capability.required |
|
TestScript.metadata.capability.validated |
|
TestScript.metadata.capability.capabilities |
|
TestScript.fixture.autocreate |
|
TestScript.fixture.autodelete |
|
TestScript.setup.action.operation.accept |
|
TestScript.setup.action.operation.contentType |
|
TestScript.setup.action.operation.encodeRequestUrl |
|
TestScript.setup.action.assert.contentType |
|
TestScript.setup.action.assert.warningOnly |
|
See the Full Difference for further information
This analysis is available as XML or JSON.
See R3 <--> R4 Conversion Maps (status = 7 tests that all execute ok. 7 fail round-trip testing and 7 r3 resources are invalid (0 errors).)
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
TestScript | ITU | DomainResource | Describes a set of tests + Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension | |
url | Σ | 1..1 | uri | Canonical identifier for this test script, represented as a URI (globally unique) |
identifier | Σ | 0..1 | Identifier | Additional identifier for the test script |
version | Σ | 0..1 | string | Business version of the test script |
name | ΣI | 1..1 | string | Name for this test script (computer friendly) |
title | Σ | 0..1 | string | Name for this test script (human friendly) |
status | ?!Σ | 1..1 | code | draft | active | retired | unknown PublicationStatus (Required) |
experimental | Σ | 0..1 | boolean | For testing purposes, not real usage |
date | Σ | 0..1 | dateTime | Date last changed |
publisher | Σ | 0..1 | string | Name of the publisher (organization or individual) |
contact | Σ | 0..* | ContactDetail | Contact details for the publisher |
description | 0..1 | markdown | Natural language description of the test script | |
useContext | Σ | 0..* | UsageContext | The context that the content is intended to support |
jurisdiction | Σ | 0..* | CodeableConcept | Intended jurisdiction for test script (if applicable) Jurisdiction (Extensible) |
purpose | 0..1 | markdown | Why this test script is defined | |
copyright | 0..1 | markdown | Use and/or publishing restrictions | |
origin | 0..* | BackboneElement | An abstract server representing a client or sender in a message exchange | |
index | 1..1 | integer | The index of the abstract origin server starting at 1 | |
profile | 1..1 | Coding | FHIR-Client | FHIR-SDC-FormFiller Test script profile origin type (Extensible) | |
destination | 0..* | BackboneElement | An abstract server representing a destination or receiver in a message exchange | |
index | 1..1 | integer | The index of the abstract destination server starting at 1 | |
profile | 1..1 | Coding | FHIR-Server | FHIR-SDC-FormManager | FHIR-SDC-FormReceiver | FHIR-SDC-FormProcessor Test script profile destination type (Extensible) | |
metadata | I | 0..1 | BackboneElement | Required capability that is assumed to function correctly on the FHIR server being tested + Rule: TestScript metadata capability SHALL contain required or validated or both. |
link | 0..* | BackboneElement | Links to the FHIR specification | |
url | 1..1 | uri | URL to the specification | |
description | 0..1 | string | Short description | |
capability | 1..* | BackboneElement | Capabilities that are assumed to function correctly on the FHIR server being tested | |
required | 1..1 | boolean | Are the capabilities required? | |
validated | 1..1 | boolean | Are the capabilities validated? | |
description | 0..1 | string | The expected capabilities of the server | |
origin | 0..* | integer | Which origin server these requirements apply to | |
destination | 0..1 | integer | Which server these requirements apply to | |
link | 0..* | uri | Links to the FHIR specification | |
capabilities | 1..1 | canonical(CapabilityStatement) | Required Capability Statement | |
fixture | 0..* | BackboneElement | Fixture in the test script - by reference (uri) | |
autocreate | 1..1 | boolean | Whether or not to implicitly create the fixture during setup | |
autodelete | 1..1 | boolean | Whether or not to implicitly delete the fixture during teardown | |
resource | 0..1 | Reference(Any) | Reference of the resource | |
profile | 0..* | Reference(Any) | Reference of the validation profile | |
variable | I | 0..* | BackboneElement | Placeholder for evaluated elements + Rule: Variable can only contain one of expression, headerField or path. |
name | 1..1 | string | Descriptive name for this variable | |
defaultValue | 0..1 | string | Default, hard-coded, or user-defined value for this variable | |
description | 0..1 | string | Natural language description of the variable | |
expression | 0..1 | string | The FHIRPath expression against the fixture body | |
headerField | 0..1 | string | HTTP header field name for source | |
hint | 0..1 | string | Hint help text for default value to enter | |
path | 0..1 | string | XPath or JSONPath against the fixture body | |
sourceId | 0..1 | id | Fixture Id of source expression or headerField within this variable | |
rule | 0..* | BackboneElement | Assert rule used within the test script | |
resource | 1..1 | Reference(Any) | Assert rule resource reference | |
param | 0..* | BackboneElement | Rule parameter template | |
name | 1..1 | string | Parameter name matching external assert rule parameter | |
value | 0..1 | string | Parameter value defined either explicitly or dynamically | |
ruleset | 0..* | BackboneElement | Assert ruleset used within the test script | |
resource | 1..1 | Reference(Any) | Assert ruleset resource reference | |
rule | 1..* | BackboneElement | The referenced rule within the ruleset | |
ruleId | 1..1 | id | Id of referenced rule within the ruleset | |
param | 0..* | BackboneElement | Ruleset rule parameter template | |
name | 1..1 | string | Parameter name matching external assert ruleset rule parameter | |
value | 0..1 | string | Parameter value defined either explicitly or dynamically | |
setup | 0..1 | BackboneElement | A series of required setup operations before tests are executed | |
action | I | 1..* | BackboneElement | A setup operation or assert to perform + Rule: Setup action SHALL contain either an operation or assert but not both. |
operation | I | 0..1 | BackboneElement | The setup operation to perform + Rule: Setup operation SHALL contain either sourceId or targetId or params or url. |
type | 0..1 | Coding | The operation code type that will be executed Test script operation code (Extensible) | |
resource | 0..1 | code | Resource type FHIRDefinedType (Required) | |
label | 0..1 | string | Tracking/logging operation label | |
description | 0..1 | string | Tracking/reporting operation description | |
accept | 0..1 | code | Mime type to accept in the payload of the response, with charset etc. MimeType (Required) | |
contentType | 0..1 | code | Mime type of the request payload contents, with charset etc. MimeType (Required) | |
destination | 0..1 | integer | Server responding to the request | |
encodeRequestUrl | 1..1 | boolean | Whether or not to send the request url in encoded format | |
origin | 0..1 | integer | Server initiating the request | |
params | 0..1 | string | Explicitly defined path parameters | |
requestHeader | 0..* | BackboneElement | Each operation can have one or more header elements | |
field | 1..1 | string | HTTP header field name | |
value | 1..1 | string | HTTP headerfield value | |
requestId | 0..1 | id | Fixture Id of mapped request | |
responseId | 0..1 | id | Fixture Id of mapped response | |
sourceId | 0..1 | id | Fixture Id of body for PUT and POST requests | |
targetId | 0..1 | id | Id of fixture used for extracting the [id], [type], and [vid] for GET requests | |
url | 0..1 | string | Request URL | |
assert | I | 0..1 | BackboneElement | The assertion to perform + Rule: Only a single assertion SHALL be present within setup action assert element. + Rule: Setup action assert SHALL contain either compareToSourceId and compareToSourceExpression, compareToSourceId and compareToSourcePath or neither. + Rule: Setup action assert response and responseCode SHALL be empty when direction equals request |
label | 0..1 | string | Tracking/logging assertion label | |
description | 0..1 | string | Tracking/reporting assertion description | |
direction | 0..1 | code | response | request AssertionDirectionType (Required) | |
compareToSourceId | 0..1 | string | Id of the source fixture to be evaluated | |
compareToSourceExpression | 0..1 | string | The FHIRPath expression to evaluate against the source fixture | |
compareToSourcePath | 0..1 | string | XPath or JSONPath expression to evaluate against the source fixture | |
contentType | 0..1 | code | Mime type to compare against the 'Content-Type' header MimeType (Required) | |
expression | 0..1 | string | The FHIRPath expression to be evaluated | |
headerField | 0..1 | string | HTTP header field name | |
minimumId | 0..1 | string | Fixture Id of minimum content resource | |
navigationLinks | 0..1 | boolean | Perform validation on navigation links? | |
operator | 0..1 | code | equals | notEquals | in | notIn | greaterThan | lessThan | empty | notEmpty | contains | notContains | eval AssertionOperatorType (Required) | |
path | 0..1 | string | XPath or JSONPath expression | |
requestMethod | 0..1 | code | delete | get | options | patch | post | put TestScriptRequestMethodCode (Required) | |
requestURL | 0..1 | string | Request URL comparison value | |
resource | 0..1 | code | Resource type FHIRDefinedType (Required) | |
response | 0..1 | code | okay | created | noContent | notModified | bad | forbidden | notFound | methodNotAllowed | conflict | gone | preconditionFailed | unprocessable AssertionResponseTypes (Required) | |
responseCode | 0..1 | string | HTTP response code to test | |
rule | 0..1 | BackboneElement | The reference to a TestScript.rule | |
ruleId | 1..1 | id | Id of the TestScript.rule | |
param | 0..* | BackboneElement | Rule parameter template | |
name | 1..1 | string | Parameter name matching external assert rule parameter | |
value | 1..1 | string | Parameter value defined either explicitly or dynamically | |
ruleset | 0..1 | BackboneElement | The reference to a TestScript.ruleset | |
rulesetId | 1..1 | id | Id of the TestScript.ruleset | |
rule | 0..* | BackboneElement | The referenced rule within the ruleset | |
ruleId | 1..1 | id | Id of referenced rule within the ruleset | |
param | 0..* | BackboneElement | Rule parameter template | |
name | 1..1 | string | Parameter name matching external assert ruleset rule parameter | |
value | 1..1 | string | Parameter value defined either explicitly or dynamically | |
sourceId | 0..1 | id | Fixture Id of source expression or headerField | |
validateProfileId | 0..1 | id | Profile Id of validation profile reference | |
value | 0..1 | string | The value to compare to | |
warningOnly | 1..1 | boolean | Will this assert produce a warning only on error? | |
test | 0..* | BackboneElement | A test in this script | |
name | 0..1 | string | Tracking/logging name of this test | |
description | 0..1 | string | Tracking/reporting short description of the test | |
action | I | 1..* | BackboneElement | A test operation or assert to perform + Rule: Test action SHALL contain either an operation or assert but not both. |
operation | I | 0..1 | see operation | The setup operation to perform + Rule: Test operation SHALL contain either sourceId or targetId or params or url. |
assert | I | 0..1 | see assert | The setup assertion to perform + Rule: Only a single assertion SHALL be present within test action assert element. + Rule: Test action assert SHALL contain either compareToSourceId and compareToSourceExpression, compareToSourceId and compareToSourcePath or neither. + Rule: Test action assert response and response and responseCode SHALL be empty when direction equals request |
teardown | 0..1 | BackboneElement | A series of required clean up steps | |
action | 1..* | BackboneElement | One or more teardown operations to perform | |
operation | I | 1..1 | see operation | The teardown operation to perform + Rule: Teardown operation SHALL contain either sourceId or targetId or params or url. |
Documentation for this format |
XML Template
<TestScript xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <url value="[uri]"/><!-- 1..1 Canonical identifier for this test script, represented as a URI (globally unique) --> <identifier><!-- 0..1 Identifier Additional identifier for the test script --></identifier> <version value="[string]"/><!-- 0..1 Business version of the test script --> <name value="[string]"/><!-- 1..1 Name for this test script (computer friendly) --> <title value="[string]"/><!-- 0..1 Name for this test script (human friendly) --> <status value="[code]"/><!-- 1..1 draft | active | retired | unknown --> <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage --> <date value="[dateTime]"/><!-- 0..1 Date last changed --> <publisher value="[string]"/><!-- 0..1 Name of the publisher (organization or individual) --> <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact> <description value="[markdown]"/><!-- 0..1 Natural language description of the test script --> <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext> <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for test script (if applicable) --></jurisdiction> <purpose value="[markdown]"/><!-- 0..1 Why this test script is defined --> <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions --> <origin> <!-- 0..* An abstract server representing a client or sender in a message exchange --> <index value="[integer]"/><!-- 1..1 The index of the abstract origin server starting at 1 --> <profile><!-- 1..1 Coding FHIR-Client | FHIR-SDC-FormFiller --></profile> </origin> <destination> <!-- 0..* An abstract server representing a destination or receiver in a message exchange --> <index value="[integer]"/><!-- 1..1 The index of the abstract destination server starting at 1 --> <profile><!-- 1..1 Coding FHIR-Server | FHIR-SDC-FormManager | FHIR-SDC-FormReceiver | FHIR-SDC-FormProcessor --></profile> </destination> <metadata> <!-- 0..1 Required capability that is assumed to function correctly on the FHIR server being tested --> <link> <!-- 0..* Links to the FHIR specification --> <url value="[uri]"/><!-- 1..1 URL to the specification --> <description value="[string]"/><!-- 0..1 Short description --> </link> <capability> <!-- 1..* Capabilities that are assumed to function correctly on the FHIR server being tested --> <required value="[boolean]"/><!-- 1..1 Are the capabilities required? --> <validated value="[boolean]"/><!-- 1..1 Are the capabilities validated? --> <description value="[string]"/><!-- 0..1 The expected capabilities of the server --> <origin value="[integer]"/><!-- 0..* Which origin server these requirements apply to --> <destination value="[integer]"/><!-- 0..1 Which server these requirements apply to --> <link value="[uri]"/><!-- 0..* Links to the FHIR specification --> <capabilities><!-- 1..1 canonical(CapabilityStatement) Required Capability Statement --></capabilities> </capability> </metadata> <fixture> <!-- 0..* Fixture in the test script - by reference (uri) --> <autocreate value="[boolean]"/><!-- 1..1 Whether or not to implicitly create the fixture during setup --> <autodelete value="[boolean]"/><!-- 1..1 Whether or not to implicitly delete the fixture during teardown --> <resource><!-- 0..1 Reference(Any) Reference of the resource --></resource> </fixture> <profile><!-- 0..* Reference(Any) Reference of the validation profile --></profile> <variable> <!-- 0..* Placeholder for evaluated elements --> <name value="[string]"/><!-- 1..1 Descriptive name for this variable --> <defaultValue value="[string]"/><!-- 0..1 Default, hard-coded, or user-defined value for this variable --> <description value="[string]"/><!-- 0..1 Natural language description of the variable --> <expression value="[string]"/><!-- 0..1 The FHIRPath expression against the fixture body --> <headerField value="[string]"/><!-- 0..1 HTTP header field name for source --> <hint value="[string]"/><!-- 0..1 Hint help text for default value to enter --> <path value="[string]"/><!-- 0..1 XPath or JSONPath against the fixture body --> <sourceId value="[id]"/><!-- 0..1 Fixture Id of source expression or headerField within this variable --> </variable> <rule> <!-- 0..* Assert rule used within the test script --> <resource><!-- 1..1 Reference(Any) Assert rule resource reference --></resource> <param> <!-- 0..* Rule parameter template --> <name value="[string]"/><!-- 1..1 Parameter name matching external assert rule parameter --> <value value="[string]"/><!-- 0..1 Parameter value defined either explicitly or dynamically --> </param> </rule> <ruleset> <!-- 0..* Assert ruleset used within the test script --> <resource><!-- 1..1 Reference(Any) Assert ruleset resource reference --></resource> <rule> <!-- 1..* The referenced rule within the ruleset --> <ruleId value="[id]"/><!-- 1..1 Id of referenced rule within the ruleset --> <param> <!-- 0..* Ruleset rule parameter template --> <name value="[string]"/><!-- 1..1 Parameter name matching external assert ruleset rule parameter --> <value value="[string]"/><!-- 0..1 Parameter value defined either explicitly or dynamically --> </param> </rule> </ruleset> <setup> <!-- 0..1 A series of required setup operations before tests are executed --> <action> <!-- 1..* A setup operation or assert to perform --> <operation> <!-- 0..1 The setup operation to perform --> <type><!-- 0..1 Coding The operation code type that will be executed --></type> <resource value="[code]"/><!-- 0..1 Resource type --> <label value="[string]"/><!-- 0..1 Tracking/logging operation label --> <description value="[string]"/><!-- 0..1 Tracking/reporting operation description --> <accept value="[code]"/><!-- 0..1 Mime type to accept in the payload of the response, with charset etc. --> <contentType value="[code]"/><!-- 0..1 Mime type of the request payload contents, with charset etc. --> <destination value="[integer]"/><!-- 0..1 Server responding to the request --> <encodeRequestUrl value="[boolean]"/><!-- 1..1 Whether or not to send the request url in encoded format --> <origin value="[integer]"/><!-- 0..1 Server initiating the request --> <params value="[string]"/><!-- 0..1 Explicitly defined path parameters --> <requestHeader> <!-- 0..* Each operation can have one or more header elements --> <field value="[string]"/><!-- 1..1 HTTP header field name --> <value value="[string]"/><!-- 1..1 HTTP headerfield value --> </requestHeader> <requestId value="[id]"/><!-- 0..1 Fixture Id of mapped request --> <responseId value="[id]"/><!-- 0..1 Fixture Id of mapped response --> <sourceId value="[id]"/><!-- 0..1 Fixture Id of body for PUT and POST requests --> <targetId value="[id]"/><!-- 0..1 Id of fixture used for extracting the [id], [type], and [vid] for GET requests --> <url value="[string]"/><!-- 0..1 Request URL --> </operation> <assert> <!-- 0..1 The assertion to perform --> <label value="[string]"/><!-- 0..1 Tracking/logging assertion label --> <description value="[string]"/><!-- 0..1 Tracking/reporting assertion description --> <direction value="[code]"/><!-- 0..1 response | request --> <compareToSourceId value="[string]"/><!-- 0..1 Id of the source fixture to be evaluated --> <compareToSourceExpression value="[string]"/><!-- 0..1 The FHIRPath expression to evaluate against the source fixture --> <compareToSourcePath value="[string]"/><!-- 0..1 XPath or JSONPath expression to evaluate against the source fixture --> <contentType value="[code]"/><!-- 0..1 Mime type to compare against the 'Content-Type' header --> <expression value="[string]"/><!-- 0..1 The FHIRPath expression to be evaluated --> <headerField value="[string]"/><!-- 0..1 HTTP header field name --> <minimumId value="[string]"/><!-- 0..1 Fixture Id of minimum content resource --> <navigationLinks value="[boolean]"/><!-- 0..1 Perform validation on navigation links? --> <operator value="[code]"/><!-- 0..1 equals | notEquals | in | notIn | greaterThan | lessThan | empty | notEmpty | contains | notContains | eval --> <path value="[string]"/><!-- 0..1 XPath or JSONPath expression --> <requestMethod value="[code]"/><!-- 0..1 delete | get | options | patch | post | put --> <requestURL value="[string]"/><!-- 0..1 Request URL comparison value --> <resource value="[code]"/><!-- 0..1 Resource type --> <response value="[code]"/><!-- 0..1 okay | created | noContent | notModified | bad | forbidden | notFound | methodNotAllowed | conflict | gone | preconditionFailed | unprocessable --> <responseCode value="[string]"/><!-- 0..1 HTTP response code to test --> <rule> <!-- 0..1 The reference to a TestScript.rule --> <ruleId value="[id]"/><!-- 1..1 Id of the TestScript.rule --> <param> <!-- 0..* Rule parameter template --> <name value="[string]"/><!-- 1..1 Parameter name matching external assert rule parameter --> <value value="[string]"/><!-- 1..1 Parameter value defined either explicitly or dynamically --> </param> </rule> <ruleset> <!-- 0..1 The reference to a TestScript.ruleset --> <rulesetId value="[id]"/><!-- 1..1 Id of the TestScript.ruleset --> <rule> <!-- 0..* The referenced rule within the ruleset --> <ruleId value="[id]"/><!-- 1..1 Id of referenced rule within the ruleset --> <param> <!-- 0..* Rule parameter template --> <name value="[string]"/><!-- 1..1 Parameter name matching external assert ruleset rule parameter --> <value value="[string]"/><!-- 1..1 Parameter value defined either explicitly or dynamically --> </param> </rule> </ruleset> <sourceId value="[id]"/><!-- 0..1 Fixture Id of source expression or headerField --> <validateProfileId value="[id]"/><!-- 0..1 Profile Id of validation profile reference --> <value value="[string]"/><!-- 0..1 The value to compare to --> <warningOnly value="[boolean]"/><!-- 1..1 Will this assert produce a warning only on error? --> </assert> </action> </setup> <test> <!-- 0..* A test in this script --> <name value="[string]"/><!-- 0..1 Tracking/logging name of this test --> <description value="[string]"/><!-- 0..1 Tracking/reporting short description of the test --> <action> <!-- 1..* A test operation or assert to perform --> <operation><!-- 0..1 Content as for TestScript.setup.action.operation The setup operation to perform --></operation> <assert><!-- 0..1 Content as for TestScript.setup.action.assert The setup assertion to perform --></assert> </action> </test> <teardown> <!-- 0..1 A series of required clean up steps --> <action> <!-- 1..* One or more teardown operations to perform --> <operation><!-- 1..1 Content as for TestScript.setup.action.operation The teardown operation to perform --></operation> </action> </teardown> </TestScript>
JSON Template
{ "resourceType" : "TestScript", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "url" : "<uri>", // R! Canonical identifier for this test script, represented as a URI (globally unique) "identifier" : { Identifier }, // Additional identifier for the test script "version" : "<string>", // Business version of the test script "name" : "<string>", // C? R! Name for this test script (computer friendly) "title" : "<string>", // Name for this test script (human friendly) "status" : "<code>", // R! draft | active | retired | unknown "experimental" : <boolean>, // For testing purposes, not real usage "date" : "<dateTime>", // Date last changed "publisher" : "<string>", // Name of the publisher (organization or individual) "contact" : [{ ContactDetail }], // Contact details for the publisher "description" : "<markdown>", // Natural language description of the test script "useContext" : [{ UsageContext }], // The context that the content is intended to support "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for test script (if applicable) "purpose" : "<markdown>", // Why this test script is defined "copyright" : "<markdown>", // Use and/or publishing restrictions "origin" : [{ // An abstract server representing a client or sender in a message exchange "index" : <integer>, // R! The index of the abstract origin server starting at 1 "profile" : { Coding } // R! FHIR-Client | FHIR-SDC-FormFiller }], "destination" : [{ // An abstract server representing a destination or receiver in a message exchange "index" : <integer>, // R! The index of the abstract destination server starting at 1 "profile" : { Coding } // R! FHIR-Server | FHIR-SDC-FormManager | FHIR-SDC-FormReceiver | FHIR-SDC-FormProcessor }], "metadata" : { // Required capability that is assumed to function correctly on the FHIR server being tested "link" : [{ // Links to the FHIR specification "url" : "<uri>", // R! URL to the specification "description" : "<string>" // Short description }], "capability" : [{ // R! Capabilities that are assumed to function correctly on the FHIR server being tested "required" : <boolean>, // R! Are the capabilities required? "validated" : <boolean>, // R! Are the capabilities validated? "description" : "<string>", // The expected capabilities of the server "origin" : [<integer>], // Which origin server these requirements apply to "destination" : <integer>, // Which server these requirements apply to "link" : ["<uri>"], // Links to the FHIR specification "capabilities" : { canonical(CapabilityStatement) } // R! Required Capability Statement }] }, "fixture" : [{ // Fixture in the test script - by reference (uri) "autocreate" : <boolean>, // R! Whether or not to implicitly create the fixture during setup "autodelete" : <boolean>, // R! Whether or not to implicitly delete the fixture during teardown "resource" : { Reference(Any) } // Reference of the resource }], "profile" : [{ Reference(Any) }], // Reference of the validation profile "variable" : [{ // Placeholder for evaluated elements "name" : "<string>", // R! Descriptive name for this variable "defaultValue" : "<string>", // Default, hard-coded, or user-defined value for this variable "description" : "<string>", // Natural language description of the variable "expression" : "<string>", // The FHIRPath expression against the fixture body "headerField" : "<string>", // HTTP header field name for source "hint" : "<string>", // Hint help text for default value to enter "path" : "<string>", // XPath or JSONPath against the fixture body "sourceId" : "<id>" // Fixture Id of source expression or headerField within this variable }], "rule" : [{ // Assert rule used within the test script "resource" : { Reference(Any) }, // R! Assert rule resource reference "param" : [{ // Rule parameter template "name" : "<string>", // R! Parameter name matching external assert rule parameter "value" : "<string>" // Parameter value defined either explicitly or dynamically }] }], "ruleset" : [{ // Assert ruleset used within the test script "resource" : { Reference(Any) }, // R! Assert ruleset resource reference "rule" : [{ // R! The referenced rule within the ruleset "ruleId" : "<id>", // R! Id of referenced rule within the ruleset "param" : [{ // Ruleset rule parameter template "name" : "<string>", // R! Parameter name matching external assert ruleset rule parameter "value" : "<string>" // Parameter value defined either explicitly or dynamically }] }] }], "setup" : { // A series of required setup operations before tests are executed "action" : [{ // R! A setup operation or assert to perform "operation" : { // The setup operation to perform "type" : { Coding }, // The operation code type that will be executed "resource" : "<code>", // Resource type "label" : "<string>", // Tracking/logging operation label "description" : "<string>", // Tracking/reporting operation description "accept" : "<code>", // Mime type to accept in the payload of the response, with charset etc. "contentType" : "<code>", // Mime type of the request payload contents, with charset etc. "destination" : <integer>, // Server responding to the request "encodeRequestUrl" : <boolean>, // R! Whether or not to send the request url in encoded format "origin" : <integer>, // Server initiating the request "params" : "<string>", // Explicitly defined path parameters "requestHeader" : [{ // Each operation can have one or more header elements "field" : "<string>", // R! HTTP header field name "value" : "<string>" // R! HTTP headerfield value }], "requestId" : "<id>", // Fixture Id of mapped request "responseId" : "<id>", // Fixture Id of mapped response "sourceId" : "<id>", // Fixture Id of body for PUT and POST requests "targetId" : "<id>", // Id of fixture used for extracting the [id], [type], and [vid] for GET requests "url" : "<string>" // Request URL }, "assert" : { // The assertion to perform "label" : "<string>", // Tracking/logging assertion label "description" : "<string>", // Tracking/reporting assertion description "direction" : "<code>", // response | request "compareToSourceId" : "<string>", // Id of the source fixture to be evaluated "compareToSourceExpression" : "<string>", // The FHIRPath expression to evaluate against the source fixture "compareToSourcePath" : "<string>", // XPath or JSONPath expression to evaluate against the source fixture "contentType" : "<code>", // Mime type to compare against the 'Content-Type' header "expression" : "<string>", // The FHIRPath expression to be evaluated "headerField" : "<string>", // HTTP header field name "minimumId" : "<string>", // Fixture Id of minimum content resource "navigationLinks" : <boolean>, // Perform validation on navigation links? "operator" : "<code>", // equals | notEquals | in | notIn | greaterThan | lessThan | empty | notEmpty | contains | notContains | eval "path" : "<string>", // XPath or JSONPath expression "requestMethod" : "<code>", // delete | get | options | patch | post | put "requestURL" : "<string>", // Request URL comparison value "resource" : "<code>", // Resource type "response" : "<code>", // okay | created | noContent | notModified | bad | forbidden | notFound | methodNotAllowed | conflict | gone | preconditionFailed | unprocessable "responseCode" : "<string>", // HTTP response code to test "rule" : { // The reference to a TestScript.rule "ruleId" : "<id>", // R! Id of the TestScript.rule "param" : [{ // Rule parameter template "name" : "<string>", // R! Parameter name matching external assert rule parameter "value" : "<string>" // R! Parameter value defined either explicitly or dynamically }] }, "ruleset" : { // The reference to a TestScript.ruleset "rulesetId" : "<id>", // R! Id of the TestScript.ruleset "rule" : [{ // The referenced rule within the ruleset "ruleId" : "<id>", // R! Id of referenced rule within the ruleset "param" : [{ // Rule parameter template "name" : "<string>", // R! Parameter name matching external assert ruleset rule parameter "value" : "<string>" // R! Parameter value defined either explicitly or dynamically }] }] }, "sourceId" : "<id>", // Fixture Id of source expression or headerField "validateProfileId" : "<id>", // Profile Id of validation profile reference "value" : "<string>", // The value to compare to "warningOnly" : <boolean> // R! Will this assert produce a warning only on error? } }] }, "test" : [{ // A test in this script "name" : "<string>", // Tracking/logging name of this test "description" : "<string>", // Tracking/reporting short description of the test "action" : [{ // R! A test operation or assert to perform "operation" : { Content as for TestScript.setup.action.operation }, // The setup operation to perform "assert" : { Content as for TestScript.setup.action.assert } // The setup assertion to perform }] }], "teardown" : { // A series of required clean up steps "action" : [{ // R! One or more teardown operations to perform "operation" : { Content as for TestScript.setup.action.operation } // R! The teardown operation to perform }] } }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:TestScript; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:TestScript.url [ uri ]; # 1..1 Canonical identifier for this test script, represented as a URI (globally unique) fhir:TestScript.identifier [ Identifier ]; # 0..1 Additional identifier for the test script fhir:TestScript.version [ string ]; # 0..1 Business version of the test script fhir:TestScript.name [ string ]; # 1..1 Name for this test script (computer friendly) fhir:TestScript.title [ string ]; # 0..1 Name for this test script (human friendly) fhir:TestScript.status [ code ]; # 1..1 draft | active | retired | unknown fhir:TestScript.experimental [ boolean ]; # 0..1 For testing purposes, not real usage fhir:TestScript.date [ dateTime ]; # 0..1 Date last changed fhir:TestScript.publisher [ string ]; # 0..1 Name of the publisher (organization or individual) fhir:TestScript.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher fhir:TestScript.description [ markdown ]; # 0..1 Natural language description of the test script fhir:TestScript.useContext [ UsageContext ], ... ; # 0..* The context that the content is intended to support fhir:TestScript.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for test script (if applicable) fhir:TestScript.purpose [ markdown ]; # 0..1 Why this test script is defined fhir:TestScript.copyright [ markdown ]; # 0..1 Use and/or publishing restrictions fhir:TestScript.origin [ # 0..* An abstract server representing a client or sender in a message exchange fhir:TestScript.origin.index [ integer ]; # 1..1 The index of the abstract origin server starting at 1 fhir:TestScript.origin.profile [ Coding ]; # 1..1 FHIR-Client | FHIR-SDC-FormFiller ], ...; fhir:TestScript.destination [ # 0..* An abstract server representing a destination or receiver in a message exchange fhir:TestScript.destination.index [ integer ]; # 1..1 The index of the abstract destination server starting at 1 fhir:TestScript.destination.profile [ Coding ]; # 1..1 FHIR-Server | FHIR-SDC-FormManager | FHIR-SDC-FormReceiver | FHIR-SDC-FormProcessor ], ...; fhir:TestScript.metadata [ # 0..1 Required capability that is assumed to function correctly on the FHIR server being tested fhir:TestScript.metadata.link [ # 0..* Links to the FHIR specification fhir:TestScript.metadata.link.url [ uri ]; # 1..1 URL to the specification fhir:TestScript.metadata.link.description [ string ]; # 0..1 Short description ], ...; fhir:TestScript.metadata.capability [ # 1..* Capabilities that are assumed to function correctly on the FHIR server being tested fhir:TestScript.metadata.capability.required [ boolean ]; # 1..1 Are the capabilities required? fhir:TestScript.metadata.capability.validated [ boolean ]; # 1..1 Are the capabilities validated? fhir:TestScript.metadata.capability.description [ string ]; # 0..1 The expected capabilities of the server fhir:TestScript.metadata.capability.origin [ integer ], ... ; # 0..* Which origin server these requirements apply to fhir:TestScript.metadata.capability.destination [ integer ]; # 0..1 Which server these requirements apply to fhir:TestScript.metadata.capability.link [ uri ], ... ; # 0..* Links to the FHIR specification fhir:TestScript.metadata.capability.capabilities [ canonical(CapabilityStatement) ]; # 1..1 Required Capability Statement ], ...; ]; fhir:TestScript.fixture [ # 0..* Fixture in the test script - by reference (uri) fhir:TestScript.fixture.autocreate [ boolean ]; # 1..1 Whether or not to implicitly create the fixture during setup fhir:TestScript.fixture.autodelete [ boolean ]; # 1..1 Whether or not to implicitly delete the fixture during teardown fhir:TestScript.fixture.resource [ Reference(Any) ]; # 0..1 Reference of the resource ], ...; fhir:TestScript.profile [ Reference(Any) ], ... ; # 0..* Reference of the validation profile fhir:TestScript.variable [ # 0..* Placeholder for evaluated elements fhir:TestScript.variable.name [ string ]; # 1..1 Descriptive name for this variable fhir:TestScript.variable.defaultValue [ string ]; # 0..1 Default, hard-coded, or user-defined value for this variable fhir:TestScript.variable.description [ string ]; # 0..1 Natural language description of the variable fhir:TestScript.variable.expression [ string ]; # 0..1 The FHIRPath expression against the fixture body fhir:TestScript.variable.headerField [ string ]; # 0..1 HTTP header field name for source fhir:TestScript.variable.hint [ string ]; # 0..1 Hint help text for default value to enter fhir:TestScript.variable.path [ string ]; # 0..1 XPath or JSONPath against the fixture body fhir:TestScript.variable.sourceId [ id ]; # 0..1 Fixture Id of source expression or headerField within this variable ], ...; fhir:TestScript.rule [ # 0..* Assert rule used within the test script fhir:TestScript.rule.resource [ Reference(Any) ]; # 1..1 Assert rule resource reference fhir:TestScript.rule.param [ # 0..* Rule parameter template fhir:TestScript.rule.param.name [ string ]; # 1..1 Parameter name matching external assert rule parameter fhir:TestScript.rule.param.value [ string ]; # 0..1 Parameter value defined either explicitly or dynamically ], ...; ], ...; fhir:TestScript.ruleset [ # 0..* Assert ruleset used within the test script fhir:TestScript.ruleset.resource [ Reference(Any) ]; # 1..1 Assert ruleset resource reference fhir:TestScript.ruleset.rule [ # 1..* The referenced rule within the ruleset fhir:TestScript.ruleset.rule.ruleId [ id ]; # 1..1 Id of referenced rule within the ruleset fhir:TestScript.ruleset.rule.param [ # 0..* Ruleset rule parameter template fhir:TestScript.ruleset.rule.param.name [ string ]; # 1..1 Parameter name matching external assert ruleset rule parameter fhir:TestScript.ruleset.rule.param.value [ string ]; # 0..1 Parameter value defined either explicitly or dynamically ], ...; ], ...; ], ...; fhir:TestScript.setup [ # 0..1 A series of required setup operations before tests are executed fhir:TestScript.setup.action [ # 1..* A setup operation or assert to perform fhir:TestScript.setup.action.operation [ # 0..1 The setup operation to perform fhir:TestScript.setup.action.operation.type [ Coding ]; # 0..1 The operation code type that will be executed fhir:TestScript.setup.action.operation.resource [ code ]; # 0..1 Resource type fhir:TestScript.setup.action.operation.label [ string ]; # 0..1 Tracking/logging operation label fhir:TestScript.setup.action.operation.description [ string ]; # 0..1 Tracking/reporting operation description fhir:TestScript.setup.action.operation.accept [ code ]; # 0..1 Mime type to accept in the payload of the response, with charset etc. fhir:TestScript.setup.action.operation.contentType [ code ]; # 0..1 Mime type of the request payload contents, with charset etc. fhir:TestScript.setup.action.operation.destination [ integer ]; # 0..1 Server responding to the request fhir:TestScript.setup.action.operation.encodeRequestUrl [ boolean ]; # 1..1 Whether or not to send the request url in encoded format fhir:TestScript.setup.action.operation.origin [ integer ]; # 0..1 Server initiating the request fhir:TestScript.setup.action.operation.params [ string ]; # 0..1 Explicitly defined path parameters fhir:TestScript.setup.action.operation.requestHeader [ # 0..* Each operation can have one or more header elements fhir:TestScript.setup.action.operation.requestHeader.field [ string ]; # 1..1 HTTP header field name fhir:TestScript.setup.action.operation.requestHeader.value [ string ]; # 1..1 HTTP headerfield value ], ...; fhir:TestScript.setup.action.operation.requestId [ id ]; # 0..1 Fixture Id of mapped request fhir:TestScript.setup.action.operation.responseId [ id ]; # 0..1 Fixture Id of mapped response fhir:TestScript.setup.action.operation.sourceId [ id ]; # 0..1 Fixture Id of body for PUT and POST requests fhir:TestScript.setup.action.operation.targetId [ id ]; # 0..1 Id of fixture used for extracting the [id], [type], and [vid] for GET requests fhir:TestScript.setup.action.operation.url [ string ]; # 0..1 Request URL ]; fhir:TestScript.setup.action.assert [ # 0..1 The assertion to perform fhir:TestScript.setup.action.assert.label [ string ]; # 0..1 Tracking/logging assertion label fhir:TestScript.setup.action.assert.description [ string ]; # 0..1 Tracking/reporting assertion description fhir:TestScript.setup.action.assert.direction [ code ]; # 0..1 response | request fhir:TestScript.setup.action.assert.compareToSourceId [ string ]; # 0..1 Id of the source fixture to be evaluated fhir:TestScript.setup.action.assert.compareToSourceExpression [ string ]; # 0..1 The FHIRPath expression to evaluate against the source fixture fhir:TestScript.setup.action.assert.compareToSourcePath [ string ]; # 0..1 XPath or JSONPath expression to evaluate against the source fixture fhir:TestScript.setup.action.assert.contentType [ code ]; # 0..1 Mime type to compare against the 'Content-Type' header fhir:TestScript.setup.action.assert.expression [ string ]; # 0..1 The FHIRPath expression to be evaluated fhir:TestScript.setup.action.assert.headerField [ string ]; # 0..1 HTTP header field name fhir:TestScript.setup.action.assert.minimumId [ string ]; # 0..1 Fixture Id of minimum content resource fhir:TestScript.setup.action.assert.navigationLinks [ boolean ]; # 0..1 Perform validation on navigation links? fhir:TestScript.setup.action.assert.operator [ code ]; # 0..1 equals | notEquals | in | notIn | greaterThan | lessThan | empty | notEmpty | contains | notContains | eval fhir:TestScript.setup.action.assert.path [ string ]; # 0..1 XPath or JSONPath expression fhir:TestScript.setup.action.assert.requestMethod [ code ]; # 0..1 delete | get | options | patch | post | put fhir:TestScript.setup.action.assert.requestURL [ string ]; # 0..1 Request URL comparison value fhir:TestScript.setup.action.assert.resource [ code ]; # 0..1 Resource type fhir:TestScript.setup.action.assert.response [ code ]; # 0..1 okay | created | noContent | notModified | bad | forbidden | notFound | methodNotAllowed | conflict | gone | preconditionFailed | unprocessable fhir:TestScript.setup.action.assert.responseCode [ string ]; # 0..1 HTTP response code to test fhir:TestScript.setup.action.assert.rule [ # 0..1 The reference to a TestScript.rule fhir:TestScript.setup.action.assert.rule.ruleId [ id ]; # 1..1 Id of the TestScript.rule fhir:TestScript.setup.action.assert.rule.param [ # 0..* Rule parameter template fhir:TestScript.setup.action.assert.rule.param.name [ string ]; # 1..1 Parameter name matching external assert rule parameter fhir:TestScript.setup.action.assert.rule.param.value [ string ]; # 1..1 Parameter value defined either explicitly or dynamically ], ...; ]; fhir:TestScript.setup.action.assert.ruleset [ # 0..1 The reference to a TestScript.ruleset fhir:TestScript.setup.action.assert.ruleset.rulesetId [ id ]; # 1..1 Id of the TestScript.ruleset fhir:TestScript.setup.action.assert.ruleset.rule [ # 0..* The referenced rule within the ruleset fhir:TestScript.setup.action.assert.ruleset.rule.ruleId [ id ]; # 1..1 Id of referenced rule within the ruleset fhir:TestScript.setup.action.assert.ruleset.rule.param [ # 0..* Rule parameter template fhir:TestScript.setup.action.assert.ruleset.rule.param.name [ string ]; # 1..1 Parameter name matching external assert ruleset rule parameter fhir:TestScript.setup.action.assert.ruleset.rule.param.value [ string ]; # 1..1 Parameter value defined either explicitly or dynamically ], ...; ], ...; ]; fhir:TestScript.setup.action.assert.sourceId [ id ]; # 0..1 Fixture Id of source expression or headerField fhir:TestScript.setup.action.assert.validateProfileId [ id ]; # 0..1 Profile Id of validation profile reference fhir:TestScript.setup.action.assert.value [ string ]; # 0..1 The value to compare to fhir:TestScript.setup.action.assert.warningOnly [ boolean ]; # 1..1 Will this assert produce a warning only on error? ]; ], ...; ]; fhir:TestScript.test [ # 0..* A test in this script fhir:TestScript.test.name [ string ]; # 0..1 Tracking/logging name of this test fhir:TestScript.test.description [ string ]; # 0..1 Tracking/reporting short description of the test fhir:TestScript.test.action [ # 1..* A test operation or assert to perform fhir:TestScript.test.action.operation [ See TestScript.setup.action.operation ]; # 0..1 The setup operation to perform fhir:TestScript.test.action.assert [ See TestScript.setup.action.assert ]; # 0..1 The setup assertion to perform ], ...; ], ...; fhir:TestScript.teardown [ # 0..1 A series of required clean up steps fhir:TestScript.teardown.action [ # 1..* One or more teardown operations to perform fhir:TestScript.teardown.action.operation [ See TestScript.setup.action.operation ]; # 1..1 The teardown operation to perform ], ...; ]; ]
Changes since Release 3
TestScript | |
TestScript.experimental |
|
TestScript.metadata.capability.required |
|
TestScript.metadata.capability.validated |
|
TestScript.metadata.capability.capabilities |
|
TestScript.fixture.autocreate |
|
TestScript.fixture.autodelete |
|
TestScript.setup.action.operation.accept |
|
TestScript.setup.action.operation.contentType |
|
TestScript.setup.action.operation.encodeRequestUrl |
|
TestScript.setup.action.assert.contentType |
|
TestScript.setup.action.assert.warningOnly |
|
See the Full Difference for further information
This analysis is available as XML or JSON.
See R3 <--> R4 Conversion Maps (status = 7 tests that all execute ok. 7 fail round-trip testing and 7 r3 resources are invalid (0 errors).)
See the Profiles & Extensions and the alternate definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions & the dependency analysis
Path | Definition | Type | Reference |
---|---|---|---|
TestScript.status | The lifecycle status of an artifact. | Required | PublicationStatus |
TestScript.jurisdiction | Countries and regions within which this artifact is targeted for use. | Extensible | Jurisdiction ValueSet |
TestScript.origin.profile | The type of origin profile the test system supports. | Extensible | TestScriptProfileOriginType |
TestScript.destination.profile | The type of destination profile the test system supports. | Extensible | TestScriptProfileDestinationType |
TestScript.setup.action.operation.type | The allowable operation code types. | Extensible | TestScriptOperationCode |
TestScript.setup.action.operation.resource TestScript.setup.action.assert.resource | A list of all the concrete types defined in this version of the FHIR specification - Data Types and Resource Types. | Required | Defined Types |
TestScript.setup.action.operation.accept TestScript.setup.action.operation.contentType TestScript.setup.action.assert.contentType | The mime type of an attachment. Any valid mime type is allowed. | Required | Mime Types |
TestScript.setup.action.assert.direction | The type of direction to use for assertion. | Required | AssertionDirectionType |
TestScript.setup.action.assert.operator | The type of operator to use for assertion. | Required | AssertionOperatorType |
TestScript.setup.action.assert.requestMethod | The allowable request method or HTTP operation codes. | Required | TestScriptRequestMethodCode |
TestScript.setup.action.assert.response | The type of response code to use for assertion. | Required | AssertionResponseTypes |
id | Level | Location | Description | Expression |
tst-0 | Warning | (base) | Name should be usable as an identifier for the module by machine processing applications such as code generation | name.matches('[A-Z]([A-Za-z0-9_]){0,254}') |
tst-1 | Rule | TestScript.setup.action | Setup action SHALL contain either an operation or assert but not both. | operation.exists() xor assert.exists() |
tst-2 | Rule | TestScript.test.action | Test action SHALL contain either an operation or assert but not both. | operation.exists() xor assert.exists() |
tst-3 | Rule | TestScript.variable | Variable can only contain one of expression, headerField or path. | expression.empty() or headerField.empty() or path.empty() |
tst-4 | Rule | TestScript.metadata | TestScript metadata capability SHALL contain required or validated or both. | capability.required.exists() or capability.validated.exists() |
tst-5 | Rule | TestScript.setup.action.assert | Only a single assertion SHALL be present within setup action assert element. | contentType.count() + expression.count() + headerField.count() + minimumId.count() + navigationLinks.count() + path.count() + requestMethod.count() + resource.count() + responseCode.count() + response.count() + rule.count() + ruleset.count() + validateProfileId.count() <=1 |
tst-6 | Rule | TestScript.test.action.assert | Only a single assertion SHALL be present within test action assert element. | contentType.count() + expression.count() + headerField.count() + minimumId.count() + navigationLinks.count() + path.count() + requestMethod.count() + resource.count() + responseCode.count() + response.count() + rule.count() + ruleset.count() + validateProfileId.count() <=1 |
tst-7 | Rule | TestScript.setup.action.operation | Setup operation SHALL contain either sourceId or targetId or params or url. | sourceId.exists() or (targetId.count() + url.count() + params.count() = 1) or (type.code in ('capabilities' |'search' | 'transaction' | 'history')) |
tst-8 | Rule | TestScript.test.action.operation | Test operation SHALL contain either sourceId or targetId or params or url. | sourceId.exists() or (targetId.count() + url.count() + params.count() = 1) or (type.code in ('capabilities' | 'search' | 'transaction' | 'history')) |
tst-9 | Rule | TestScript.teardown.action.operation | Teardown operation SHALL contain either sourceId or targetId or params or url. | sourceId.exists() or (targetId.count() + url.count() + params.count() = 1) or (type.code in ('capabilities' | 'search' | 'transaction' | 'history')) |
tst-10 | Rule | TestScript.setup.action.assert | Setup action assert SHALL contain either compareToSourceId and compareToSourceExpression, compareToSourceId and compareToSourcePath or neither. | compareToSourceId.empty() xor (compareToSourceExpression.exists() or compareToSourcePath.exists()) |
tst-11 | Rule | TestScript.test.action.assert | Test action assert SHALL contain either compareToSourceId and compareToSourceExpression, compareToSourceId and compareToSourcePath or neither. | compareToSourceId.empty() xor (compareToSourceExpression.exists() or compareToSourcePath.exists()) |
tst-12 | Rule | TestScript.setup.action.assert | Setup action assert response and responseCode SHALL be empty when direction equals request | (response.empty() and responseCode.empty() and direction = 'request') or direction.empty() or direction = 'response' |
tst-13 | Rule | TestScript.test.action.assert | Test action assert response and response and responseCode SHALL be empty when direction equals request | (response.empty() and responseCode.empty() and direction = 'request') or direction.empty() or direction = 'response' |
Please refer to the Testing FHIR - How Tos for examples on working with this resource.
Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
Name | Type | Description | Expression | In Common |
context | token | A use context assigned to the test script | (TestScript.useContext.value as CodeableConcept) | |
context-quantity | quantity | A quantity- or range-valued use context assigned to the test script | (TestScript.useContext.value as Quantity) | (TestScript.useContext.value as Range) | |
context-type | token | A type of use context assigned to the test script | TestScript.useContext.code | |
context-type-quantity | composite | A use context type and quantity- or range-based value assigned to the test script | On TestScript.useContext: context-type: code context-quantity: value.as(Quantity) | value.as(Range) | |
context-type-value | composite | A use context type and value assigned to the test script | On TestScript.useContext: context-type: code context: value.as(CodeableConcept) | |
date | date | The test script publication date | TestScript.date | |
description | string | The description of the test script | TestScript.description | |
identifier | token | External identifier for the test script | TestScript.identifier | |
jurisdiction | token | Intended jurisdiction for the test script | TestScript.jurisdiction | |
name | string | Computationally friendly name of the test script | TestScript.name | |
publisher | string | Name of the publisher of the test script | TestScript.publisher | |
status | token | The current status of the test script | TestScript.status | |
testscript-capability | string | TestScript required and validated capability | TestScript.metadata.capability.description | |
title | string | The human-friendly name of the test script | TestScript.title | |
url | uri | The uri that identifies the test script | TestScript.url | |
version | token | The business version of the test script | TestScript.version |