Edit

InitializeCorrelation Activity Designer

  • Article

The InitializeCorrelation activity designer is used to create and configure an InitializeCorrelation activity. The InitializeCorrelation activity establishes a correlation between messages before sending or receiving them.

The InitializeCorrelation Activity

An InitializeCorrelation activity is used to initialize correlations without sending or receiving a message. Typically correlation is initialized when sending or receiving a message. If correlation must be established before a message is sent or received, use InitializeCorrelation to initialize the correlation.

Using the InitializeCorrelation Activity Designer

Access the InitializeCorrelation activity designer in the Messaging category of the Toolbox.

The InitializeCorrelation activity designer can be dragged from the Toolbox and dropped on to the Workflow Designer surface. Dropping the activity designer creates a InitializeCorrelation activity with a default DisplayName of InitializeCorrelation. The DisplayName can be edited in the header of the InitializeCorrelation activity designer or in the DisplayName box of the Properties window.

The CorrelationHandle can be specifies in the Correlation field in Properties window on the InitializeCorrelation activity designer surface.

To display the Initialize Correlation dialog box where you can specify the correlation handle and the key-value pairs used to initialize it, select the ellipsis button next to the CorrelationData field in Properties window. Or, select the "View ..." hint text on the InitializeCorrelation activity designer surface. For more information about using this dialog box, see the Type Collection Editor Dialog Box article.

The InitializeCorrelation Properties

The following table shows the InitializeCorrelation properties and describes how they're used in the designer. These properties can be edited in Properties window or on Workflow Designer surface.

Property Name Required Usage
DisplayName False The friendly name of the InitializeCorrelation activity. The default value is InitializeCorrelation.

Although the use of a non-default value for the friendly DisplayName isn't strictly required, it is recommended.
Correlation False The CorrelationHandle used to associate workflow activities in the correlation.
CorrelationData False A dictionary of correlation data that relates messages to the workflow instance.

Use the Initialize Correlation dialog box to configure the CorrelationData. For more information about the use this dialog box, see the Type Collection Editor Dialog Box article.

See also