Integrating the Healthcare Enterprise

 IHE/MESA Patient Demographics Consumer Tests

Electronic Radiology Laboratory
Mallinckrodt Institute of Radiology
510 South Kingshighway Blvd.
St. Louis, MO  63110
314.362.6965 (Voice)
314.362.6971 (Fax)

Revision 10.11.0
29-November-2006

Copyright: Washington University School of Medicine, 2005

Patient Demographics Consumer
Introduction
Patient Identification
Configuration
Starting the MESA Servers
Installation Test
Loading MESA PD Supplier
Submission of Results
Test Cases: PDQ

1. Test Case 11311: Exact Name Search
   
2. Test 11312: Name Search – No Match
   
3. Test Case 11315: Partial Name Search
   
4. Test Case 11320: Complete ID Search - Unspecified Domain
   
5. Test Case 11325: Complete ID Search - Single Domain
   
6. Test Case 11330: Complete ID Search - Multiple Domains
   
7. Test Case 11335: Partial ID Search - Single Domain
   
8. Test Case 11340: Date of Birth Search
   
9. Test Case 11345: Age Range Search Search
   
10. Test Case 11350: Multi Key Search 1
    
11. Test Case 11355: Multi Key Search 2
    
12. Test Case 11360: Attending Doctor
    
13. Test Case 11365: Continuation Test 1
    

Test Cases: PAM

1. Test Case 12101: PAM Create New Patient
   
2. Test Case 12102: PAM Update Patient Information

Patient Demographics Consumer

Introduction

Patient Identification

Patient IDs are assigned to test specific features of the PDQ profile. The values used for Assigning Authority in PID.3 are taken from the HIMSS 2005 demonstrations. The values work equally well for test cases. The values for assigning authority are listed in the table below.
Note that the use of OIDs replaces simple assigning authority names used in other MESA tests.

Configuration

The MESA scripts are run from the directory $MESA_TARGET/mesa_tests/iti/actors/pd_consumer. The ASCII configuration file pd_consumer.cfg contains parameters that configure the MESA Patient Demographics Supplier. The default port number is 3700. You should only change this port number if there is a conflict with another service on the MESA test computer. There will be no conflicts with other MESA servers; the only conflict would occur with something from the operating system or other software package.
You should configure your Patient Demographics Conumer to send HL7 query messages to the MESA Cross Reference Manager listening on port 3700. HL7 communication uses TCP sockets and the minimal lower level protocol.
For testing the PAM profile, the Patient Demographics Consumer is expected to have an HL7 server that accepts ADT messages. The pd_consumer.cfg file lists entries for the server as follows:

Modify the text file as appropriate to designate the system under test.

Starting the MESA Servers

MESA servers are started from a DOS/CMD window or a terminal emulator. Follow these steps for Unix systems

cd  $MESA_TARGET/mesa_tests/iti/actors/pd_consumer

scripts/start_mesa_servers.csh

To stop the servers:

     scripts/stop_mesa_servers.csh

cd %MESA_TARGET%\mesa_tests\iti\actors\pd_consumer

scripts\start_mesa_servers.bat

To stop the MESA servers:
Kill the server using ^C in the same DOS window where you started the server. When you started the server, it ran the server in the foreground.

Installation Test

Loading MESA PD Supplier

The MESA PD supplier needs demographic records loaded to support the PD Consumer under test. After the MESA servers are running, the PD Supplier is loaded as follows:

     perl scripts/pdc_pdq.pl 11300 1 x

Submission of Results

Test descriptions below inform the reader to “submit results to the Project Manager”. This is does not mean “email”. The current submission process should be documented by the Project Manager, but will not include emailing files directly to the Project Manager.

Test Cases: PDQ

This section describes test cases that are generally associated with the PDQ Integration Profile. There may be some overlap with other profiles.

     perl  scripts/pdc_pdq.pl 11311 <log level>

     perl  11311/eval_11311.pl <log level>

     perl  scripts/pdc_pdq.pl 11311 4 self

Test 11312: Name Search – No Match

Test case 11312 covers an exact name search by the Patient Demographics Consumer that results in no records found/returned by the Supplier.
Several ADT messages are sent to the Patient Demographics Supplier. Then, the PD Consumer sends a query. The consumer is expected to query by exact patient name:

What if my application does not make this query?

The PDQ profile does not demand specific queries of consumers. If this is not a natural query for your application, submit a note (.txt file) that briefly explains why your system would not make this query and list queries that your system does make.

References

ITI TF-2: 3.21

