Gestion du format XML personnalisé

La procédure décrite dans cette section ne vous intéresse que si vous envisagez d'utiliser un format XML personnalisé.

XML(Extensible Markup Language) est le format universel des documents et des données structurés à l'échelle du Web. Dans la page Gestion des formats XML, vous pouvez créer et gérer les formats XML personnalisés que vous pouvez ajouter à la liste des définitions de flot de documents disponibles.

Un format XML définit les chemins parmi un ensemble de documents XML. Il permet au Gestionnaire de documents de récupérer les valeurs qui identifient de façon unique un document et d'accéder aux informations contenues dans le document qui s'avèrent nécessaires à un acheminement et à un traitement corrects.

La procédure de création d'un format XML comporte plusieurs étapes. Vous devez en effet :

  1. créer un protocole pour le format et l'associer à un ou plusieurs modules ;
  2. créer un flot de documents pour le format et l'associer au protocole nouvellement créé ;
  3. créer le format.

Vous devez ensuite créer une interaction correcte pour le nouveau format.

Ces étapes sont décrites dans les sections qui suivent. Vous trouverez également un exemple de ces étapes à la section Configuration du concentrateur pour les documents XML personnalisés.

Création d'un format de définition de protocole XML personnalisé

La procédure suivante indique comment créer un format de définition de protocole XML personnalisé.

  1. Cliquez sur Administrateur du concentrateur > Définitions du flot de documents > Création d'une définition du flot de documents.

    Figure 26. Création d'une page de définitions de flot de documents


  2. Dans la liste déroulante Type de flot de documents, sélectionnez Protocole.
  3. Dans la zone Code, indiquez la valeur du type d'objet que vous avez sélectionné à l'étape précédente. Par exemple, vous pouvez entrer XML.
  4. Dans la zone Nom, indiquez un identificateur pour la définition de flot de documents. Par exemple, pour un protocole XML personnalisé, vous pouvez entrer XML_Personnalisé. Cette zone doit être renseignée.
  5. Dans la zone Version, entrez 1.0.
  6. Entrez éventuellement une description du protocole.
  7. Réglez le paramètre Niveau du document sur Non, car vous définissez un protocole et non un flot de documents (défini à la section suivante).
  8. Réglez le paramètre Etat sur Activé.
  9. Réglez le paramètre Visibilité pour ce protocole. Il est probable que vous souhaiterez le rendre visible à tous les participants.
  10. Sélectionnez les modules dans lesquels ce nouveau protocole sera encapsulé. Par exemple, si vous souhaitez que ce protocole soit associé aux trois modules, sélectionnez Module : AS, Module : Aucun, et Module : Intégration dorsale.
  11. Cliquez sur Sauvegarder.

Création d'une définition de flot de documents

Vous devez ensuite réutiliser la page Création d'une définition du flot de documents pour créer un flot de documents.

  1. Cliquez sur Administrateur du concentrateur > Définitions du flot de documents > Création d'une définition du flot de documents.
  2. Dans la liste déroulante Type de flot de documents, sélectionnez Flot de documents.
  3. Dans la zone Code, indiquez la valeur du type d'objet (flot de documents) que vous avez sélectionné à l'étape précédente.
  4. Dans la zone Nom, indiquez un identificateur pour la définition de flot de documents. Par exemple, vous pouvez entrer Testeur_XML comme nom de flot de documents. Cette zone doit être renseignée.
  5. Dans la zone Version, entrez 1.0.
  6. Entrez éventuellement une description du protocole.
  7. Réglez le paramètre Niveau du document sur Oui(car vous définissez un niveau de document).
  8. Réglez le paramètre Etat sur Activé.
  9. Réglez le paramètre Visibilité pour ce flot. Il est probable que vous souhaiterez le rendre visible à tous les participants.
  10. Cliquez sur l'icône du dossier pour développer chaque module sélectionné lors de la procédure précédente. Développez le dossier, puis sélectionnez le nom du protocole créé à la section précédente (en l'occurrence, Protocole : XML_Personnalisé.).
  11. Cliquez sur Sauvegarder.

