Afficheur de documents

L'Afficheur de documents vous permet de visualiser les documents qui composent un processus. Vous pouvez utiliser les critères de recherche pour afficher les événements et les caractéristiques de gestion des documents de base et des documents associés. Vous pouvez également utiliser l'afficheur de documents pour renvoyer des documents ayant échoué ou abouti.

Recherche des documents

  1. Cliquez sur Afficheurs > Afficheur de documents. Le système affiche la fenêtre Recherche de l'afficheur de documents.
  2. Sélectionnez les critères de recherche, décrits dans le tableau 22 dans les listes déroulantes.
    Tableau 22. Critères de recherche de l'Afficheur de documents
    Valeur Description

    Date de début

    Date à laquelle le processus a été initialisé.

    Heure de début

    Heure à laquelle le processus a été initialisé.

    Date de fin

    Date à laquelle le processus a été terminé.

    Heure de fin

    Heure à laquelle le processus a été terminé.

    Participant source

    Représente le participant ayant lancé le flot de documents. La valeur par défaut est Tout.

    Participant cible

    Représente le participant ayant reçu le flot de documents. La valeur par défaut est Tout.

    Recherche

    Indique si la recherche doit porter sur le flot de documents source ou le flot de documents cible. La valeur par défaut est Flot de documents source.

    Type de passerelle

    Identifie le type de document échangé (par exemple, s'il est utilisé à des fins de production ou de test). La valeur par défaut est Tout.

    Etat du document

    Etat du document en cours dans le système : En cours, Succès ou Echec. La valeur par défaut est Tout.

    Module

    Décrit le regroupement, le chiffrement, le format du document et l'identification du type de contenu. Limite la recherche au module affiché. La valeur par défaut est Tout.

    Protocole

    Type de protocole de processus disponible pour les participants.

    Flot de documents

    Processus métier spécifique.

    Nom de fichier d'origine

    Le nom d'origine du fichier.

    ID Document

    Créé par le participant source. Les critères peuvent inclure le caractère générique astérisque (*).

    ID Référence

    Identifiant créé par le système pour contrôler l'état du document.

    Adresse IP source

    Adresse IP du participant source.

    Filtre

    Recherche les documents reçus en mode synchrone. Cela signifie que la connexion entre l'initiateur et le Gestionnaire de documents reste ouverte jusqu'à ce que la transaction soit terminée, notamment une requête et un accusé de réception ou une requête et une réponse.

    Trier par

    Indique si les documents seront triés en fonction de l'Horodatage de la cible, du flot de documents source ou du flot de documents cible. La valeur par défaut est Horodatage cible. Vous pouvez également indiquer si les documents doivent être triés par ordre croissant ou décroissant. La valeur par défaut est Ordre décroissant.

    Résultats par page

    Nombre d'enregistrements affichés sur chaque page.

    Ordre décroissant

    Trie les résultats par ordre décroissant ou croissant.

    Remarque :
    Seuls les événement d'avertissement sont affichés par défaut. Pour afficher tous les événements, sélectionnez Débogage.
  3. Cliquez sur Rechercher. Le système affiche les résultats de votre recherche, décrits dans le tableau 23.
    Remarque :
    Le terme participants est utilisé dans les fenêtres des Afficheurs pour désigner un membre de la communauté de concentrateur, notamment de Gestionnaire de communauté.
    Tableau 23. Caractéristiques des documents
    Valeur Description

    Participants

    Participants source (expéditeur) et cible (destinataire) impliqués dans le processus métier.

    Horodatages

    Date et heure auxquelles le traitement du document commence et se termine.

    Flot de documents

    Processus métier en cours de traitement.

    Type de passerelle

    Passerelle de test ou de production. La passerelle de test est uniquement disponible sur les systèmes qui prennent en charge ce type de passerelle.

    Synchrone

    Indique que le document a été reçu en mode synchrone. Cela signifie que la connexion entre l'initiateur et le Gestionnaire de documents reste ouverte jusqu'à ce que la transaction soit terminée, notamment une requête et un accusé de réception ou une requête et une réponse.

Affichage des événements, des caractéristiques du document et des documents de base

  1. Cliquez sur Afficheurs > Afficheur de documents. Le système affiche la fenêtre Recherche de l'afficheur de documents.
  2. Sélectionnez les critères de recherche dans les listes déroulantes.
  3. Cliquez sur Rechercher. Le système affiche la liste des documents.

Les informations sur le traitement du document s'affichent lorsque vous visualisez les caractéristiques du document, décrites dans le tableau 24.

Tableau 24. Valeurs de traitement du document disponibles via l'Afficheur de documents
Valeur Description

ID Référence

Numéro d'identification unique attribué à un document par le système.

ID Document

Numéro d'identification unique attribué à un document par le participant source.

Horodatage du document

Date et heure auxquelles le document a été créé par le participant.

Passerelle

Passerelle par laquelle le document est passé.

Flot de documents de la connexion

Actions exécutées sur un document par le système pour vérifier sa compatibilité avec les exigences commerciales entre les participants.

Source et cible

participants source et cible impliqués dans le processus métier.

Horodatage d'entrée

Date et heure auxquelles le document envoyé par le participant a été reçu par le système.

Horodatage de l'état de fin

Date et heure auxquelles le document a été acheminé par le système jusqu'au participant cible.

ID Métier source et cible

Numéro d'identification métier des participants source et cible, par exemple DUNS.

Flot de documents source et cible

Processus métier spécifique établi entre les participants source et cible.

Restrictions :
Les documents de base dont la taille dépasse 100 Ko sont tronqués. Lorsque la signature se trouve par exemple au bas du document brut (fichier .rno), et que la taille de ce dernier dépasse 100 Ko, ou que la signature est située au-delà des 100 premiers kilo-octets du fichier .rno, la signature n'apparaît pas dans l'afficheur de documents.

Conseil :
Si le système affiche un événement de document en double, visualisez le document d'origine précédemment envoyé en cliquant sur l'icône représentant une flèche bleue en regard de l'événement de document en double, puis cliquez sur l'icône Afficher le document d'origine.

Conseil :
Pour plus d'informations sur la manière de résoudre les incidents liés aux documents dont le traitement a échoué, voir Affichage des erreurs de validation des données dans la section suivante.

Affichage des documents EDI

En plus de prendre en charge les échanges EDI, WebSphere Partner Gateway prend en charge le désenveloppement et l'enveloppement des échanges EDI. Les documents d'échanges EDI sont désenveloppés lors de leur réception de la part d'un participant de communauté ou d'un gestionnaire de communauté. Les documents de transaction qui sont désenveloppés de l'échange entrant peuvent alors être traités par WebSphere Partner Gateway comme tout autre document métier.

WebSphere Partner Gateway enveloppe les transactions EDI et génère des échanges EDI. Les documents de transaction EDI sont générés par la transformation des documents XML, EDI et ROD en transactions EDI. Les documents de transaction EDI qui sont désenveloppés des échanges EDI reçus par WebSphere Partner Gateway peuvent être transformés en d'autres types de documents de transaction EDI. WebSphere Partner Gateway enveloppe les documents de transaction EDI dans un document d'échange EDI et envoie le document d'échange EDI au destinataire voulu.

Les scénarios suivant vous aideront à appréhender ces informations :

Voir le manuel Guide de configuration du concentrateur pour plus d'informations sur le désenveloppement et l'enveloppement des échanges EDI.

Affichage des transactions source de documents EDI

WebSphere Partner Gateway désenveloppe les transactions EDI entrantes à partir des échanges EDI.

Pour afficher les enfants de transactions EDI résultant, procédez comme suit :

  1. Cliquez sur Afficheurs > Afficheur de documents. Le système affiche la fenêtre Recherche de l'afficheur de documents.
  2. Sélectionnez les critères de recherche dans les listes déroulantes.
  3. Cliquez sur Rechercher. Le système affiche la liste des documents.
  4. Cliquez sur l'icône Afficher les détails en regard de l'ID d'un document.
  5. Cliquez sur le bouton radio Source de la section Enfants de documents pour voir les détails sur les enfants de documents.

Affichage des transactions cible de documents EDI

WebSphere Partner Gateway route les transactions EDI sortantes vers l'échange à envelopper.

Pour voir les enfants de transactions EDI contenus dans l'échange résultant, procédez comme suit :

  1. Cliquez sur Afficheurs > Afficheur de documents. Le système affiche la fenêtre Recherche de l'afficheur de documents.
  2. Spécifiez les critères de recherche pour localiser les échanges EDI reçus par WebSphere Partner Gateway.
  3. Cliquez sur Rechercher. Le système affiche une liste de tous les documents répondant à vos critères de recherche.
  4. Cliquez sur l'icône Afficher les détails en regard de l'ID de document que vous souhaitez afficher.
  5. Cliquez sur le bouton radio Cible de la section Enfants de documents pour voir les détails sur les enfants de documents.

Localisation de l'échange source

Vous pouvez utiliser l'afficheur de documents pour obtenir l'échange source d'une transaction EDI :

  1. Cliquez sur Afficheurs > Afficheur de documents. Le système affiche la fenêtre Recherche de l'afficheur de documents.
  2. Sélectionnez les critères de recherche dans les listes déroulantes.
  3. Cliquez sur Rechercher. Le système affiche la liste des documents.

    L'ID de document d'échange source est répertorié pour chaque transaction EDI.

Localisation de l'échange cible

Vous pouvez utiliser l'afficheur de documents pour obtenir l'échange cible d'une transaction EDI enfant :

  1. Cliquez sur Afficheurs > Afficheur de documents. Le système affiche la fenêtre Recherche de l'afficheur de documents.
  2. Sélectionnez les critères de recherche dans les listes déroulantes.
  3. Cliquez sur Rechercher. Le système affiche la liste des documents.
  4. Cliquez sur l'icône Afficher les détails en regard de l'ID d'un document.
  5. Cliquez sur le bouton radio Information dans la section Evénements des documents.
  6. Cliquez sur l'icône Développer en regard de la transaction EDI enveloppée dans la colonne Nom de l'événement.
  7. Localisez et copiez l'ID d'activité d'enveloppe dans la liste Détails de l'événement.
  8. Cliquez sur Afficheurs > Afficheur de documents. Le système affiche la fenêtre Recherche de l'afficheur de documents.
  9. Collez l'ID d'activité d'enveloppe dans la zone ID de référence, puis cliquez sur Rechercher.

    L'afficheur de documents affiche les informations d'échange cible.

Affichage des erreurs de validation des données

Vous pouvez rechercher rapidement des documents dont le traitement a échoué à l'aide du texte codé en couleur dans les zones XML qui contiennent les erreurs de validation. Les zones contenant les erreurs de validation s'affichent en rouge. Si trois erreurs de validation différentes se produisent dans les zones XML imbriquées, les couleurs permettent de distinguer les zones d'erreur, comme indiqué dans le tableau 25.

Tableau 25. Document codé en couleur - Erreurs de validation
Valeur Description

Rouge

Première erreur de validation

Orange

Deuxième erreur de validation

Vert

Troisième erreur de validation

Voici un exemple des erreurs de validation XML imbriquées :

Exemple d'erreurs de validation XML imbriquées

Exemple d'erreurs de validation XML non imbriquées :

Exemple d'erreurs de validation XML non imbriquées

Pour plus de détails sur l'affichage des erreurs de validation dans un document de base, voir Affichage des documents de base.

Restrictions :
La Console affiche uniquement les 100 premiers Ko d'un document de base. Les erreurs de validation au-delà des 100 Ko ne sont pas visualisables.

Arrêt d'un document en cours d'exécution

Cliquez sur Arrêt du processus pour arrêter un document en cours de traitement. Cette fonction est uniquement disponibles pour les utilisateurs Administrateur de concentrateur.

Remarque :
Le système peut mettre une heure à arrêter le document. Pendant ce temps, l'Afficheur de documents continue d'afficher l'état du document En cours.

Renvoi des documents ayant échoué et ayant abouti

Vous pouvez renvoyer des documents ayant échoué après correction de la cause de l'échec. En outre, vous pouvez renvoyer les documents ayant abouti si nécessaire. Par exemple, un partenaire peut demander qu'un document soit renvoyé si le document original a été perdu sur le serveur client avant qu'il ait été mis en interface avec le système dorsal. Cette fonction est uniquement disponibles pour les utilisateurs Administrateur de concentrateur.

Il existe deux types basiques de documents que les administrateurs peuvent renvoyer :

Pour renvoyer un document Entrant ayant échoué, l'administrateur le sélectionne et clique sur le bouton Renvoyer. Le document est resoumis à partir du moteur DAE ou du moteur BPE en fonction de l'emplacement d'origine de l'échec. Par exemple, les échecs de documents entrants peuvent intervenir dans les moteurs DAE dans les cas suivants :

Les échecs de documents entrants peuvent intervenir dans les moteurs BPE dans les cas suivants :

Remarque :
Les documents échouant dans le réceptionnaire sont resoumis lorsque l'administrateur a résolu le problème.

Pour renvoyer un document Sortant ayant échoué, l'administrateur le sélectionne et clique sur le bouton Renvoyer. Le document est resoumis à partir du moteur BPE ou du gestionnaire de sortie.

Les échecs de documents sortants peuvent intervenir dans les cas suivants :

On part du principe qu'aucune modification pouvant entraîner un échec n'a été apportée (spécialement sur les moteurs DAE ou BPE). Par exemple, si le document entrant est chiffré, les certificats requis pour déchiffrer le document n'ont pas été modifiés à partir des certificats utilisés pour chiffrer le document. L'administrateur doit être conscient des toutes les conséquences éventuelles d'un renvoi.

Pour renvoyer un document, procédez comme suit :

  1. Cliquez sur Afficheurs > Afficheur de documents. Le système affiche la fenêtre Recherche de l'afficheur de documents.
  2. Sélectionnez les critères de recherche dans les listes déroulantes.
  3. Cliquez sur Rechercher. Le système affiche la liste des documents.
  4. Cochez la case en regard du ou des documents que vous souhaitez renvoyer.
  5. Cliquez sur Renvoyer.

    Vous recevrez un message de confirmation après le traitement du nouvel envoi.

Copyright IBM Corp. 2003, 2005