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.

  1. Ouvrez une fenêtre de commande.
  2. Entrez la commande ou le script suivant :

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 :

  1. Cliquez sur Administrateur du concentrateur > Configuration du concentrateur > Mappes > Mappes de transformation.

    La mappe S_DT_EDI_TO_XML s'affiche.

  2. 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 :

  1. Cliquez sur Administrateur du concentrateur > Configuration du concentrateur > Cibles puis sur Créer cible.
  2. Dans la zone Nom de la cible, entrez CibleFichierEDI.
  3. Dans la liste Transfert, sélectionnez Répertoire de fichiers.
  4. Dans Chemin principal, entrez /Data/Manager/editarget
  5. 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.

  1. Cliquez sur Administrateur du concentrateur > Configuration du concentrateur > Définition du flot de documents.
  2. Cliquez sur Gestion des interactions, puis sur Création d'une interaction.
  3. Développez Regroupement : Aucun et Protocole : EDI-X12 puis sélectionnez Flot de documents : ISA.
  4. Développez Regroupement : N/A et Protocole : EDI-X12 puis sélectionnez Flot de documents : ISA.
  5. 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.
  6. Cliquez sur Enregistrer.

Créez une interaction dont une source représente la transaction 879 et une cible le document transformé.

  1. Cliquez sur Administrateur du concentrateur > Configuration du concentrateur > Définition du flot de documents.
  2. Cliquez sur Gestion des interactions, puis sur Création d'une interaction.
  3. Développez Regroupement : N/A et Protocole : X12V5R1 puis sélectionnez Flot de documents : 879.
  4. Développez Regroupement : Aucun et Protocole : FVT-XML-TEST puis sélectionnez Flot de documents: WWRE_ITEMCREATIONINTERNAL.
  5. Dans la liste des mappes de transformation, sélectionnez S_DT_EDI_TO_XML.
  6. Dans la liste des actions, sélectionnez Validation et conversion EDI.
  7. 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é :

  1. Cliquez sur Administrateur de compte > Profils > Participant de communauté puis sur Créer.
  2. Pour Nom de connexion de l'entreprise, tapez : GestionnaireCom
  3. Pour Nom affiché du participant, tapez Gestionnaire
  4. Pour Type de participant, sélectionnez Gestionnaire de communauté.
  5. 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.
  6. Cliquez sur Nouveau pour ID métier et tapez 01-000000000 pour ID de forme libre.
  7. Cliquez sur Enregistrer.

Créez le second participant :

  1. Cliquez sur Administrateur de compte > Profils > Participant de communauté puis sur Créer.
  2. Pour Nom de connexion de l'entreprise, tapez TP1
  3. Pour Nom affiché du participant, tapez TP1
  4. Pour Type de participant, sélectionnez Participant de communauté.
  5. 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.
  6. Cliquez sur Nouveau pour ID métier et tapez 01-000000001 pour ID de forme libre.
  7. 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 :

  1. Cliquez sur Administrateur de compte > Profils > Participant de communauté puis sur Rechercher.
  2. Cliquez sur l'icône Afficher les détails en regard du Profil du gestionnaire.
  3. Cliquez sur Passerelles puis sur Créer.
  4. 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.
    1. Dans Nom, tapez PasserelleFichierGestionnaire.
    2. Dans la liste Transfert, sélectionnez Répertoire de fichiers.
    3. Dans Adresse, tapez : file:///Data/Manager/filegateway
    4. Cliquez sur Enregistrer.
  5. Cliquez sur Liste pour afficher la liste de toutes les passerelles du Gestionnaire de communauté.
  6. Cliquez sur Afficher les passerelles par défaut.
  7. Dans la liste Production, sélectionnez la passerelle créée à l'étape 4.
  8. Cliquez sur Enregistrer.

