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 Business Integration Connect et présente les divers endroits où vous pouvez modifier le comportement des composants au niveau du système. pour le traitement d'un document commercial.

Utilisez un récupérateur pour modifier le comportement des cibles fournies par le système, les passerelles, les étapes de flux de travaux et les actions. Il existe deux types de récupérateurs -- ceux fournis par WebSphere Business Integration Connect et ceux définis par l'utilisateur. Pour plus d'informations sur la création des récupérateurs, voir le manuel Programmer Guide.

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 5. Points de configuration cible


Preprocess est généralement utilisé pour tout traitement sur le document (par exemple, la séparation d'un document) qui dit être accompli avant que le document ne soit envoyé au système de fichiers partagés.

SyncCheck est utilisé pour déterminer si le document est synchrone ou asynchrone. WebSphere Business Integration Connect fournit les récupérateurs suivants pour le contrôle de synchrone :

Comme vous pouvez le constater à partir des conventions de dénomination, les quatre premiers récupérateurs s'appliquent de manière spécifique aux quatre transports qui peuvent être utilisés pour les transactions synchrones. Toute demande utilisant le récupérateur DefaultAsynchronousSyncCheckHandler sera traitée comme une demande asynchrone. Toute demande utilisant le récupérateur DefaultSynchronousSyncCheckHandler sera traitée comme une demande synchrone.

Postprocess est utilisé pour le traitement du document de réponse qui est envoyé comme résultat d'une transaction synchrone.

Dans le cas des transferts HTTP/S et de ceux définis par l'utilisateur, vous pouvez ajouter des récupérateurs qui seront appelés aux trois points de configuration disponibles pour les cibles. Dans le cas de documents AS2, cXML, RNIF et SOAP, vous devez spécifier le récupérateur SyncCheck. Cette procédure est décrite à la section Modification des points de configuration.

Lorsque vous sélectionnez un point de configuration lors de la création d'une cible HTTP/S ou définie par l'utilisateur, vous voyez s'afficher deux listes de récupérateurs : les récupérateurs configurés et les récupérateurs disponibles. La liste des récupérateurs configurés affiche les récupérateurs qui ont été configurés pour la cible. La liste des récupérateurs disponibles affiche les récupérateurs pouvant être utilisés pour configurer la cible.

Vous pouvez manipuler les récupérateurs dans la liste des récupérateurs configurés, en mettant en surbrillance un récupérateur à l'aide des boutons de contrôle (déplacement vers le haut ou déplacement vers le bas).

Les illustrations suivantes indiquent la liste des récupérateurs disponibles pour le point de configuration SyncCheck.

Figure 6. Listes de récupérateurs disponibles et configurés


Vous pouvez ajouter vos propres récupérateurs à ceux fournis par le système en téléchargeant un récupérateur cible défini par l'utilisateur. Utilisez l'option Importer de la page Liste des récupérateurs pour télécharger un récupérateur défini par l'utilisateur.

Figure 7. Liste des récupérateurs


Lorsque vous téléchargez un récupérateur cible défini par l'utilisateur, le récupérateur est ajouté à la liste des récupérateurs. Il apparaît également sur la liste des récupérateurs disponibles pour le type de point de configuration auquel il appartient.

Vous pouvez effectuer des transferts de la liste des récupérateurs disponibles vers la liste des récupérateurs configurés ou retirer des récupérateurs de la liste des récupérateurs configurés, ou encore modifier l'ordre d'affichage des récupérateurs.

Remarque : Les récupérateurs sont appelés dans l'ordre d'apparition de la liste des récupérateurs configurés, mais le premier récupérateur n'est pas toujours celui utilisé pour configurer la cible. Le premier récupérateur disponible (le premier capable de traiter la demande) est utilisé. Par exemple, supposons que trois récupérateurs soient configurés pour une cible (Handler1, Handler2 et Handler3, dans l'ordre indiqué). Si une demande est effectuée pour un récupérateur, le premier récupérateur qui répond à la demande est celui qui traite cette demande, et les récupérateurs suivants (dans la liste des récupérateurs configurés) ne sont pas appelés. Dans cet exemple, si Handler2 répond en premier, Handler3 n'est jamais appelé.

Gestionnaire de documents

Lorsqu'un document est envoyé par la cible à destination du système de fichiers partagés, le Gestionnaire de documents reçoit l'instruction de récupérer ce document en vue de son traitement. Tout traitement de document, indépendamment du regroupement de protocole, et le flot de documents implique l'utilisation d'étapes de flux de travaux fixe de la communication entrante, une ou plusieurs actions (étapes de flux de travaux variable) et une étape de flux de travaux de la communication sortante.

