Configuration des composants de traitement des documents à l'aide de récupérateurs

Cette section décrit plus en détail les composants de WebSphere Partner Gateway et indique les divers points auxquels vous pouvez (ou devez) modifier le comportement système des composants pour le traitement d'un document métier.

Pour modifier le comportement fourni par le système des cibles, passerelles, étapes de flux de travaux fixes et actions, vous utiliserez des récupérateurs. Il existe deux types de récupérateurs -- ceux fournis par WebSphere Partner Gateway et ceux définis par l'utilisateur. Pour plus d'informations sur la création des récupérateurs, voir le Programmer Guide.

Une fois qu'un récupérateur est créé, téléchargez-le pour le rendre disponible. Ne téléchargez que les récupérateurs définis par l'utilisateur. Ceux qui sont fournis par WebSphere Partner Gateway sont déjà disponibles.

Les sections suivantes décrivent les étapes du processus où vous pouvez spécifier des récupérateurs.

Cibles

Les cibles disposent de trois points de configuration pour lesquels des récupérateurs peuvent être spécifiés : Preprocess, SyncCheck et Postprocess.

Figure 8. Points de configuration cible
Cette figure montre comment un document passe par les étapes Preprocess et SyncCheck avant d'être reçu par le Gestionnaire de documents, et comment l'étape Postprocess peut éventuellement être utilisée pour la réponse par le Gestionnaire de documents, dans une transaction synchrone

La procédure s'exécute dans l'ordre suivant :

  1. Une fois qu'il a reçu le document, le Réceptionnaire appelle les étapes Preprocess et SyncCheck.
  2. Il appelle ensuite le Gestionnaire de documents pour traiter le document.
  3. Dans le cas de flots synchrones, le Gestionnaire de documents apporte une Réponse synchrone. Le Réceptionnaire appelle ensuite l'étape Postprocess avec la réponse retournée par le Gestionnaire de documents.

Les procédures sont décrites dans les sections suivantes :

Gestionnaire de documents

Les documents reçus par les cibles sont récupérés par le Gestionnaire de documents dans le système de fichiers commun, pour être traités. Le Gestionnaire de documents utilise les connexions du participant pour router les documents. Tous les documents qui transitent par le Gestionnaire de documents suivent plusieurs flux de travaux : flux de travaux fixe de communication entrante, flux de travaux variable et flux de travaux fixe de communication sortante. A la fin de ce dernier flux, la connexion avec le participant est déterminée. Elle indique l'action à effectuer sur ce document. Après avoir effectué le flux de travaux variable, le Gestionnaire de documents effectue le flux de travaux fixe de communication sortante sur ce document.

Figure 9. Flux de travaux fixe et actions
Cette figure montre le flot de documents, depuis les étapes du flux de travaux fixe de communication entrante, à travers une action, et jusqu'aux étapes du flux de travaux fixe de communication sortante

La figure 9 montre le cheminement d'un PIP RosettaNet ou d'un service Web. Certains documents exigent néanmoins plusieurs flots configurés. Par exemple, un EDI peut consister en plusieurs transactions. Le premier flot utilise une action pour désenvelopper l'ensemble des transactions individuelles. Chacune de ces transactions est réintroduite et traitée dans son propre flot configuré.

Figure 10. Flux de travaux fixe et actions pour un EDI
Cette figure montre le traitement d'un EDI par le flux de travaux fixe de communication entrante, et comment l'action de désenveloppement crée plusieurs transactions, qui sont traitées par le flux de travaux fixe de communication sortante

Flux de travaux fixe de communication entrante

Le flux de travaux fixe de communication entrante consiste en un ensemble standard d'étapes de traitement, exécutées sur tous les documents émis par un Réceptionnaire et reçus par le Gestionnaire de documents. Le flux de travaux est fixe car le nombre et le types des étapes sont toujours les mêmes. Toutefois, au moyen d'exits utilisateurs, vous pouvez fournir des récupérateurs personnalisés pour le dégroupement et le traitement de protocole. La dernière étape du flux de travaux fixe de communication entrante consiste à rechercher la connexion du participant, qui détermine le flux de travaux variable qui s'exécute pour ce document métier.

Par exemple, si un message AS2 est reçu, il est décrypté, l'ID métier de l'expéditeur et du réceptionnaire sont extraits. La procédure de flux de travaux fixe de communication entrante convertit le document AS2 en texte en clair pour les traitements suivants par WebSphere Partner Gateway, et extrait les informations de sorte que l'action pour le message puisse être déterminée.

Figure 11. Flux de travaux fixe de la communication entrante
Cette figure montre comment un document, en cours de flux de travaux fixe de communication entrante, subit le dégroupement de protocole lors de l'étape de traitement de protocole
Dégroupement de protocole

