Using the Send Shape

The Send shape (Send shape) sends a message to a port. You specify the message that you will send, and the port operation by which it will be sent.

If you expect to receive an indirect response (not using a request-response port) to the message that you have sent, you need to correlate the message with the currently running instance of the orchestration, so that the respondent can get the response to the correct instance. You can apply a following correlation set to the Send shape for a previously initialized correlation, or you can apply an initializing correlation set. For more information, see Correlating Messages with Orchestration Instances.

To configure a Send shape

  1. Set a message and a port operation.
    1. In the Orchestration View window, verify that your orchestration has both a message and a port operation defined for the multi-part message type being sent.
    2. In the Properties window, select the message to send from the Message property drop-down list.
    3. In the Properties window, select the port operation that sends the message from the Port Operation drop-down list.

      —Or—

      Drag the send connector from the Send shape to the port socket that sends the message.

  2. Specify correlation sets to restrict the messages the Send shape will send or to initialize the values in a correlation set.
    1. For each correlation set you want to use, check a correlation set from the drop-down on the Following Correlation Sets property.
    2. For each correlation set that you want to initialize, check a correlation set from the drop-down on the Initializing Correlation Sets property.

Delivery Notification

You can test to see whether you have successfully sent a message over a send port.

To do this, put your Send shape in a long-running or non-transactional scope, set the DeliveryNotification property to Transmitted on your send port, and add a catch handler to your scope to handle a DeliveryFailureException.

The orchestration waits for acknowledgment at the end of the enclosing non-atomic scope, or the end of the orchestration, to receive the acknowledgment.

Note  This applies only to one-way operations; failure in two-way (request-response) operations results in a SoapException (negative acknowledgement) even without the port attribute being set.

Note  Delivery notification is not supported for direct binding.

Report to Analyst

Select True if you want to make this shape viewable in the Visual Business Analyst Tool.

See Also

Using the Receive Shape

Using Ports in Orchestrations

To download updated BizTalk Server 2004 Help from www.microsoft.com, go to http://go.microsoft.com/fwlink/?linkid=20616.

Copyright © 2004 Microsoft Corporation.
All rights reserved.
Show: