Documents RosettaNet

Cette section propose des informations générales sur les documents RosettaNet et vous indique comment définir des définitions de flots de documents et interactions pour ces documents.

Généralités

RosettaNet est une organisation qui fournit des normes ouvertes permettant de gérer l'échange de messages commerciaux entre des partenaires. Pour plus d'informations sur RosettaNet, voir http://www.rosettanet.org. Les normes comprennent les spécifications RNIF (RosettaNet Implementation Framework) et PIP (Partner Interface Process). RNIF définit l'échange de messages entre des partenaires commerciaux en fournissant une structure de regroupement de messages, de protocoles de transfert et de sécurité. Deux versions ont été publiées : 1.1 et 2.0. Un processus PIP définit un processus métier public ainsi que les formats de message XML permettant la prise en charge de ce processus.

WebSphere Partner Gateway prend en charge l'échange de messages RosettaNet conformes aux spécifications RNIF 1.1 et 2.0. Lorsque le concentrateur reçoit un message PIP, il le valide et le transforme pour l'envoyer au système dorsal approprié. WebSphere Partner Gateway fournit un protocole permettant le regroupement du message transformé en un message RNSC (RosettaNet Service Content) que le système dorsal peut traiter. Pour plus d'informations sur le regroupement utilisé avec ces messages pour fournir des informations d'acheminement, reportez-vous au Guide d'intégration d'entreprise.

Le concentrateur peut également recevoir des messages RNSC à partir de systèmes dorsaux et créer le message PIP approprié puis l'envoyer au partenaire d'échanges qui convient (un participant). Vous fournissez les définitions de flot de documents pour la version RNIF et les processus PIP que vous souhaitez utiliser.

En plus d'assurer l'acheminement des messages RosettaNet, WebSphere Partner Gateway maintient un état pour chaque message traité. Il peut ainsi renvoyer les messages qui échouent jusqu'à ce que le nombre de tentatives atteigne un seuil spécifié. Le mécanisme de notification d'événement alerte les systèmes dorsaux si un message PIP ne peut pas être remis. En outre, le concentrateur peut générer automatiquement des PIP 0A1 à envoyer aux participants appropriés s'il reçoit certains messages de notification d'événement provenant des systèmes dorsaux. Pour plus d'informations sur la notification d'événement, reportez-vous au Guide d'intégration d'entreprise.

Regroupements de flot de documents RNIF et PIP

Pour prendre en charge l'échange de messages RosettaNet, WebSphere Partner Gateway fournit deux jeux de fichiers compressés appelés regroupements. Les regroupements RNIF comportent définitions de flot de documents nécessaires pour prendre en charge le protocole RNIF. Ces regroupements se trouvent dans le répertoire B2BIntegrate.

Pour RNIF V1.1, les regroupements sont :

Pour RNIF V02.00, les regroupements sont :

Le premier regroupement de chaque paire fournit les définitions de flot de documents requises pour la prise en charge des communications RosettaNet avec les participants, tandis que le second fournit les définitions nécessaires pour la prise en charge des communications RosettaNet avec les systèmes dorsaux.

Le second jeu se compose de regroupements de flot de documents PIP. Chaque regroupement de flot de documents PIP comporte un répertoire Packages contenant un fichier XML et un répertoire GuidelineMaps contenant des fichiers XSD. Le fichier XML spécifie les définitions de flot de documents qui déterminent le mode de traitement du processus PIP par WebSphere Partner Gateway et définissent les messages et signaux échangés. Les fichiers XSD spécifient le format des messages du processus PIP et précisent les valeurs acceptées pour les éléments XML de ces messages. Les fichiers compressés des processus PIP 0A1 contiennent également un fichier XML que le concentrateur utilise comme modèle pour créer des documents 0A1.

Le processus PIP pour lesquels WebSphere Partner Gateway fournit des regroupements de flot de documents PIP sont les suivants :

Pour chaque processus PIP, il existe quatre regroupements de flot de documents PIP :

