Exemple de document XML vers EDI
Cette section fournit un exemple d'envoi de document XML par le
Gestionnaire de communauté au concentrateur, qui le transforme en transaction
EDI enveloppée dans un EDI et l'envoie au participant.
Dans cet exemple, il est supposé que le spécialiste du mappage Data
Interchange Services a créé une mappe de transformation qui transforme un
document XML en transaction EDI 850 standard (définie avec le dictionnaire
MX12V3R1) qui sera traitée par le participant. Dans cet exemple, la mappe est nommée S_DT_XML_TO_EDI.eif.
Le spécialiste de mappage Data Interchange Services peut exporter la mappe
de transformation directement dans la base de données WebSphere Partner
Gateway.
Il peut aussi vous envoyer le fichier, auquel cas vous utiliserez bcgDISImport
pour l'importer dans WebSphere Partner Gateway. Cette annexe suit ce second scénario.
Importation de la mappe de transformation
La présente section décrit la procédure permettant d'importer une
mappe de transformation qui transformera une entrée XML en transaction EDI. Lors de l'importation de la mappe de transformation, vous importez également la
définition de document associée à la mappe.
Avant de pouvoir importer la mappe de transformation, le spécialiste de mappage Data Interchange
Services doit vous l'envoyer. Cette procédure suppose que le fichier S_DT_XML_TO_EDI.eif est présent sur
votre système.
- Ouvrez une fenêtre de commande.
- Entrez la commande ou le script suivant :
- Sous UNIX :
<ProductDir>/bin/bcgDISImport.sh <ID utilisateur base de données>
<mot de passe> S_DT_XML_TO_EDI.eif
- Sous Windows :
<ProductDir>\bin\bcgDISImport.bat <ID utilisateur base de données>
<mot de passe> S_DT_XML_TO_EDI.eif
où <ID utilisateur base de données> et
<mot de passe> sont les valeurs que vous avez
utilisées lors de l'installation de la base de données, dans le cadre de
l'installation de WebSphere Partner Gateway.
Vérification de la mappe de transformation et des définitions de flot de documents
Pour vérifier que les mappes de transformation et définitions de
documents importées sont disponibles sur la Console de communauté, procédez
comme suit :
- Cliquez sur Administrateur du concentrateur >
Configuration du concentrateur > Mappes > Mappes de transformation.
La mappe S_DT_XML_TO_EDI s'affiche.
- Cliquez sur l'icône Afficher les détails en regard de la mappe.
Les
définitions de flot de documents auxquelles cette mappe est associée s'affichent :
Tableau 29. Définitions de flot de documents associées à la mappe
Source |
Cible |
Regroupement : Aucun
Protocole : FVT-XML-TEST (TOUT)
Flot de documents : ICGCPO (TOUT) |
Regroupement : N/A
Protocole : MX12V3R1 (TOUT)
Flot de documents : 850 (TOUT) |
La mappe S_DT_XML_TO_EDI a été définie pour transformer un document XML en transaction EDI.
Configuration de la cible
Cette section explique comment créer une cible de répertoire de
système de fichiers pour le concentrateur :
- Cliquez sur Administrateur du concentrateur >
Configuration du concentrateur > Cibles puis sur Créer cible.
- Dans la zone Nom de la cible, entrez CibleFichierXML.
- Dans la liste Transfert, sélectionnez Répertoire de fichiers.
- Dans Chemin principal, entrez /Data/Manager/xmltarget
- Dans la liste des points de configuration, sélectionnez Preprocess.
- Sélectionnez com.ibm.bcg.edi.receiver.preprocesshandler.XMLSplitterHandler
dans la liste des récupérateurs disponibles et cliquez sur Ajouter
pour le déplacer dans la liste des récupérateurs configurés.
- Cliquez sur Sauvegarder.
Le Gestionnaire de communauté envoie le document XML à cette cible.
Création des interactions
Créez deux interactions : une pour l'enveloppe XML-to-EDI et
l'autre pour la transaction contenue dans l'enveloppe EDI.
Créez une interaction dont la source représente le document XML et la
cible la transaction 850 transformée.
- Cliquez sur Administrateur du concentrateur >
Configuration du concentrateur > Définition du flot de documents.
- Cliquez sur Gestion des interactions, puis sur Création d'une interaction.
- Développez Regroupement : Aucun et
Protocole : FVT-XML-TEST puis sélectionnez
Flot de documents : ICGCPO.
- Développez Regroupement : N/A et
Protocole : MX12V3R1, puis sélectionnez
Flot de documents : 850.
- Dans la liste Mappe de transformation, sélectionnez S_DT_XML_TO_EDI.
- Dans la liste des actions, sélectionnez Traduction XML et validation EDI.
- Cliquez sur Enregistrer.
Cette interaction représente la transformation d'un document XML en
transaction EDI. Par conséquent vous devez sélectionner une mappe de
transformation.
Créez une interaction qui représente l'enveloppe EDI.
- Cliquez sur Administrateur du concentrateur >
Configuration du concentrateur > Définition du flot de documents.
- Cliquez sur Gestion des interactions, puis sur Création d'une interaction.
- Développez Regroupement : N/A et
Protocole : EDI-X12 puis sélectionnez
Flot de documents : ISA.
- Développez Regroupement : Aucun et
Protocole : EDI-X12 puis sélectionnez
Flot de documents : ISA.
- Dans la liste des actions, sélectionnez Passe-système.
Remarque : Aucune transformation ne se produit dans cette interaction.
- Cliquez sur Enregistrer.
Création des participants
Dans cet exemple, vous avez deux participants : le Gestionnaire de
communauté (Gestionnaire) et un participant (TP1).
Créez le profil du Gestionnaire de communauté :
- Cliquez sur Administrateur de compte > Profils >
Participant de communauté puis sur Créer.
- Pour Nom de connexion de l'entreprise, tapez : GestionnaireCom
- Pour Nom affiché du participant, tapez Gestionnaire
- Pour Type de participant, sélectionnez Gestionnaire de communauté.
- Cliquez sur Nouveau pour ID métier et tapez 000000000 pour ID de forme libre.
Remarque : Veillez à sélectionner ID de forme libre et non DUNS.
- Cliquez sur Nouveau pour ID Métier et tapez 01-000000000 pour ID de forme libre.
- Cliquez sur Enregistrer.
Créez le second participant :
- Cliquez sur Administrateur de compte > Profils >
Participant de communauté puis sur Créer.
- Pour Nom de connexion de l'entreprise, tapez TP1
- Pour Nom affiché du participant, tapez TP1
- Pour Type de participant, sélectionnez Participant.
- Cliquez sur Nouveau pour ID métier et tapez 000000001 pour ID de forme libre.
Remarque : Veillez à sélectionner ID de forme libre et non DUNS.
- Cliquez sur Nouveau pour ID métier et tapez 01-000000001 pour ID de forme libre.
- Cliquez sur Enregistrer.
Création des passerelles
Créez des passerelles fichier-répertoire pour tous les participants de l'exemple. Créez
d'abord une passerelle pour le Gestionnaire :
- Cliquez sur Administrateur de compte > Profils >
Participant de communauté puis sur Rechercher.
- Cliquez sur l'icône Afficher les détails en regard du Profil du gestionnaire.
- Cliquez sur Passerelles puis sur Créer.
-
Entrez les valeurs suivantes pour la passerelle.
Rappelez-vous que le répertoire de fichiers (le chemin entier) doit déjà exister sur le système de fichiers.
- Dans Nom, tapez PasserelleFichierGestionnaire.
- Dans la liste Transfert, sélectionnez Répertoire de fichiers.
- Dans Adresse, tapez : file:///Data/Manager/filegateway
- Cliquez sur Enregistrer.
- Cliquez sur Liste pour afficher la liste de toutes les passerelles du Gestionnaire de communauté.
- Cliquez sur Afficher les passerelles par défaut.
- Dans la liste Production, sélectionnez la passerelle
créée à l'étape 4.
- Cliquez sur Enregistrer.
Ensuite, créez une passerelle pour le participant.
- Cliquez sur Administrateur de compte > Profils >
Participant de communauté puis sur Rechercher.
- Sélectionnez l'autre participant créé pour cet exemple, en cliquant sur l'icône
Afficher les détails en regard de TP1.
- Cliquez sur Passerelles puis sur Créer.
-
Entrez les valeurs suivantes pour la passerelle.
Rappelez-vous que le répertoire de fichiers (le chemin entier) doit déjà exister.
- Dans Nom, tapez PasserelleFichierTP1.
- Dans la liste Transfert, sélectionnez Répertoire de fichiers.
- Dans Adresse, tapez : file:///Data/TP1/filegateway
- Cliquez sur Enregistrer.
- Cliquez sur Liste pour afficher la liste de toutes
les passerelles du participant.
- Cliquez sur Afficher les passerelles par défaut.
- Dans la liste Production, sélectionnez la passerelle
créée à l'étape 4.
- Cliquez sur Enregistrer.
Configuration des capacités B2B
Activez les capacités B2B des deux participants de cet échange. Dans
cet exemple, le document XML est émis par le Gestionnaire de communauté et sera
transmis au participant.
- Cliquez sur Administrateur de compte > Profils >
Participant de communauté puis sur Rechercher.
- Cliquez sur l'icône Afficher les détails du
participant source de cet exemple (GestCom).
- Cliquez sur Capacités B2B.
- Activez trois ensembles de capacités pour le participant source.
- Activez la définition de flot de documents représentant le document XML :
- Cliquez sur l'icône Rôle inactif sous
Définir source pour Regroupement : Aucun pour l'activer.
- Développez Regroupement : Aucun.
- Cliquez sur l'icône Role inactif sous
Définir source pour Protocole : FVT-XML-TEST (TOUT).
- Développez Protocole : FVT-XML-TEST (TOUT).
- Cliquez sur l'icône Role inactif sous
Définir source pour Flot de documents : ICGCPO (TOUT).
- Ensuite, activez la définition de flot de documents représentant le
document transformé :
- Cliquez sur l'icône Rôle inactif sous
Définir source pour Regroupement : N/A, afin de l'activer.
- Développez Regroupement : N/A.
- Cliquez sur l'icône Role inactif
sous Définir source pour Protocole : MX12V3R1 (TOUT).
- Développez Protocole : MX12V3R1 (TOUT).
- Cliquez sur l'icône Role inactif
sous Définir source pour Flot de documents : 850.
- Ensuite, activez la définition de flot de documents représentant l'enveloppe EDI :
- Cliquez sur l'icône Rôle inactif sous
Définir source pour Regroupement : N/A, afin de l'activer.
- Développez Regroupement : N/A.
- Cliquez sur l'icône Role inactif
sous Définir source pour Protocole : EDI-X12 (TOUT).
- Développez Protocole EDI-X12 (TOUT).
- Cliquez sur l'icône Role inactif
sous Définir source pour Flot de documents : ISA (TOUT).
- Cliquez sur Administrateur de compte > Profils >
Participant de communauté puis sur Rechercher.
- Cliquez sur l'icône Afficher les détails du participant cible de cet
exemple (TP1).
- Cliquez sur Capacités B2B.
- Activez deux ensembles de capacités pour le participant cible.
- Tout d'abord, activez la définition de flot de documents représentant la transaction EDI 850 :
- Cliquez sur l'icône Rôle inactif sous
Définir cible pour Regroupement : N/A, afin de l'activer.
- Développez Regroupement : N/A.
- Cliquez sur l'icône Role inactif
sous Définir cible pour Protocole : MX12V3R1 (TOUT).
- Développez Protocole : MX12V3R1 (TOUT).
- Cliquez sur l'icône Role inactif
sous Définir cible pour Flot de documents : 850 (TOUT).
- Ensuite, activez la définition de flot de documents :
- Cliquez sur l'icône Rôle inactif sous
Définir cible pour Regroupement : Aucun pour l'activer.
- Développez Regroupement : Aucun.
- Cliquez sur l'icône Role inactif
sous Définir cible pour Protocole : EDI-X12 (TOUT).
- Développez Protocole : EDI-X12 (TOUT).
- Cliquez sur l'icône Role inactif sous
Définir cible pour Flot de documents :ISA (TOUT).
Création du profil d'enveloppe
Vous créez ensuite le profil de l'enveloppe qui contiendra la transaction 850 transformée :
- Cliquez sur Administrateur du concentrateur >
Configuration du concentrateur > EDI > Profil d'enveloppe.
- Cliquez sur Créer.
- Tapez le nom du profil : EnvProf1.
- Dans la liste EDI Standard, sélectionnez X12.
- Le bouton Général est sélectionné par défaut.
Tapez les valeurs suivantes pour les attributs généraux de l'enveloppe :
- INTCTLLEN: 9
- GRPCTLLEN: 9
- TRXCTLLEN: 9
- MAXDOCS: 1000
- Cliquez sur le bouton Interchange et indiquez les valeurs suivantes pour les attributs EDI :
- ISA01: 01
- ISA02: ISA0000002
- ISA03: 02
- ISA04: ISA0000004
- ISA11: U
- ISA12: 00301
- ISA15: T
- Cliquez sur Enregistrer.
Création du format XML
Cette section explique comment créer le format XML personnalisé.
- Cliquez sur Administrateur du concentrateur >
Configuration du concentrateur > Formats XML.
- Cliquez sur Création du format XML.
- Dans Format d'acheminement, sélectionnez FVT-XML-TEST ALL.
- Dans Type de fichier, sélectionnez XML.
- Dans Type d'identificateur, sélectionnez Code racine et tapez MMDoc.
- Dans ID Métier source, sélectionnez Constante et tapez 000000000.
- Dans ID Métier cible, sélectionnez Constante et tapez 000000001.
- Dans Flot de documents source, sélectionnez Constante et tapez ICGCPO.
- Dans Version du flot de documents source, sélectionnez Constante et tapez TOUT.
- Cliquez sur Enregistrer.
Activation des connexions
Activez les connexions du participant :
- Cliquez sur Administrateur du compte > Connexions du participant.
- Sélectionnez Gestionnaire dans la liste des sources.
- Sélectionnez TP1 dans la liste des cibles.
- Cliquez sur Rechercher.
- Cliquez sur Activation pour la connexion suivante :
Tableau 30. Connexion de transaction de document XML vers EDI
Source |
Cible |
Regroupement : Aucun (N/A)
Protocole : FVT-XML-TEST (TOUT)
Flot de documents : ICGCPO (TOUT) |
Regroupement : N/A (N/A)
Protocole : MX12V3R1 (TOUT)
Flot de documents : 850 (TOUT) |
- Cliquez sur Activation pour la connexion qui représente l'enveloppe EDI :
Tableau 31. Connexion de l'enveloppe EDI
Source |
Cible |
Regroupement : N/A (N/A)
Protocole : EDI-X12 (TOUT)
Flot de documents : ISA (TOUT) |
Regroupement : Aucun (N/A)
Protocole : EDI-X12 (TOUT)
Flot de documents : ISA (TOUT) |
Configuration des attributs
Configurez les attributs Capacités B2B du participant
cible (TP1) et du participant source (Gestionnaire) :
- Cliquez sur Administrateur de compte > Profils >
Participant de communauté puis sur Rechercher.
- Cliquez sur Afficher les détails en regard de
TPI pour le sélectionner.
- Cliquez sur Capacités B2B.
- Cliquez sur l'icône Développer en regard de Regroupement : N/A.
- Cliquez sur l'icône Edition en regard de Protocole : MX12V3R1.
- Précisez les attributs suivants :
- Sur la ligne Profil d'enveloppe, sélectionnez EnvProf1 dans la liste.
- Sur la ligne Qualificatif EDI, tapez 01.
- Sur la ligne Identificateur EDI, tapez 000000001.
- Sur la ligne Indicateur de syntaxe EDI, tapez T.
- Cliquez sur Enregistrer.
- Cliquez sur Administrateur de compte > Profils >
Participant de communauté puis sur Rechercher.
- Cliquez sur Afficher les détails en regard de Gestionnaire pour le sélectionner.
- Cliquez sur Capacités B2B.
- Cliquez sur l'icône Développer en regard de Regroupement : N/A.
- Cliquez sur l'icône Edition en regard de Protocole : MX12V3R1 (TOUT).
- Précisez les attributs suivants :
- Sur la ligne Qualificatif EDI, tapez 01.
- Sur la ligne Identificateur EDI, tapez 000000000.
- Sur la ligne Indicateur de syntaxe EDI, tapez T.
- Cliquez sur Enregistrer.
A ce stade, si le participant source (le Gestionnaire de communauté) a
envoyé un document XML au participant, ce document sera transformé (au niveau
du concentrateur) en transaction EDI, puis envoyé à la passerelle du
participant.
