MESA/Importer
The test definitions on this page are RETIRED, but are kept here, for now, as an archive. |
MESA/Importer
Importer Tests
Introduction
This document lists a number of tests for Importer systems. You may not be responsible for all of these tests. Please refer to the Connectathon web tool to list the required tests for your system. The web address of this tool depends on the year and project manager. Please contact the appropriate project manager to obtain this information.
Message Attributes
Message Values
Configuration
The Importer scripts use an ASCII configuration file to identify parameters such as host names and port numbers. The configuration file is named imp_test.cfg and is included in the directory $MESA_TARGET/mesa_tests/rad/actors/importer. Edit the file and change entries (host name, port number) which pertain to your system. Your system is identified by entries that begin with TEST. For IHE Basic Security tests, all messages are exchanged using TLS. MESA servers are run on the same ports but with the TLS option. The configuration file that identifies your information is imp_secure.cfg. This separate file allows you to use different port numbers for secure and standard configurations. You may decide to use the same port numbers for both types of communication. The MESA software will only use all secure or all standard communication for a test; we do not mix communication protocols. This version of the software assumes the AE title of your Importer is IMPORTER1. That will be the Scheduled AE title and the AE title we assume you use when you send images, mpps events and storage commitment requests. Please use this AE title for your Importer. Importers will communicate with two MESA servers during these tests. Parameters for the tests are listed below. Worklist queries should be sent to the MESA MWL Server. All other messages (storage, storage commitment, MPPS) should be sent to the MESA Image Manager. The file $MESA_TARGET/runtime/imgmgr/ds_dcm.cfg is used to configure the MESA Image Manager . The only parameter users should change is the LOG_LEVEL value. Log levels are defined in the "Starting MESA Servers" section below. DICOM configuration parameters are listed in the table below.
System | Application Entry Title | Port |
---|---|---|
MESA Image Manager | MESA_IMG_MGR | 2350 |
MESA MWL Server | MESA_MWL | 2250 |
MESA Audit Record Repository | 4000 |
There is a one-time setup step to run before any tests are started. DICOM UIDs and other identifiers have seed values which are stored in the MESA databases. You should reset the UIDs one time before you start the tests. If you decide to rerun tests, you should not have to reset the UIDs. If you decide to reload the Modality Worklist, you will get different Study Instance UIDs (which is probably the behavior that you want).
To set the UIDs for the first time or reset them at a later time:
perl scripts/reset_uids.pl
Starting the MESA Servers
These instructions assume you are using a terminal emulator on Unix systems or an MS DOS command window under Windows NT. Each test uses a command line interface; there is no graphical user interface. Before you start the test procedure, you need to start the MESA Order Placer and MESA Order Filler servers. Make sure the appropriate database is running (PostgreSQL, SQL Server). To start the MESA servers:
1. Enter the Importer exam folder: mesa_tests/rad/actors/importer 2. Execute the appropriate script to start the servers:
scripts/start_mesa_servers.csh (Unix)
scripts\start_mesa_servers.bat (Windows)
Log levels are set for the MESA Image Manager in the file: $MESA_TARGET/runtime/rpt_manager/ds_dcm.cfg.' / Log levels are:
0. no logging
1. errors
2. warnings
3. verbose
4. conversational (really verbose)
When you are finished running one or more tests, you can stop the servers:
scripts/stop_mesa_servers.csh (Unix)
scripts\stop_mesa_servers.bat (Windows)
Log files are stored in $MESA_TARGET/logs.
For the security tests, the MESA servers are started with different scripts. These are scripts/start_mesa_secure.csh and scripts\start_mesa_secure.bat. The log levels are the same as for the standard tests. The MESA servers are stopped using these scripts: scripts/stop_mesa_secure.csh and scripts\stop_mesa_secure.bat.
Loading Test Data
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: Importer
These test cases are associated with the Radiology Import Reconciliation Workflow (IRWF) profile
Test 251: Storage Commitment Association Negotiation
This is a test of association negotiation with your Importer. An Image Manager that wants to send Storage Commitment N-Event reports will initiate a DICOM association with your Imorter and should propose to be an SCP of the Storage Commitment SOP Class (Push Model). In this test, one association will be proposed. The MESA Image Manager proposes the SCP role. Your modality should accept this association and proposed presentation context.
References
Instructions
1. Start your server process that accepts Image Manager Storage Commitment association requests.
2. Run the evaluation script for this test. This script sends the appropriate association requests and records results in 251/grade_251.txt:
perl 251/eval_251.pl [-v]
3. The evaluation output is found in 251/mir_mesa_251.xml. The final result should indicate 0 errors. Submit the result run at log level 4 to the Project Manager. For pre-Connectathon tests, this normally means uploading the XML file into the Kudu or Gazelle tool.
Supplemental Information
Test 283: DICOM Composite Object Evaluation – DVT
NOTE: This test is not yet available in the importer directory; you must run this test from the MESA_TARGET/rad/actors/mod directory
In this test, you evaluate samples of Composite Objects that you create using the Agfa/Philips DVT. The number of evaluations you run depends on the types of images that you import/produce. We will not list specific requirements, but ask you to apply good judgment. You need to evaluate and provide the output for at least one DICOM Composite Object. Evaluating other objects can only help your implementation.
References
Instructions
1. Produce a DICOM Part 10 file containing your composite object for evaluation.
2. Run the evaluation script for test 283 as follows:
perl 283/eval_283.pl <output level> <path to file>
3. The output is stored in 283/grade_283.txt. Submit the file to the Project Manager for evaluation.
Evaluation
Supplemental Information
Test 283 assumes you have installed the DVT on a Windows system. You may elect not to run this test, but you will be required to run test 284. If you choose not to run this test, create a file with a message that indicates you have chosen to run test 284 and submit that file as the results for test 283.
Test 284: DICOM Composite Object Evaluation – DICOM3TOOLS
NOTE: This test is not yet available in the importer directory; you must run this test from the MESA_TARGET/rad/actors/mod directory
In this test, you evaluate samples of Composite Objects that you create using the Dave Clunie DICOM3TOOLS. The number of evaluations you run depends on the types of images that you import/produce. We will not list specific requirements, but ask you to apply good judgment. You need to evaluate and provide the output for at least one DICOM Composite Object. Evaluating other objects can only help your implementation.
References
Instructions
1. Produce a DICOM Part 10 file containing your composite object for evaluation.
2. Run the evaluation script for test 283 as follows:
perl 284/eval_284.pl <output level> <path to file>
3. The output is stored in 284/grade_284.txt. Submit the file to the Project Manager for evaluation.
Evaluation
Supplemental Information
Test 284 assumes you have installed the MESA tools on a Unix system. You may elect not to run this test, but you will be required to run test 283. If you choose not to run this test, create a file with a message that indicates you have chosen to run test 283 and submit that file as the results for test 284.
Test Case 3705: MWL Test for Scheduled Import Option
This test case exercises the MWL SCU capabilities of the Importer actor for those Importer actors supporting the Scheduled Import Option in the IRWF profile. The Importer’s requirements for transaction RAD-5 are the same as those for an Acquisition Modality in Scheduled Workflow.
References
RAD TF-2: 4.5.4.1.2.2
Instructions
<this test is intented to test the Importer’s ability to query the DSS/OF for MWL. It is not implemented yet.>
Evaluation
Supplemental Information
Test Case 3720: Importer (portable media) Coerces Attributes – Unscheduled Import Option
<This test is not yet implemented in the MESA tools.>
Test Case 3720 involves transactions for the patient GOLDENROD^G for the Unscheduled Import Option in the IRWF profile. If you import scanned film or documents, you should run test 3721 instead. Importers will query the Patient Demographics Supplier, import a DICOM study from portable media, or via the network, coerce attributes as required, and store the resulting DICOM objects to the Image Manager, with associated PPS messages. Storage Commitment is covered in a different test. In this test, the Patient ID (3720) and Date of Birth received in the query response differs from that in the DICOM objects imported from portable media.
References
RAD TF-1: 21.3.1.3 and RAD TF-2: Appendix A.2
Instructions
To run this test, follow these steps:
Create the DICOM CD/DVD that will be imported. The CD image may be found at XXX. Make sure the MESA servers have been started as described in the Starting the MESA Servers section above. From the $MESA_TARGET/mesa_tests/rad/actors/importer directory, run the following script:
perl scripts/imp_irw.pl 3720
Evaluation
To evaluate this test run:
perl 3720/eval_3720.pl <log> <IMP AE title>
Supplemental Information
Test Case 3725: Importer Coerces Attributes – Scheduled Import Option
Test Case 3725 involves transactions for the patient VIOLET^V for the Scheduled Import Option in the IRWF profile. If you import scanned film or documents, you should run test 3726 instead.
Importers will query for modality worklist, import a DICOM study from portable media or via the network, coerce attributes as required, and store the resulting DICOM objects to the Image Manager, with associated PPS messages. Storage Commitment is covered in a different test.
In this test, the Patient ID (3725) and Date of Birth received in the MWL differ from that in the DICOM objects imported from portable media. That is part of the test; use the data from the MWL entry to coerce the data from the CD.
The test steps below reference the ISO image of the IRWF-FUSION-2006 CD. This CD is located with the MESA software distribution. It contains more than one study (and is therefore a good test of your ability to import selected data from a CD).
References
RAD TF-1:21.3.1.2 RAD TF-1:Appendix A.2
Instructions
To run this test, follow these steps:
1. If you are importing from digital media, create the DICOM CD/DVD that will be imported. The ISO image containing the study for this test may be found on the IRWF-FUSION-2006 CD located on the MESA software distribution page.
2. Make sure the MESA servers have been started as described in the Starting the MESA Servers section above.
3. From the $MESA_TARGET/mesa_tests/rad/actors/importer directory, run the following script:
perl scripts/imp_irw.pl 3725 <log_level>
Evaluation To evaluate this test run:
perl 3725/eval_3725.pl <log_level: 1-4> <AE title of your MPPS SCU>
Supplemental Information
If you are a digitizer, you will not run this test, but you will be required to run test 3726. If you do not run this test, create a file with a message that indicates you are a digitizer which will run test 3726 and submit that file as the results for test 3725.
Test Case 3726: Importer (digitizer) Coerces Attributes – Scheduled Import Option
Test Case 3726 involves transactions for the patient LAVENDER^L for the Scheduled Import Option in the IRWF profile. If you import DICOM objects, eg from portable media such as CD, or via the network you should run test 3725 instead.
For this test, you should assume: - the original Patient Name on the scanned film/document is VIOLET^V - the original Patient ID on the scanned film/docment is 9999 You will be expected to include these values in the Modified Attributes Sequence (0400,0550).
Importers will query for modality worklist, scan a film or document, coerce the attributes as required, and store the resulting DICOM objects to the Image Manager, with associated PPS messages. Storage Commitment is covered in another test.
References
RAD TF-1: 21.3.1.2 and RAD TF-2: Appendix A.2
Instructions
To run this test, follow these steps:
1.Use your application to scan one film or document.
2.Make sure the MESA servers have been started as described in the Starting the MESA Servers section above.
3.From the $MESA_TARGET/mesa_tests/rad/actors/importer directory, run the following script:
perl scripts/imp_irw.pl 3726 <log_level>
Evaluation
To evaluate this test run:
perl 3726/eval_3726.pl <log_level: 1-4> <AE title of your MPPS SCU>
Supplemental Information
If you are a an Importer which imports via the network or portable media, you will not run this test, but you will be required to run test 3725. If you do not run this test, create a file with a message that indicates you are not a digitize, so will run test 3725, and submit that file as the results for test 3726.
Test Case 3739: PPS Exception Management – abandoned import – unscheduled
<This test is not yet implemented in the MESA tools.>
This tests the behavior of the Importer when the operator abandons the import after storing one object to the Image Manager, and then discontinues the PPS. This test is for Importers which support the Unscheduled Import Option.
References
RAD TF-2: 21.3.2 RAD TF-3: 4.60.4.1.2.2
Instructions
To run this test, follow these steps:
1. Use your DICOM application to import two DICOM objects from CD or via the network, or digitize 2 films or documents from hardcopy.
2. From the $MESA_TARGET/mesa_tests/rad/actors/importer directory, run the following script:
perl scripts/imp_irw.pl 3739 <log_level>
Evaluation
To evaluate this test run:
perl 3739/eval_3739.pl <log_level: 1-4> <AE title of your MPPS SCU>
Supplemental Information
Test Case 3740: PPS Exception Management – abandoned import - scheduled
This tests the behavior of the Importer when the operator abandons the import after storing one object to the Image Manager, and then discontinues the PPS. This test is for Importers which support the Scheduled Import Option. If you support the Unscheduled Import Option, you should run test 3739 instead.
References
RAD TF-2: 21.3.2 RAD TF-3: 4.60.4.1.2.2
Test description/steps for test 3740.
Instructions
To run this test, follow these steps:
1. Use your DICOM application to import at least two DICOM objects from CD or via the network, or digitize 2 films or documents from hardcopy.
2. Make sure the MESA servers have been started as described in the Starting the MESA Servers section above.
3. From the $MESA_TARGET/mesa_tests/rad/actors/importer directory, run the following script:
perl scripts/imp_irw.pl 3740 <log_level>
Evaluation
To evaluate this test run:
perl 3740/eval_3740.pl <log_level: 1-4> <AE title of your MPPS SCU>
Supplemental Information
Test Case 3741: PPS Exception Management – incorrect patient selected from list - unscheduled
<This test is not yet implemented in the MESA tools.>
This tests the behavior of the Importer when the operator realizes, after storing one object to the Image Manager, that the wrong patient was selected from the list received from the Patient Demographic Supplier. After the PPS is discontinued, the Importer selects the correct patient, reconciles the imported objects and stores them to the Image Manager. This test is for Importers which support the Unscheduled Import Option.
References
RAD TF-2: 21.3.2 RAD TF-3: 4.60.4.1.2.2
Instructions
To run this test, follow these steps:
1. Use your DICOM application to import two DICOM objects from the CD, or digitize 2 from hardcopy.
2. Make sure the MESA servers have been started as described in the Starting the MESA Servers section above.
3. From the $MESA_TARGET/mesa_tests/rad/actors/importer directory, run the following script:
perl scripts/imp_irw.pl 3741 <log_level>
Evaluation
To evaluate this test run:
perl 3741/eval_3741.pl <log_level: 1-4> <AE title of your MPPS SCU>
Supplemental Information
Test Case 3742: PPS Exception Management – incorrect worklist item - scheduled
This tests the behavior of the Importer when the operator realizes, after storing one object to the Image Manager, that the wrong item was selected from the worklist received from the DSS/OF. After the PPS is discontinued, the Importer re-queries the DSS/OF, reconciles the imported objects and stores them to the Image Manager. This test is for Importers which support the Scheduled Import Option.
References
RAD TF-2: 21.3.2 RAD TF-3: 4.60.4.1.2.2
Test description/steps for test 3742.
Instructions
To run this test, follow these steps:
1. Use your DICOM application to import at least two DICOM objects from the CD, or digitize 2 hardcopy films or documents.
2. Make sure the MESA servers have been started as described in the Starting the MESA Servers section above.
3. From the $MESA_TARGET/mesa_tests/rad/actors/importer directory, run the following script:
perl scripts/imp_irw.pl 3742 <log_level>
Evaluation
To evaluate this test run:
perl 3742/eval_3742.pl <log_level: 1-4> <AE title of your MPPS SCU>
Supplemental Information
Test Case 3734: Image Manager rejects imported objects
<This test is not yet implemented in the MESA tools.>
This tests the Importer behavior when the Image Manager fails to store the objects which were imported (ie receives a non-zero (not success) status in response to the C-STORE).
References
Instructions
Evaluation
Supplemental Information
Test Case 3745: Billing and Material Management Option - unscheduled
<This test is not yet implemented in the MESA tools.>
This is derived from Test Case 218 for Acquisition Modalitites.
Test 3745 exercises the Billing and Material Management Option for Importer actors. With this option, a importer actor must provide the Billing Supplies and Devices Sequence in the MPPS message, as specified in RAD TF-3: Table 4.60-2. This test is for Importers which support the Unscheduled Import Option.
References
RAD TF-3: 4.60.4.1.2.3
Instructions
1. Query the PDS for patient Billing^3745
2. Perform one import for the one Patient in the worklist. Generate appropriate MPPS messages and fill in this sequence:
0040 0324 Billing Supplies and Devices Sequence
3. The table below lists the values to supply for the coded items in the sequences
Attribute Name | Tag | Value |
---|---|---|
Billing Procedure Step Seque
Nce |
(0040,0320) | |
>Code Value | (0008,0100) | BP1001 |
>Coding Scheme Designator | (0008,0102) | IHEDEMO |
>Code Meaning | (0008,0104) | Billing Procedure 101 |
>Billing Supplies and Devices Sequence | (0040,0324) | |
Billing Item Sequence | (0040,0296) | |
>>Code Value | (0008,0100) | These values are still TBD from
DICOM |
>> Coding Scheme Designator | (0008,0102) | DCM |
>>Code Meaning | (0008,0104) | See valudes in RAD TF-3: Table 4.60-3. |
>Quantity Sequence | (0040,0293) | |
>>Quantity | (0040,0294) | 1 |
Evaluation
To evaluate your MPPS messages:
perl 3476/eval_3476.pl <log_level: 1-4> <AE title of your MPPS SCU>
Supplemental Information
Test Case 3746: Billing and Material Management Option - scheduled
<This test is not yet implemented in the MESA tools.>
This is derived from Test Case 218 for Acquisition Modalitites.
Test 3746 exercises the Billing and Material Management Option for Importer actors. With this option, a importer actor must provide the Billing Supplies and Devices Sequence in the MPPS message, as specified in RAD TF-3: Table 4.60-2. This test is for Importers which support the Scheduled Import Option.
References
RAD TF-3: 4.60.4.1.2.3
Instructions
1. Query the MESA DSS/OF for patient Billing^3746
2. Perform one import for the one Patient in the worklist. Generate appropriate MPPS messages and fill in this sequence:
0040 0324 Billing Supplies and Devices Sequence
3. The table below lists the values to supply for the coded items in the sequences
Attribute Name | Tag | Value |
---|---|---|
Billing Procedure Step Seque
Nce |
(0040,0320) | |
>Code Value | (0008,0100) | BP1001 |
>Coding Scheme Designator | (0008,0102) | IHEDEMO |
>Code Meaning | (0008,0104) | Billing Procedure 101 |
>Billing Supplies and Devices Sequence | (0040,0324) | |
Billing Item Sequence | (0040,0296) | |
>>Code Value | (0008,0100) | These values are still TBD from
DICOM |
>> Coding Scheme Designator | (0008,0102) | DCM |
>>Code Meaning | (0008,0104) | See valudes in RAD TF-3: Table 4.60-3. |
>Quantity Sequence | (0040,0293) | |
>>Quantity | (0040,0294) | 1 |
Evaluation
To evaluate your MPPS messages:
perl 3476/eval_3476.pl <log level> <AE Title MPPS SCU>
Supplemental Information
Test Case 3750: Instance Availability Notification upon Import
References
Instructions
<This test is not yet implemented in the MESA tools.>
Evaluation
Supplemental Information