Modification des points de configuration

Le nombre de points de configuration disponibles et de récupérateurs associés varie en fonction du type de cible défini. Par exemple, le point de configuration SyncCheck n'est disponible qu'avec les cibles HTTP/S et JMS.

Pour certains protocoles métiers (RosettaNet, cXML, SOAP et AS2) impliqués dans les échanges synchrones, vous devez spécifier un récupérateur pour le point de configuration SyncCheck. Vous pouvez également modifier la façon dont les cibles traitent les documents, en appliquant un récupérateur téléchargé défini par l'utilisateur (ou un processus fourni par le système) aux autres points de Preprocess et Postprocess de la cible.

Pour appliquer un récupérateur écrit par l'utilisateur à ces points de configuration, vous devez d'abord télécharger le récupérateur, comme décrit dans la section Téléchargement de récupérateurs définis par l'utilisateur. Vous pouvez également utiliser un récupérateur fourni par le système, déjà disponible et qu'il n'est pas nécessaire de télécharger.

Preprocess

Le récupérateur de configuration Preprocess est disponible pour tous les types de cibles, mais n'est pas applicable aux cibles SMTP.

Attributs Preprocess

Le tableau 3 décrit les attributs que vous pouvez définir dans un récupérateur Preprocess, ainsi que les récupérateurs de fractionnement auxquels s'appliquent ces attributs.

Les attributs ROD pris comme exemple dans ce tableau correspondent à ceux utilisés Exemple ROD vers EDI. Dans cet exemple, les attributs ROD sont contenus dans la mappe S_DT_ROD_TO_EDI.eif, qui comprend les définitions suivantes de flot de documents :

Le métadictionnaire et le métadocument ROD associés à ce flot sont ROD_TO_EDI_DICT et DTROD-TO-EDI_ROD.

Tableau 3. Attributs de récupérateur de fractionnement
Attribut Description Récupérateur de fractionnement
Codage Le codage des caractères du document. La valeur par défaut est ASCII. ROD
Générique
XML
EDI
BATCHDOCS Lorsque l'attribut BCG_BATCHDOCS est activé (on), l'utilitaire de fractionnement ajoute des ID de traitement aux documents après les avoir séparés. Si les documents sont transformés en transactions EDI pour être enveloppées, l'Enveloppeur utilise ces ID de traitement pour s'assurer que les transactions sont (si possible) mises dans le même EDI avant d'être livrées. Notez que pour cela, l'Enveloppeur doit avoir l'attribut de traitement par lots (batching) défini sur On (la valeur par défaut). Voir Mode de traitement par lot. ROD
Générique
XML
Nom du regroupement d'origine Le regroupement associé au document. La valeur doit correspondre au regroupement indiqué dans la définition du flot de documents. Par exemple, pour un document dont le regroupement est Aucun, la valeur doit être Aucun. ROD
Générique
Version du regroupement d'origine La version du regroupement indiquée dans le Nom du regroupement d'origine. Par exemple, pour un document dont le regroupement est Aucun, la valeur doit être N/A. ROD
Générique
Nom du protocole d'origine Le protocole associé au document. La valeur doit correspondre au protocole indiqué dans la définition du flot de documents. Par exemple, pour un document ROD, cette valeur doit être ROD-TO-EDI_DICT. ROD
Générique
Version du protocole d'origine La version du protocole indiquée dans le Nom du regroupement d'origine. Par exemple, pour le protocole ROD-TO-EDI_DICT, la valeur doit être TOUT. ROD
Générique
Code du processus d'origine Le processus (flot de document) associé à ce document. La valeur doit correspondre au flot de document indiqué dans la définition du flot de documents. Par exemple, pour un document ROD, cette valeur doit être DTROD-TO-EDI_ROD. ROD
Générique
Version du processus d'origine La version du processus indiquée dans le Code du processus d'origine. Par exemple, pour DTROD-TO-EDI_ROD, cette valeur doit être TOUT. ROD
Générique
Métadictionnaire Le métadictionnaire donne des informations qui permettent à WebSphere Partner Gateway d'interpréter les données. Par exemple, pour un document ROD document, cette valeur doit être ROD-TO-EDI_DICT. ROD
Générique
Métadocument Le métadocument donne des informations qui permettent à WebSphere Partner Gateway d'interpréter les données. Par exemple, pour un document ROD, cette valeur doit être DTROD-TO-EDI_ROD. ROD
Générique
Métasyntaxe La métasyntaxe décrit le format du document en cours de fractionnement. La valeur par défaut est rod. ROD
Générique

Remarques :
  1. Une instance de cible n'accepte qu'un seul type de document ROD.
  2. Si une cible dispose de plusieurs récupérateurs de fractionnement configurés (par exemple des récupérateurs de fractionnement ROD, XML et EDI), le récupérateur de fractionnement ROD doit être le dernier dans la Liste configurée.

Modification du point de configuration Preprocess

