Tag Archive: configuration

How to Configure BTAHL7 Configuration Explorer

A Party needs to be added to the BTAHL7 Configuration Explorer before Receive and Send Ports can work properly. The following process shows the location in the A01 message of the Party Name to be added and the steps to add the Party and configure acknowledgments.

Example A01Message: The highlighted Sending Application is the Party Name to be added.

  1. Open BizTalk Server Administration Console
  2. Expand BizTalk Group
  3. Right click Parties->New->Party
    1. Under General
      1. Rename Party1 to “SendingParty” from the example above
      2. Click Apply, Click OK
    2. Under Send ports
      1. Select “SendACKs” from the Name drop down list
    3. “SendingParty” is now located in Parties and Business Profiles
  4. Open BTAHL7 Configuration Explorer
    1. Located in Programs under Microsoft BizTalk 2013 Accelerator for HL7
    2. “SendingParty” is now Available to Configure
  5. Under Acknowledgement
    1. Select “Original Mode” for Acknowledgement type
    2. Click “Save”
  6. Under Validation
    1. Uncheck “Validate body segments”
      1. This will reduce the amount of errors the HL7 pipeline will pick up
    2. Click “Save”
  7. Restart the BizTalk Host Instance under Platform settings
  8. Drop the following ADT^A01 Sample file in the ReceiveADTA01Location:
    MSH|^~&|SendingParty|SendFac|ReceApp|RecFac|201307092343||ADT^A01|msgCtrId|P|2.5.1
    EVN|A01|198808181318||01
    PID|9|M11|M11||JOHN^DOE^A^JR||19310615|M||C|303 Test DRIVE^TestCITY^CO^81505|GL|(919)555-5555|(919)555-5555||M|A|M11|987654321|143257NC
    NK1|1|DOE^JANE^A|WIFE
    PV1|1|I|2000|A|||004777^SMITH^DAVID^SR|||SUR|||||A0
  9. Notice the Acknowledgment in the SendACKs folder
    1. MSA-1 is the type of Acknowledgment
      1. AA – Application Accepted
      2. AE – Application Error
        1. ERR segment will follow with Segment – field error information
      3. AR – Application Rejected
    2. MSA-2 is the Message Control Id and can be used to find the Original Message. It is located in MSH.10_MessageControlId

How to Set Up Ports in BizTalk for an ADT^A01 HL7 Message

DLLs need to be added to BizTalk to access artifacts in the ports. The following steps show how to add assemblies, set up ports to receive and send an HL7 message and send an acknowledgement which shows whether the message was accepted, produced an error or was rejected.

  1. Open BizTalk Server Administration Console
  2. Expand BizTalk Group
  3. Expand Applications
  4. Expand BizTalk Application1
    1. This is the Application set up for HL7
  5. Right Click “BizTalk Application1” Add->BizTalk Assemblies
    1. Click Add browse to the necessary assemblies
    2. Click OK
    3. Check “Overwrite all”
    4. Check “Add the Global assembly cache on add resource”
      1. Check this for each assembly, If adding multiple assemblies
    5.  Click OK
  6. Right Click Receive Ports-> New -> One-way Receive Port
    1. Rename ReceivePort1 to “ReceiveADTA01”
  7. Under Receive Locations Click New
    1. Under General
      1. Rename Receive Location1 to “ReceiveADTA01”
      2. Select “File” for Type
      3. Click Configure
        1. Browse to the location to receive ADTA01 flat file message
        2. Change the File mask to *.* or *.txt if this is the file extension of your message.
        3. Click Apply, Click OK
      4. Select “BTAHL72XReceivePieline” for the Receive Pipeline
        1. This is the HL7 Receive Pipeline for flat file messages
      5. Click Apply, Click OK
  8. Right Click Send Ports-> New Static One-Way Send Port
    1. Under General
      1. Rename “SendPort1” to “SendADTA01”
      2. Select “File” for Type
      3. Click Configure
        1. Browse to the to send Location
        2. Keep current File Mask
      4. Select “XML Transmit” for the Send Pipeline
      5. Click Apply, Click OK
    2. Under Filters
      1. Add the following Properties:
  9. Right Click Send Ports-> New Static One-Way Send Port
    1. Under General
      1. Rename “SendPort1” to “SendACKs”
      2. Select “File” for Type
      3. Click Configure
        1. Browse to the to send Location
        2. Change the File Mask to %MessageID%.txt
      4. Select “BTAHL72XSendPipeline” for the Send Pipeline
        1. This Pipeline will output a flat file ACK
    2. Under Filters
      1. Select the following Properties