Configuring a Port to Receive EDI Messages and Acknowledgments

To receive an EDI interchange, you can create either a one-way receive port or a request-response (two-way) receive port to receive the interchange.

• Create a one-way receive port if you will also create a one-way send port to send EDI acknowledgments (if enabled). You will also have to clear the Route ACK to send pipeline on request-response receive port agreement property.

• Create a request response receive port and location to return EDI acknowledgments (if enabled) over the associated send pipeline. You will also have to select the Route ACK to send pipeline on request-response receive port agreement property.

Creating a One-Way Receive Port

Create the receive port and location with the following configuration:

Location	Property	Setting
Receive Port Properties: General	Port type	One-Way
Receive Port Properties: General	Authentication	Set to Drop messages if authentication fails or Keep messages if authentication fails to authenticate the party that sent the received message. Set to No authentication to disable authentication of the party that sent the received message. If set to Drop messages if authentication fails, BizTalk Server will suspend a message if the authentication of its sender fails. If set to Drop messages if authentication fails or Keep messages if authentication fails, the message must resolve to an agreement. Using the fallback agreement properties is not allowed. If no agreement is determined for an incoming message, BizTalk Server will treat the message as though authentication had failed, and will suspend the message.
Receive Location Properties: General	Transport Type	Can be any of a number of transport types.
Receive Location Properties: General	Receive handler	BizTalkServerApplication
Receive Location Properties: General	Receive pipeline	EdiReceive
FILE Transport Properties: Authentication	Use these credentials when host does not have access to network share (with User name and Password)	Set if authentication is required.
FILE Transport Properties: Batching	Number of messages in a batch	Set if interchange is batched.
FILE Transport Properties: Batching	Maximum batch size (in bytes)	Set if interchange is batched.

Creating a Request-Response Receive Port

Create the receive port and location with the following configuration:

Location	Property	Setting
Receive Port Properties: General	Port type	Request Response
Receive Port Properties: General	Authentication	Set to Drop messages if authentication fails or Keep messages if authentication fails to authenticate the party that sent the received message. Set to No authentication to disable authentication of the party that sent the received message. Note: If set to Drop messages if authentication fails or Keep messages if authentication fails, the message must resolve to an agreement.
Receive Location Properties: General	Transport Type	Can be any of a number of transport types, except FILE, which is not available in the drop-down list. Note: A security issue could occur if you create a receive location that uses the EDIReceive pipeline and has a transport type of HTTP. The EdiReceive pipeline will not generate an HTTP "200 OK" acknowledgment. If no EDI acknowledgment is returned, the connection will remain open until the time-out period has expired.
Receive Location Properties: General	Receive handler	BizTalkServerApplication
Receive Location Properties: General	Receive pipeline	EdiReceive
Receive Location Properties: General	Send pipeline	EdiSend
FILE Transport Properties: Authentication	Use these credentials when host does not have access to network share (with User name and Password)	Set if authentication is required.
FILE Transport Properties: Batching	Number of messages in a batch	Set if interchange is batched.
FILE Transport Properties: Batching	Maximum batch size (in bytes)	Set if interchange is batched.

Setting Agreement Properties

After creating the receive port and location, you need to set the agreement properties required for the receive pipeline to function. These properties are set in various pages of the Agreement Properties dialog box. For a list of the properties that the EDI Disassembler must have to process an EDI interchange in the EdiReceive receive pipeline, see How the EDI Disassembler Works.

See Also

Configuring Ports for an EDI Solution
How the EDI Disassembler Works
How to Create a Receive Port