Using the HL7 Document Protocol

Oracle SOA Suite for healthcare integration implements the Health Level 7 (HL7) version 2.x to exchange documents containing health care information using the Generic exchange or MLLP exchange. When using HL7, the standard Oracle SOA Suite for healthcare integration features, such as validation, translation, automatic generation of outbound envelope headers, and acknowledgments, are available. For information about the organization that created and maintains the HL7 standards, go to

http://www.hl7.org

3.3.1 What You May Need to Know About HL7 Document Version Parameters

When you create an HL7 document version, you can set various parameters.

Figure 3–6 shows document version parameters for an HL7 document.

Field Value

Identification Value US

Using the HL7 Document Protocol

Figure 3–6 Document Version Parameters for an HL7 Document

Table 3–2 describes the document version parameters for an HL7 document.

Table 3–2 Document Version Parameters for an HL7 Document

Parameter Description

Message Header Tab -

Security In some applications of HL7, this field is used to implement security features. Processing ID MSH.11 - This field is used to decide whether to process the message as defined in

HL7 Application (level 7) processing rules. The first component defines whether the message is part of a production, training, or debugging system (refer to HL7 table 0103 - Processing ID for valid values). The second component defines whether the message is part of an archival process or an initial load (refer to HL7 table 0207 - Processing mode for valid values). This allows different priorities to be given to different processing modes.

Accept Acknowledgement Type

Sets the conditions under which application acknowledgments are required to be returned in response to the message. The value AL (always) is supplied.

Oracle SOA Suite for healthcare integration checks the payload (MSH.15) of an incoming message to see if an ACK has to be generated. In some HL7 Systems, MSH.15 is not sent in the payload at all and it is expected that an ACK is still sent. Application

Acknowledgment Type

MSH.16. The value AL (always) is supplied.

Country Code Sets the country of origin for the message. The value US is supplied. Character Set Sets the character set for the entire message. The value ASCII is supplied. Internationalization Code

Identifier

Using the HL7 Document Protocol

Internationalization Code Text

MSH.19

Internationalization Coding System Name

MSH.19 Internationalization Code Alternate Identifier MSH.19 Internationalization Code Alternate Text MSH.19 Internationalization Code Alternate Coding System Name MSH.19 International Version Identifier MSH.12 International Version ID Text MSH.12 International Version ID Coding System Name

MSH.12 International Version ID Alternate Identifier MSH.12 International Version ID Alternate Text MSH.12 International Version ID Alternate Coding System Name

MSH.12

Batch Header Tab -

Create Batch Header Select the box to create batch headers.

Batch Header Ecs File Use the Browse button to find an ecs file to override the standard file. If not provided, the provided default file is used.

Batch Security BHS.8

Batch Date BHS.7. The system date-time stamp is supplied (#SystemDateTime(CCYYMMDDHHMM)#).

File Header Tab -

Create File Header Select the check box to create file headers.

File Header Ecs File Use the Browse button to find an ecs file to override the standard file. If not provided, the provided default file is used.

File Security FHS.8

File Date FHS.7. The system date-time stamp is supplied (#SystemDateTime(CCYYMMDDHHMM)#).

Delimiters Tab Click Select Hexadecimal Characters next to any of the delimiter fields to provide values.

Element Delimiter A single character that follows the segment identifier and separates each data element in a segment except the last. The value 0x7c is supplied.

Escape Character The value 0x5c is supplied.

Repeating Separator A service character used to separate adjacent occurrences of a repeating data element, or to separate multiple occurrences of a field.The value 0x7e is supplied.

Table 3–2 (Cont.) Document Version Parameters for an HL7 Document

Using the HL7 Document Protocol

3.3.2 What You May Need to Know About HL7 Document Type Parameters

When you create an HL7 document type, you can set various parameters. Figure 3–7

shows the document type parameters for an HL7 document.

Figure 3–7 Document Type Parameters for an HL7 Document

Table 3–3 describes the document type parameters for an HL7 document.

Segment Delimiter A syntax character indicating the end of a segment (a logical grouping of data fields) within a message. The value 0x0d is supplied.

Subcomponent Delimiter The value 0x26 is supplied. Subelement Delimiter The value 0x5e is supplied.

Miscellaneous Tab -

Ignore Envelope Parameters

Use this option to provide a list of envelope elements, separated by commas, to be ignored during look-up validation. For an HL7 agreement, the possible values include MessageSendingApp, MessageReceivingApp, MessageSendingFacility, and MessageReceivingFacility.

Ack Mode Select this option to specify whether to send a single acknowledgment or multiple acknowledgments for inbound batched HL7 messages.

Table 3–3 Document Type Parameters for an HL7 Document

Parameter Description

Transaction Tab -

Table 3–2 (Cont.) Document Version Parameters for an HL7 Document

Using the HL7 Document Protocol

3.3.3 What You May Need to Know About HL7 Document Definition Parameters

When you create an HL7 document definition (see Section 3.4, "Creating Document Definitions" for more information on creating document definitions), you can set various parameters. Figure 3–8 shows document definition parameters for an HL7 document.

Figure 3–8 Document Definition Parameters for an HL7 Document

Table 3–4 describes the document definition parameters for an HL7 document. HL7 Generic ACK If selected, Oracle SOA Suite for healthcare integration sends a generic ACK. Map ACK Control ID Select to enable mapping the MSH.10 of the business message to the MSH.10 of the

acknowledgment.

Note: This Map ACK Control ID parameter is for the functional ACK.

Accept Acknowledgement A functional acknowledgment is generated when MSH.15 has no value. Select None to take no action. Acknowledgment generation is dependent on the value in MSH.15 of the business message. Select AL (always) to generate the acknowledgment under any conditions. Select ER (error/reject) to generate the acknowledgment when the message errors or is rejected. Select SU (successful completion) to generate the acknowledgment when the message is successfully processed.

Table 3–4 Document Definition Parameters for an HL7 Document

Parameter Description

Transaction Tab -

*Transaction Set ecs File Use the Browse button to find the ecs file.

Routing Tab -

Document Routing ID Sets the consumer name to the back-end application

XPath Tab -See Section 3.2.2.1, "How to Configure the XPath Expression for a Custom XML Document," for more information.

XPath Name1 The XML XPath name for retrieving the value from the payload

Table 3–3 (Cont.) Document Type Parameters for an HL7 Document

Creating Document Definitions

3.3.4 What You May Need to Know About Using HL7

No business message is produced for an HL7 immediate acknowledgment (transport-level acknowledgment).

Negative acknowledgment messages indicating errors in an HL7 exchange may be truncated because of the 80-character length limitation in HL7 versions 2.1 through 2.5.