Validating Messages

Microsoft BizTalk Accelerator for HL7 (BTAHL7) supports sending acknowledgments (ACK) for inbound messages from an application or trading partner in the form of an HL7 XML receipt that might need conversion to an HL7 encoded ACK message. BTAHL7 typically generates a receipt after it checks the inbound message against the relevant inbound (trading-partner format) document specification. When all the segments pass validation, BTAHL7 returns a receipt that indicates acceptance to the application. Otherwise, BTAHL7 generates a receipt indicating error or failure/reject.

The BTAHL7 ACK transmission reports syntactical and schematic errors against the HL7 standard. If the validation fails, BTAHL7 places the document in the suspended message queue and returns a receipt detailing the rejection. The BTAHL7 parser performs validation that involves checking data types, syntax, and the schema validation. BTAHL7 records any schematic errors that occur in parsing in the receipt along with the location details.

At configure time, you need to create the BizTalk Server artifacts required for responding with an ACK. The BTAHL7 parser creates the HL7 canonical ACK XML instance. BizTalk converts this to the required version format in an appropriate BizTalk map and validates the destination format. The BTAHL7 serializer then converts the message into an HL7-encoded instance.

Note

If there is a conflict between the delimiters of an inbound message and those specified in the BTAHL7 configuration, then BTAHL7 will generate an ACK message that uses the same delimiters of the inbound message and overrides the configuration settings.

See Also

Creating and Processing Acknowledgments
Programming Guide
ACK Message Modes