Pour modifier le point de configuration Preprocess, procédez comme suit :

  1. Sélectionnez Preprocess dans la liste Récupérateurs des points de configuration.

    Quatre récupérateurs preprocess sont fournis (par défaut) et figurent dans la Liste des récupérateurs disponibles.

    Remarque : Les récupérateurs Preprocess ne s'appliquent pas aux cibles SMTP.
  2. Si vous comptez recevoir plusieurs EDI ou documents XML ou ROD qui doivent être fractionnés, veillez à sélectionner le bon récupérateur de fractionnement. Pour configurer l'étape Preprocess :
    1. Sélectionnez un récupérateur dans la Liste des récupérateurs disponibles et cliquez sur Ajouter. Notez que le récupérateur passe de la Liste des récupérateurs disponibles à la Liste des récupérateurs configurés, comme illustré dans la figure 17:
      Figure 17. Configuration du preprocess
      Cette figure montre comment déplacer le récupérateur de fractionnement ROD depuis la Liste disponible vers la Liste configurée
    2. Répétez cette étape pour chaque récupérateur que vous souhaitez ajouter à la liste des récupérateurs configurés.

      N'oubliez pas que pour les cibles, les récupérateurs sont appelés dans leur ordre d'apparition dans la liste des récupérateurs configurés. Le premier récupérateur disponible traite la requête et les récupérateurs suivants de la liste ne sont pas appelés.

    3. Pour configurer le récupérateur, sélectionnez-le et cliquez sur Configurer:
      • Si vous avez ajouté le récupérateur EDISplitterHandler, vous pouvez modifier le codage de ses attributs. Le codage par défaut est ASCII.
      • Si vous avez ajouté le récupérateur XMLSplitterHandler, vous pouvez modifier le codage de ses attributs (BCGBATCHDOCs). La valeur par défaut est ON. Voir Attributs Preprocess pour obtenir des informations sur cet attribut.
      • Si vous avez ajouté le récupérateur RODSplitterHandler, vous pouvez préciser des valeurs pour 11 attributs. Les attributs Codage, BATCHDOCS et Métasyntaxe ont des valeurs par défaut. Vous devez saisir une valeur pour les autres attributs, à savoir Nom du regroupement d'origine, Version du regroupement d'origine, Nom du protocole d'origine, Version du protocole d'origine, Code du processus d'origine, Version du processus d'origine, Métadictionnaire et Métadocument. Voir Attributs Preprocess pour obtenir des informations sur ces attributs.
      • Si vous avez ajouté le GenericDocumentFlowHandler, vous pouvez préciser des valeurs pour 11 attributs. Le codage et BATCHDOCS ont des valeurs par défaut. Vous devez saisir une valeur pour les autres attributs, à savoir Nom du regroupement d'origine, Version du regroupement d'origine, Nom du protocole d'origine, Version du protocole d'origine, Code du processus d'origine, Version du processus d'origine, Métadictionnaire, Métadocument et Métasyntaxe. Voit Attributs Preprocess pour obtenir des informations sur ces attributs.

SyncCheck

Le point de configuration SyncCheck n'est disponible que pour les cibles HTTP/S et JMS.

Pour spécifier un récupérateur pour un protocole métier impliqué dans un échange synchrone, procédez comme suit :

  1. Sélectionnez SyncCheck dans la liste Récupérateurs des points de configuration.

    Six récupérateurs SyncCheck sont fournis (par défaut) pour une cible HTTP/S. Ces récupérateurs figurent dans la Liste des récupérateurs disponible :

    Par exemple, si vous configurez une cible HTTP/S, la Liste des récupérateurs disponibles se présente ainsi :

    Figure 18. Liste des récupérateurs disponibles pour un point de configuration SyncCheck HTTP/S
    Cette figure monte la Liste disponible pour le point de configuration SyncCheck, pour des cibles HTTP et HTTPS

    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 types de documents 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.

    DefaultAsynchronousSyncCheckHandler et DefaultSynchronousSyncCheckHandler peuvent être utilisés avec d'autres cibles (telles qu'une cible JMS).

  2. Si vous envisagez de recevoir des documents synchrones sur cette cible, procédez comme suit :
    1. Sélectionnez un ou plusieurs récupérateurs dans la Liste des récupérateurs disponibles et cliquez sur Ajouter.
    2. Répétez cette étape si vous voulez ajouter d'autres récupérateurs à la liste. N'oubliez pas que pour les cibles, les récupérateurs sont appelés dans leur ordre d'apparition dans la liste des récupérateurs configurés. Le premier récupérateur disponible traite la requête et les récupérateurs suivants de la liste ne sont pas appelés.

    Pour les cibles HTTP et HTTPS, il est très judicieux d'indiquer le récupérateur spécifique SyncCheck (par exemple, com.ibm.bcg.server.sync.As2SyncHdlr pour les transactions AS2), avant le récupérateur par défaut SyncCheck.

Postprocess

Aucun récupérateur n'étant fourni par défaut pour le postprocess, aucun n'est indiqué par défaut dans la Liste des récupérateurs disponibles. Vous pouvez toutefois télécharger un récupérateur pour ce point de configuration pour tous les types de cibles qui prennent en charge les communications synchrones. Les types de récupérateurs disponibles pour l'étape de postprocess sont :

Vous pouvez ajouter un récupérateur de postprocess en en téléchargeant un qui soit conforme à l'un de ces types. 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. 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.

Pour modifier le point de configuration Postprocess, procédez comme suit :

  1. Sélectionnez Postprocess dans la liste Récupérateurs des points de configuration.
  2. Sélectionnez un récupérateur défini par l'utilisateur dans la Liste des récupérateurs disponibles et cliquez sur Ajouter. Notez que le récupérateur passe de la Liste des récupérateurs disponibles à la Liste des récupérateurs configurés.

Modification de la Liste des récupérateurs configurés

Si vous souhaitez modifier l'ordre des récupérateurs, en supprimer un ou configurer des attributs, procédez comme suit :

Copyright IBM Corp. 2003, 2005