hl7-parseme

Tools Used

• Mirth Connect (NextGen Connect): Integration engine for routing HL7 messages
• Python (hl7apy): Script to parse HL7 and convert to JSON
• Sample HL7 Messages: ADT^A01 (Admission) and ORU^R01 (Lab Results)

Project Structure

hl7-parseme/

├── mirth_channels/ # exported Mirth channels

├── python_parser/ # Python parser and sample messages

├── screenshots/ # Mirth screenshots

└── README.md

Message Types

Type	Trigger	Description
ADT^A01	Admit/Visit Notification	Used for patient admissions
ORU^R01	Observation Result	Sends lab or clinical results

How It Works

1. Mirth Connect listens for incoming HL7 messages
2. Messages are routed based on their type (ADT or ORU)
3. Python script converts sample messages to JSON for readability

HL7 -> JSON Watcher

The included Python watcher script (hl7_watcher.py) monitors the Mirth output folders for new HL7 files and automatically converts them to JSON.

Wacther Workflow

1. Mirth receives HL7 ADT or ORU messages.
2. The message is written to disk.
3. The Python watcher detects the new file.
4. It parses the HL7 and saves the JSON version to /json_output.