Skip to content

Before Running the DICOM Tutorial

Before you start the DICOM tutorial, please make sure that you have completed the following:

Note

This tutorial assumes that the QIE server has been installed and configured and that you have been given a QIE username and password with privileges to create and modify QIE channels. Please refer to the QIE Install Guide for instructions on how to complete these steps if they have not already been completed.

Complete the QIE Tutorial First

This tutorial assumes you are familiar with the QIE console, channels, source and destination nodes, mapping nodes, and the JavaScript editor. If you have not yet completed the QIE Tutorial, do that first. The DICOM tutorial builds on the same channel-construction patterns.

Choose an AE Title and Port for Your Listener

Every DICOM device on the network is identified by an Application Entity Title (AE Title) and a port number. The AE Title is a short identifier (up to 16 characters from A-Z, 0-9, and underscore) that the sending DICOM device uses to address your QIE listener.

Pick a value before you start the build, for example QIE_LISTENER on port 11112. Make a note of both; you enter them when you configure the channel's source node.

Note

The AE Title and port you choose for your listener must match what the sending DICOM device is configured to use. Coordinate with the team that owns the sending device.

Choose an Outbound AE Title for the Forwarding Destination

The passthrough channel you build in Chapter 3 forwards each received DICOM message to a second DICOM endpoint. Decide which device you forward to and confirm the following with the team that owns it:

  • Host or IP address
  • Port
  • AE Title of the destination device
  • Whether the destination requires TLS and, if so, which certificate it accepts

If you do not have a real second DICOM endpoint available for the tutorial, you can install a free DICOM toolkit such as dcmtk's storescp on your local workstation to act as a receiver.

Have a Sample DICOM File Available

Several steps in this tutorial use a sample DICOM file to test the channel. Any standards-compliant DICOM file works: a single CT image, X-ray, or other modality output. Save it somewhere on the QIE server (for example, C:\DICOM\samples\sample.dcm) so you can use it when you populate the source node's sample messages.

Have a Certificate Available for the Deidentification Chapter

Chapter 4 (Deidentification) uses a public/private key pair stored in QIE's Certificate Management page to encrypt and decrypt patient identifiers. If you do not already have a certificate uploaded for this purpose, the tutorial walks you through generating one.