Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 5 Next »

CorrelationScope

This activity provides implicit CorrelationHandle management for child messaging activities.

Activity Parameters

The CorrelationScope activity has one parameter and it can be provided by manually inserted values or via IN arguments or variables:

Parameters:

  • CorrelatesWith (text box editor type) (type: CorrelationHandle): Specifies the CorrelationHandle used to manage child messaging activities. If you do not set this property, CorrelationScope creates an implicit CorrelationHandle automatically.

 

InitializeCorrelation

This 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.

Activity Parameters

The InitializeCorrelation activity has three parameters (including DisplayName) that can be provided by manually inserted values or via IN arguments or variables:

Parameters:

  • Correlation (text box editor type) (type: CorrelationHandle): The CorrelationHandle used to associate workflow activities in the correlation.
  • CorellationData (collection editor type) (type: Collection): A dictionary of correlation data that relates messages to the workflow instance.

 

Receive

This activity is an activity that receives a message that can be either a built-in type such as Message, Stream or XElement, or an application-defined data contract, message contract, or XML class that can be serialized.

Activity Parameters

The Receive activity has parameters that can be provided by manually inserted values or via IN arguments or variables:

Parameters:

  • CorrelatesOn (collection editor type) (type: Collection): Specifies the correlations between Receive activities in service operations of a workflow with a MessageQuerySet object.
  • CorrelatesWith (text box editor type) (type: CorrelationHandle): Specifies the CorrelationHandle used to route the message to the appropriate workflow instance.
  • CorrelationInitializers (collection editor type) (type: Collection): Specifies the collection of CorrelationInitializer objects that initialize multiple CorrelationHandle objects that configure this Receive activity within the workflow.
  • Content (Content Definition window) (type: Custom): Specifies the message or parameter content to receive. It can be either a ReceiveMessageContent activity or a ReceiveParametersContent activity.
  • OperationName (text box editor type) (type: String): Specifies the name of the service operation implemented by this Receive activity. This property is used to construct the default value for the Action property if the Action property is not explicitly set.
  • ServiceContractName (text box editor type) (type: String): Specifies the name of the service contract. This property is used to group service operations into individual service contracts. All Receive activities that have the same ServiceContractName are grouped into the same service contract (WSDL Port Type). The default value is the fully-qualified CLR name of the top level (root) activity.
  • Action (text box editor type) (type: String): Specifies the action header of the message. If it is not explicitly set, its value defaults to: https://tempuri.org/{service contract namespace}/{service contract name}/{operation name}.
  • CanCreateInstalce (checkbox control type) (type: boolean): Specifies a value that determines whether a new workflow instance is created to process the message if the message does not correlate to an existing workflow instance. If the value is set to true, a new workflow instance is created to process the message when the message is not correlated with an existing workflow instance.
  • KnownTypes (collection editor type) (type: collection): Specifies a collection of known types for the service operation implemented by this Receive activity. This property should be used in conjunction with the SerializerOption property set to DataContractSerializer. It is ignored if XmlSerializer is used.
  • ProtectionLevel(combobox control type) (type: string): Specifies the ProtectionLevel for the message. None means authentication only. Sign means sign data to help ensure the integrity of transmitted data. EncryptAndSign means encrypt and sign data to help ensure the confidentiality and integrity of transmitted data.
  • SerializerOption (combobox control type) (type: string): Specifies the type of serializer to use for the service operation implemented by the Receive activity. The default value is DataContractSerializer, which serializes and deserializes an instance of a type into an XML stream or document that uses a supplied data contract. The XmlSerializer can also be used if more control is required over the XML.

 

ReceiveAndSendReply

The ReceiveAndSendReply template is used to create a pair of pre-configured Receive and SendReply activities within a Sequence activity that are correlated as part of a request/response message exchange pattern on the server.

Activity Parameters

The ReceiveAndSendReply template has 2 sets of parameters that can be provided by manually inserted values or via IN arguments or variables. We will only be covering the parameters for SendReply in the current block, since the parameters for Receive have been covered in the previous section (immediately above the current activity):

Parameters:

  • CorrelationInitializers (collection editor type) (type: Collection): Specifies the collection of CorrelationInitializer objects that initialize multiple CorrelationHandle objects that configure this Receive activity within the workflow.
  • Content (Content Definition window) (type: Custom): Specifies the message or parameter content to receive. It can be either a ReceiveMessageContent activity or a ReceiveParametersContent activity.
  • PersistBeforeSend (checkbox control type) (type: boolean): Specifies whether the workflow instance should be persisted before the reply message is sent. The default value is false.
  • Request (combobox control type) (type: string): Reference to the Receive activity paired with this SendReply activity. This property must not be null. Receive and SendReply activities are used together on the server to model a request/response messaging pattern. This property specifies which Send activity is paired. In the designer, you cannot edit this property because it is automatically bound to the Send activity from which you created the SendReply activity.
  • Action (text box editor type) (type: String): Specifies the action header of the message. If it is not explicitly set, its value defaults to: https://tempuri.org/{service contract namespace}/{service contract name}/{operation name}

 

 

 

  • No labels