Test Cases for Document Registry (2018)


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

The toolkit will send a small number of HL7 V2 ADT messages to the Document Registry under test. Your Document Registry will need to accept those V2 messages and use them to register your patients as required by the IHE XDS.b profile. The toolkit does not have a V3 option.

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 Provide test administrator with configuration parameters for your Document Registry.
Admin Configuration
  • Create a SYSTEM within the XDS Toolkit that uses the supplied configuration parameters.
  • In this system, include only the DOCUMENT REGISTRY configuration. Do not double up with other actors.
Admin Configuration Create a testing SESSION for this DOCUMENT REGISTRY. 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 REGISTRY. 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 Registry tab.
  5. Check the Reset box and activate the button: Initialize Testing Environment. This will send HL7 V2 ADT messages to your registry.
  6. Wait for the environment initialization steps to complete. You should see initilization steps under the heading Supporting Environment Configuration turn green.
  7. Now you can run all tests (one button for the Document Registry - Required Tests, or you can run individual tests. The trashcan icon clears the log/test results.
  8. 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. reg/11897.html
  2. reg/11898.html
  3. reg/11899.html
  4. reg/11901.html
  5. reg/11902.html
  6. reg/11903.html
  7. reg/11904.html
  8. reg/11905.html
  9. reg/11906.html
  10. reg/11907.html
  11. reg/11908.html
  12. reg/11909.html
  13. reg/11990.html
  14. reg/11991.html
  15. reg/11992.html
  16. reg/11993.html
  17. reg/11994.html
  18. reg/11995.html
  19. reg/11996.html
  20. reg/11997.html
  21. reg/11998.html
  22. reg/11999.html
  23. reg/12000.html
  24. reg/12001.html
  25. reg/12002.html
  26. reg/12004.html
  27. reg/12084.html
  28. reg/12000.html
  29. reg/12323.html
  30. reg/12326.html
  31. reg/12327.html
  32. reg/12361.html
  33. reg/12368.html
  34. reg/12370.html
  35. reg/12379.html
  36. reg/15803.html