Activité invoke

Chapter 11 Travailler avec WS-BPEL 2.0

Activité invoke

L'activité invoke permet au processus métiers d'initier un message envoyé à un partenaire, le partenaire pouvant répondre ou non. Elle peut inclure :

Des gestionnaires d'erreur pour gérer les messages d'erreur renvoyés par les opérations
Un gestionnaire de compensation
Des affectations implicites nommées éléments <toParts> et <fromParts>

L'élément <toParts> fournit une alternative afin de créer de façon explicite des messages WSDL multipartie à partir du contenu de variables WS-BPEL. Chaque opération <copy> copie des données depuis la variable (spécifiée dans l'attribut "fromVariable") dans la partie de la variable anonyme temporaire WSDL, qui est référencée dans l'attribut "part" de l'élément <toPart>.

L'élément <fromParts> est similaire à l'élément <toParts>. L'élément <fromParts> est utilisé pour extraire des données dans un message WSDL multipartie entrant et les placer dans des variables WS-BPEL individuelles. Chaque opération <copy> copie les données comme faisant partie de la variable anonyme temporaire WSDL variable, qui est référencée dans l'attribut "part" de l'élément <fromPart> vers la variable indiquée dans l'attribut "toVariable".

L'activité <assign> virtuelle créée en conséquence des éléments <fromParts> et <toParts> se produit comme faisant partie de la portée de l'activité <invoke> et par conséquent toute erreur émise est interceptée par le gestionnaire d'erreur en ligne d'une activité <invoke>, s'il est défini.

Syntaxe

<invoke name="InvokeCreditOrg" partnerLink="CreditOrg" portType="cc:CheckCreditPT" operation="CheckCreditOp">
   <correlations>
      <correlation set="AccountKey" initiate="yes" pattern="request"/>
   </correlations>
   <fromParts>
      <fromPart part="message" toVariable="transfer"/>
   </fromParts>
   <toParts>
      <toPart part="account" fromVariable="personal" />
   </toParts>
</invoke>

Correspondance

Vous modélisez une activité invoke de l'une des façons suivantes :

Processus ayant les propriétés suivantes :

Propriété de processus	Valeur
Type (mise en oeuvre)	Exécuter l'opération
Type d'action	Appeler une opération
Mis en oeuvre par	Opération définir sous un fournisseur de service au sein du même modèle

Pointez sur un processus <<empty>> ou sur un processus dépourvu de stéréotype, cliquez le bouton droit de la souris, puis sélectionnez la commande Changer en Assign
Faites glisser l'opération depuis l'Explorateur d'objets pour la déposer sur un processus dans la fenêtre de diagramme, puis définissez le type d'action approprié

Attributs étendus

Les attributs étendus suivants s'appliquent à l'activité invoke et sont disponibles dans sa feuille de propriétés :

Nom	Code interne	Description
Condition de jointure	joinCondition	Condition de jointure
Suppression des échecs de jointure	suppressJoinFailure	Evite la propagation des erreurs de jointure
Corrélation multiple	MultipleCorrelation	Définit des activités BPEL Invoke, Receive ou Reply en utilisant plusieurs corrélations.
Premier motif de corrélation	InCorrelationPattern	Lorsque la première corrélation est utilisée par l'activité invoke, il peut s'agir d'une demande, d'une réponse ou d'une demande-réponse
Second motif de corrélation	OutCorrelationPattern	Lorsque la seconde corrélation est utilisée par l'activité invoke, il peut s'agir d'une demande, d'une répondre ou d'une demande-réponse
—	InCorrelationInitiate	Lorsque la première corrélation est utilisée par l'activité invoke, l'attribut initiate peut prendre la valeur yes, no ou join.
—	OutCorrelationInitiate	Lorsque la seconde corrélation est utilisée par l'activité invoke, l'attribut initiate peut prendre la valeur yes, no ou join
—	expressionLanguage	Spécifie le langage utilisé dans les expressions

Lorsque l'opération appelée est une opération One-Way (sens unique), l'attribut Correspondance de message du message envoyé correspond à la variable invoke définie pour l'activité invoke BPEL et l'attribut Clé de corrélation correspond à l'élément de corrélation de l'activité BPEL :

Lorsque l'opération appelée est une opération Request-Response (demande-réponse), l'attribut Correspondance de message du message reçu correspond à la variable d'entrée définie pour l'activité invoke et l'attribut Correspondance de message du message envoyé correspond à la variable de sortie.