HL7 to FHIR
Category: Transform Standards: HL7 v2.x · FHIR R4 · HIPAA
Convert HL7 v2.x messages to FHIR R4 resources
What this node does
- ADT/ORM/ORU mapping
- Custom mappings
- Terminology mapping
- US Core profiles
How to use
- In the Agentic Studio, open or create a workflow
- In the node palette on the left, find HL7 to FHIR under the Transform category (or use the search bar)
- Drag the node onto the canvas
- Double-click the node to open its configuration dialog
- Fill in the required parameters (see Configuration below)
- Connect the HL7 Message input port from an upstream node
- Connect the FHIR Bundle and FHIR Resources output to the next node downstream
Inputs
| Port | Type | Required | Description |
|---|---|---|---|
| HL7 Message | hl7-message | ✓ | An HL7 v2.x message (ADT, ORU, ORM, etc.) |
Outputs
| Port | Type | Description |
|---|---|---|
| FHIR Bundle | fhir-bundle | A FHIR R4 Bundle containing one or more resources |
| FHIR Resources | fhir-resource | A single FHIR R4 resource (Patient, Observation, etc.) |
Configuration
Open the configuration dialog by double-clicking the HL7 to FHIR node on the canvas.
| Parameter | What to enter |
|---|---|
messageType | Configure messageType in the node settings |
mappingTemplate | Configure mappingTemplate in the node settings |
terminologyService | Configure terminologyService in the node settings |
outputProfile | Configure outputProfile in the node settings |
When to use this node
- Convert ADT to Patient/Encounter
- Transform ORU to Observations
- Legacy integration
Need help configuring this node?
Go to Settings → Connectors to set up the connection this node depends on, then reference the connector ID in the node configuration dialog.