Instructions

To run this test, follow these steps using a DOS window or terminal emulator:

1. Set the current directory to $MESA_TARGET/mesa_tests/iti/actors/pd_consumer.
2. The file pd_consumer.cfg describes the MESA servers for this test. You should be aware of this file but should not modify it unless you have problems starting the MESA servers.
3. Make sure the MESA servers have been started. See Starting the MESA Servers for details.
4. Load the MESA PD Supplier with data as described in Loading MESA PD Supplier (if not already done).
5. Run the test script as follows:

     perl  scripts/pdc_pdq.pl 11312 <log level>

where <log level> is a value between 1 and 4.

6. Your system is prompted to send one Patient Demographics Query.
7. Perform a screen capture that shows your user interface with the user input that triggers the query.
8. Perform a screen capture that shows your user interface with results indicating no matches/returned records.

Evaluation

To evaluate your response to this test:

1. Save the screen capture of the query trigger in a file named <SYSTEM>_11312_query.<ext> where <ext> is the appropriate extension.
2. Save the screen catpure of the response window in a file named <SYSTEM>_11312_response.<ext>.
3. Submit the screen captures to the Project Manager. The Project Manager may examine the files and require you to modify your query and/or to perform additional queries.

Supplemental Information

     perl  scripts/pdc_pdq.pl 11315 <log level>

     perl  11315/eval_11315.pl 4

     perl  scripts/pdc_pdq.pl 11315 4 self

Test Case 11320: Complete ID Search - Unspecified Domain

Test case 11320 covers a complete ID search where the return domains are unspecified by the Patient Demographics Consumer.
Several ADT messages are sent to the Patient Demographics Supplier. Then, the PD Consumer sends a query. The consumer is expected to query with a Patient identifier

No other query keys should be present.
If populated, field RCP-2 should contain the value 10^RD or a higher number. This will allow a response with all records. There are later tests for limiting the number of records in a response.

What if my application does not make this query?

The PDQ profile does not demand specific queries of consumers. If this is not a natural query for your application, submit a note (.txt file) that briefly explains why your system would not make this query and list queries that your system does make.

References

ITI TF-2: 3.21

Instructions

To run this test, follow these steps using a DOS window or terminal emulator:

1. Set the current directory to $MESA_TARGET/mesa_tests/iti/actors/pd_consumer.
2. The file pd_consumer.cfg describes the MESA servers for this test. You should be aware of this file but should not modify it unless you have problems starting the MESA servers.
3. Make sure the MESA servers have been started. See Starting the MESA Servers for details.
4. Load the MESA PD Supplier with data as described in Loading MESA PD Supplier (if not already done).
5. Run the test script as follows:

     perl  scripts/pdc_pdq.pl 11320 <log level>

where <log level> is a value between 1 and 4.

6. Your system is prompted to send one Patient Demographics Query.

Evaluation

To evaluate your response to this test:

1. Run the evaluation script

     perl  11320/eval_11320.pl <log level>

2. The output file is 11320/grade_11320.txt. This test is successfully completed when the last line in the output file indicates 0 errors.
3. Submit the grade file at log level 4 to the Project Manager. The Project Manager may examine the file and require you to modify your query and/or to perform additional queries.

Supplemental Information

1. If you want to see a query generated by a MESA PD Consumer, run test 11320 in self test mode. Then run the evaluation as above and examine the grade file. To run in self test mode:

     perl  scripts/pdc_pdq.pl 11320 4 self

     perl  scripts/pdc_pdq.pl 11325 <log level>

     perl  11325/eval_11325.pl <log level>

     perl  scripts/pdc_pdq.pl 11325 4 self

Test Case 11330: Complete ID Search - Multiple Domains

Not implemented in this release.
Test case 11330 covers a complete ID search where the domain of interest (QPD-8) is different from the Patient ID Domain associated with MSH-5 Receiving Application..
Several ADT messages are sent to the Patient Demographics Supplier. Then, the PD Consumer sends a query. The consumer is expected to query with a Patient identifier

PID.3.1 = PDQ113XX01

     QRY_PDQ_1001^Query  By Name^IHEDEMO

References

ITI TF-2: 3.21

Instructions

To run this test, follow these steps using a DOS window or terminal emulator:

1. Set the current directory to $MESA_TARGET/mesa_tests/iti/actors/pd_consumer.
2. The file pd_consumer.cfg describes the MESA servers for this test. You should be aware of this file but should not modify it unless you have problems starting the MESA servers.
3. Make sure the MESA servers have been started. See Starting the MESA Servers for details.
4. Load the MESA PD Supplier with data as described in Loading MESA PD Supplier (if not already done).
5. Run the test script as follows:

     perl  scripts/pdc_pdq.pl 11330 <log level>

