Comme indiqué dans la précédente section, vous pouvez préciser de nombreux attributs portant sur l'échange d'EDI. Par exemple, vous pouvez modifier les profils d'enveloppe fournis par le système, définir des enveloppes spécifiques à utiliser pour certaines connexions, déterminer les numéros de contrôle affectés aux diverses parties d'un EDI et configurer des profils de connexion pour que le même EDI puisse être livré de façons différentes. Ces tâches sont décrites dans la présente section.
L'Enveloppeur est le composant qui rassemble un groupe de transactions à envoyer à un participant, les place dans une enveloppe et les envoie. Planifiez l'Enveloppeur (ou acceptez la planification par défaut) pour indiquer à WebSphere Partner Gateway quand vous souhaitez que l'Enveloppeur recherche les transactions qui attendent d'être envoyées. Vous pouvez également mettre à jour les valeurs par défaut de la durée de verrouillage, la durée de la file d'attente et du mode de traitement par lot.
Chaque instance du Gestionnaire de documents possède son propre Enveloppeur. Si deux Gestionnaires de documents sont installés sur le système, vous disposez de deux Enveloppeurs. Deux instances (ou plus) d'Enveloppeurs peuvent donc tenter d'interroger des transactions qui attendent d'être enveloppées. Pour s'assurer qu'une transaction sera interrogée par un seul Enveloppeur, il est fait usage de verrous. Ces verrous assurent que s'il existe plus d'un Enveloppeur, un seul d'entre eux pourra interroger et traiter une transaction donnée. Les Enveloppeurs interrogent simultanément, mais travaillent sur des transactions différentes.
Le verrou reçoit un limite de validité. La durée par défaut pendant laquelle un Enveloppeur peut maintenir le verrou est de 240 secondes.
Si l'Enveloppeur doit attendre le verrou, il est mis en file d'attente. La durée d'attente maximale dans la file (durée d'attente de l'Enveloppeur) est de 740 secondes.
En règle générale, vous n'aurez pas besoin de modifier ces valeurs par défaut.
Si plusieurs documents arrivent dans un même fichier, ils peuvent être fractionnés, selon la définition de l'utilitaire de fractionnement que vous avez faite pour ce type de document. (La configuration des récupérateurs de fractionnement fait partie de la définition des cibles. Elle est décrite Modification des points de configuration.) BCG_BATCHDOCS est l'un des attributs du récupérateur fractionnement. Lorsque BCG_BATCHDOCS est activé (on), l'utilitaire de fractionnement ajoute des ID de traitement aux documents après les avoir séparés.
L'Enveloppeur dispose d'un attribut pour le mode de traitement par lots, qui est associé à l'attribut BCG_BATCHDOCS. Si des ID de traitement par lots ont été attribués aux documents individuels, et si vous acceptez la valeur par défaut du mode de traitement par lots, l'Enveloppeur s'assure que tous les documents qui arrivent ensemble dans le même fichie sont traités avant d'être enveloppés et envoyés. Vous êtes donc sûr que les transactions seront enveloppées ensemble. Par exemple, supposons que cinq documents XML arrivent dans le même fichier. Ils doivent être transformés en transactions EDI et livrés au même destinataire. Lorsque trois des documents ont été transformés, l'Enveloppeur commence son interrogation planifiée des transactions. Si le mode de traitement par lot est sélectionné, l'Enveloppeur ne traite (enveloppe) pas les trois transactions qui sont prêtes. Il attend que le traitement des cinq transactions soit terminé avant de les envelopper et de les envoyer. Elles sont placées dans la même enveloppe, à moins que le standard EDI applicable ne l'interdise.
Pour modifier les valeurs par défaut de l'Enveloppeur, procédez comme suit :
Un profil d'enveloppe détermine les valeurs placées dans des éléments spécifiques de l'enveloppe. Vous affectez le profil d'enveloppe à des transactions EDI dans l'attribut Profil d'enveloppe de définition du flot de documents. WebSphere Partner Gateway fournit un profil d'enveloppe prédéfini pour chaque standard pris en charge (X12, EDIFACT ou UCS). Vous pouvez utiliser ces enveloppes prédéfinies directement, les modifier ou les copier dans de nouveaux profils d'enveloppe. Les étapes pour créer ou modifier un profil d'enveloppe sont indiquées à la section Modification des valeurs par défaut.
Les profils d'Enveloppe contiennent une zone pour chaque élément du standard d'enveloppe. Ils fournissent des données littérales ou des constantes pour concevoir des segments d'en-tête ou de fin adaptés aux ensembles de transactions, messages, groupes fonctionnels et EDI. Précisez uniquement les informations nécessaires et pour lesquelles aucune valeur n'est fournie par d'autres sources.
Les noms de zones sont conçus pour faciliter les références croisées. Par exemple, la zone UNB03 est le troisième élément de données du segment UNB.
Comme indiqué dans la section Attributs d'enveloppe, les attributs configurés dans d'autres éléments sont prioritaires sur ceux qui ont été définis dans le profil d'enveloppe. Certains attributs peuvent être supplantés par les attributs et mappes liés à la définition des flots de documents.
Des attributs d'enveloppe peuvent être définis à plusieurs moments de la configuration de l'échange, ainsi que dans la mappe de transformation associée aux documents. Par exemple, le spécialiste de mappage du client Data Interchange Services peut définir la propriété CtlNumFlag lorsqu'il définit une mappe. Cette propriété peut également être configurée dans le profil d'enveloppe (dans la zone Numéros de contrôle par ID de transaction). Tout attribut défini dans la mappe de transformation supplante les valeurs configurées sur la Console de communauté. Par exemple, si CtlNumFlag est défini sur N (non) dans la mappe de transformation et sur Y (oui) dans la zone Numéros de contrôle par ID de transaction, c'est la valeur N qui est utilisée.
D'autres profils d'enveloppe peuvent être définis au niveau du protocole (à partir de la page Gérer des définitions de flots de documents ou de la page Capacités B2B associée au participant) ou en tant que partie de la connexion. La liste ci-dessous précise les priorités :
Pour consulter la liste des propriétés de mappe de transformation et les attributs de Console de communauté associés, voir Propriétés du client Data Interchange Services.
La section Attributs de profil d'enveloppe présente un tableau indiquant les valeurs par défaut utilisées pour chaque attribut d'enveloppe de standard EDI, si vous n'entrez pas de valeur dans le profil ou si vous ne créez pas de profil. Assurez-vous que les profils d'enveloppe que vous utilisez fournissent tous les éléments obligatoires qui ne sont pas fournis par le système lors de l'exécution.
Pour définir un profil d'enveloppe, procédez comme suit :
Vous pouvez ajouter des valeurs dans les zones suivantes :
Les zones du profil général d'enveloppe sont les mêmes pour les trois standards, sauf pour EDIFACT qui compte une zone supplémentaire : Créer des groupes pour EDI.
Si vous avez apporté des modifications à la page Général, cliquez sur Enregistrer.
Si vous avez apporté des modifications à la page EDI, cliquez sur Enregistrer.
Les zones de cette page définissent généralement l'émetteur et le réceptionnaire du groupe.
Si vous avez apporté des modifications à la page Groupe, cliquez sur Enregistrer.
Si vous avez apporté des modifications à la page Transaction, cliquez sur Enregistrer.
Lorsqu'un profil d'enveloppe est défini, il s'ajoute à la liste des profils d'enveloppe. Vous pouvez y sélectionner le profil et cliquer sur l'icône Cas d'emploi pour déterminer les connexions qui utilisent le profil.
Vous utilisez des profils de connexions avec des transactions désenveloppées et des EDI créés par l'Enveloppeur. Pour les transactions, le profil de connexion détermine le mode de traitement de la transaction une fois qu'elle est désenveloppé. Pour les EDI, le profil de connexion détermine leur mode de livraison.
La table suivante indique les attributs de profil de connexion, les noms de zones correspondants sur la page de détails Profil de connexion, et indique s'ils s'appliquent aux EDI ou aux transactions :
Attribut | Nom de la zone | EDI | Transaction EDI |
---|---|---|---|
Qualificatif 1 de profil de connexion | Qualificatif 1 | X | |
Indicateur de syntaxe EDI | Type de syntaxe EDI | X | |
Identificateur d'émetteur d'application de groupe | ID de l'émetteur de l'application | X | |
Identificateur de réceptionnaire d'application de groupe | ID du réceptionnaire de l'application | X | |
Mot de passe d'application de groupe | Mot de passe | X |
Lorsqu'un EDI arrive dans WebSphere Partner Gateway, la première opération consiste généralement à le désenvelopper en transactions individuelles. Lorsque les transactions sont créées, l'action de désenveloppement définit l'Indicateur d'utilisation de l'EDI et les informations de groupe (l'Identificateur de l'émetteur d'application de groupe, l'Identificateur du réceptionnaire d'application de groupe, et le Mot de passe d'application de groupe) dans les métadonnées de la transaction. Chaque transaction est ensuite à nouveau traitée par WebSphere Partner Gateway, dans son propre flot de travaux.
Prenons deux transactions de même type (par exemple 850) qui doivent être traitées différemment en fonction du groupe auquel elles appartenaient et des valeurs de leurs indicateurs d'utilisation EDI. Si l'Indicateur d'utilisation est Production (P), vous souhaiterez peut-être utiliser une mappe (A), et si l'Indicateur d'utilisation est Test (T), vous utiliserez une autre mappe (B). Deux connexions identiques sont requises pour cette transaction 850, la seule différence étant que l'une des connexions utilise la mappe A et l'autre la mappe B.
Les transactions étant identiques (mêmes participants source et cible, regroupement, protocole et type de document), le Gestionnaire de documents doit pouvoir déterminer laquelle utiliser. Il utilise pour cela l'attribut de profil de connexion que vous avez indiqué dans les métadonnées de la transaction. Dans cet exemple, si vous créez deux profils de connexion, l'un (CPProduction) avec le Type de syntaxe EDI défini sur P et l'autre (CPTest) sur T, le Gestionnaire de documents fait correspondre la transaction dont l'identificateur de syntaxe est P avec le profil CPProduction. Il sait ensuite utiliser la mappe A pour convertir la transaction.
L'exemple de cette section utilise un attribut Identificateur de syntaxe EDI, mais vous pouvez également utiliser les attributs Identificateur d'application d'émetteur de groupe, Identificateur d'application de réceptionnaire de groupe et Mot de passe d'application de groupe pour différencier les transactions.
Pour les EDI, utilisez l'attribut Qualificatif 1 de profil de connexion.
Par exemple, supposons que votre société soit en train de migrer depuis un VAN (regroupement Aucun) ou Internet (regroupement AS2). Vous souhaitez que les transactions 840 (Demande de devis) utilisent le VAN et les transactions 850 (Bon de commande) utilisent Internet. Vous configurez deux connexions de participants pour le même EDI source mais avec deux cibles différentes (l'une pour le regroupement Aucun, l'autre pour le regroupement AS2). Les profils de connexion aident à faire la distinction entre les deux connexions.
La configuration du profil de connexion des EDI s'effectue en plusieurs étapes. Voici comment procéder pour créer les deux profils de connexion de l'exemple :
L'Enveloppeur utilise l'attribut Qualificatif 1 de profil de connexion do côté "Vers" de la connexion du participant comme point d'arrêt d'enveloppe. Ainsi, les transactions qui ont des valeurs différentes pour l'attribut Qualificatif 1 de profil de connexion iront dans des enveloppes différentes. Lorsque vous indiquez des valeurs différentes pour les transactions, l'Enveloppeur ne placera jamais les transactions 840 et 850 dans le même EDI.
Lorsque le Gestionnaire de document recherche la connexion, il trouve les deux connexions possibles mais utilise celle dont le profil de connexion est approprié.
La configuration des profils de connexion est facultative. Si vous n'avez pas besoin de plus d'une connexion pour chaque type de document échangé pour un participant, passez à la section suivante.
Pour configurer un profil de connexion :
Le nom et la description (le cas échéant) apparaîtront sur la page Liste des profils de connexion.
Pour les transactions que vous voulez insérer dans certaines enveloppes d'EDI, pour pouvez donner à l'attribut Qualificatif 1 de profil de connexion la valeur qui correspond au profil de connexion avec la même valeur pour l'attribut Qualificatif 1. L'attribut Qualificatif 1 de profil de connexion peut être défini au niveau protocole d'une définition de flot de documents (vous pouvez par exemple modifier les attributs du protocole X12V5R1 dans la fenêtre Gestion des définitions de flots de documents pour indiquer le profil de connexion à utiliser, en cliquant sur la valeur de l'attribut Qualificatif 1 de profil de connexion correspondant). Ensuite, lorsque vous activez la connexion EDI, associez le profil de connexion en cliquant sur le bouton Profil de connexion et en sélectionnant le profil dans la liste.
L'Envelopeur utilise des numéros de contrôle pour assurer la numérotation unique des EDI, groupes et transactions d'une enveloppe. Ces numéros sont établis pour le Gestionnaire de communauté et les participants. Lors de l'échange de documents, des numéros de contrôle sont générés pour la paire de participants.
A chaque participant bénéficiant de capacités B2B d'EDI correspond un ensemble de valeurs d'initialisation des numéros de contrôle. Ces valeurs sont utilisées la première fois qu'un EDI est créé et échangé entre une paire de participants. Les valeurs d'initialisation s'appliquent au participant auquel l'EDI est envoyé. Lorsqu'un document a été envoyé d'un participant à un autre, les derniers numéros utilisés s'affichent sur la page Numéros de contrôle actuels. Pour une paire donnée de participants, il peut exister plusieurs entrées, si Numéros de contrôle par ID de transaction a la valeur O. Une fois qu'une entrée existe, elle sert à générer les nouveaux numéros de contrôle.
Dans le cadre de l'initialisation des numéros de contrôle, vous pouvez utiliser des masques pour modifier la création normale de numéros de contrôle par l'Enveloppeur. Les masques servent à baser le numéro de contrôle sur le numéro de contrôle du groupe ou sur le numéro de l'EDI. Les masques sont décrits ci-dessous. Remplacez le n qui figure dans le masque d'édition par le nombre d'octets que vous souhaitez utiliser pour créer la valeur du numéro de contrôle. Consultez le tableau 15 pour une description des codes disponibles :
Code | Numéro de contrôle | Description |
---|---|---|
G | Transaction | Le numéro de contrôle de transaction est identique au numéro de contrôle de groupe. Une seule transaction est autorisée par groupe. |
Gn | Transaction | n octets sont extraits du numéro de contrôle de groupe. Le reste du numéro de contrôle de transaction est complété par des zéros jusqu'à la taille maximale. Une seule transaction est autorisée par groupe. |
C | Groupe, transaction | Les octets restants de la zone du numéro de contrôle de transaction ou de groupe sont utilisés pour maintenir un numéro de contrôle pour ce participant. |
V | Groupe, transaction | Une valeur incrémentale est utilisée. Le premier groupe ou la première transaction a la valeur 1, le deuxième la valeur 2, etc. |
Vn | Transaction | Une valeur incrémentale de n octets de long est utilisée. La première transaction a la valeur 1, la deuxième la valeur 2, etc. |
GnC | Transaction | n octets sont extraits du numéro de contrôle de groupe, les octets restants de la zone du numéro de contrôle de transaction sont utilisés pour maintenir un numéro de contrôle. Le nombre de positions laissées détermine la valeur maximale du numéro de contrôle. Par exemple, G5C laisse quatre positions et la valeur maximale est 9999. Le numéro de contrôle repasse ensuite à 1. |
GnV | Transaction | n octets sont extraits du numéro de contrôle de groupe. Pour les octets restants de la zone de numéro de contrôle de transaction, une valeur incrémentale est utilisée, de sorte que la première transaction a la valeur 1, la deuxième la valeur 2, etc. |
GnVm | Transaction | n octets sont extraits du numéro de contrôle de groupe. Pour les octets restants, jusqu'à m octets de la zone du numéro de contrôle de transaction, une valeur incrémentale est utilisée, de sorte que la première transaction a la valeur 1, la deuxième la valeur 2, etc. |
I | Groupe, transaction | Le numéro de contrôle de groupe ou de transaction doit être identique au numéro de contrôle de l'EDI. Un seul groupe est autorisé pour l'EDI, et une seule transaction est autorisée pour le groupe ou l'EDI. |
In | Groupe, transaction | n octets sont extraits du numéro de contrôle de l'EDI. Le restant de la zone du numéro de contrôle de transaction ou de groupe est complété par des zéros jusqu'à sa taille maximale. Un seul groupe est autorisé pour chaque EDI, et une seule transaction est autorisée pour chaque groupe. |
InC | Groupe, transaction | n octets sont extraits du numéro de contrôle de l'EDI. Les octets restants de la zone du numéro de contrôle de transaction sont utilisés pour maintenir un numéro de contrôle. Le nombre de positions laissées détermine la valeur maximale du numéro de contrôle. Par exemple, I5C laisse quatre positions et la valeur maximale est 9999. Le numéro de contrôle repasse ensuite à 1. |
InV | Groupe, transaction | n octets sont extraits du numéro de contrôle de l'EDI. Pour les octets restants de la zone de numéro de contrôle de transaction ou de groupe, une valeur incrémentale est utilisée, de sorte que le premier groupe ou transaction a la valeur 1, le deuxième la valeur 2, etc. |
InVm | Transaction | n octets sont extraits du numéro de contrôle de l'EDI. Pour les octets restants, jusqu'à m octets de la zone du numéro de contrôle de transaction, une valeur incrémentale est utilisée, de sorte que la première transaction a la valeur 1, la deuxième la valeur 2, etc. |
InGm | Transaction | n octets sont extraits du numéro de contrôle de l'EDI et un maximum de m octets sont extraits du numéro de contrôle de groupe. Si n plus m est supérieur à 9, alors seulement 9 - n octets sont extraits du numéro de contrôle de groupe. Par exemple, avec I4G6, 4 octets sont extraits de l'EDI. |
InGmC | Transaction | n octets sont extraits du numéro de contrôle de l'EDI et m octets sont extraits du numéro de contrôle de groupe. Les octets restants de la zone du numéro de contrôle de transaction sont utilisés pour maintenir un numéro de contrôle. Le nombre de positions laissées détermine la valeur maximale du numéro de contrôle. Par exemple, I2G4C laisse trois positions et la valeur maximale est 999. Le numéro de contrôle repasse ensuite à 1. |
InGmV | Transaction | n octets sont extraits du numéro de contrôle de l'EDI et m octets sont extraits du numéro de contrôle de groupe. Pour les octets restants de la zone de numéro de contrôle de transaction, une valeur incrémentale est utilisée, de sorte que la première transaction a la valeur 1, la deuxième la valeur 2, etc. |
InGmVo | Transaction | n octets sont extraits du numéro de contrôle de l'EDI et m octets sont extraits du numéro de contrôle de groupe. Pour les octets restants, jusqu'à o octets de la zone du numéro de contrôle de transaction, une valeur incrémentale est utilisée, de sorte que la première transaction a la valeur 1, la deuxième la valeur 2, etc. |
Pour configurer les numéros de contrôle qui seront utilisés par l'Enveloppeur, procédez comme suit :
Pour une paire de participants dont la table de contrôle contient déjà des données, vous pouvez modifier la génération des numéros de contrôle. Vous pouvez :
Pour déterminer quels participants ont des numéros de contrôle (et identifier ces numéros), utilisez la fonctionnalité Numéros de contrôle actuels.