NEW!

HL7 Radiology Worklist Viewer

Parse HL7 ORM^O01 radiology orders into a DICOM Modality Worklist view. Extract accession numbers, procedures, and HL7-to-DICOM mappings. Free, browser-only.

HIPAA-Compliant by Design

Your medical data never leaves your device. No PHI is transmitted to any server.

HIPAA-Friendly No PHI Transmission Local Processing

Drag files here, paste ORM^O01 text below, or click to select

Supports .hl7, .hl7v2, .txt files containing radiology ORM^O01 orders

Examples:

All parsing happens locally in your browser. Your HL7 messages and PHI never leave your device. HIPAA-compatible.

Keywords

hl7 radiology worklisthl7 orm o01 parserdicom modality worklisthl7 to dicom mappingradiology order parserhl7 obr segment viewerradiology worklist viewer onlinehl7 accession number extractordicom mwl from hl7

Need something else?

How to use

1

Paste one or more HL7 ORM^O01 messages into the text area, or drag and drop .hl7 files. You can also click Load Sample Messages to try with demo data.

2

Click Parse Worklist. The tool splits messages on MSH boundaries, extracts PID, PV1, ORC, and OBR segments, and builds a radiology worklist table.

3

Review the worklist table showing patient name, MRN, accession number, procedure, scheduled date/time, priority (color-coded), ordering physician, and order control status.

4

Click Show Details on any order to see full patient demographics, the complete HL7-to-DICOM Modality Worklist field mapping, and any validation issues detected.

5

Use the search bar to find specific patients or accession numbers. Filter by priority (Stat, Routine, Urgent). Export the worklist or DICOM mapping as CSV for further analysis.

Features

ORM^O01 Multi-Message Parsing

Paste multiple ORM^O01 messages at once — the tool automatically splits on MSH boundaries and parses each message independently, building a unified worklist from all orders found.

HL7-to-DICOM MWL Field Mapping

For each order, the tool generates a detailed mapping table showing how HL7 fields (PID-3, PID-5, OBR-4, OBR-18, OBR-27, ORC-2) translate to DICOM Modality Worklist tags like Patient ID (0010,0020), Accession Number (0008,0050), and Scheduled Procedure Step (0040,0002).

Priority Color-Coding and Filtering

Orders are visually tagged by priority — Stat (red), Urgent (amber), Routine (green) — extracted from OBR-27 Quantity/Timing or OBR-5. Filter the worklist to show only Stat orders for rapid triage.

Validation and Issue Detection

Each order is validated for common problems: missing accession numbers, empty procedure codes, incomplete patient names, missing scheduled dates. Issues appear as inline warnings so you can identify data quality gaps before they reach the RIS or PACS.

CSV Export for Worklist and DICOM Mapping

Export the entire worklist as a CSV spreadsheet, or export the DICOM mapping for a specific order. CSV exports are useful for interface documentation, audit trails, and sharing parsing results with clinical engineering teams.

Why Choose This Tool?

Private by Design — No PHI Leaves Your Browser

Radiology orders contain patient names, MRNs, accession numbers, and procedure details — all Protected Health Information. This tool runs entirely in your browser. No HL7 message data is transmitted to any server, stored in any database, or logged by any analytics platform. Healthcare IT teams can safely analyze production ORM messages on hospital workstations.

Bridges the HL7-to-DICOM Gap

Understanding how HL7 ORM fields map to DICOM Modality Worklist attributes is essential for radiology integration. This tool generates a side-by-side mapping table showing exactly which OBR, PID, PV1, and ORC values become which DICOM tags — making it a practical reference during interface design, RIS configuration, and PACS integration projects.

Catches Data Quality Issues Early

Missing accession numbers, empty procedure codes, and incomplete patient names are the most common causes of MWL mismatches that lead to failed exam associations in PACS. The built-in validation detects these issues at parse time so you can fix them in the sending system before they propagate downstream.

Works With Any HL7 v2.x ORM Engine

Whether your orders come from Epic, Cerner, MEDITECH, Allscripts, or a custom EHR, the tool parses standard HL7 v2.x ORM^O01 messages. It handles common variations in field encoding — XCN name-first vs ID-first formats, TQ priority encoding, and localized procedure codes.

HL7 ORM^O01 and DICOM Modality Worklist: How Radiology Orders Flow from EHR to Scanner

The Radiology Order Workflow

When a physician orders a radiology exam — a CT scan, MRI, X-ray, or ultrasound — the order originates in the Electronic Health Record (EHR) system and must travel through several systems before the patient reaches the scanner. The HL7 ORM^O01 message is the standard transaction that carries this order from the EHR to the Radiology Information System (RIS). The RIS, in turn, populates the DICOM Modality Worklist (MWL), which the imaging modality queries to retrieve patient and exam information. Understanding this chain — EHR → HL7 ORM → RIS → DICOM MWL → Modality — is fundamental for anyone working in healthcare imaging integration.

Anatomy of an ORM^O01 Message

An HL7 ORM^O01 (Order Message) contains several key segments that carry the data needed to build a worklist entry:

  • MSH (Message Header): Identifies the sending and receiving applications, message type (ORM^O01), timestamp, and HL7 version.
  • PID (Patient Identification): Contains the patient's MRN (PID-3), name (PID-5), date of birth (PID-7), and sex (PID-8). These map directly to DICOM Patient ID, Patient Name, Birth Date, and Sex tags.
  • PV1 (Patient Visit): Carries patient class (inpatient, outpatient, emergency), location (PV1-3), attending doctor (PV1-7), and referring physician (PV1-8).
  • ORC (Common Order): Contains the order control code (ORC-1: NW for new, CA for cancel, XO for change), placer order number (ORC-2), and ordering provider (ORC-12).
  • OBR (Observation Request): The core segment for radiology orders. OBR-4 carries the procedure code and description, OBR-16 the ordering physician, OBR-18 the accession number (critical for DICOM study linkage), and OBR-27 the scheduled date/time and priority.