where <log level> is a value between 1 and 4.

6. Your system is prompted to send one Patient Demographics Query.

Evaluation

To evaluate your response to this test:

1. Run the evaluation script

     perl  11330/eval_11330.pl 4

2. The output file is 11330/grade_11330.txt. This test is successfully completed when the last line in the output file indicates 0 errors.
3. Submit the grade file to the Project Manager. The Project Manager may examine the file and require you to modify your query and/or to perform additional queries.

Supplemental Information

1. The evaluation script takes a single argument, <log level>. When debugging output, it is sometimes helpful to use a log level of 1 to see only differences. When submitting results, we prefer the output with the most verbose level, 4.
2. If you want to see a query generated by a MESA PD Consumer, run test 11330 in self test mode. Then run the evaluation as above and examine the grade file. To run in self test mode:

     perl  scripts/pdc_pdq.pl 11330 4 self

     perl  scripts/pdc_pdq.pl 11335 <log level>

     perl  11335/eval_11335.pl <log level>

     perl  scripts/pdc_pdq.pl 11335 4 self

Test Case 11340: Date of Birth Search

Not implemented in this release.
Test case 11340 covers a Date of Birth search within a single domain. The user may specify the return domain (^^^&1.3.6.1.4.1.21367.2005.1.1&ISO) or leave that field empty.
Several ADT messages are sent to the Patient Demographics Supplier. Then, the PD Consumer sends a query. The consumer is expected to query with a Patient identifier

PID.7 = 19780920

     QRY_PDQ_1001^Query  By Name^IHEDEMO

References

ITI TF-2: 3.21

Instructions

To run this test, follow these steps using a DOS window or terminal emulator:

1. Set the current directory to $MESA_TARGET/mesa_tests/iti/actors/pd_consumer.
2. The file pd_consumer.cfg describes the MESA servers for this test. You should be aware of this file but should not modify it unless you have problems starting the MESA servers.
3. Make sure the MESA servers have been started. See Starting the MESA Servers for details.
4. Load the MESA PD Supplier with data as described in Loading MESA PD Supplier (if not already done).
5. Run the test script as follows:

     perl  scripts/pdc_pdq.pl 11340 <log level>

where <log level> is a value between 1 and 4.

6. Your system is prompted to send one Patient Demographics Query.

Evaluation

To evaluate your response to this test:

1. Run the evaluation script

     perl  11340/eval_11340.pl 4

2. The output file is 11340/grade_11340.txt. This test is successfully completed when the last line in the output file indicates 0 errors.
3. Submit the grade file to the Project Manager. The Project Manager may examine the file and require you to modify your query and/or to perform additional queries.

Supplemental Information

1. The evaluation script takes a single argument, <log level>. When debugging output, it is sometimes helpful to use a log level of 1 to see only differences. When submitting results, we prefer the output with the most verbose level, 4.
2. If you want to see a query generated by a MESA PD Consumer, run test 11340 in self test mode. Then run the evaluation as above and examine the grade file. To run in self test mode:

     perl  scripts/pdc_pdq.pl 11340 4 self

Test Case 11350: Multi Key Search 1

In test 11350, a Patient Demographics Consumer is required to send a search using two search keys, patient name and date of birth.
Several ADT messages are sent to the Patient Demographics Supplier. Then, the PD Consumer sends a query. The consumer is expected to query with a Patient identifier

Field RCP-2 should contain the value 10^RD or a higher number. This will allow a response with all records. There are later tests for limiting the number of records in a response.
No other query keys should be present.

What if my application does not make this query?

The PDQ profile does not demand specific queries of consumers. If this is not a natural query for your application, submit a note (.txt file) that briefly explains why your system would not make this query and list queries that your system does make.

References

ITI TF-2: 3.21

Instructions

To run this test, follow these steps using a DOS window or terminal emulator:

1. Set the current directory to $MESA_TARGET/mesa_tests/iti/actors/pd_consumer.
2. The file pd_consumer.cfg describes the MESA servers for this test. You should be aware of this file but should not modify it unless you have problems starting the MESA servers.
3. Make sure the MESA servers have been started. See Starting the MESA Servers for details.
4. Load the MESA PD Supplier with data as described in Loading MESA PD Supplier (if not already done).
5. Run the test script as follows:

     perl  scripts/pdc_pdq.pl 11350 <log level>

