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
- Cliquez sur Afficheurs >
Afficheur de documents.
Le système affiche la fenêtre Recherche de l'afficheur de documents.
- 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.
- 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
- Cliquez sur Afficheurs >
Afficheur de documents.
Le système affiche la fenêtre Recherche de l'afficheur de documents.
- Sélectionnez les critères de recherche dans les listes
déroulantes.
- Cliquez sur Rechercher. Le système affiche
la liste des documents.
- Pour afficher les événements et les caractéristiques d'un
document, cliquez sur l'icône en forme de dossier en regard du document affiché sous l'en-tête Documents associés. Le système affiche
les événements et les caractéristiques du processus du document
sélectionné. Pour l'échange de documents EDI, s'il existe des transactions
EDI provenant de désenveloppement ou d'enveloppement,
elles peuvent être affichées en sélectionnant le bouton radio source ou cible Enfants de documents. Voir Affichage des documents EDI pour
plus de détails.
- Pour afficher le document de base avec les en-têtes de transfert, cliquez sur l'icône
Afficher le document de base en regard du document. Le système
affiche le contenu du document de base.
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 :
- Cliquez sur Afficheurs >
Afficheur de documents.
Le système affiche la fenêtre Recherche de l'afficheur de documents.
- Sélectionnez les critères de recherche dans les listes
déroulantes.
- Cliquez sur Rechercher. Le système affiche
la liste des documents.
- Cliquez sur l'icône Afficher les détails en regard de l'ID d'un document.
- 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 :
- Cliquez sur Afficheurs >
Afficheur de documents.
Le système affiche la fenêtre Recherche de l'afficheur de documents.
- Spécifiez les critères de recherche pour localiser les échanges EDI reçus par
WebSphere Partner Gateway.
- Cliquez sur Rechercher. Le système affiche une liste de tous les documents
répondant à vos critères de recherche.
- Cliquez sur l'icône Afficher les détails en regard de l'ID de document que vous
souhaitez afficher.
- 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 :
- Cliquez sur Afficheurs >
Afficheur de documents.
Le système affiche la fenêtre Recherche de l'afficheur de documents.
- Sélectionnez les critères de recherche dans les listes
déroulantes.
- 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 :
- Cliquez sur Afficheurs >
Afficheur de documents.
Le système affiche la fenêtre Recherche de l'afficheur de documents.
- Sélectionnez les critères de recherche dans les listes
déroulantes.
- Cliquez sur Rechercher. Le système affiche
la liste des documents.
- Cliquez sur l'icône Afficher les détails en regard de l'ID d'un document.
- Cliquez sur le bouton radio Information dans la section Evénements des documents.
- Cliquez sur l'icône Développer en regard de la transaction EDI enveloppée dans la colonne
Nom de l'événement.
- Localisez et copiez l'ID d'activité d'enveloppe dans la liste Détails de l'événement.
- Cliquez sur Afficheurs >
Afficheur de documents.
Le système affiche la fenêtre Recherche de l'afficheur de documents.
- 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 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 :
- Les documents Entrants sont des documents qui arrivent dans
WebSphere Partner Gateway, soit en provenance d'une intégration dorsale, soit du participant.
Ces documents peuvent échouer dans le réceptionnaire, dans le moteur DAE ou dans le moteur BPE.
- Les documents Sortants sont des documents qui sortent de
WebSphere Partner Gateway, soit en direction d'une intégration dorsale, soit du participant.
Ces documents peuvent échouer dans le moteur BPE ou dans le gestionnaire de sortie.
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 :
- La taille du document reçu est supérieure à la limite maximum de taille.
- Echec de la non répudiation du document reçu.
- Echec d'envoi du document au BPE.
Les échecs de documents entrants
peuvent intervenir dans les moteurs BPE dans les cas suivants :
- Echecs de flot de travail entrant corrigés
- Pendant le dégroupement, les échecs de messages peuvent intervenir pendant le déchiffrement du message ou la
vérification de la signature. Cela peut être causé par une mauvaise configuration des certificats sur le partenaire ou le concentrateur.
- Les fonctionnalités B2B ne sont pas configurées pour le partenaire.
- Echecs de flot de travail variables
- Les mappes de validation ne sont pas configurées.
- Les mappes de conversion sont configurées.
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 :
- Alors que pour un échec de moteur BPE lorsque une nouvelle soumission du document sortant n'a pas de sens,
elle a du sens pour un document entrant. Cela permet de garantir que tout ce qui était incorrect
dans le flot BPE ne sera pas repris dans le flot corrigé. La transformation permet d'illustrer cette correction. Les échecs de documents sortants
dans les moteurs BPE peuvent être des échecs de flot de travail sortants corrigés. Le regroupement du message
peut échouer pendant le chiffrement ou la signature du message en raison d'un configuration
incorrecte du certificat pour le partenaire ou le concentrateur.
- Pour un échec du gestionnaire de sortie :
- Si le problème est dû à une erreur du flot BPE, le document entrant
doit être resoumis. Cela permet de garantir que toutes les corrections apportées au flot BPE seront prises en compte. C'est le cas, par exemple, si les informations cible de la passerelle étaient incorrectes.
- Si l'échec a été causé par quelque chose d'autre, comme un échec du transfert cible de la passerelle, vous pouvez resoumettre
le document sortant ainsi que le document sortant.
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 :
- Cliquez sur Afficheurs >
Afficheur de documents.
Le système affiche la fenêtre Recherche de l'afficheur de documents.
- Sélectionnez les critères de recherche dans les listes
déroulantes.
- Cliquez sur Rechercher. Le système affiche
la liste des documents.
- Cochez la case en regard du ou des documents que vous souhaitez renvoyer.
- Cliquez sur Renvoyer.
Vous recevrez un message de confirmation après le traitement du nouvel envoi.
