Edit

Add CorrelationInitializers Dialog Box

  • Article

The Add Correlation Initializers dialog box is used in Workflow Designer to configure the CorrelationInitializers properties of the Send, Receive, SendReply, and ReceiveReply activities. For more information about the activity designers that use this box, see the Send, Receive, ReceiveAndSendReply, and SendAndReceiveReply topics.

The correlation initializers in the collection specified with this dialog box can initialize the following correlations between the messaging activities:

  • query-based
  • context
  • callback context
  • request-reply

The following table describes the user interface (UI) elements of the Add Correlation Initializers dialog box:

UI Element Description
Add Initializer Click the Add initialize box to add an additional initializer to the collection.
Correlation Type Specifies the type of correlation initializer. There are four types to choose from:

1. A callback correlation initializer to specify a CallbackCorrelationInitializer.
2. A context correlation initializer to specify a CorrelationInitializer.
3. A request-reply correlation initializer to specify a RequestReplyCorrelationInitializer.
4. A query correlation initializer to specify a QueryCorrelationInitializer.

To edit the CorrelationType

1. Tab to the specific row in the Add Initializer DataGrid.
2. To set focus to CorrelationTypeComboBox, press Ctrl+Tab.
3. Press Alt+Down to pop up the ComboBox and edit it.
XPath Queries A key/value pair that contains the queries used to extract correlation data from incoming and outgoing messages. This list is only valid when using QueryCorrelationInitializer types.

To launch the Add Correlation Initializers dialog box

The Add Correlation Initializers dialog box is used by the Send, Receive, ReceiveAndSendReply, and SendAndReceiveReply designers. Accessing them is similar in each case, and the case that involves the Receive designer is used here to illustrate the procedure.

The Receive activity designer can be dragged from the Toolbox and dropped on to the Workflow Designer surface wherever activities are placed. Dropping the Receive activity designer creates a Receive activity with a default DisplayName of Receive. Select the Receive activity designer and click the ellipsis button next to the (Collection) text for the CorrelationInitializers property in the property grid for the Add Correlation Initializers dialog box to appear.

See also