Hl7-serializer NPM

HL7 Serializer

HL7 serializer written in typescript for Nodejs.

Features

Parsing HL7 messages
Editing HL7 messages with a simplistic js api
Saving HL7 messages after manipulation
Custom segment delimiter

Installation

npm install --save hl7-serializer

Examples

Create a HL7 message

import { Parser } from "hl7-serializer";

const hl7Message = `MSH|^~\\&|HIS|MedCenter|LIS|MedCenter|20060307110114||ORM^O01|MSGID20060307110114|P|2.3`;

const parser = new Parser();
const message = parser.parseMessage(hl7Message);
message.addSegment("BLC");

const blcSegment = message.getSegment("BLC");
blcSegment.addFields("", "");
console.log(blcSegment.toString()); // prints: BLC||

blcSegment.getField(1).setComponents("Component1", "Component2");
console.log(blcSegment.toString()); // prints: BLC|Component1^Component2|

const blcField2 = blcSegment.getField(2).setComponents("Component3");
console.log(blcSegment.toString()); // prints: BLC|Component1^Component2|Component3

blcField2.addComponents("Component4");
console.log(blcSegment.toString()); // prints: BLC|Component1^Component2|Component3^Component4

Edit a HL7 message

import { Parser } from "hl7-serializer";

const hl7Message = `MSH|^~\\&|HIS|MedCenter|LIS|MedCenter|20060307110114||ORM^O01|MSGID20060307110114|P|2.3
PID|||12001||Jones^John^^^Mr.||19670824|M|||123 West St.^^Denver^CO^80020^USA|||||||
ORC|NW|20060307110114
`;

const parser = new Parser();
const message = parser.parseMessage(hl7Message);
console.log(message.toString());
/* 
prints:
 MSH|^~\\&|HIS|MedCenter|LIS|MedCenter|20060307110114||ORM^O01|MSGID20060307110114|P|2.3
 PID|||12001||Jones^John^^^Mr.||19670824|M|||123 West St.^^Denver^CO^80020^USA|||||||
 ORC|NW|20060307110114
*/

const segment = message.getSegment("ORC").addFields("More Data");
segment.getField(3).addComponents("SecondComponent");
console.log(message.toString());

/* 
prints:
 MSH|^~\\&|HIS|MedCenter|LIS|MedCenter|20060307110114||ORM^O01|MSGID20060307110114|P|2.3
 PID|||12001||Jones^John^^^Mr.||19670824|M|||123 West St.^^Denver^CO^80020^USA|||||||
 ORC|NW|20060307110114|More Data^SecondComponent
*/