Hitachi Vantara Pentaho Community Wiki
Skip to end of metadata
Go to start of metadata

Description

This step provides the ability to read data from HL7 data streams within a transformation. With the combination of the job entries HL7 MLLP Input, messages can be read from a remote server, processed by a transformation and then acknowledged by the HL7 MLLP Acknowledge job entry.

It is based on the HAPI project (HL7 application programming interface; pronounced "happy") and supports actually messages for HL7 versions up to 2.6.

Options

Property

Description

Step name

Name of the step; the name has to be unique in a single transformation.

Message field

Specifies the field name in the data stream that gets parsed.

Output fields

All output fields have fixed names and are String value types.

Fieldname

Description

Example

ParentGroup

This is the name of the root group

MFN_M01

Group

Name of the Group.

MFN_M01

HL7Version

HL7 version of the data stream

2.3

StructureName

Name of the HL7 structure

MSH

StructureNumber

Child number within structure (level)

1

FieldName

Field Description according to HL7

 

Coordinates

Level within each Segment: Segment.Terser.Component.SubComponent

1.1.1.1

HL7DataType

Data Types according to the HL7 specification. Note: These data types do not get mapped to Kettle data types

ST

FieldDescription

Field Description according to HL.

 

Value

The value of the field. Note: All values are of String type.

 

Note: User defined Z-Segments can be handled by this step, too. Z-Segment values are written to the data stream with an empty FieldName, a question mark ("?") for the FieldDescription and with an "UNKNOWN" HL7DataType. Due to the fact, that the Coordinates field gives the level within each Segment, these values can be analyzed according to the user defined Z-Segment definition: Segment.Terser.Component.SubComponent - Please see the samples section for more details.

Note: When you get an exception like this: Can't process message of version '2.3 MFI' - version not recognized (or similar) it is most likely that the file has LF instead of CR as segment terminators. The HL7 standard defines the segment terminator as "The segment terminator is the last character of every segment. It is always the ASCII CR character (hex 0D)." - Please see the samples section for a workaround.

  • No labels