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.

  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_XML_TO_EDI 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 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 :

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

  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 : FVT-XML-TEST puis sélectionnez Flot de documents : ICGCPO.
  4. Développez Regroupement : N/A et Protocole : MX12V3R1, puis sélectionnez Flot de documents : 850.
  5. Dans la liste Mappe de transformation, sélectionnez S_DT_XML_TO_EDI.
  6. Dans la liste des actions, sélectionnez Traduction XML et validation EDI.
  7. 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.

  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 : EDI-X12 puis sélectionnez Flot de documents : ISA.
  4. Développez Regroupement : Aucun et Protocole : EDI-X12 puis sélectionnez Flot de documents : ISA.
  5. Dans la liste des actions, sélectionnez Passe-système.
    Remarque : Aucune transformation ne se produit dans cette interaction.
  6. 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é :

  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.
  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, le document XML est émis par le Gestionnaire de communauté et sera transmis au participant.

  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 (GestCom).
  3. Cliquez sur Capacités B2B.
  4. Activez trois ensembles de capacités pour le participant source.
    1. Activez la définition de flot de documents représentant le document XML :
      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 : FVT-XML-TEST (TOUT).
      4. Développez Protocole : FVT-XML-TEST (TOUT).
      5. Cliquez sur l'icône Role inactif sous Définir source pour Flot de documents : ICGCPO (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 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 : MX12V3R1 (TOUT).
      4. Développez Protocole : MX12V3R1 (TOUT).
      5. Cliquez sur l'icône Role inactif sous Définir source pour Flot de documents : 850.
    3. Ensuite, 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 : 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 : 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).
  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 (TP1).
  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 représentant la transaction EDI 850 :
      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 : MX12V3R1 (TOUT).
      4. Développez Protocole : MX12V3R1 (TOUT).
      5. Cliquez sur l'icône Role inactif sous Définir cible pour Flot de documents : 850 (TOUT).
    2. Ensuite, activez la définition de flot de documents :
      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 : 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).

Création du profil d'enveloppe

Vous créez ensuite le profil de l'enveloppe qui contiendra la transaction 850 transformée :

  1. Cliquez sur Administrateur du concentrateur > Configuration du concentrateur > EDI > Profil d'enveloppe.
  2. Cliquez sur Créer.
  3. Tapez le nom du profil : EnvProf1.
  4. Dans la liste EDI Standard, sélectionnez X12.
  5. Le bouton Général est sélectionné par défaut. Tapez les valeurs suivantes pour les attributs généraux de l'enveloppe :
  6. Cliquez sur le bouton Interchange et indiquez les valeurs suivantes pour les attributs EDI :
  7. Cliquez sur Enregistrer.

Création du format XML

Cette section explique comment créer le format XML personnalisé.

  1. Cliquez sur Administrateur du concentrateur > Configuration du concentrateur > Formats XML.
  2. Cliquez sur Création du format XML.
  3. Dans Format d'acheminement, sélectionnez FVT-XML-TEST ALL.
  4. Dans Type de fichier, sélectionnez XML.
  5. Dans Type d'identificateur, sélectionnez Code racine et tapez MMDoc.
  6. Dans ID Métier source, sélectionnez Constante et tapez 000000000.
  7. Dans ID Métier cible, sélectionnez Constante et tapez 000000001.
  8. Dans Flot de documents source, sélectionnez Constante et tapez ICGCPO.
  9. Dans Version du flot de documents source, sélectionnez Constante et tapez TOUT.
  10. Cliquez sur Enregistrer.

Activation des connexions

Activez les connexions du participant :

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

  1. Cliquez sur Administrateur de compte > Profils > Participant de communauté puis sur Rechercher.
  2. Cliquez sur Afficher les détails en regard de TPI pour le sélectionner.
  3. Cliquez sur Capacités B2B.
  4. Cliquez sur l'icône Développer en regard de Regroupement : N/A.
  5. Cliquez sur l'icône Edition en regard de Protocole : MX12V3R1.
  6. Précisez les attributs suivants :
    1. Sur la ligne Profil d'enveloppe, sélectionnez EnvProf1 dans la liste.
    2. Sur la ligne Qualificatif EDI, tapez 01.
    3. Sur la ligne Identificateur EDI, tapez 000000001.
    4. Sur la ligne Indicateur de syntaxe EDI, tapez T.
  7. Cliquez sur Enregistrer.
  8. Cliquez sur Administrateur de compte > Profils > Participant de communauté puis sur Rechercher.
  9. Cliquez sur Afficher les détails en regard de Gestionnaire pour le sélectionner.
  10. Cliquez sur Capacités B2B.
  11. Cliquez sur l'icône Développer en regard de Regroupement : N/A.
  12. Cliquez sur l'icône Edition en regard de Protocole : MX12V3R1 (TOUT).
  13. Précisez les attributs suivants :
    1. Sur la ligne Qualificatif EDI, tapez 01.
    2. Sur la ligne Identificateur EDI, tapez 000000000.
    3. Sur la ligne Indicateur de syntaxe EDI, tapez T.
  14. 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.

Copyright IBM Corp. 2003, 2005