{ "version": "1.0.0", "exportedAt": "2026-09-02T11:35:21.986Z", "workflow": { "name": "HL7 ADT to FHIR Patient (Example)", "description": "Downloadable Academy example: receives an HL7 v2 ADT^A01 admit message and maps it to a FHIR R4 Patient resource using the bundled mapping project. Synthetic data only." }, "flow": { "tab": { "id": "workflow_96b56641-01c4-485b-b040-cb3cf3a9a28f", "type": "tab", "label": "HL7 ADT to FHIR Patient (Example)", "disabled": false, "info": "Downloadable Academy example: receives an HL7 v2 ADT^A01 admit message and maps it to a FHIR R4 Patient resource using the bundled mapping project. Synthetic data only.", "created": "2026-09-02T10:16:21.714Z" }, "nodes": [ { "id": "cmt_entry", "type": "comment", "z": "workflow_96b56641-01c4-485b-b040-cb3cf3a9a28f", "name": "Two ways to run this: click Inject to test instantly with the built-in message, or configure HL7 In with your own connection for real traffic.", "info": "", "x": 380, "y": 60, "wires": [] }, { "id": "inj_test", "type": "inject", "z": "workflow_96b56641-01c4-485b-b040-cb3cf3a9a28f", "name": "Test with sample ADT^A01", "props": [ { "p": "payload" } ], "repeat": "", "crontab": "", "once": false, "onceDelay": 0.1, "topic": "", "payload": "MSH|^~\\&|EHR|HOSP|RECV|RCVFAC|20240115120000||ADT^A01|MSG0001|P|2.5\rEVN|A01|20240115120000\rPID|1||MRN12345^^^HOSP^MR||Doe^John^A||19800101|M||2106-3^White^CDCREC|123 Main St^^Anytown^CA^90210||5551234567|||M||ACC98765||||N^Not Hispanic^CDCREC\rPV1|1|I|WARD2^R5^B1^MAIN|EL|||DR001^Smith^Jane|||MED||||7^Physician referral|||||VN12345|||||||||||||||||01^Discharged home||||||||20240115120000|20240118130000\rAL1|1|DA^Drug^HL70127|7980^Penicillin^L|SV^Severe|Hives^Urticaria|20230101\rAL1|2|FA^Food^HL70127|E905^Peanuts^L|SV^Severe|Anaphylaxis|20220601\rDG1|1||I10^Essential Hypertension^ICD10|||F", "payloadType": "str", "x": 190, "y": 140, "wires": [ [ "chg_wrap" ] ] }, { "id": "e4a23562fe6ee1ec", "type": "ec-hl7-in", "z": "workflow_96b56641-01c4-485b-b040-cb3cf3a9a28f", "name": "", "integrationId": "", "messageTypes": "", "x": 190, "y": 220, "wires": [ [ "chg_wrap" ] ] }, { "id": "chg_wrap", "type": "change", "z": "workflow_96b56641-01c4-485b-b040-cb3cf3a9a28f", "name": "Wrap payload for HL7 Parser", "rules": [ { "t": "set", "p": "payload", "pt": "msg", "to": "{\"hl7msg\": payload}", "tot": "jsonata" } ], "action": "", "property": "", "from": "", "to": "", "reg": false, "x": 440, "y": 180, "wires": [ [ "hl7_parse" ] ] }, { "id": "hl7_parse", "type": "ec-hl7-parser", "z": "workflow_96b56641-01c4-485b-b040-cb3cf3a9a28f", "name": "Parse HL7 message", "outputField": "parsedInfo", "outputFieldType": "msg", "x": 680, "y": 180, "wires": [ [ "dbg_parsed", "chg_restore" ] ] }, { "id": "cmt_parser", "type": "comment", "z": "workflow_96b56641-01c4-485b-b040-cb3cf3a9a28f", "name": "HL7 Parser validates the message and extracts structured patient/metadata info for inspection. The Mapper node below re-reads the original raw text to do the actual field mapping.", "info": "", "x": 600, "y": 100, "wires": [] }, { "id": "dbg_parsed", "type": "debug", "z": "workflow_96b56641-01c4-485b-b040-cb3cf3a9a28f", "name": "Parsed HL7 structure", "active": true, "tosidebar": true, "console": false, "tostatus": false, "complete": "parsedInfo", "targetType": "msg", "statusVal": "", "statusType": "auto", "x": 980, "y": 180, "wires": [] }, { "id": "chg_restore", "type": "change", "z": "workflow_96b56641-01c4-485b-b040-cb3cf3a9a28f", "name": "Restore raw HL7 for Mapper", "rules": [ { "t": "set", "p": "payload", "pt": "msg", "to": "payload.hl7msg", "tot": "msg" } ], "action": "", "property": "", "from": "", "to": "", "reg": false, "x": 620, "y": 400, "wires": [ [ "d6877544210eccc8" ] ] }, { "id": "d6877544210eccc8", "type": "ec-mapper", "z": "workflow_96b56641-01c4-485b-b040-cb3cf3a9a28f", "name": "", "projectId": "mapping_1f57c0dc-39f4-49b9-9e89-671412b2ade1", "projectName": "HL7 ADT Admission to FHIR Patient", "templateId": "", "inputField": "payload", "inputFieldType": "msg", "outputField": "payload", "outputFieldType": "msg", "x": 940, "y": 400, "wires": [ [ "dbg_output" ] ] }, { "id": "cmt_mapper", "type": "comment", "z": "workflow_96b56641-01c4-485b-b040-cb3cf3a9a28f", "name": "Mapper runs the bundled \"HL7 ADT Admission to FHIR Patient\" mapping project, producing a FHIR R4 Patient resource.", "info": "", "x": 1080, "y": 340, "wires": [] }, { "id": "dbg_output", "type": "debug", "z": "workflow_96b56641-01c4-485b-b040-cb3cf3a9a28f", "name": "FHIR Patient output", "active": true, "tosidebar": true, "console": false, "tostatus": false, "complete": "payload", "targetType": "msg", "statusVal": "", "statusType": "auto", "x": 1260, "y": 400, "wires": [] } ] }, "requirements": [], "mappingProjects": [ { "schemaVersion": 1, "exportedAt": "2026-09-02T11:35:24.289Z", "project": { "id": "mapping_1f57c0dc-39f4-49b9-9e89-671412b2ade1", "name": "HL7 ADT Admission to FHIR Patient", "description": "Example mapping: an HL7 v2 ADT^A01 admit message transformed into a FHIR R4 Patient resource. Synthetic data only.", "templates": [ { "id": "tmpl_30b29bda-8760-42a1-be60-4148d732a065", "triggerEvent": "ADT_A01", "triggerVersion": "2.5", "label": "ADT_A01 - Admission", "sourceType": "hl7v2", "targetType": "json", "mode": "fields", "mappings": [ { "id": "55395a91-a7c6-4b3a-be7c-a6059573457e", "targetPath": "birthDate", "sourceRef": "PID.7", "expression": "{{ firstSegments.PID[7].Value | format_as_date_time }}", "filterRefs": [], "directives": [] }, { "id": "db621379-4991-4049-aafc-b20724521d74", "targetPath": "resourceType", "sourceRef": "PV1.2", "expression": "{{ 'Patient' }}", "filterRefs": [], "directives": [] }, { "id": "cfda8bff-dc85-47c7-b8d0-8232d74d2f94", "targetPath": "identifier[0].value", "sourceRef": "PID.3.1", "filterRefs": [], "directives": [] }, { "id": "ea877181-d673-41f6-a507-d64b4c322e27", "targetPath": "name[0].family", "sourceRef": "PID.5.1", "filterRefs": [], "directives": [] }, { "id": "8f0e7ed5-9cff-4bb8-97a0-6db73f4b2bfa", "targetPath": "name[0].given[0]", "sourceRef": "PID.5.2", "filterRefs": [], "directives": [] }, { "id": "f0b5eb21-2d11-4be3-8555-40081076ca43", "targetPath": "gender", "sourceRef": "PID.8", "filterRefs": [], "directives": [] }, { "id": "ebe769b0-ecfa-4f0f-8a3f-ec36e4fa03cd", "targetPath": "address[0].line[0]", "sourceRef": "PID.11.1", "filterRefs": [], "directives": [] }, { "id": "a5962f16-500b-4c90-835f-2a4cd61fb8a8", "targetPath": "address[0].city", "sourceRef": "PID.11.3", "filterRefs": [], "directives": [] }, { "id": "ae549a78-eeed-46bd-9765-57f4f45d2c65", "targetPath": "address[0].state", "sourceRef": "PID.11.4", "filterRefs": [], "directives": [] }, { "id": "6c43227d-adc2-4203-9570-41c17c099bad", "targetPath": "address[0].postalCode", "sourceRef": "PID.11.5", "filterRefs": [], "directives": [] }, { "id": "e85cff47-cc76-4adf-98e2-14fa1771e031", "targetPath": "telecom[0].value", "sourceRef": "PID.13", "filterRefs": [], "directives": [] } ], "repeatingGroups": [], "targetSchema": [ { "id": "resourceType", "segment": "resourceType", "suggestedName": "Resource Type", "valueType": "string" }, { "id": "identifier[0]", "segment": "identifier", "suggestedName": "Identifier", "children": [ { "id": "identifier[0].system", "segment": "identifier", "suggestedName": "System", "valueType": "string" }, { "id": "identifier[0].value", "segment": "identifier", "suggestedName": "Value", "valueType": "string" } ] }, { "id": "name[0]", "segment": "name", "suggestedName": "Name", "children": [ { "id": "name[0].family", "segment": "name", "suggestedName": "Family", "valueType": "string" }, { "id": "name[0].given[0]", "segment": "name", "suggestedName": "Given", "valueType": "string" } ] }, { "id": "gender", "segment": "gender", "suggestedName": "Gender", "valueType": "string" }, { "id": "birthDate", "segment": "birthDate", "suggestedName": "Birth Date", "valueType": "string" }, { "id": "address[0]", "segment": "address", "suggestedName": "Address", "children": [ { "id": "address[0].line[0]", "segment": "address", "suggestedName": "Line", "valueType": "string" }, { "id": "address[0].city", "segment": "address", "suggestedName": "City", "valueType": "string" }, { "id": "address[0].state", "segment": "address", "suggestedName": "State", "valueType": "string" }, { "id": "address[0].postalCode", "segment": "address", "suggestedName": "Postal Code", "valueType": "string" } ] }, { "id": "telecom[0]", "segment": "telecom", "suggestedName": "Telecom", "children": [ { "id": "telecom[0].system", "segment": "telecom", "suggestedName": "System", "valueType": "string" }, { "id": "telecom[0].value", "segment": "telecom", "suggestedName": "Value", "valueType": "string" } ] } ], "sourceSchema": [ { "id": "MSH", "segment": "MSH", "suggestedName": "Message Header", "children": [ { "id": "MSH.3", "segment": "MSH", "suggestedName": "Sending Application", "valueType": "string" }, { "id": "MSH.4", "segment": "MSH", "suggestedName": "Sending Facility", "valueType": "string" }, { "id": "MSH.5", "segment": "MSH", "suggestedName": "Receiving Application", "valueType": "string" }, { "id": "MSH.6", "segment": "MSH", "suggestedName": "Receiving Facility", "valueType": "string" }, { "id": "MSH.7", "segment": "MSH", "suggestedName": "Date/Time of Message", "valueType": "string" }, { "id": "MSH.9", "segment": "MSH", "suggestedName": "Message Type", "children": [ { "id": "MSH.9.1", "segment": "MSH", "suggestedName": "Message Type", "valueType": "string" }, { "id": "MSH.9.2", "segment": "MSH", "suggestedName": "Trigger Event", "valueType": "string" } ] }, { "id": "MSH.10", "segment": "MSH", "suggestedName": "Message Control ID", "valueType": "string" }, { "id": "MSH.11", "segment": "MSH", "suggestedName": "Processing ID", "valueType": "string" }, { "id": "MSH.12", "segment": "MSH", "suggestedName": "Version ID", "valueType": "string" } ] }, { "id": "EVN", "segment": "EVN", "suggestedName": "Event Type", "children": [ { "id": "EVN.1", "segment": "EVN", "suggestedName": "Event Type Code", "valueType": "string" }, { "id": "EVN.2", "segment": "EVN", "suggestedName": "Recorded Date/Time", "valueType": "string" } ] }, { "id": "PID", "segment": "PID", "suggestedName": "Patient Identification", "children": [ { "id": "PID.1", "segment": "PID", "suggestedName": "Set ID - PID", "valueType": "number" }, { "id": "PID.3", "segment": "PID", "suggestedName": "Patient Identifier List", "children": [ { "id": "PID.3.1", "segment": "PID", "suggestedName": "Patient ID", "valueType": "string" }, { "id": "PID.3.4", "segment": "PID", "suggestedName": "Assigning Authority", "valueType": "string" }, { "id": "PID.3.5", "segment": "PID", "suggestedName": "Identifier Type Code", "valueType": "string" } ] }, { "id": "PID.5", "segment": "PID", "suggestedName": "Patient Name", "children": [ { "id": "PID.5.1", "segment": "PID", "suggestedName": "Family Name", "valueType": "string" }, { "id": "PID.5.2", "segment": "PID", "suggestedName": "Given Name", "valueType": "string" }, { "id": "PID.5.3", "segment": "PID", "suggestedName": "Middle Name/Initial", "valueType": "string" } ] }, { "id": "PID.7", "segment": "PID", "suggestedName": "Date/Time of Birth", "valueType": "string" }, { "id": "PID.8", "segment": "PID", "suggestedName": "Gender", "valueType": "string" }, { "id": "PID.10", "segment": "PID", "suggestedName": "Race", "children": [ { "id": "PID.10.1", "segment": "PID", "valueType": "string" }, { "id": "PID.10.2", "segment": "PID", "valueType": "string" }, { "id": "PID.10.3", "segment": "PID", "valueType": "string" } ] }, { "id": "PID.11", "segment": "PID", "suggestedName": "Patient Address", "children": [ { "id": "PID.11.1", "segment": "PID", "suggestedName": "Street Address", "valueType": "string" }, { "id": "PID.11.3", "segment": "PID", "suggestedName": "City", "valueType": "string" }, { "id": "PID.11.4", "segment": "PID", "suggestedName": "State", "valueType": "string" }, { "id": "PID.11.5", "segment": "PID", "suggestedName": "Postal Code", "valueType": "string" } ] }, { "id": "PID.13", "segment": "PID", "suggestedName": "Phone Number - Home", "valueType": "string" }, { "id": "PID.16", "segment": "PID", "suggestedName": "Marital Status", "valueType": "string" }, { "id": "PID.18", "segment": "PID", "suggestedName": "Patient Account Number", "valueType": "string" }, { "id": "PID.22", "segment": "PID", "suggestedName": "Ethnic Group", "children": [ { "id": "PID.22.1", "segment": "PID", "valueType": "string" }, { "id": "PID.22.2", "segment": "PID", "valueType": "string" }, { "id": "PID.22.3", "segment": "PID", "valueType": "string" } ] } ] }, { "id": "PV1", "segment": "PV1", "suggestedName": "Patient Visit", "children": [ { "id": "PV1.1", "segment": "PV1", "suggestedName": "Set ID - PV1", "valueType": "number" }, { "id": "PV1.2", "segment": "PV1", "suggestedName": "Patient Class", "valueType": "string" }, { "id": "PV1.3", "segment": "PV1", "suggestedName": "Assigned Patient Location", "children": [ { "id": "PV1.3.1", "segment": "PV1", "valueType": "string" }, { "id": "PV1.3.2", "segment": "PV1", "valueType": "string" }, { "id": "PV1.3.3", "segment": "PV1", "valueType": "string" }, { "id": "PV1.3.4", "segment": "PV1", "valueType": "string" } ] }, { "id": "PV1.4", "segment": "PV1", "suggestedName": "Admission Type", "valueType": "string" }, { "id": "PV1.7", "segment": "PV1", "suggestedName": "Attending Doctor", "children": [ { "id": "PV1.7.1", "segment": "PV1", "valueType": "string" }, { "id": "PV1.7.2", "segment": "PV1", "valueType": "string" }, { "id": "PV1.7.3", "segment": "PV1", "valueType": "string" } ] }, { "id": "PV1.10", "segment": "PV1", "suggestedName": "Hospital Service", "valueType": "string" }, { "id": "PV1.14", "segment": "PV1", "suggestedName": "Admit Source", "children": [ { "id": "PV1.14.1", "segment": "PV1", "valueType": "string" }, { "id": "PV1.14.2", "segment": "PV1", "valueType": "string" } ] }, { "id": "PV1.19", "segment": "PV1", "suggestedName": "Visit Number", "valueType": "string" }, { "id": "PV1.36", "segment": "PV1", "suggestedName": "Discharge Disposition", "children": [ { "id": "PV1.36.1", "segment": "PV1", "valueType": "string" }, { "id": "PV1.36.2", "segment": "PV1", "valueType": "string" } ] }, { "id": "PV1.44", "segment": "PV1", "suggestedName": "Admit Date/Time", "valueType": "string" }, { "id": "PV1.45", "segment": "PV1", "suggestedName": "Discharge Date/Time", "valueType": "string" } ] }, { "id": "AL1", "segment": "AL1", "suggestedName": "Allergy", "occurrenceCount": 2, "children": [ { "id": "AL1.1", "segment": "AL1", "suggestedName": "Set ID - AL1", "valueType": "number" }, { "id": "AL1.2", "segment": "AL1", "suggestedName": "Allergen Type Code", "children": [ { "id": "AL1.2.1", "segment": "AL1", "valueType": "string" }, { "id": "AL1.2.2", "segment": "AL1", "valueType": "string" }, { "id": "AL1.2.3", "segment": "AL1", "valueType": "string" } ] }, { "id": "AL1.3", "segment": "AL1", "suggestedName": "Allergen Description", "children": [ { "id": "AL1.3.1", "segment": "AL1", "valueType": "string" }, { "id": "AL1.3.2", "segment": "AL1", "valueType": "string" }, { "id": "AL1.3.3", "segment": "AL1", "valueType": "string" } ] }, { "id": "AL1.4", "segment": "AL1", "suggestedName": "Allergy Severity Code", "children": [ { "id": "AL1.4.1", "segment": "AL1", "valueType": "string" }, { "id": "AL1.4.2", "segment": "AL1", "valueType": "string" } ] }, { "id": "AL1.5", "segment": "AL1", "suggestedName": "Allergy Reaction Code", "children": [ { "id": "AL1.5.1", "segment": "AL1", "valueType": "string" }, { "id": "AL1.5.2", "segment": "AL1", "valueType": "string" } ] }, { "id": "AL1.6", "segment": "AL1", "valueType": "string" } ] }, { "id": "DG1", "segment": "DG1", "suggestedName": "Diagnosis", "children": [ { "id": "DG1.1", "segment": "DG1", "suggestedName": "Set ID - DG1", "valueType": "number" }, { "id": "DG1.3", "segment": "DG1", "suggestedName": "Diagnosis Code", "children": [ { "id": "DG1.3.1", "segment": "DG1", "valueType": "string" }, { "id": "DG1.3.2", "segment": "DG1", "valueType": "string" }, { "id": "DG1.3.3", "segment": "DG1", "valueType": "string" } ] }, { "id": "DG1.6", "segment": "DG1", "suggestedName": "Diagnosis Type", "valueType": "string" } ] } ], "createdAt": "2026-09-02T10:12:18.346Z", "updatedAt": "2026-09-02T10:15:52.161Z", "compiledLiquid": "{% assign firstSegments = hl7v2Data | get_first_segments: \"PID|PV1\" %}\n{\n \"birthDate\": \"{{ firstSegments.PID[7].Value | format_as_date_time }}\",\n \"resourceType\": \"{{ 'Patient' }}\",\n \"identifier\": [\n {\n \"value\": \"{{ firstSegments.PID[3][1].Value }}\"\n }\n ],\n \"name\": [\n {\n \"family\": \"{{ firstSegments.PID[5][1].Value }}\",\n \"given\": [\n \"{{ firstSegments.PID[5][2].Value }}\"\n ]\n }\n ],\n \"gender\": \"{{ firstSegments.PID[8].Value }}\",\n \"address\": [\n {\n \"line\": [\n \"{{ firstSegments.PID[11][1].Value }}\"\n ],\n \"city\": \"{{ firstSegments.PID[11][3].Value }}\",\n \"state\": \"{{ firstSegments.PID[11][4].Value }}\",\n \"postalCode\": \"{{ firstSegments.PID[11][5].Value }}\"\n }\n ],\n \"telecom\": [\n {\n \"value\": \"{{ firstSegments.PID[13].Value }}\"\n }\n ]\n}" } ], "filters": [], "resources": [], "fieldNames": {}, "version": 5, "createdAt": "2026-09-02T10:11:58.202Z", "updatedAt": "2026-09-02T10:15:55.194Z" } } ] }