Le Dégroupement de protocole consiste à dégrouper un document pour que son traitement puisse se poursuivre. Ce processus peut inclure le déchiffrement, la décompression, la vérification de signature, l'extraction d'informations d'acheminement, l'authentification utilisateur ou l'extraction de parties de documents métiers.

WebSphere Partner Gateway fournit des récupérateurs pour les regroupements RNIF, AS, Intégration dorsale et Aucun. Si des récupérateurs d'autres types sont nécessaires, vous pouvez les développer en tant qu'exits utilisateur. Consulter le Programmer Guide pour plus d'informations sur la programmation d'exits utilisateur.

Vous ne pouvez pas modifier l'étape de Dégroupement de protocole. Toutefois, vous pouvez lui ajouter une logique métier à l'aide de récupérateurs.

Voir Configuration des flux de travaux fixes pour obtenir des informations sur la configuration de cette étape.

Etape de traitement de protocole

Le traitement de protocole implique de déterminer des informations spécifiques au protocole, pouvant aller jusqu'à l'analyse syntaxique du message pour obtenir des informations sur l'acheminement (telles que ID de l'émetteur et du réceptionnaire), sur le protocole et le flot de documents. WebSphere Partner Gateway peut traiter plusieurs protocoles, comme indiqué dans la section Récupérateurs de traitement de protocole. Le traitement pour d'autres protocoles, par exemple CSV (valeurs séparées par des virgules), peut être assuré grâce à un exit utilisateur.

Vous ne pouvez pas modifier l'étape de Dégroupement de protocole. Toutefois, vous pouvez lui procurer une logique métier en ajoutant des récupérateurs.

Voir Configuration des flux de travaux fixes pour obtenir des informations sur la configuration de cette étape.

Vous pouvez utiliser le récupérateur par défaut qui s'applique au protocole de votre document ou vous pouvez indiquer un autre récupérateur pour les étapes de flux de travaux fixe de Dégroupement et traitement de protocole.

Actions

L'étape suivante dans la séquence de traitement dépend des actions définies pour l'échange de documents. Les actions sont constituées d'un nombre variable d'étapes qui peuvent être exécutées sur le document. La validation d'un document (pour le rendre conforme à un ensemble de règles déterminé) et sa conversion au format exigé par le destinataire sont autant d'exemples d'action.

Si le document n'est soumis à aucune étape spécifique, il peut utiliser l'action passe-système fournie par le système, qui n'applique aucune modification au document.

Figure 12. Etapes d'une action
Cette figure montre que les actions ont un nombre variable d'étapes

Vous ne pouvez pas modifier une action fournie par le système. Vous pouvez toutefois créer une action (et ajouter des récupérateurs à la liste des éléments configurés) ou copier une action fournie par le système puis modifier la liste des récupérateurs.

Consultez la section Configuration des actions pour plus d'informations sur la création ou la copie d'une action fournie par le système, ainsi que sur la configuration d'une action définie par l'utilisateur.

Flux de travaux fixe de communication sortante

Le flux de travaux fixe de la communication sortante consiste en une seule étape, le regroupement du document et des informations de protocole correspondantes. Par exemple, si ce document a été configuré dans le but d'être reçu par une application dorsale utilisant un regroupement Intégration dorsale, certaines informations d'en-tête sont ajoutées au document avant qu'il soit transmis à la passerelle.

Figure 13. Flux de travaux fixe de la communication sortante
Cette figure montre l'étape de regroupement de protocole appliquée à un document, avant qu'il ne soit livré

WebSphere Partner Gateway fournit des récupérateurs adaptés à divers regroupements et protocoles, indiqués dans la section Flux de travaux de communication sortante. Si d'autres récupérateurs de regroupement sont nécessaires, vous pouvez les développer en tant qu'exit utilisateur. En général, ces étapes prennent en charge un ou plusieurs des processus suivants :

Vous ne pouvez pas modifier l'étape de regroupement de protocole. Toutefois, vous pouvez lui ajouter une logique métier à l'aide de récupérateurs.

Voir Configuration des flux de travaux fixes pour obtenir des informations sur la configuration de cette étape du flux de travaux.

Passerelles

Après avoir quitté le Gestionnaire de documents, le document est envoyé au destinataire prévu à partir de la passerelle. La passerelle dispose de deux points de configuration -- Preprocess et Postprocess.

Figure 14. Points de configuration de la passerelle
Cette figure montre l'étape Preprocess appliquée à un document avant qu'il ne soit livré, et que l'étape Postprocess peut également lui être appliquée, avant sa livraison

Voir Configuration de récupérateurs pour obtenir des informations sur le paramétrage des étapes Preprocess et Postprocess.

Copyright IBM Corp. 2003, 2005