The hl7-client Reference Manual

Table of Contents

Next: , Previous: , Up: (dir)   [Contents][Index]

The hl7-client Reference Manual

This is the hl7-client Reference Manual, generated automatically by Declt version 2.4 "Will Decker" on Wed Jun 20 11:56:45 2018 GMT+0.


Next: , Previous: , Up: Top   [Contents][Index]

1 Introduction

hl7-client

Common-Lisp client for sending HL7-Messages with MLLP envelope over TCP/IP socket.

The HL7 Version 2 Messaging Standard — Application Protocol for Electronic Data Exchange in Healthcare Environments — is considered to be the workhorse of data exchange in healthcare and is the most widely implemented standard for healthcare information in the world.

Source: http://www.hl7.org/about/FAQs/index.cfm?ref=nav ("General HL7 FAQ" > "Version 2" > "What is Version 2?")

The client sends HL7-Messages in MLLP evelopes to a TCP/IP socket and returns the acknowledges.

There is no validation of messages or acknowledges done by the client so it will NOT stop when an NACK-Message occurs.

License

http://opensource.org/licenses/BSD-3-Clause

Installation

HL7-Client is 'quickloadable':

(ql:quickload "hl7-client")

Usage

(hl7-client:send server port message-or-message-list)

hl7-client:send returns a list with the HL7-acknowledges

Example

For testing purposes there is a function (hl7-client:get-hl7-test-message) which returns a HL7-Message with random message-ID.

CL-USER> (hl7-client:SEND "localhost" 24777 (hl7-client:get-hl7-test-message))
("MSH|^~\\&|Receiving-App^^|Receiving-Facility^^|Sending-App^^|Sending-Facility^^|20150101195400^||ACK|9089|P^|2.2^^|||||||^^^^^|^MMSA|AA|9089^M")
CL-USER> (hl7-client:SEND "localhost" 24777 (list (hl7-client:get-hl7-test-message) (hl7-client:get-hl7-test-message)))
("MSH|^~\\&|Receiving-App^^|Receiving-Facility^^|Sending-App^^|Sending-Facility^^|20150101195400^||ACK|1800|P^|2.2^^|||||||^^^^^|^MMSA|AA|1800^M"
 "MSH|^~\\&|Receiving-App^^|Receiving-Facility^^|Sending-App^^|Sending-Facility^^|20150101195400^||ACK|1309|P^|2.2^^|||||||^^^^^|^MMSA|AA|1309^M")
CL-USER> 

^M = #\Return

Dependencies

Installable via Quicklisp:

(ql:quickload "usocket")

Development

I developed and tested hl7-client on:

ToDo


Next: , Previous: , Up: Top   [Contents][Index]

2 Systems

The main system appears first, followed by any subsystem dependency.


Previous: , Up: Systems   [Contents][Index]

2.1 hl7-client

Author

Martin R. Enders <martin@martin-enders.de>

License

BSD

Description

hl7-client - send HL7-Messages over TCP/IP with MLLP

Dependency

usocket

Source

hl7-client.asd (file)

Components

Next: , Previous: , Up: Top   [Contents][Index]

3 Files

Files are sorted by type and then listed depth-first from the systems components trees.


Previous: , Up: Files   [Contents][Index]

3.1 Lisp


Next: , Previous: , Up: Lisp files   [Contents][Index]

3.1.1 hl7-client.asd

Location

hl7-client.asd

Systems

hl7-client (system)


Next: , Previous: , Up: Lisp files   [Contents][Index]

3.1.2 hl7-client/package.lisp

Parent

hl7-client (system)

Location

package.lisp

Packages

hl7-client


Previous: , Up: Lisp files   [Contents][Index]

3.1.3 hl7-client/hl7-client.lisp

Dependency

package.lisp (file)

Parent

hl7-client (system)

Location

hl7-client.lisp

Exported Definitions
Internal Definitions

Next: , Previous: , Up: Top   [Contents][Index]

4 Packages

Packages are listed by definition order.


Previous: , Up: Packages   [Contents][Index]

4.1 hl7-client

Source

package.lisp (file)

Use List

common-lisp

Exported Definitions
Internal Definitions

Next: , Previous: , Up: Top   [Contents][Index]

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.


Next: , Previous: , Up: Definitions   [Contents][Index]

5.1 Exported definitions


Previous: , Up: Exported definitions   [Contents][Index]

5.1.1 Functions

Function: get-hl7-test-message &optional MESSAGE-CONTROL-ID
Package

hl7-client

Source

hl7-client.lisp (file)

Function: send SERVER PORT MESSAGE-OR-MESSAGE-LIST
Package

hl7-client

Source

hl7-client.lisp (file)


Previous: , Up: Definitions   [Contents][Index]

5.2 Internal definitions


Previous: , Up: Internal definitions   [Contents][Index]

5.2.1 Functions

Function: get-hl7-test-message-list &optional NUMBER-OF-MESSAGES
Package

hl7-client

Source

hl7-client.lisp (file)

Function: mllp-send-message STREAM LINE

Print Message with MLLP Envelope to stream

Package

hl7-client

Source

hl7-client.lisp (file)


Previous: , Up: Top   [Contents][Index]

Appendix A Indexes


Next: , Previous: , Up: Indexes   [Contents][Index]

A.1 Concepts

Jump to:   F   H   L  
Index Entry  Section

F
File, Lisp, hl7-client.asd: The hl7-client<dot>asd file
File, Lisp, hl7-client/hl7-client.lisp: The hl7-client/hl7-client<dot>lisp file
File, Lisp, hl7-client/package.lisp: The hl7-client/package<dot>lisp file

H
hl7-client.asd: The hl7-client<dot>asd file
hl7-client/hl7-client.lisp: The hl7-client/hl7-client<dot>lisp file
hl7-client/package.lisp: The hl7-client/package<dot>lisp file

L
Lisp File, hl7-client.asd: The hl7-client<dot>asd file
Lisp File, hl7-client/hl7-client.lisp: The hl7-client/hl7-client<dot>lisp file
Lisp File, hl7-client/package.lisp: The hl7-client/package<dot>lisp file

Jump to:   F   H   L  

Next: , Previous: , Up: Indexes   [Contents][Index]

A.2 Functions

Jump to:   F   G   M   S  
Index Entry  Section

F
Function, get-hl7-test-message: Exported functions
Function, get-hl7-test-message-list: Internal functions
Function, mllp-send-message: Internal functions
Function, send: Exported functions

G
get-hl7-test-message: Exported functions
get-hl7-test-message-list: Internal functions

M
mllp-send-message: Internal functions

S
send: Exported functions

Jump to:   F   G   M   S  

Next: , Previous: , Up: Indexes   [Contents][Index]

A.3 Variables


Previous: , Up: Indexes   [Contents][Index]

A.4 Data types

Jump to:   H   P   S  
Index Entry  Section

H
hl7-client: The hl7-client system
hl7-client: The hl7-client package

P
Package, hl7-client: The hl7-client package

S
System, hl7-client: The hl7-client system

Jump to:   H   P   S