L'exemple suivant est une illustration de la page Gestion des définitions du flot de documents tel qu'il apparaîtrait suite à la création du protocole XML_Personnalisé, de l'association de ce dernier au module AS, Aucun et Intégration dorsale, et de la création du flot de documents Testeur_XML

Figure 27. Page Définition de flot de documents avec un nouveau protocole XML personnalisé et l'ajout d'un flot de documents


Création d'un format XML

Une fois que vous avez créé un protocole XML personnalisé (et que vous l'avez associé avec un module ou un jeu de modules) et que vous avez créé un flot de documents associé, vous pouvez alors créer le format XML.

Pour créer un format XML, procédez comme suit :

  1. Cliquez sur Administrateur du concentrateur > Configuration du concentrateur > Formats XML.
  2. Cliquez sur Création du format XML.

    Figure 28. Vue d'une page de format XML


  3. Pour la zone Format d'acheminement, sélectionnez la définition de flot de documents avec laquelle ce format sera associé.
  4. Dans la zone Type de fichier, sélectionnez XML.

    Remarque : XML est la seule option disponible pour le type de fichier.

  5. Dans la zone Type d'identificateur, sélectionnez l'élément utilisé pour identifier le type de document entrant. Les options sont DTD, Espace-nom ou Code racine.
  6. Pour chaque zone pour laquelle une option de ce type est fournie, sélectionnez Chemin d'accès à l'élément, qui est le chemin d'accès à la valeur dans le document, ou Constante, qui est la valeur réelle du document. Indiquez ensuite une valeur.
    1. Dans les zones ID métier source/cible, entrez le chemin d'accès de l'ID métier. Cette zone doit être renseignée.
    2. Pour la zone Flot & Version du flot de documents source, entrez une expression qui définit le chemin d'accès au flot de documents et à la valeur de la version dans le document XML. Cette zone doit être renseignée.
    3. Dans la zone Identificateur du document, entrez le chemin d'accès au numéro d'identification du document.
    4. Dans la zone Horodatage du document, entrez le chemin d'accès pour l'horodatage de la création du document.
    5. Pour les zone Clé de vérification en double 1 à 5, entrez les chemins permettant d'identifier l'acheminement d'un document en double.
  7. Cliquez sur Sauvegarder.

Utilisation de mappes de validation

WebSphere Business Integration Connect fait appel à des mappes de validation pour valider la structure des documents RosettaNet ou XML. S'il ne vous est pas utile d'importer des mappes de validation, passez à la section Création d'interactions.

Ajout de mappes de validation

Vous pouvez associer une action à une mappe de validation pour être certain que le participant de destination ou le système dorsal peut procéder à une analyse syntaxique du document. Sachez qu'une mappe de validation ne fait que valider la structure du document. Elle ne valide pas le contenu du message.

Remarque : Une fois que vous avez associé une mappe de validation à une définition du flot de documents, vous ne pouvez plus les dissocier.

Pour ajouter une nouvelle mappe de validation au concentrateur, procédez comme suit :

  1. Enregistrez le fichier de la mappe de validation dans le concentrateur ou à un emplacement à partir duquel WebSphere Business Integration Connect peut lire les fichiers.
  2. Cliquez sur Administrateur du concentrateur > Configuration du concentrateur > Mappes de validation.
  3. Cliquez sur Créer.
  4. Entrez une description de la mappe de validation. Choisissez le chemin et le nom du fichier schéma à utiliser pour valider les documents.
  5. Cliquez sur Sauvegarder.

Association de mappes à des définitions de flot de documents

Pour associer une mappe de validation à une définition du flot de documents, procédez comme suit :

  1. Cliquez sur Administrateur du concentrateur > Configuration du concentrateur > Mappes de validation. La console affiche la page Gestion des mappes de validation.
  2. Cliquez sur l'icône symbolisant une loupe en regard de la mappe de validation que vous voulez associer à la définition du flot de documents.
  3. Cliquez sur l'icône de dossier pour développer les éléments individuellement jusqu'au niveau Action, ou sélectionnez Tout pour développer l'arborescence dans son intégralité.
  4. Sélectionnez la définition du flot de documents que vous voulez associer à la mappe de validation.
  5. Cliquez sur Soumettre.

Copyright IBM Corp. 1997, 2004