MESA/Patient Demographics Consumer

Patient Demographics Consumer

Introduction

This document describes test cases and software for the Patient Demographics Consumer actor in the PDQ and PAM profiles. These are based on HL7 Version 2 messages. The HL7 V3 PDQ tests are described in a different document.

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.

Name	Value
XDS2005	&1.3.6.1.4.1.21367.2005.1.1&ISO

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:

TEST_PDC_PAM_HOST	pdc
TEST_PDC_PAM_PORT	3800

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:

   1. cd $MESA_TARGET/mesa_tests/iti/actors/pd_consumer
   2. scripts/start_mesa_servers.csh 

To stop the servers:

   1. scripts/stop_mesa_servers.csh 

The start instructions for MESA tools on a Windows system are:

   1. cd %MESA_TARGET%\mesa_tests\iti\actors\pd_consumer 
   2. scripts\start_mesa_servers.bat 

To stop the MESA servers:

   1. scripts\stop_mesa_servers.bat 

Installation Test

Run test 1 as documented in the Installation Manual.

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

This is a one time setup that should be run before the first test. It does not have to be run in between tests.

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.

11311: Exact Name Search

Test case 11311 covers an exact name search 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 by exact patient name:

   PID.5.1.1 = MOORE
   PID.5.2 = CHIP

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.

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.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 above (if not already done).

5. Run the test script as follows:

   perl scripts/pdc_pdq.pl 11311 <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 11311/eval_11311.pl 4

2. The output file is 11311/mir_mesa_11311.xml. This test is successfully completed when the output file indicates 0 errors.

3. Submit the grade file to the Project Manager (Kudu or Gazelle). The Project Manager may examine the file and require you to modify your query and/or to perform additional queries.

Supplemental Information

