Test Cases for Document Repository (2018)


This document describes testing requirements for the Document Repository actor in the IHE XDS-I.b integration profile. The Document Repository will perform tests using the XDS Toolkit software from NIST and also ATNA security tests using the Gazelle software. The test procedure includes:

General Instructions

Certain toolkit management functions are password protected and must be performed by the test administrator. Please follow these general instructions.

Party Type Step
User Configuration Your Document Repository will need to communicate with a Document Registry simulator. The detailed instructions below will tell you how to obtain the configuration information for the simulator.
User Configuration Provide test administrator with configuration parameters for your Document Repository.
Admin Configuration
  • Create a SYSTEM within the XDS Toolkit that uses the supplied configuration parameters.
  • In this system, include only the Document Repository configuration. Do not double up with other actors.
Admin Configuration Create a testing SESSION for this Document Repository. The system under test should use only this SESSION and no others.
User Instruction Use only the testing ENVIRONMENT and testing SESSION assigned by the administrator when testing your Document Repository. Do not test other actors using this testing SESSION.
User Instruction It is expected that the user will execute the tests and the administrator will review results when the tests are complete. The user may execute individual or all tests multiple times. Each time you execute a test, the toolkit will overwrite the previous results in the test SESSION for that test.

Detailed Instructions

  1. In the web user interface, make sure you have selected the proper testing ENVIRONMENT and proper testing SESSION.
  2. In the lower left flap of the toolkit, select Conformance Tests.
  3. Activate the teal/green Test Context control (right side of conformance tests). Select your SYSTEM as the system under test.
  4. Select the Document Repository tab.
  5. Check the Reset box and activate the button: Initialize Testing Environment. This will create a Document Registry simulator and load test patients into that simulator.
  6. Wait for the environment initialization steps to complete. You should see initilization steps under the heading Supporting Environment Configuration turn green.
  7. The display will show you the configuration parameters for the Document Registry simulator. Use that data to configure your Document Repository. Please note that you can initialize the environment any number of times. The Document Registry simulator will always be created with the same endpoints. You will not have to reconfigure your Document Repository if you decide to initialize the testing environment again.
  8. Now you can run all tests (one button for the Document Repository - Required Tests, or you can run individual tests. The trashcan icon clears the log/test results.
  9. As stated above, you can run the test cases and review the results on your own schedule. Contact the administrator with questions or to verify results.

Test Documentation

Instructions for individual tests are stored in the toolkit. The links below provide static copies of the documentation that do not rely on toolkit access.

  1. rep/11966.html
  2. rep/11979.html
  3. rep/11983.html
  4. rep/11986.html
  5. rep/12021.html
  6. rep/12029.html
  7. rep/12369.html
  8. rep/15816.html