Chaque regroupement de flot de documents PIP respecte sa propre convention de dénomination, ce qui vous permet de déterminer s'il concerne les messages entre WebSphere Partner Gateway et les participants ou entre WebSphere Partner Gateway et les systèmes dorsaux. Cette convention identifie également la version RNIF, le processus PIP et la version PIP prise en charge par le regroupement. Pour les regroupements de flot de documents PIP destinés à l'échange de messages entre WebSphere Partner Gateway et les participants, le format est le suivant :

BCG_Package_RNIF<version_RNIF>_<PIP><version_PIP>.zip

Pour les regroupements de flot de documents PIP destinés à l'échange de messages entre WebSphere Partner Gateway et les systèmes dorsaux, le format est le suivant :

BCG_Package_RNSC<version_Backend_Integration>_RNIF<version_RNIF>_
 <PIP><version_PIP>.zip

Par exemple, le regroupement BCG_Package_RNIF1.1_3A4V02.02.zip sert à valider les documents pour la version 02.02 du processus PIP 3A4 qui sont échangés entre les participants et WebSphere Partner Gateway à l'aide du protocole RNIF 1.1. Quant aux regroupements de flot de documents PIP permettant la communication avec les systèmes dorsaux, leur nom doit également indiquer le protocole utilisé pour envoyer le contenu RosettaNet aux systèmes dorsaux. Pour plus d'informations sur le regroupement utilisé avec ces messages, reportez-vous au Guide d'intégration d'entreprise.

Création de définitions de flots de documents

Pour l'échange de messages RosettaNet, WebSphere Partner Gateway exige les regroupements RNIF de la version utilisée pour envoyer les messages. Pour chaque processus PIP pris en charge par WebSphere Partner Gateway, il faut les deux regroupements de flot de documents PIP pour la version RNIF. Par exemple, pour prendre en charge le processus PIP 3A4 sur RNIF 2.0, WebSphere Partner Gateway exige les regroupements suivants :

Le premier regroupement prend en charge l'échange de messages RosettaNet avec les participants, le second l'échange de messages RosettaNet avec les systèmes dorsaux. Les troisième et quatrième regroupements permettent à WebSphere Partner Gateway de transmettre des messages 3A4 entre des participants et des systèmes dorsaux par le biais du protocole RNIF 2.0.