Figure 8. Flux de travaux fixe et actions


Flux de travaux fixe de la communication entrante

Le flux de travaux fixe de la communication entrante est constitué de deux étapes destinées à dégrouper le protocole et à effectuer une analyse syntaxique du document. 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.

Les étapes de flux de travaux fixe de la communication entrante convertissent le document AS2 en texte en clair pour les prochains traitements par WebSphere Business Integration Connect et extraient les informations de sorte que l'action pour le message puisse être déterminée.

Figure 9. Flux de travaux fixe de la communication entrante


Le protocole métier du document détermine comment les deux étapes extraient ces informations. Au minimum, le document ou le message doit inclure les ID de l'expéditeur et du réceptionnaire, et la définition de flot de documents (regroupement, protocole et flot de documents).

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 l'étape du flux de travaux fixe.

Figure 10. Liste d'étape du flux de travaux fixe de la communication entrante


Une fois que vous avez cliqué sur l'icône représentant une loupe, vous voyez les récupérateurs que vous pouvez sélectionner pour chacune des étapes de flux de travaux fixe de la communication entrante :

Figure 11. Page Détails de l'étape


Les étapes du flux de travaux qui sont préconfigurées avec le système s'affiche dans la liste des récupérateurs configurés. Vous ne pouvez pas modifier ces étapes ; toutefois, vous pouvez ajouter une logique métier aux étapes en ajoutant des récupérateurs.

Pour ajouter des récupérateurs définis par l'utilisateur pour une étape de flux de travaux de la communication entrante, téléchargez le fichier représentant le récupérateur. Après le téléchargement du fichier, ce dernier apparaît dans la liste des récupérateurs disponibles ; vous pouvez l'ajouter à la liste des récupérateurs configurés.

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 d'étapes variable 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'apporte aucune modification au document.

Figure 12. Etapes d'une action


La manière dont les récupérateurs sont traités pour les actions est différente de celle dont ils sont traités pour les cibles, les passerelles et les flux de travaux fixes. Pour les actions, tous les récupérateurs de la liste de récupérateurs configurés sont appelés et ils sont tous utilisés conformément à leur ordre d'apparition dans la liste.

Flux de travaux fixe de la communication sortante

Le flux de travaux fixe de la communication sortante consiste en une seule étape, à savoir, 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 d'intégration dorsale, certaines informations d'en-tête sont ajoutées au document avant d'être transmis à la passerelle.

Figure 13. Flux de travaux fixe de la communication sortante


Vous pouvez visualiser les étapes de flux de travaux de la communication sortante fourni par le système en sélectionnant Configuration du concentrateur > Flux de travaux fixes > Communication sortante. Pour télécharger un descripteur défini par l'utilisateur à ajouter à la liste de descripteurs définis par l'utilisateur, sélectionnez Configuration du concentrateur > Récupérateurs > Flux de travaux fixes et sélectionnez Importer pour télécharger le récupérateur défini par l'utilisateur.

Passerelles

Après avoir quitté le Gestionnaire de documents, le document est envoyé au destinataire prévu à partir de la passerelle. La passerelle présente deux points de configuration : le traitement préalable et le traitement ultérieur.

Figure 14. Points de configuration de la passerelle


Preprocess intervient dans le traitement d'un document avant qu'il ne soit envoyé au réceptionnaire. Le traitement (Process) correspond à l'envoi réel du document. Postprocess agit sur les résultats de la transmission du document (par exemple, sur la réponse reçue du destinataire lors d'une transmission synchrone).

Il n'existe pas de conditions préalables à la configuration des récupérateurs pour les protocoles WebSphere Business Integration pris en charge pour la connexion lorsque vous définissez une passerelle (étant donné qu'il existe dans le cas de certains protocoles métier utilisés dans des transactions synchrones lorsque vous configurez les cibles.

Comme vous configurez des cibles, des passerelles et des flots de documents dans les chapitres suivants, vous verrez comment vous pouvez (devez) spécifier un récupérateur pour un point de configuration spécifique. Si vous envisagez d'appliquer des récupérateurs définis par l'utilisateur aux points de configuration, vous devez d'abord télécharger les fichiers correspondant à ces récupérateurs dans le concentrateur. Cette procédure est décrite à la section Téléchargement de récupérateurs définis par l'utilisateur.

Remarque : Les récupérateurs fournis par WebSphere Business Integration n'ont pas besoin d'être téléchargés.

Copyright IBM Corp. 1997, 2004