Exemple ROD 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 qui transforme un
document ROD en transaction EDI 850 standard (définie avec le dictionnaire
X12V5R1 correspondant à la version 5010 de X12), qui sera traitée par le
participant.
Dans cet exemple, la mappe est nommée S_DT_ROD_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 ROD en transaction X12. 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_ROD_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_ROD_TO_EDI.eif
- Sous Windows :
<ProductDir>\bin\bcgDISImport.bat <ID utilisateur base de données>
<mot de passe> S_DT_ROD_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_ROD_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 32. Définitions de flot de documents associées à la mappe
Source |
Cible |
Regroupement : Aucun
Protocole : ROD-TO-EDI_DICT (TOUT)
Flot de documents : DTROD-TO-EDI_ROD (TOUT) |
Regroupement : N/A
Protocole : X12V5R1 (TOUT)
Flot de documents : 850 (TOUT) |
La mappe S_DT_ROD_TO_EDI a été définie pour transformer un document ROD
associé au dictionnaire ROD-TO-EDI_DICT en transaction 850 X12,
conforme au standard X12V5R1.
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 CibleFichierROD.
- Dans la liste Transfert, sélectionnez Répertoire de fichiers.
- Dans Chemin principal, entrez /Data/Manager/rodtarget
- Dans la liste des points de configuration, sélectionnez Preprocess.
- Sélectionnez
com.ibm.bcg.edi.receiver.preprocesshandler.RODSplitterHandler
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.
- Sélectionnez
com.ibm.bcg.edi.receiver.preprocesshandler.RODSplitterHandler
dans la liste des récupérateurs configurés et cliquez sur
Configurer.
- Ajoutez les valeurs de la table ci-dessous :
Tableau 33. Attributs Récupérateur du processus de fractionnement ROD
Zone |
Valeur |
Nom du regroupement d'origine |
Aucun |
Version du regroupement d'origine |
N/A |
Nom du protocole d'origine |
ROD-TO-EDI_DICT |
Version du protocole d'origine |
TOUT |
Code processus De |
DTROD-TO-EDI_ROD |
Version processus De |
TOUT |
METADICTIONARY |
ROD-TO-EDI_DICT |
METADOCUMENT |
DTROD-TO-EDI_ROD |
METASYNTAX |
rod |
ENCODING |
ascii |
BCG_BATCHDOCS |
ON |
- Cliquez sur Définir valeurs.
- Cliquez sur Sauvegarder.
Le Gestionnaire de communauté envoie le document ROD à cette cible.
Création des interactions
Créez deux interactions : une pour l'enveloppe EDI qui sera envoyée à
partir du concentrateur, et une pour la transformation du document ROD en EDI.
Créez une interaction dont la source représente la document ROD et la cible le document X12.
- 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 : ROD-TO-EDI_DICT puis
sélectionnez DTROD-TO-EDI_ROD.
- Développez Regroupement :
N/A et Protocole : X12V5R1 puis sélectionnez
Flot de documents : 850.
- Dans la liste Mappe de transformation, sélectionnez S_DT_ROD_TO_EDI.
- Dans la liste des actions, sélectionnez
Validation ROD et validation EDI.
- Cliquez sur Enregistrer.
Cette interaction représente la transformation d'un document ROD en
transaction X12 standard et 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. Son but est d'envelopper l'EDI.
- 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 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, le document ROD 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 (Gestionnaire).
- 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 le document ROD :
- 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 : ROD-TO-EDI_DICT (TOUT).
- Développez Protocole : ROD-TO-EDI_DICT (TOUT).
- Cliquez sur l'icône Role inactif sous
Définir source pour Flot de documents :
DTROD-TO-EDI_ROD (TOUT).
- 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 : X12V5R1 (TOUT).
- Développez Protocole X12V5R1 (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 représentant l'enveloppe EDI :
- 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: \
- ISA12: 00501
- ISA15: T
- Cliquez sur Enregistrer.
Activation des connexions
Pour activer les connexions :
- 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 qui
représente la transaction du document ROD vers EDI :
Tableau 34. Connexion ROD vers EDI
Source |
Cible |
Regroupement : N/A (N/A)
Protocole : ROD-TO-EDI_DICT (TOUT) Flot de documents : DTROD-TO-EDI_ROD (TOUT) |
Regroupement : Aucun (N/A)
Protocole : X12V5R1 (TOUT)
Flot de documents : 850 (TOUT) |
- Cliquez sur Activation pour la connexion qui représente l'enveloppe :
Tableau 35. 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) |
Configuration des attributs
Pour préciser les attributs du profil de l'enveloppe :
- Cliquez sur Administrateur de compte > Profils >
Participant de communauté puis sur Rechercher.
- Sélectionnez TP1 dans la liste.
- 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 : X12V5R1.
- 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.
A ce stade, si le Gestionnaire de communauté envoie un document ROD au concentrateur,
le document sera transformé en transaction 850, qui sera ensuite enveloppée et
envoyée à la passerelle du participant.