Pour télécharger des regroupements RosettaNet :

  1. Cliquez sur Administrateur du concentrateur > Configuration du concentrateur > Définition du flot de documents.
  2. Cliquez sur Téléchargement des regroupements.
  3. Sélectionnez Non pour Regroupement WSDL.
  4. Cliquez sur Parcourir et sélectionnez le regroupement RNIF pour communiquer avec les participants.

    Par défaut, les regroupements RNIF sont situés dans le répertoire B2BIntegrate/Rosettanet du support d'installation. Par exemple, pour télécharger le regroupement RNIF version 2.00, vous devez accéder au répertoire B2BIntegrate/Rosettanet et sélectionner : Package_RNIF_V0200.zip.

  5. Assurez-vous que le paramètre Validation dans la base de données est sur Oui.
  6. Cliquez sur Télécharger.
  7. Cliquez de nouveau sur Parcourir et sélectionnez le regroupement RNIF pour communiquer avec les applications dorsales.

    Par exemple, pour télécharger le regroupement RNIF version 2.00, vous devez accéder au répertoire B2BIntegrate/Rosettanet et sélectionner Package_RNSC_1.0_RNIF_V02.00.zip.

  8. Cliquez sur Télécharger.

    Les regroupements nécessaires pour communiquer avec les participants ou le système dorsal sont à présent installés sur le système. Si vous consultez la page Gérer les définitions de documents, vous voyez une entrée pour Regroupement : RNIF/Protocole : RosettaNet, qui représente le regroupement pour communiquer avec les participants, et Regroupement : Intégration dorsale/Protocole : RNSC, qui est le regroupement pour communiquer avec les applications dorsales.

  9. Pour chaque PIP que vous souhaitez prendre en charge, téléchargez le regroupement de flot de documents PIP pour le processus PIP et la version RNIF que vous prenez en charge. Par exemple, pour télécharger le PIP 3A6 (Notify of Remittance Advice) à envoyer à un participant, procédez comme suit :
    1. Cliquez sur Parcourir et sélectionnez BCG_Package_RNIFV02.00_3C6V02.02 dans le répertoire B2BIntegrate/Rosettanet.
    2. Assurez-vous que le paramètre Validation dans la base de données est sur Oui.
    3. Cliquez sur Télécharger.

    Le PIP 3C6V02.02 apparaît comme étant le flot de documents sous Regroupement : RNIF/Protocole : RosettaNet sur la page Gérer les définitions de documents. Une activité, une action et deux signaux sont également affichés. Ils sont inclus dans le téléchargement du PIP.

    Pour télécharger le PIP 3A6 à envoyer à l'application dorsale, procédez comme suit :

    1. Cliquez sur Parcourir et sélectionnez BCG_Package_RNSC1.0_RNIFV02.00_3C6V02.02.zip.
    2. Assurez-vous que le paramètre Validation dans la base de données est sur Oui.
    3. Cliquez sur Télécharger.

    Le PIP 3C6V02.02 apparaît désormais comme étant le flot de documents sous Regroupement : Intégration dorsale/Protocole : RNSC , sur la page Gérer les définitions de flots de documents.

    Si WebSphere Partner Gateway ne fournit pas de regroupement pour le processus ou la version PIP que vous souhaitez utiliser, vous pouvez créer votre propre regroupement et le télécharger. Pour plus d'informations, voir Création de regroupements de flot de documents PIP.

Configuration des valeurs d'attribut

Pour les définitions de flot de documents PIP, la plupart des valeurs des attributs sont déjà définies et ne nécessitent pas de configuration. Toutefois, vous devez définir les attributs suivants :

Regroupement RNIF (1.0)

Regroupement RNIF (V02.00)

Notez que les processus PIP pour lesquels WebSphere Partner Gateway fournit des regroupements de flot de documents PIP ne sont pas synchrones. En conséquence, il n'est pas nécessaire de modifier les attributs Accusé de réception de synchronisation requise et Synchronisation prise en charge pour ces processus PIP.

Remarque : Le comportement de l'attribut Accusé de réception de synchronisation requise est différent entre les processus PIP à sens unique et à double sens. Pour un processus PIP à double sens, lorsque l'attribut Accusé de réception de synchronisation requise a la valeur Non, ce paramètre prend le pas sur un paramètre Irréfutabilité de l'avis de réception ayant la valeur Oui. Par exemple, si vous envoyez un 3A7 avec les paramètres suivants :

Pour un processus PIP à double sens, vous recevez un message d'erreur sur le document entrant. Pour un processus PIP à sens unique, cependant, vous voyez le document entrant sur la console et un code 0KB 200 est renvoyé au participant.

Pour définir les attributs, procédez comme suit :

  1. Cliquez sur Administrateur du concentrateur > Configuration du concentrateur > Définition du flot de documents.
  2. Cliquez sur les icônes Développer pour développer un noeud jusqu'au niveau Définition du flot de documents approprié, ou sélectionnez Tout pour développer tous les noeuds de définition de flot de documents de l'arborescence.
  3. Dans la colonne Actions, cliquez sur l'icône Edition des valeurs d'attribut du regroupement que vous souhaitez modifier (par exemple Regroupement : RNIF (1.1) ou Regroupement : RNIF (V02.00)).
  4. Dans la section Attributs de contexte du flot de documents, allez dans la colonne Mettre à jour de l'attribut que vous souhaitez définir et sélectionnez ou entrez la nouvelle valeur dans la zone. Répétez l'opération pour chaque attribut à définir.
  5. Cliquez sur Enregistrer.

