Concepteur d'activités Receive
Le concepteur d’activités Receive permet de créer et configurer une activité Receive. Une activité Receive est une activité qui reçoit un message qui peut être un type intégré, tel que Message, Stream ou XElement, ou un contrat de données défini par l'application, un contrat de message ou une classe XML sérialisable.
Activité Receive
L'activité Receive peut recevoir un élément unique ou plusieurs éléments selon le type de contenu de réception utilisé. Une activité SendReply peut être liée à une activité Receive qui reçoit un message dans le cadre d’un modèle d’échange de messages de demande/réponse sur le service.
Utilisation du concepteur d'activités Receive
Accédez au concepteur d’activités Receive dans la catégorie Messagerie de la Boîte à outils. Vous pouvez faire glisser le concepteur d’activités Receive de la Boîte à outils et le déposer dans l’aire du Concepteur de flux de travail, là où les activités sont généralement placées. Cette opération crée une activité Receive avec une propriété DisplayName affectée de la valeur par défaut Receive. Le DisplayName peut être modifié dans l’en-tête du concepteur d’activités Receive ou dans la zone DisplayName de la grille des propriétés.
Pour créer une activité SendReply et la lier à l’activité Receive sélectionnée, cliquez avec le bouton droit sur le concepteur d’activités Receive, cliquez sur l’élément Créer un SendReply dans le menu contextuel. Le concepteur SendReplyToReceive s’affiche sous le concepteur Receive. L’activité SendReply est une activité qui envoie le message de réponse dans le cadre d’un modèle d’échange de messages de demande/réponse sur le service. Elle peut être configurée avec le concepteur SendReplyToReceive.
Par ailleurs, le concepteur de modèles ReceiveAndSendReply dans la catégorie Messagerie de la Boîte à outils permet de créer une paire d’activités Receive et SendReply préconfigurées. Pour plus d’informations sur l’utilisation du modèle ReceiveAndSendReply et SendReplyToReceive, consultez la rubrique ReceiveAndSendReply.
Propriétés de l'activité Receive
Le tableau suivant présente les propriétés de Receive et décrit comment elles sont utilisées dans le concepteur. Ces propriétés peuvent être modifiées dans la grille des propriétés ou dans l’aire du Concepteur de flux de travail. Seule la propriété OperationName est obligatoire.
| Nom de la propriété | Obligatoire | Usage |
|---|---|---|
| DisplayName | False | Spécifie le nom convivial de l'activité Receive. La valeur par défaut est Receive. Bien que l'utilisation d'une valeur autre que celle par défaut pour le nom convivial de la propriété DisplayName ne soit pas strictement obligatoire, il est recommandé d'utiliser une telle valeur. |
| OperationName | True | Spécifie le nom de l'opération de service implémenté par cette activité Receive. Cette propriété est utilisée pour construire la valeur par défaut de la propriété Action si la propriété Action n’est pas définie de manière explicite. |
| ServiceContractName | False | Spécifie le nom du contrat de service. Cette propriété permet de regrouper des opérations de service dans des contrats de service individuels. Toutes les activités Receive qui ont le même ServiceContractName sont regroupées dans le même contrat de service (type de port WSDL). La valeur par défaut est le nom CLR complet de l’activité de niveau supérieur (racine). |
| Content | False | Spécifie le contenu du message ou du paramètre à recevoir. Il peut s'agir d'une activité ReceiveMessageContent ou d'une activité ReceiveParametersContent. Modifiez cette propriété en sélectionnant les points de suspension à côté du champ Contenu dans la grille des propriétés, ou en cliquant sur le bouton Définir... à côté de l’étiquette Contenu dans l’aire du concepteur d’activités Receive. Les deux affichent la boîte de dialogue Définition de contenu. Pour plus d’informations sur l’utilisation de cette zone, consultez la rubrique Boîte de dialogue Définition de contenu. |
| CorrelatesOn | False | Spécifie les corrélations entre des activités Receive dans des opérations de service d'un workflow avec un objet MessageQuerySet. Cliquez sur les points de suspension à côté de la propriété CorrelatesOn dans la grille des propriétés pour ouvrir la boîte de dialogue Définition de CorrelatesOn. Pour plus d’informations sur l’utilisation de cette boîte de dialogue, consultez la rubrique Boîte de dialogue Définition de contenu. |
| CorrelatesWith | False | Spécifie l'objet CorrelationHandle utilisé pour router le message vers l'instance de workflow appropriée. Cliquez sur les points de suspension à côté de la propriété CorrelatesWith dans la grille des propriétés pour ouvrir la boîte de dialogue Éditeur d’expressions. Pour plus d’informations sur l’utilisation de cette boîte de dialogue, consultez la rubrique Guide pratique pour utiliser l’éditeur d’expressions. |
| CorrelationInitializers | False | Spécifie la collection d’objets CorrelationInitializer initialisant plusieurs objets CorrelationHandle qui configurent cette activité Receive dans le workflow. Cliquez sur les points de suspension à côté de la propriété CorrelationInitializers dans la grille des propriétés pour ouvrir la boîte de dialogue Ajouter des initialiseurs de corrélation. Pour plus d’informations sur l’utilisation de cette zone, consultez la rubrique Boîte de dialogue Ajouter des CorrelationInitializers. |
| CanCreateInstance | False | Spécifie une valeur qui détermine si une nouvelle instance de workflow est créée pour traiter le message si le message n'est pas corrélé à une instance de workflow existante. Si la valeur est définie sur true, une nouvelle instance de workflow est créée pour traiter le message, s’il n’est pas corrélé à une instance de workflow existante. |
| KnownTypes | False | Spécifie une collection de types connus pour l'opération de service implémentée par cette activité Receive. Cette propriété doit être utilisée conjointement à la propriété SerializerOption affectée de la valeur DataContractSerializer. Elle est ignorée si XmlSerializer est utilisé. Sélectionnez les points de suspension à côté du champ KnownTypes dans la grille des propriétés pour afficher la boîte de dialogue Éditeur de collections de types qui vous permet d’ajouter des types pertinents. Pour plus d’informations sur l’utilisation de cette zone, consultez la rubrique Boîte de dialogue Éditeur de collections de types. |
| ProtectionLevel | False | Spécifie l'objet ProtectionLevel du message. 1. ProtectionLevel implique l’authentification uniquement. 2. ProtectionLevel implique la signature des données pour garantir l’intégrité des données transmises. 3. ProtectionLevel implique le chiffrement et la signature des données pour garantir la confidentialité et l’intégrité des données transmises. |
| SerializerOption | False | Spécifie le type de sérialiseur à utiliser pour l'opération de service implémentée par l'activité Receive. La valeur par défaut est DataContractSerializer, qui sérialise et désérialise une instance d'un type dans un flux ou document XML utilisant un contrat de données fourni. XmlSerializer peut également être utilisé s'il est nécessaire de mieux contrôler les données XML. |
| Action | False | Spécifie l'en-tête Action header du message. S’il n’est pas défini explicitement, sa valeur par défaut est : https://tempuri.org/{service contract namespace}/{service contract name}/{operation name}. |