https://github.com/josephbartlett/hl7-message-analyzer
HL7 Message Analyzer is a single-page, browser-based tool for visualizing HL7 v2.x messages. It parses raw HL7 text into color-coded segments, highlights fields/components, flags non-printable characters, and offers ASCII view, segment jumping, and copyable output—all client-side, no server required.
https://github.com/josephbartlett/hl7-message-analyzer
adt analyzer ascii clinical-data health-it healthcare hl7 hl7-v2 hl7v2 interface-engine interoperability mllp msh obx orm oru parser pid viewer web-tool
Last synced: 12 days ago
JSON representation
HL7 Message Analyzer is a single-page, browser-based tool for visualizing HL7 v2.x messages. It parses raw HL7 text into color-coded segments, highlights fields/components, flags non-printable characters, and offers ASCII view, segment jumping, and copyable output—all client-side, no server required.
- Host: GitHub
- URL: https://github.com/josephbartlett/hl7-message-analyzer
- Owner: josephbartlett
- License: mit
- Created: 2024-12-19T16:32:43.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-15T22:39:52.000Z (20 days ago)
- Last Synced: 2026-01-16T01:52:26.329Z (20 days ago)
- Topics: adt, analyzer, ascii, clinical-data, health-it, healthcare, hl7, hl7-v2, hl7v2, interface-engine, interoperability, mllp, msh, obx, orm, oru, parser, pid, viewer, web-tool
- Language: HTML
- Homepage: https://hl7tools.io/hl7-message-analyzer.html
- Size: 42 KB
- Stars: 5
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Roadmap: ROADMAP.md
Awesome Lists containing this project
README
# HL7 Message Analyzer
A sleek, lightweight tool to parse and analyze raw HL7 messages. Paste your HL7 content, hit "Parse HL7," and instantly transform complex segments into a readable, well-structured output.
See the [project roadmap](ROADMAP.md) for upcoming milestones.
## Features
- **One-Click Parsing:** Paste an HL7 message and parse it with a single click.
- **Segment Highlighting:** HL7 segments are distinctly colored, making it easy to identify MSH, PID, OBR, OBX, ORC, PV1, and more.
- **Field & Component Breakdown:** Hover over fields, components, and subcomponents to highlight their boundaries. Subcomponents are displayed in pink for clarity.
- **Non-Printable Characters:** Easily spot and understand non-printable characters, displayed with their hex codes and highlighted in yellow for visual distinction.
- **ASCII View:** Toggle an ASCII-view panel that shows raw character codes for deeper inspection. The ASCII view panel also allows users to click characters in the parsed output to highlight them in the ASCII view.
- **Segment Navigation:** Quickly find and jump to specific HL7 segments.
- **Copy to Clipboard:** Easily copy the formatted output for use elsewhere.
## How to Use
1. Open the tool in your browser.
2. Paste your raw HL7 message into the provided text area.
3. Click the "Parse HL7" button.
4. Review the parsed segments. Hovering over fields, components, and subcomponents highlights them.
5. Use navigation features:
- **Find Segment:** Enter a segment type (e.g., MSH, PID) to jump directly to those segments.
- **ASCII View:** Click "Show ASCII View" to see the raw ASCII codes for each character. Clicking characters in the parsed output highlights them in ASCII view.
6. Click "Copy" to copy the parsed output.
## Running Locally
Simply open `hl7-message-analyzer.html` in your browser. No server required.
## Localization
Localization support is under research and not yet available.
## Roadmap
Current milestones focus on a command-line interface and export options. Localization remains a future milestone that requires further research. See [ROADMAP.md](ROADMAP.md) for the full roadmap.
## Contributing
Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on submitting issues and pull requests.