Remarque : Vous pouvez également mettre à jour les attributs RosettaNet au niveau de la connexion en cliquant sur Attributs pour la source et la cible puis en entrant ou modifiant les valeurs de la colonne Mettre à jour. Voir Spécification ou modification des attributs.

Création d'interactions

La procédure suivante décrit la création d'une interaction entre un système dorsal et un participant. Notez que vous devez créer une interaction pour chaque processus PIP que vous souhaitez envoyer et une pour chaque processus PIP que vous souhaitez recevoir.

Avant de commencer, assurez-vous que les définitions appropriées de flot de documents RNIF ont été téléchargées, ainsi que les regroupements du processus PIP que vous souhaitez utiliser. Si vous voulez pouvoir générer un PIP 0A1 (Notification of Failure), assurez-vous de l'avoir téléchargé, ainsi que décrit à l'étape 9.

Pour créer une interaction pour un PIP particulier, procédez comme suit :

  1. Cliquez sur Administrateur du concentrateur > Configuration du concentrateur > Définition du flot de documents.
  2. Cliquez sur Gestion des interactions.
  3. Cliquez sur Création d'une interaction.
  4. Développez l'arborescence Source jusqu'au niveau Action et l'arborescence Cible jusqu'au niveau Action.
  5. Dans les arborescences, sélectionnez les définitions de flot de documents à utiliser pour les contextes source et cible. Par exemple, si le participant est l'initiateur d'un processus PIP 3C6 (PIP à une action), sélectionnez les définitions de flot de documents suivantes :
    Tableau 5. Processus PIP 3C6 lancé par un participant
    Source Cible
    Regroupement : RNIF (V02.00) Regroupement : Intégration dorsale (1.0)
    Protocole : RosettaNet (V02.00) Protocole : RNSC (1.0)
    Flot de documents : 3C6 (V01.00) Flot de documents : 3C6 (V01.00)
    Activité : Notification d'avis de paiement Activité : Notification d'avis de paiement
    Action : Action de notification d'avis de paiement Action : Action de notification d'avis de paiement

    Si le système dorsal est l'initiateur du processus PIP 3C6, sélectionnez les définitions de flot de documents suivantes :

    Tableau 6. Processus PIP 3C6 lancé par un système dorsal
    Source Cible
    Regroupement : Intégration dorsale (1.0) Regroupement : RNIF (V02.00)
    Protocole : RNSC (1.0) Protocole : RosettaNet (V02.00)
    Flot de documents : 3C6 (V01.00) Flot de documents : 3C6 (V01.00)
    Activité : Notification d'avis de paiement Activité : Notification d'avis de paiement
    Action : Action de notification d'avis de paiement Action : Action de notification d'avis de paiement

    Pour un processus PIP à deux actions tel qu'un processus 3A4 lancé par un participant, sélectionnez les définitions de flot de documents suivantes pour la première action :

    Tableau 7. Processus PIP 3A4 lancé par un participant
    Source Cible
    Regroupement : RNIF (V02.00) Regroupement : Intégration dorsale (1.0)
    Protocole : RosettaNet (V02.00) Protocole : RNSC (1.0)
    Flot de documents : 3A4 (V02.02) Flot de documents : 3A4 (V02.02)
    Activité : Demande de bon de commande Activité : Demande de bon de commande
    Action : Action de demande de bon de commande Action : Action de demande de bon de commande

    Si un système dorsal lance le processus PIP à deux actions 3A4, sélectionnez les définitions de flot de documents suivantes pour la première action :

    Tableau 8. Processus PIP 3A4 lancé par un système dorsal
    Source Cible
    Regroupement : Intégration dorsale (1.0) Regroupement : RNIF (V02.00)
    Protocole : RNSC (1.0) Protocole : RosettaNet (V02.00)
    Flot de documents : 3A4 (V02.02) Flot de documents : 3A4 (V02.02)
    Activité : Demande de bon de commande Activité : Demande de bon de commande
    Action : Action de demande de bon de commande Action : Action de demande de bon de commande
  6. Dans la zone Action, sélectionnez Translation bidirectionnelle de RosettaNet et de RosettaNet Service Content avec Validation.
  7. Cliquez sur Enregistrer.
  8. Si vous configurez un processus PIP à deux actions, répétez les étapes nécessaires pour créer l'interaction pour la seconde action. Par exemple, sélectionnez les définitions de flot de documents suivantes pour la seconde action d'un processus PIP 3A4 lancé par un participant. Il s'agit de l'action par laquelle le système dorsal envoie la réponse.
    Tableau 9. Processus PIP 3A4 lancé par un participant (seconde action)
    Source Cible
    Regroupement : Intégration dorsale (1.0) Regroupement : RNIF (V02.00)
    Protocole : RNSC (1.0) Protocole : RosettaNet (V02.00)
    Flot de documents : 3A4 (V02.02) Flot de documents : 3A4 (V02.02)
    Activité : Demande de bon de commande Activité : Demande de bon de commande
    Action : Action de confirmation de bon de commande Action : Action de confirmation de bon de commande

    Pour la seconde action d'un processus PIP 3A4 lancé par un système dorsal, sélectionnez les définitions de flot de documents suivantes :

    Tableau 10. Processus PIP 3A4 lancé par un système dorsal (seconde action)
    Source Cible
    Regroupement : RNIF (V02.00) Regroupement : Intégration dorsale (1.0)
    Protocole : RosettaNet (V02.00) Protocole : RNSC (1.0)
    Flot de documents : 3A4 (V02.02) Flot de documents : 3A4 (V02.02)
    Activité : Demande de bon de commande Activité : Demande de bon de commande
    Action : Action de confirmation de bon de commande Action : Action de confirmation de bon de commande
  9. Si vous voulez générer la Notification of Failure 0A1, créez une interaction pour XMLEvent.
    1. Cliquez sur Administrateur du concentrateur > Configuration du concentrateur > Définition du flot de documents.
    2. Cliquez sur Gestion des interactions.
    3. Cliquez sur Création d'une interaction.
    4. Développez l'arborescence Source jusqu'au niveau Flot de documents et l'arborescence Cible jusqu'au niveau Flot de documents.
    5. Sélectionnez les définitions de flots de documents suivants :
      Tableau 11. Définition d'un flot de documents d'événement XML
      Source Cible
      Regroupement : Intégration dorsale (1.0) Regroupement : Intégration dorsale (1.0)
      Protocole : XMLEvent (1.0) Protocole : XMLEvent (1.0)
      Flot de documents : XMLEvent (1.0) Flot de documents : XMLEvent (1.0)
    6. Dans la zone Action, sélectionnez Passe-système.
    7. Cliquez sur Enregistrer.
  10. Création d'une interaction pour XMLEvent vers 0A1 RNSC.
    1. Cliquez sur Administrateur du concentrateur > Configuration du concentrateur > Définition du flot de documents.
    2. Cliquez sur Gestion des interactions.
    3. Cliquez sur Création d'une interaction.
    4. Développez l'arborescence Source jusqu'au niveau Flot de documents et l'arborescence Cible jusqu'au niveau Activité.
    5. Sélectionnez les définitions de flots de documents suivants :
      Tableau 12. Définition d'un flot de documents d'événement XML à 0A1
      Source Cible
      Regroupement : Intégration dorsale (1.0) Regroupement : Intégration dorsale (1.0)
      Protocole : XMLEvent (1.0) Protocole : RNSC (1.0)
      Flot de documents : XMLEvent (1.0) Flot de documents : 0A1 (V02.00)
      Activité : Distribution de notification d'échec.
    6. Dans la zone Action, sélectionnez Conversion bidirectionnelle de RosettaNet et XML avec Validation.
    7. Cliquez sur Enregistrer.

Copyright IBM Corp. 2003, 2005