The HL7-to-DICOM Mapping

The RIS transforms HL7 ORM data into DICOM Modality Worklist attributes. Key mappings include:

  • PID-3 → (0010,0020) Patient ID: The MRN becomes the DICOM Patient ID, used by the modality to associate the study with the correct patient record.
  • PID-5 → (0010,0010) Patient's Name: HL7 XPN format (Family^Given^Middle) maps to the DICOM PN (Person Name) value representation.
  • OBR-18 → (0008,0050) Accession Number: This is the critical linkage field. The accession number assigned by the RIS uniquely identifies the order and must match between the worklist entry and the acquired DICOM images. Mismatches cause "orphaned studies" that appear in PACS without correct order linkage.
  • OBR-4 → (0032,1060) Requested Procedure Description: The human-readable exam description (e.g., "CT Abdomen with Contrast") populates the worklist entry the technologist sees on the modality screen.
  • OBR-27 → (0040,0002) Scheduled Procedure Step Start Date: The scheduled date/time tells the modality when the exam is expected, enabling worklist filtering by time window.

Common Integration Problems

Most radiology worklist integration issues stem from a small set of recurring data quality problems. Missing accession numbers (OBR-18 empty) mean the RIS cannot generate the DICOM Accession Number tag, leading to studies that cannot be linked to orders. Empty or incorrect procedure codes (OBR-4) result in worklist entries with no exam description, forcing technologists to manually select the protocol. Inconsistent patient IDs between the EHR and RIS cause patient matching failures. And priority encoding differences — some systems use "S" for Stat while others spell out "STAT" in the TQ data type — can lead to urgent studies not being flagged correctly on the modality worklist.

Using This Tool for Interface Analysis

This Radiology Worklist Viewer helps integration analysts and clinical engineers validate the end-to-end data flow by parsing raw ORM messages and showing exactly how the HL7 fields would map to DICOM MWL attributes. By pasting production ORM captures (with PHI safely staying in the browser), teams can verify that accession numbers are present, procedure codes are correctly encoded, patient demographics match, and priorities are properly extracted — catching issues before they cause failed worklist queries or orphaned studies in production PACS systems.

Frequently Asked Questions

What HL7 message types does this tool support?

The tool is designed for HL7 v2.x ORM^O01 (Order Message) transactions, which are the standard message type for radiology order communication. It extracts data from MSH, PID, PV1, ORC, and OBR segments. Other ORM trigger events and ORM-like messages that contain OBR segments will also parse correctly.

Does my HL7 data get sent to a server?

No. All parsing, validation, and DICOM mapping happens locally in your browser using JavaScript. Your HL7 messages — which typically contain patient names, MRNs, accession numbers, and procedure details — never leave your device. No data is transmitted, stored, or logged externally.

What is an accession number and why is it important?

The accession number (OBR-18 in HL7, tag 0008,0050 in DICOM) is a unique identifier assigned to a radiology order. It links the HL7 order to the DICOM study acquired at the modality. If the accession number is missing or incorrect, the PACS cannot associate the images with the correct order, resulting in orphaned or unlinked studies.

How does the HL7-to-DICOM mapping work?

For each parsed order, the tool generates a mapping table showing which HL7 fields (e.g., PID-3, OBR-4, OBR-18) correspond to which DICOM Modality Worklist tags (e.g., Patient ID 0010,0020; Accession Number 0008,0050). This mapping follows the IHE Radiology Scheduled Workflow profile and standard RIS-to-MWL transformation rules.

Can I parse multiple ORM messages at once?

Yes. Paste multiple ORM^O01 messages into the text area — the tool automatically splits on MSH segment boundaries and parses each message independently. The worklist table shows all orders from all messages in a unified view.

What do the priority colors mean?

Stat (red) indicates an emergency or time-critical exam. Urgent (amber) means the exam should be performed soon but is not immediately life-threatening. Routine (green) is a standard scheduled exam. The priority is extracted from OBR-27 (Quantity/Timing) component or OBR-5 (Priority).

What validation checks does the tool perform?

The tool checks for: missing accession number (OBR-18), empty procedure code and description (OBR-4), missing patient name (PID-5), missing MRN (PID-3), missing scheduled date/time (OBR-27/OBR-7), unknown order control codes (ORC-1), and missing ordering physician (OBR-16/ORC-12). Errors and warnings are shown per order.

What is a DICOM Modality Worklist (MWL)?

The DICOM Modality Worklist is a service that imaging modalities (CT scanners, MRI machines, X-ray units) query to retrieve patient and exam information. Instead of technologists manually entering patient demographics at the scanner, the modality pulls this data from the MWL — reducing transcription errors and ensuring DICOM studies are correctly tagged from acquisition.

Does the tool handle ORC cancel orders (CA)?

Yes. The tool recognizes all standard ORC-1 order control codes including NW (New Order), CA (Cancel), XO (Change), SC (Status Change), and others. Cancel orders appear in the worklist with a visual strike-through indicator so you can identify them. The order control label is shown in the table.

Can I export the results?

Yes. You can export the full worklist as a CSV file containing patient name, MRN, accession number, procedure, priority, ordering physician, and validation issues. You can also export the DICOM mapping table for a selected order as a separate CSV. Both exports are useful for interface documentation and audit trails.

Learn more