Exemple EDI vers XML
Cette section présente un exemple d'envoi de transaction EDI (dans
une enveloppe) au concentrateur, qui la transforme en document XML et l'envoie
au Gestionnaire de communauté.
Dans cet exemple, il est supposé que le spécialiste du mappage Data Interchange Services a
créé une mappe qui transforme une transaction EDI 879 standard (définie avec le dictionnaire
X12V5R1 et correspondant à la version 5010 de X12) en un document XML, qui sera
traité par l'application dorsale du Gestionnaire de communauté. Dans cet
exemple, la mappe est nommée S_DT_EDI_TO_XML.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 qui transformera une entrée EDI au format XML. 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_EDI_TO_XML.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_EDI_TO_XML.eif
- Sous Windows :
<ProductDir>\bin\bcgDISImport.bat <ID utilisateur base de données>
<mot de passe> S_DT_EDI_TO_XML.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_EDI_TO_XML 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 26. Définition de flot de document associée à la mappe
Source |
Cible |
Regroupement : N/A
Protocole : X12V5R1
Flot de documents : 879 (TOUT) |
Regroupement : Aucun
Protocole : FVT-XML-TEST (TOUT)
Flot de documents : WWRE_ITEMCREATIONINTERNAL (TOUT) |
La mappe S_DT_EDI_TO_XML a été définie pour transformer une transaction X12
879 (conforme au standard X12V5R1) en un protocole personnalisé.
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 CibleFichierEDI.
- Dans la liste Transfert, sélectionnez Répertoire de fichiers.
- Dans Chemin principal, entrez /Data/Manager/editarget
- Cliquez sur Sauvegarder.
Le participant de la communauté envoie l'EDI à cette cible.
Création des interactions
Créez deux interactions : une pour l'enveloppe EDI et l'autre pour la transaction contenue dans l'enveloppe EDI.
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 : Aucun et Protocole : EDI-X12
puis sélectionnez Flot de documents : ISA.
- Développez Regroupement : N/A et Protocole : EDI-X12
puis sélectionnez Flot de documents : ISA.
- Dans la liste des actions, sélectionnez Désenveloppement EDI.
Remarque : Aucune transformation ne se produit dans cette interaction. Le désenveloppement de
l'EDI est effectué, générant la transaction individuelle (879). Vous n'avez
donc pas besoin de mappe de transformation pour cette interaction.
- Cliquez sur Enregistrer.
Créez une interaction dont une source représente la transaction 879 et une cible le document transformé.
- 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 : X12V5R1 puis sélectionnez
Flot de documents : 879.
- Développez Regroupement : Aucun et Protocole : FVT-XML-TEST
puis sélectionnez Flot de documents: WWRE_ITEMCREATIONINTERNAL.
- Dans la liste des mappes de transformation, sélectionnez S_DT_EDI_TO_XML.
- Dans la liste des actions, sélectionnez Validation et conversion EDI.
- Cliquez sur Enregistrer.
Cette interaction représente la transformation d'une transaction EDI X12 879
standard dans un autre format. Vous devez par conséquent sélectionner une mappe
de transformation.
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 de communauté.
- 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, l'EDI est émis par le participant de la communauté (TP1) et sera
transmis au Gestionnaire de communauté.
- 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 (TP1).
- Cliquez sur Capacités B2B.
- Activez deux ensembles de capacités pour le participant source.
- Tout d'abord, 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 : Aucun pour l'activer.
- Développez Regroupement : Aucun.
- 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).
- Ensuite, activez la définition de flot de documents représentant la transaction :
- 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 : X12V5R1.
- Développez Protocole X12V5R1 (TOUT).
- Cliquez sur l'icône Role inactif
sous Définir source pour Flot de documents : 879.
- 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 (Gestionnaire).
- 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 :
- 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 : 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).
- 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 cible pour Regroupement : Aucun pour l'activer.
- Développez Regroupement : Aucun.
- Cliquez sur l'icône Role inactif
sous Définir cible pour Protocole : FVT-XML-TEST (TOUT).
- Développez Protocole : FVT-XML-TEST (TOUT).
- Cliquez sur l'icône Role inactif
sous Définir cible pour Flot de documents :WWRE_ITEMCREATIONINTERNAL (TOUT).
Activation des connexions
Pour activer les connexions :
- Cliquez sur Administrateur du compte > Connexions du participant.
- Sélectionnez TP1 dans la liste des sources.
- Sélectionnez Gestionnaire dans la liste des cibles.
- Cliquez sur Rechercher.
- Cliquez sur Activation pour la connexion qui représente l'enveloppe :
Tableau 27. Connexion de l'enveloppe
Source |
Cible |
Regroupement : Aucun (N/A)
Protocole : EDI-X12 (TOUT)
Flot de documents : ISA (TOUT) |
Regroupement : N/A (N/A)
Protocole : EDI-X12 (TOUT)
Flot de documents : ISA (TOUT) |
- Cliquez sur Activation pour la connexion qui
représente la transaction 879 vers le document transformé :
Tableau 28. Connexion de la transaction EDI vers le document XML
Source |
Cible |
Regroupement : N/A (N/A)
Protocole : X12V5R1 (ALL)
Flot de documents : 879 (TOUT) |
Regroupement : Aucun (N/A)
Protocole : FVT-XML-TEST (TOUT)
Flot de documents : WWRE_ITEMCREATIONINTERNAL (TOUT) |
A ce stade, si TP1 a envoyé un EDI contenant une transaction 879 au
Gestionnaire de communauté, l'EDI sera désenveloppé et générera une transaction
879. Celle-ci sera transformée et le document résultant envoyé à
la passerelle du Gestionnaire de communauté.