where <log level> is a value between 1 and 4.

6. The test script will send several A04 registration messages to the MESA Patient Demgraphics Supplier. After the A04 messages, your system is prompted to send one Patient Demographics Query.

Evaluation

To evaluate your response to this test:

1. Run the evaluation script

     perl  11350/eval_11350.pl <log level>

2. The output file is 11350/grade_11350.txt. This test is successfully completed when the last line in the output file indicates 0 errors.
3. Submit the grade file at log level 4 to the Project Manager. The Project Manager may examine the file and require you to modify your query and/or to perform additional queries.

Supplemental Information

1. If you want to see a query generated by a MESA PD Consumer, run test 11350 in self test mode. Then run the evaluation as above and examine the grade file. To run in self test mode:

     perl  scripts/pdc_pdq.pl 11350 4 self

     QRY_PDQ_1001^Query  By Name^IHEDEMO

     perl  scripts/pdc_pdq.pl 11355 <log level>

     perl  11355/eval_11355.pl 4

     perl  scripts/pdc_pdq.pl 11355 4 self

Test Case 11360: Attending Doctor

Not implemented in this release.
In test 11360, a Patient Demographics Consumer is required to send a Patient Demographics and Visit Query Search.
No other query keys should be present.
Field RCP-2 should contain the value 10^RD or a higher number. This will allow a response with all records. There are later tests for limiting the number of records in a response.
QPD-1 (Message Query Name) is a field that the Supplier needs to be able to configure on a site specific basis. For these tests, set the value to

     QRY_PDQ_1001^Query  By Name^IHEDEMO

References

ITI TF-2: 3.22

Instructions

To run this test, follow these steps using a DOS window or terminal emulator:

1. Set the current directory to $MESA_TARGET/mesa_tests/iti/actors/pd_consumer.
2. The file pd_consumer.cfg describes the MESA servers for this test. You should be aware of this file but should not modify it unless you have problems starting the MESA servers.
3. Make sure the MESA servers have been started. See Starting the MESA Servers for details.
4. Load the MESA PD Supplier with data as described in Loading MESA PD Supplier (if not already done).
5. Run the test script as follows:

     perl  scripts/pdc_pdq.pl 11360 <log level>

where <log level> is a value between 1 and 4.

6. Your system is prompted to send one Patient Demographics Query.

Evaluation

To evaluate your response to this test:

1. Run the evaluation script

     perl  11360/eval_11360.pl 4

2. The output file is 11360/grade_11360.txt. This test is successfully completed when the last line in the output file indicates 0 errors.
3. Submit the grade file to the Project Manager. The Project Manager may examine the file and require you to modify your query and/or to perform additional queries.

Supplemental Information

1. The evaluation script takes a single argument, <log level>. When debugging output, it is sometimes helpful to use a log level of 1 to see only differences. When submitting results, we prefer the output with the most verbose level, 4.
2. If you want to see a query generated by a MESA PD Consumer, run test 11360 in self test mode. Then run the evaluation as above and examine the grade file. To run in self test mode:

     perl  scripts/pdc_pdq.pl 11360 4 self

     perl  scripts/pdc_pdq.pl 11365 <log level>

     perl  11365/eval_11365.pl 

     perl  scripts/pdc_pdq.pl 11365 4 self

Test Cases: PAM

This section describes test cases that are generally associated with the PAM Integration Profile. There may be some overlap with other profiles.

     perl  scripts/pdc_pam.pl 12101 <log level> 

Test Case 12102: PAM Update Patient Information

References

ITI TF Supplement 2005 - 2006

Instructions

To run this test, follow these steps using a DOS window or terminal emulator:

1. Read the document “IHE IT Infrastructure Test Cases” for a description of the transactions used for this test. Your system is required to receive the administration messages described in that document.
2. Set the current directory to $MESA_TARGET/mesa_tests/iti/actors/ pd_consumer.
3. Make sure the MESA servers have been started as described in Starting the MESA Servers above.
4. Run the test script as follows:

     perl  scripts/pdc_pam.pl 12102 <log level> 

where <log level> is a value between 1 (low) and 4 (high).

5. Accept the A28 message that sends Patient Demographics and A31 that sends Updated Patient Demographics to your system . The intention of the transaction is that you will use this information in further transactions, but that is not specified. Perform a screen capture of a database dump, your system user interface or other evidence that you have received both these messages. Submit the screen captures to the Project Manager.

Evaluation

Supplemental Information