ART Tests

Introduction

ART-DECOR supports several methods to test message/document instances against health information standards. For specifying tests, see also Specifying Tests with DECOR.

Prerequisites for testing

Before you can start testing a testaccount has to be created (per vendor) with the following information:

• (optional) Application Id of the application. Note: the message logging system filters on the Application Id, if the Id is incorrect messages will not be properly logged.
• (optional) Name for the application
• (optional) URL of the application
• (optional) The contact person at the vendor
• HL7 resources: which standard should be tested against
• Users: which users have access to the messagelog in this testaccount

Please Contact us if you are interested in this functionality.

Sending messages to ART-DECOR

In order to send messages to ART-DECOR, perform the following steps:

• Configure the correct Application Id in the vendor application as is listed in the ART-DECOR testaccount
• Configure the ART-DECOR URL in the vendor application: for instance http://<ART-DECOR server>/xis
• Configure the correct Service location (this information is usually listed in the wsdl in the information standard)
• Send the message to the ART-DECOR server
• If a reply is configured (based on the wsdl) ART-DECOR will respond with the correct response.

Messages are saved in the vendor testaccount. After messages are saved, messages can be viewed and validated, see Validation of messages in ART-DECOR

Uploading messages to ART-DECOR

To upload messages to a testaccount, perform the following steps:

• Files should have the *.xml extension
• Log on to ART-DECOR (for this you need a personal account on the server)
• Go to 'Testing' and 'Messages'
• Choose the correct 'Account'
• To upload a message, choose 'Browse', select the correct file on your local disk.
• Note: While uploading, the upload indicator does not complete. This is a known issue. Clicking on the red cross will reset the upload indicator.
• The screen will refresh after uploading the file and list the message in the 'Validation' and 'Files' tab.

After this messages can be viewed and validated, see Validation of messages in ART-DECOR

Sending messages from ART-DECOR to your application

To send messages from ART-DECOR, perform the following steps:

• Log on to ART-DECOR (for this you need a personal account on the server)
• Go to 'Testing' and 'Messages'
• Choose the correct 'Account'
• To send a query: choose the tab 'Send Query'
  • Choose the correct 'Query' type
  • Choose the correct 'Patient'
  • (optional) Change the 'Query author'
  • (optional) Change the 'Receiver' application or change the Service Location
  • Choose 'Send Query'
• To send previously uploaded or sent messages/documents from ART-DECOR
  • Choose 'Files'
  • Select the correct file
  • Configure the correct 'Receiver URL' and 'SOAP action'
  • Choose 'Send File'
• The response will be listed under 'Response'

After this messages can be viewed and validated, see Validation of messages in ART-DECOR

Before sending messages the stub message template can be viewed, note that this will show unprocessed message templates which will not correspond to the message that will be sent. The stub message template can contain non-XML elements, for instance for application id's or effectiveTime elements. To view the stub message template, click either:

• HTML view message: shows a HTML-rendered version of the stub message template
• View message: shows the stub message template

When sending messages the stub message template is processed to XML and will usually be placed as payload in a more generic header template for this message type.

Validation of messages in ART-DECOR

To validate messages/documents in ART-DECOR, perform the following steps:

• Log on to ART-DECOR (for this you need a personal account on the server)
• Go to 'Testing' and 'Messages'
• Choose the correct 'Account'
• This assumes messages/documents have already been sent to ART-DECOR or uploaded.
• Go to tab 'Validation' and select the correct message
• Selecting the message will trigger schema and schematron validation
• Validation results are show at 'Schema errors' and 'Schematron errors'
• If there is a stylesheet configured to view the message you can select 'HTML view message' to view a pretty-printed version of the xml-file (this will open a separate tab in your browser)
• The message can be viewed in xml by selecting: 'View message' (this will open a separate tab in your browser)

Validation against a specific testcase in ART-DECOR

You can use Testsuites to test your message against a specific testcase. This will check if the content in your message/document conforms to the specified testcase. It is also possible to check whether certain elements are present, based on the testcase. Testcases are configured in 'Testsuites'. To validate messages/documents against a testcase in ART-DECOR, perform the following steps:

• This assumes that testsuites are configured for this testing scenario.
• Log on to ART-DECOR (for this you need a personal account on the server)
• Go to 'Testing' and 'Tests'
• Choose the correct 'Account'
• Add the correct testsuite by selecting the plus (Add testsuite)
• Per 'test' you can select a message by clicking 'select'
• Not all messages fit to all testcases, so make sure you select the correct testcase
• Validation results are shown, and also include the generic schema and schematron validation results