If you want to see a query generated by a MESA PD Consumer, run test 11311 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 11311 4 self

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:

   PID.5.1.1 = ZEBRA

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.

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.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 above (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

11315: Partial Name Search

Test case 11315 covers a partial name search 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 partial name

   PID.5.1.1 = MOO*

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.

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^IHE PDQ Query^IHEDEMO

When querying a vendor system, you may need different wildcard characters (or no wildcard characters).

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 above (if not already done).

5. Run the test script as follows:

   perl scripts/pdc_pdq.pl 11315 <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 of your user interface that shows the result of the query. The MESA PD Supplier should return several records.

Evaluation

To evaluate your response to this test:

1. Run the evaluation script

   perl 11315/eval_11315.pl 4

2. The output file is 11315/mir_mesa_11315.xml. This test is successfully completed when the last line in the output file indicates 0 errors.

3. Name the screen capture of the results window <SYSTEM>_11315_response.<ext> where <ext> is the appropriate file extension.

4. Submit the grade file and screen capture 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 If you want to see a query generated by a MESA PD Consumer, run test 11315 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 11315 4 self

11316: Load DEC PDQ Demographics

Test 11316 is used for systems in the DEC profile (or others) that need special demographics. This test loads demographics into the MESA PD Supplier and then allows the system to query for those demographics for use in other tests.

That is, you only use this test to load demographics into the MESA PD supplier. You will have other tests that require you to obtain the demographics and use them in a different context.

References

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:

   perl scripts/pdq.pl 113aa 1 x

This loads the MESA supplier with data. You should not have to run this script again.

Evaluation

There is no evaluation for this test. You run other tests in other profiles and use the data from this load step.

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

   PID.3.1 = PDQ113XX05

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.

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^IHE PDQ Query^IHEDEMO

The field QPD-8 should be left empty.

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 above (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 4

2. The output file is 11320/mir_mesa_11320.xml. 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 (Kudu/Gazelle). The Project Manager may examine the file and require you to modify your query and/or to perform additional queries.

Supplemental Information 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

11325: Complete ID Search - Single Domain

Test case 11325 covers a complete ID search within a single domain that is specified by the PD 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

   PID.3.1 = PDQ113XX02

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.

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

The field QPD-8 should have the value “^^^&1.3.6.1.4.1.21367.2005.1.1&ISO” to specify that domain in the response.

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 above (if not already done).

5. Run the test script as follows:

   perl scripts/pdc_pdq.pl 11325 <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 11325/eval_11325.pl 4

2. The output file is 11325/mir_mesa_11325.xml. 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 (Kudu/Gazelle). The Project Manager may examine the file and require you to modify your query and/or to perform additional queries.

Supplemental Information If you want to see a query generated by a MESA PD Consumer, run test 11325 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 11325 4 self

11330: Complete ID Search - Multiple Domains

Not implemented in this release.

11335: Partial ID Search - Single Domain

Test case 11335 covers a partial ID search within a single domain that is specified by the PD 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

   PID.3.1 = PDQ113*

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.

No other query keys should be present.

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

The field QPD-8 should have the value “^^^&1.3.6.1.4.1.21367.2005.1.1&ISO” to specify that domain in the response.

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 above (if not already done).

5. Run the test script as follows:

   perl scripts/pdc_pdq.pl 11335 <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 11335/eval_11335.pl 4

2. The output file is 11335/mir_mesa_11335.xml. 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 (Kudu/Gazelle). The Project Manager may examine the file and require you to modify your query and/or to perform additional queries.

Supplemental Information If you want to see a query generated by a MESA PD Consumer, run test 11325 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 11335 4 self

11340: Date of Birth Search

Not implemented in this release.

11345: Age Range Search Search

Not implemented in this release.

The mechanism for this is not defined in the ITI TF.

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

   PID.5.1.1 = MOORE
   PID.7.1 = 19380224

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.

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

The field QPD-8 should have the value “^^^&1.3.6.1.4.1.21367.2005.1.1&ISO” to specify that domain in the response or can be left empty.

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 above (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. 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 4

2. The output file is 11350/mir_mesa_11350.xml. 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 (Kudu/Gazelle). The Project Manager may examine the file and require you to modify your query and/or to perform additional queries.

Supplemental Information 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

11355: Multi Key Search 2

Not implemented in this release.

11360: Attending Doctor

Not implemented in this release.

11365: Continuation Test 1

Test 11365 is a test of the HL7 Continuation Protocol. In this test, a Patient Demographics Consumer needs to configure their request with a specific limit and successfully process the response from the PD Supplier.

   PID.5.1.1 = MOO*

No other query keys should be present.

Field RCP-2 should contain the value 1^RD to indicate one record per 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

The field QPD-8 should have the value “^^^&1.3.6.1.4.1.21367.2005.1.1&ISO” to specify that domain in the response or can be left empty.

The evaluation script will examine your query, but will not examine the intermediate and subsequent queries sent by your system. If you do not send the proper continuation data, the MESA server will not respond and will log information in the MESA log messages.

References

ITI TF-2: 3.21.4.1.2.3.2

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 above (if not already done).

5. Run the test script as follows:

   perl scripts/pdc_pdq.pl 11365 <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 11365/eval_11365.pl 4

2. The output file is 11365/mir_mesa_11365.xml. 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 (Kudu/Gazelle). The Project Manager may examine the file and require you to modify your query and/or to perform additional queries.

Supplemental Information If you want to see a query generated by a MESA PD Consumer, run test 11365 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 11365 4 self

13370: PDQ - Pediatric Demographics Option Support

References

ITI TF-2: 3.21.4.1.2.2.1

Instructions

There is no MESA software required for this test.

1. Create a text file which answers the following:

(a) The Pediatric Demographics option in the PDQ profile specifies eight demographic fields to be supported to aid in record matching. Please list which of these fields your system is capable of sending values for in the ITI-21 (or ITI-22) PDQ Query we will see from your system at the Connectathon:

- PID.3 Patient Identifier List

- PID.5 Patient Name

- PID.6 Mother's Maiden Name (required by the Pediatric Demographics option)

- PID.7 Date/Time of Birth

- PID.8 Administrative Sex

- PID.11 Patient Address

- PID.13 Patient Home Phone Number (required by the Pediatric Demographics option)

- PID.18 Patient Account Number

2. Upload the text file into the connectathon webtool as the results for this test.

Evaluation

The Project Managers will use these results for Connectathon planning.

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.

12101: PAM Create New Patient

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 section 1.4 above.

4. Run the test script as follows:

   perl scripts/pdc_pam.pl 12101 <log level> 

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

5. Accept the A28 message that sends 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 this demographic information in the message. Submit the screen capture to the Project Manager (Kudu, Gazelle).

You are trying to demonstrate that you have proper demographics (Name, Patient ID, Sex, DOB, Address, etc.)

Evaluation

Submit a screen capture that shows some evidence that you have accepted the A28 message from the MESA software and processed that message.

Supplemental Information

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 section 1.4 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.

You are trying to demonstrate that you have proper demographics (Name, Patient ID, Sex, DOB, Address, etc.)

Evaluation

Submit a screen capture that shows some evidence that you have accepted the A28 and A31 message from the MESA software and processed these messages.

Supplemental Information

12103: PAM Load DEC Demographics

References

Instructions

The purpose of this test is to load demographics into a PD Consumer that will be used in a later test. There is no evaluation for this test. It merely sends ADT messages to the PD Consumer.

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. Make sure the MESA servers have been started as described in section 1.4 above.

3. Run the test script as follows:

   perl scripts/pdc_pam.pl 12103 <log level> 

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

4. Accept the A28 messages that send Patient Demographics to your system.

Evaluation

Supplemental Information