Ensuite, créez une passerelle pour le participant.

  1. Cliquez sur Administrateur de compte > Profils > Participant de communauté puis sur Rechercher.
  2. Sélectionnez l'autre participant créé pour cet exemple, en cliquant sur l'icône Afficher les détails en regard de TP1.
  3. Cliquez sur Passerelles puis sur Créer.
  4. Entrez les valeurs suivantes pour la passerelle. Rappelez-vous que le répertoire de fichiers (le chemin entier) doit déjà exister.
    1. Dans Nom, tapez PasserelleFichierTP1.
    2. Dans la liste Transfert, sélectionnez Répertoire de fichiers.
    3. Dans Adresse, tapez : file:///Data/TP1/filegateway
    4. Cliquez sur Enregistrer.
  5. Cliquez sur Liste pour afficher la liste de toutes les passerelles du participant.
  6. Cliquez sur Afficher les passerelles par défaut.
  7. Dans la liste Production, sélectionnez la passerelle créée à l'étape 4.
  8. 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é.

  1. Cliquez sur Administrateur de compte > Profils > Participant de communauté puis sur Rechercher.
  2. Cliquez sur l'icône Afficher les détails du participant source de cet exemple (TP1).
  3. Cliquez sur Capacités B2B.
  4. Activez deux ensembles de capacités pour le participant source.
    1. Tout d'abord, activez la définition de flot de documents représentant l'enveloppe EDI :
      1. Cliquez sur l'icône Rôle inactif sous Définir source pour Regroupement : Aucun pour l'activer.
      2. Développez Regroupement : Aucun.
      3. Cliquez sur l'icône Role inactif sous Définir source pour Protocole : EDI-X12 (TOUT).
      4. Développez Protocole EDI-X12 (TOUT).
      5. Cliquez sur l'icône Role inactif sous Définir source pour Flot de documents : ISA (TOUT).
    2. Ensuite, activez la définition de flot de documents représentant la transaction :
      1. Cliquez sur l'icône Rôle inactif sous Définir source pour Regroupement : N/A, afin de l'activer.
      2. Développez Regroupement : N/A.
      3. Cliquez sur l'icône Role inactif sous Définir source pour Protocole : X12V5R1.
      4. Développez Protocole X12V5R1 (TOUT).
      5. Cliquez sur l'icône Role inactif sous Définir source pour Flot de documents : 879.
  5. Cliquez sur Administrateur de compte > Profils > Participant de communauté puis sur Rechercher.
  6. Cliquez sur l'icône Afficher les détails du participant cible de cet exemple (Gestionnaire).
  7. Cliquez sur Capacités B2B.
  8. Activez deux ensembles de capacités pour le participant cible.
    1. Tout d'abord, activez la définition de flot de documents :
      1. Cliquez sur l'icône Rôle inactif sous Définir cible pour Regroupement : N/A, afin de l'activer.
      2. Développez Regroupement : N/A.
      3. Cliquez sur l'icône Role inactif sous Définir cible pour Protocole : EDI-X12 (TOUT).
      4. Développez Protocole : EDI-X12 (TOUT).
      5. Cliquez sur l'icône Role inactif sous Définir cible pour Flot de documents : ISA (TOUT).
    2. Ensuite, activez la définition de flot de documents représentant le document transformé :
      1. Cliquez sur l'icône Rôle inactif sous Définir cible pour Regroupement : Aucun pour l'activer.
      2. Développez Regroupement : Aucun.
      3. Cliquez sur l'icône Role inactif sous Définir cible pour Protocole : FVT-XML-TEST (TOUT).
      4. Développez Protocole : FVT-XML-TEST (TOUT).
      5. 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 :

  1. Cliquez sur Administrateur du compte > Connexions du participant.
  2. Sélectionnez TP1 dans la liste des sources.
  3. Sélectionnez Gestionnaire dans la liste des cibles.
  4. Cliquez sur Rechercher.
  5. 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)
  6. 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é.

Copyright IBM Corp. 2003, 2005