Documentation utilisateur GENEDI 3000

Transcription

1 GEN Version révisée 3.10 Références : GENEDI_DOCUMENTATION UTILISATEUR_310.doc Créé le : , modifié le 28/07/06 par Département EDI Imprimé le 13/09/2006 DESTINATAIRES NOM SOCIETE OBJET AGENA rue des Pagannes BP CHOLET cedex Fax

2 SOMMAIRE 1 GENERALITES LES OUTILS UTILISES Le service EXI : GEN traducteur Le contrôleur de BDD et de répertoire Le navigateur L ACCES A LA PARTIE EXPLOITATION PRESENTATION GENERALE DES ECRANS ET NAVIGATION CINEMATIQUE DES ECRANS LES RACCOURCIS CLAVIER EXPORT DE DONNEES LA CONFIGURATION OPTION REMONTEE DES ALERTES OPTION CONSERVATION DES DONNEES OPTION JOURNAL : CODE ET LIBELLE OPTION AGENTS L ADMINISTRATION L OPTION PARTENAIRE L OPTION FILES D ATTENTES Généralités Backup(s) File d attente allegro File d attente type X400 (agent.messagerie.uafi) File d attente type X400 (pour fichier libre en réception) File d attente répertoire (agent.volume) File d attente messagerie électronique File d attente (Remontée d alertes via mail) OPTION DICTIONNAIRE DE DOCUMENTS OPTION MAPPING OPTION ROUTAGE Fichier en entrée normé (gencod ou edifact) Fichier en sortie (ascii) Fichier en entré (ascii) Fichier en sortie normé (gencod ou edifact) Routage cible PRIORITE DOCUMENT PRIORITE FILE D ATTENTE L EXPLOITATION L OPTION FICHE D EXPLOITATION OPTION LANCEMENT MANUEL OPTION LISTE DES FICHES D EXPLOITATION OPTION DESCRIPTION DES TACHES TACHES A VENIR GESTION DES EVENEMENTS LISTES DES EVENEMENTS PLANIFICATION DES EVENEMENTS JOURNAL DES EVENEMENTS LE SUIVI OPTION TABLEAU DE BORD Cas fichiers reçus Cas Messages traduits Cas fichiers émis Cas Fichiers en cours de traitement ou en erreur OPTION JOURNAL OPTION JOURNAL DE COMMUNICATION Impression du 13/09/2006 page 2

3 6.4 OPTION CHRONOS ALLEGRO OPTION STATISTIQUES Données générales Répartition par jour Répartition par heure Profil/Partenaire Profil/Document Document/Profil Profil/Files d attente Files d attente/profil Files d attente/documents Documents/Files d attente OPTION RECHERCHE ARCHIVES LES UTILITAIRES TRAITEMENTS EN COURS TACHES EN COURS MESSAGES DIFFUSES TACHES EN ATTENTE ANALYSE DES REPERTOIRES TEMP (SP) PREREQUIS AUX PROCEDURES CADRE RAPPEL ELEMENTAIRE Principe EDI L enveloppe Les répertoires Cheminement des fichiers en réception à travers les agents Cheminement des fichiers en émission à travers les agents Le devenir de ces fichiers Lien avec le tableau de bord Sauvegarde en temps réel Conséquences PROCEDURES PROCEDURE DE GESTION DU BACK UP AUTOMATIQUE Des mails sont émis par le Poste Maître Des mails sont émis par le Poste Esclave et supposent que le poste maître a un problème PROCÉDURE DE BACK UP (HORS BACK UP AUTOMATIQUE) Pré-requis Procédures possibles Vérification du bon fonctionnement QUESTIONS Pour ne pas repartir avec la session précédente, que doit-on faire? Autres questions LES ALERTES LES ALERTES FONCTIONNELLES LES ALERTES D EXPLOITATION LES ALERTES EVENEMENTIELLES Impression du 13/09/2006 page 3

4 1 Généralités 1.1 Les outils utilisés L exploitation de GENEDI implique le fonctionnement des outils suivants : - Un programme «Service EXI» - Un contrôleur de Base de données et de répertoire - Un navigateur Internet Explorer (GENEDI est optimisé pour une version minimale 5.5) ou FireFox (Testé à partir de la version 1.0.7) - Un serveur http (Apache 2) et un serveur d application (Apache Tomcat) - Une base de données Nous allons détailler les trois premiers : Impression du 13/09/2006 page 4

5 1.1.1 Le service EXI : GEN traducteur EXI est utilisé pour le lancement des tâches. C est lui qui gère la mise en œuvre des agents. La barre d entête de cette fenêtre comporte l adresse IP du poste (12 chiffres) sur lequel les agents «tournent», puis l horodatage d ouverture du service. Version d EXI : 3.1 Bouton «Réduire» Bouton arrêter Liste horodatée des agents lancés (finis ou non) Les diodes ci-dessus témoignent du bon fonctionnement des agents, ci-dessous leur signification : - ML : Master Lecture - ME : Master Ecriture - MD : Master Diffusion - MR : Master Répartition - MP : Master Planning - SL et SE non utilisés - AL : Agent de lecture - AE : Agent Ecriture - AC : non utilisé Sur un poste maître, les diodes changent souvent (sauf si EXI effectue un traitement plus long). Sur un poste élève, les diodes Master ne doivent pas s allumer (sinon, il faut vérifier que vous n avez pas reçu de mail (cf. voir chapitre 9 procédures)). Note : Pour des machines multi-processeurs, il est possible de paramétrer Genedi3000 pour que des agents soient lancés dans un processus différent d EXI. A ce moment là, «lancement externe» s affichera en face de l agent. Impression du 13/09/2006 page 5

6 Le bouton «Réduire» : Cliquer sur le bouton réduire fait disparaître la fenêtre. Pour la réactiver, il faut double-cliquer sur l icône située à côté de l horloge. Le bouton «Arrêter» : Cliquer sur le bouton «Stop» arrête «EXI» du poste où vous venez de cliquer. Si vous êtes sur le poste maître, l ensemble des EXI élèves se coupent et ensuite celui du poste maître. Il se peut également qu EXI vous indique que des traitements sont en cours (se référer alors au chapitre 7 : Traitements en cours). On peut également arrêter EXI si celui-ci reçoit un message d arrêt. L exemple le plus fréquent est le «fermeture.bat», que l on peut appeler dans les taches planifiées de Windows. Démarrage EXI : Il existe plusieurs façons de lancer «EXI» : 1) En double-cliquant sur l icône «EXI», 2) Ou automatiquement via les tâches planifiées. Il faut toutefois, respecter les règles suivantes : Démarrer d abord «EXI» maître et lorsque la fenêtre «Service EXI» est active, lancer «EXI» sur les postes élèves. Lors du lancement d EXI maître, il se peut que des boîtes de dialogue apparaissent. Exemple : Réorganisation de la BDD, Reprendre la session précédente (voir chapitre 9 : PROCEDURES)) Ces boîtes de dialogue se fermeront automatiquement au bout de 10 secondes, suite à la sélection par défaut de la réponse «OUI». Par ailleurs : - La répartition de charge est matérialisée par l existence d une machine maître (master) et d une machine esclave. Chacune d entre elle ayant son propre service EXI. - Le back-up automatique se traduit par la prise de relais d une machine quand l autre a une défaillance, cette information vous sera remontée par . Si le maître est hors service, l esclave prend automatiquement la main pour se gérer lui-même en tant que maître. Si l esclave est hors service, le maître se gère seul. Par ailleurs, la base de données vers laquelle pointe le service EXI peut être sur l un des 2 postes, dans ce cas, le back-up automatique est permis par la réplication de la base de données sur l autre poste. La base de données peut être sur un autre endroit de votre réseau (sur un serveur RAID5 sécurisé par exemple) Cf annexe 1 si vous disposez de la licence multiposte Impression du 13/09/2006 page 6

7 1.1.2 Le contrôleur de BDD et de répertoire C est un programme lancé au démarrage d «EXI». Il teste la présence des répertoires indispensables au bon fonctionnement de GENEDI. Il vérifie également l accès en lecture à certaines tables de la BDD (Base de Données). Si vous disposez d une base mysql qui doit être répliquée, il vérifie également que la base secours est bien répliquée. L onglet «Message(s)» affiche les tests effectués depuis le lancement du programme. L onglet «Problème(s) bloquant(s)» affiche tous les tests effectués et qui sont en erreur. L onglet «Intervenant(s) à prévenir» contient les adresses mail vers lesquelles doivent être remontées les anomalies affichées dans problèmes bloquants. Le bouton : Cliquer sur le bouton réduire fait disparaître la fenêtre. Pour la réactiver, il faut double-cliquer sur l icône située à côté de l horloge. Le bouton : arrête le contrôleur uniquement sur le poste en cours, qu il soit maître ou esclave. Impression du 13/09/2006 page 7

8 1.1.3 Le navigateur Le navigateur permet de visualiser l application et de gérer les demandes de l utilisateur. Cette visualisation est permise de n importe quel endroit de votre réseau ou par accès extérieur pourvu que le serveur maître soit accessible. Penser à mettre cette adresse URL dans les exclusions de demande d authentification de votre proxy. La présentation HTML pour l exploitation de GENEDI est permise grâce au serveur d application TOMCAT (freeware) et au serveur de page HTML APACHE. L utilisateur utilise ce module pour lancer les tâches ou suivre les traductions effectuées. D autres fonctionnalités sont disponibles et nous allons les découvrir dans les pages suivantes. Genedi 3000 nécessite des navigateurs avec des fonctionnalités avancées. Internet Explorer (version 5.5 ou supérieur) et Firefox (version ou supérieur) sont tous les deux utilisables. Impression du 13/09/2006 page 8

9 1.2 L accès à la partie exploitation La partie exploitation nécessite le démarrage des applications vues en 1. Lors du démarrage du navigateur, l accès se fait en entrant l URL sur une fenêtre Internet explorer : IP du poste /portail.html. Ces deux informations sont communiquées lors de l installation. Adresse IP Raccourci en liens favoris Code utilisateur Mot de passe Un raccourci peut aussi être créé dans les liens du navigateur. Un code utilisateur avec mot de passe est nécessaire pour se connecter à l application. Ces codes sont au nombre de cinq à l installation. Les codes d accès supplémentaires sont créés à la demande par AGENA Les fonctionnalités décrites dans ce guide peuvent être restreintes en fonction des utilisateurs. Impression du 13/09/2006 page 9

10 . 1.3 Présentation générale des écrans et navigation Elle s appuie sur FWT (Framework technique AGENA 3000 qui est indépendant de la plateforme) et sur TOMCAT. options Bureau Version EXI Dossier Impression du 13/09/2006 page 10 1

11 L écran de gestion est composé de 4 parties que l on appelle plus généralement frame. - 1 frame bureau le bureau situé en haut de l écran. Cette partie de l écran est composée d onglets permettant de gérer les bureaux et les dossiers de l utilisateur. Il permet aussi de revenir sur l écran de d accès et d avoir des informations sur l écran en cours. Dossier description des tâches Cliquez ici pour retourner sur le portail GENEDI Cliquez ici pour changer votre mot de passe Lorsqu un utilisateur se connecte sur la partie web et qu au moins un message est en erreur dans le tableau de bord, alors une alerte apparaît dans le bandeau sous la forme d un bouton clignotant accompagné d un message sonore. - 1 frame accueil pour l écran d accueil situé sous le bureau Impression du 13/09/2006 page 11 1

12 1 frame filtre pour l écran filtre situé au même emplacement que l écran d accueil 1 frame détail pour l écran situé au même emplacement que l écran d accueil Frame filtre Frame détail Impression du 13/09/2006 page 12 1

13 NOTE : Il existe désormais un bouton qui permet de trier les colonnes du filtre par ordre croissant ou décroissant : Bouton de tri Cette option est applicable sur tout les écrans comportant des colonnes, y compris dans le suivi, au niveau du tableau de bord. Impression du 13/09/2006 page 13 1

14 Le frame filtre affiche tous les enregistrements de la table gérée. Des critères sont proposés sur l écran pour préciser la sélection. A chaque critère, peut être associé un opérateur de filtre, en l occurrence : = (par défaut), >, <, >=, <=,. Le % (like) sert pour un paramètre dont on ne connaît pas exactement la valeur. La casse (caractère majuscule/caractère minuscule) au niveau des caractères est importante pour la requête. Pour certains critères, une aide de saisie est proposée par l intermédiaire d une liste déroulante ou d un champ de recherche (présence d une loupe à côté du champ de saisie). Le champ recherche peut être activé en cliquant sur la loupe ou en utilisant la touche de raccourci F4. En cliquant sur le bouton OK, la sélection s affiche. Si tous les enregistrements ne tiennent pas sur la page, une flèche suivant s affiche pour l affichage des enregistrements suivants. Inversement, une flèche précédent s affiche pour revenir aux enregistrements antérieurs. Pour sélectionner un enregistrement, il suffit de cliquer sur la flèche en face de l enregistrement choisi. Saisie du critère Opérateur de filtre Champ de recherche Affichage du calendrier Liste déroulante Affichage de la sélection = < > >= <= Opérateur de filtre Cliquez sur la flèche pour sélectionner l enregistrement Possibilité d exporter les enregistrements sous forme de grille, fiche etc. Impression du 13/09/2006 page 14 1

15 Le frame détail permet soit de gérer un enregistrement précis (mise à jour, insertion, suppression, duplication) et/ou de visualiser en détail cet enregistrement. D autres actions (recyclage, validation) peuvent être présentées en fonction de l écran choisi. De même, une aide peut être proposée pour la saisie (liste déroulante ou champ recherche). Des liens spécifiques à l écran peuvent être disponibles pour aller vers un autre écran ou un autre lien internet. Lien vers un autre écran = validation = suppression = Création = Duplication = Information sur l écran en cours Impression du 13/09/2006 page 15 1

16 1.4 Cinématique des écrans 1) Lors de l appel à GEN, ouverture de l écran d accès initial 2) Lors de la connexion, ouverture de l écran de gestion avec frame filtre et frame détail cachées 3) Lors d un click dans le bureau, frame filtre et frame détail cachées 4) Lors d un click dans un dossier, affichage des options. Frame accueil et détail cachés (possibilité de visualiser frame détail avec souris ou bouton F2) 5) Lorsque sélection d un enregistrement dans le frame filtre (clic sur une flèche ), frame accueil et frame filtre cachée (possibilité de visualiser frame filtre avec la souris ou bouton F2) 6) Lorsque frame accueil caché, possibilité de visualiser frame filtre et/ou frame détail avec bouton F2 ou souris La suite du document présente en détail les différents écrans de la partie exploitation. Chaque écran est rattaché à une option, elle-même rattachée à un dossier qui lui-même est rattaché à un bureau. Les droits aux dossiers et bureaux peuvent être gérés en fonction de l utilisateur. 1.5 Les raccourcis clavier 1.6 Export de données A partir du portail, il est possible d exporter des enregistrements. En effet sur la plupart des écrans, il existe une icône. Par exemple, allez dans l option «mapping» du dossier «Administration» et cliquez sur l icône. Une fenêtre s ouvre. Choisissez un format d export. Dans les cases à gauche de chaque champ que vous désirez, il faut inscrire un numéro qui sera le numéro d ordre. Par exemple : Impression du 13/09/2006 page 16 1

17 Il est à noter que pour le format CSV, vous pourriez ne pas avoir chaque champs dans une colonne à l affichage. En effet, le caractère de séparation est le «;». Le logiciel, typiquement Excel, affichant le contenu peut utilisé sa valeur par défaut (la virgule). Il vous faudra alors copier le contenu dans un nouveau fichier et l ouvrir en précisant que le séparateur est le point-virgule. Par ailleurs, le format exporté ne peut pas être utilisé pour un import dans Genedi. Impression du 13/09/2006 page 17 1

18 2 La configuration Le dossier configuration permet de configurer l application au niveau de la remontée des alertes, de la conservation des données, des codes et libellés du journal ainsi que des agents. Impression du 13/09/2006 page 18 1

19 2.1 Option remontée des alertes Remontée des alertes : Cochée si la remontée des alertes fonctionnelles (traduction, connexion ) doit être effective pour l utilisateur. Seuil de remontée des alertes : Seuil pouvant aller de 0 à 90, (90 étant une alerte grave). Une alerte a un numéro de niveau (Cf. journal : Code et libellé). Si le niveau est au moins égal au seuil, l alerte est remontée vers l utilisateur. Messagerie utilisée : Adresse de messagerie : Environnement : Messagerie utilisée pour la remontée des alertes fonctionnelles et évènementielles (le paramétrage de cette messagerie se fait au niveau de l option «Administration/File d attente» ). Cf File d attente Adresse de la personne recevant les alertes. Pour envoyer un SMS il suffit de mettre l adresse mail du portable (voir sur le site de votre opérateur pour l obtention de cette adresse). Environnement auquel est rattaché l utilisateur. Voir la documentation sur les Environnements. Valeur SP par défaut. Impression du 13/09/2006 page 19

20 2.2 Option conservation des données Cette option permet de définir le délai d historisation des données, qui lui-même peut être fonction de l agent, du partenaire origine ou du partenaire cible. 6 tables sont concernées : La table Chronoallegro pour les données des chronos allegro. La table Journal pour les données du journal interne de GENEDI. La table Journal de communication pour les données des journaux de communications des différents Réseaux à Valeurs Ajoutés (RVA). La table Archive pour l archivage des fichiers origines et de traduction (qu il soit intermédiaire ou final). La table évènements (pour le journal des évènements) La table statistiques Cette page vous permet donc de manipuler les données suivantes : La table concernée L agent (si la table archive est sélectionnée) Le partenaire origine et le partenaire cible (si la table archive est sélectionnée) Le délai de conservation des données Impression du 13/09/2006 page 20

21 2.3 Option journal : code et libellé Cet écran permet de visualiser la liste des erreurs, consignées par la suite au niveau du journal dans la rubrique «SUIVI». Peuvent être modifiés, le libellé du message, l action de l archiver ou non. De plus, vous pouvez également définir le degré de gravité pour la remontée des s Impression du 13/09/2006 page 21

22 2.4 Option agents Cet écran vous permet de sélectionner un agent pour définir un paramétrage spécifique. Pour certains agents, il est possible de lancer des programmes avant et/ou après le traitement. Impression du 13/09/2006 page 22

23 3 L administration Le bureau administration permet de configurer les accords partenaires. Un accord partenaire est un accord qui permet de dire que tel partenaire travaille en tel type de langage sur tel Réseau à Valeur Ajoutée (RVA). Ce bureau contient donc dans l ordre la définition des partenaires, la définition des files d attentes (terme plus générique que RVA), la définition des messages et des mappings ainsi que la liaison ou routage entre les documents, partenaires et files d attentes. Impression du 13/09/2006 page 23

24 3.1 L option partenaire Cette option permet de gérer les partenaires. Est considéré comme partenaire dans GENEDI et donc à paramétrer en tant que tel, tout intervenant de la chaîne EDI, que ce soit l émetteur du message, le destinataire du message ou l application cible. Chaque partenaire est soit rattaché à un profil soit à un partenaire. La norme de codage d un partenaire est donc le suivant : profil ou profil.partenaire. Identification : 1 er cas : partenaire générique : Saisir le code partenaire (profil) qui doit être alphanumérique et définir le code de rattachement (racine des codes partenaires définie de manière identique). Toutefois, si un partenaire est identifié dans un message et qu il n existe pas de définition pour lui, (code EAN = ou code rattachement = ) alors un partenaire «monpartenaire » sera créé par défaut (auto remplissage). Pour chaque partenaire (interne à votre société), il est possible de précisé un code environnement. Impression du 13/09/2006 page 24

25 2ème cas : partenaire non générique : Renseigner : la zone code partenaire qui se compose comme ceci : - code partenaire générique (profil )suivi d un point et enfin, identification du partenaire monpartenaire code partenaire générique identification du partenaire ainsi que la zone code EAN (s il s agit d un partenaire identifiable par un EAN 13) pour que l auto remplissage puisse fonctionner (Voir définition partenaire générique) Impression du 13/09/2006 page 25

26 3ème cas : partenaire désignant une cible : Documentation utilisateur Seul le code partenaire et le nom sont à compléter. Ces partenaires sont utilisés pour envoyer le résultat de la traduction. Dans les trois cas, si vous cliquez sur le lien Files d attentes associées, on obtient les couples files d attentes/normes associées à ce partenaire et éventuellement on peut modifier l adresse réseau de ce partenaire sur la file d attente ou l identification de ce partenaire dans le message normé. Dans les 3 cas, en cliquant sur le lien Files d attente associées, on obtient les couples files d attentes/normes associées à ce partenaire et éventuellement on peut modifier l adresse réseau de ce partenaire sur la file d attente ou l identification de ce partenaire dans le message normé. Impression du 13/09/2006 page 26

27 3.2 L option files d attentes Cette option permet de gérer les files d attentes. Est considéré comme file d attente dans GENEDI tout lieu de transit de la chaîne EDI que ce soit en réception ou en émission. A chaque file d attente est rattaché un agent avec des paramètres spécifiques à chaque agent. A ce stade, il est nécessaire de définir toutes les files d attente que l on peut avoir. Sous ce terme, on retrouve : - file d attente allegro utilisée avec un agent de messagerie allegro - file d attente x400 (carrefour, atlas400) utilisée avec un agent de messagerie uafi - file d attente répertoire utilisée avec un agent volume - file d attente messagerie électronique (type Outlook) utilisée avec un agent de messagerie internet - file d attente AS2 utilisée avec un agent de messagerie sintegrator (nécessite Module complémentaire + Licence) - file d attente pour gestion commerciale (par exemple «agent.genacod») - file d attente agent.connectsql permettant de se connecter à une base de données. Il existe d autres files d attente qui sont elles utilisées spécifiquement pour la remontée des alertes : Ex : file d attente pour la remontée des anomalies via Pour chaque file d attente, voici les différents écrans de gestion. Impression du 13/09/2006 page 27

28 3.2.1 Généralités Avant de voir chaque file d attente et leur paramétrage associé, il faut noter la présence de 2 liens pour chaque file d attente : «Files d attentes Partenaires» et «File d attentes Sociétés». Le lien Files d attentes Sociétés» est utile pour la gestion des environnements (Voir documentation séparée). L écran obtenu en sélectionnant «files d attentes Partenaires» permet de visualiser les partenaires utilisant celle-ci. Il suffit de cliquer sur le lien Partenaires associés comme présenté sur l écran ci-dessous : Cette page vous permet de consulter les couples partenaire/normes associées à cette file d attente et éventuellement de modifier l adresse réseau de ce partenaire sur la file d attente ou l identification de ce partenaire dans le message normé. Impression du 13/09/2006 page 28

29 3.2.2 Backup(s) Dans un contexte multipostes, certaines files d attentes peuvent avoir un backup. Ces files d attentes se nomment de la même façon que les files d attentes réelles mais se terminent par «SAV». L adresse de la ressource n est de ce fait pas renseignée. Attention : Avoir une file d attente se terminant par «SAV» n est pas suffisant pour avoir un backup. Impression du 13/09/2006 page 29

30 3.2.3 File d attente allegro Pour utiliser la file d attente allegro, un agent de messagerie allegro doit être utilisé. Voici l écran pour paramétrer cet agent de messagerie. On retrouve les paramètres suivants : - Sens : émission, réception ou émission/réception - Adresse IP de la ressource : adresse IP du poste sur lequel l agent de messagerie Allegro s exécutera (Note : Allegro doit être installé sur le poste). - Programme à lancer avant et après : programme spécifique à lancer avant ou après la connexion (l usage de «/env» dans le nom du programme à lancer après exécutera le code programme pour chaque lettre reçue (libre ou non) et remplacera «/env» par le nom de l enveloppe GENEDI3000). - Disque et répertoire d installation: disque et répertoire d installation du logiciel allegro - Répertoire des lots en arrivée: endroit où l on retrouve les lots reçus (lieu où allegro dépose les fichiers qu il récupère et où EXI va aller les récupérer). - Répertoire des lots au départ: endroit où l on retrouve les lots à envoyer - Répertoire des lots au rebut : endroit où l on retrouve les lots tombés au rebut - Répertoire des fichiers libres en arrivée: endroit des fichiers libres reçus - Répertoire des fichiers libres en départ : endroit des fichiers libres à envoyer - Répertoire des fichiers libres en rebut : endroit des fichiers libres tombés au rebut - Répertoire des fiches libres en arrivée : endroit des fiches libres reçus - Répertoire des fiches libres en départ : endroit des fiches libres à envoyer - Chrono départ : chemin d accès des chronos départ - Chrono arrivée : chemin d accès des chronos arrivée Impression du 13/09/2006 page 30

31 - Journal : chemin d accès au journal. Le contenu de ce fichier est vidé et enregistré dans le «journal de communication» de GENEDI (interrogeable dans le suivi). - Timeout : Temps d attente pour déclencher la connexion au RVA lors d émission. - Nombre de connexions avant remontée des alertes : Nombre d essais que l agent allegro doit effectuer sans réussite de connection au serveur avant qu une alerte fonctionnelle ne soit émise. Impression du 13/09/2006 page 31

32 3.2.4 File d attente type X400 (agent.messagerie.uafi) Pour utiliser la file d attente type X400 (exemple Réseau CARREFOUR et ATLAS), un agent de messagerie UAFI doit être utilisé. On devra créer une file d attente par boite à lettre utilisée. Avec cet agent, les fichiers libres ne peuvent être utilisé qu en émission. Voici l écran pour paramétrer cet agent de messagerie. On retrouve les paramètres suivants : - Sens : émission, réception ou émission/réception - Adresse IP de la ressource : adresse IP du poste sur lequel l agent de messagerie Uafi s exécutera (Note : Uafi doit être installé sur le poste). - Programme à lancer avant et après : programme spécifique à lancer avant ou après la connexion (l usage de «/env» dans le nom du programme à lancer après exécutera le code programme pour chaque lettre reçue (libre ou non) et remplacera «/env» par le nom de l enveloppe GENEDI3000). - Identifiant: Login lors du démarrage de Mailmax - Mot de passe : Mot de passe lors du démarrage de mailmax - Disque et répertoire d installation : disque et répertoire d installation du logiciel uafi - Exécutable à lancer : exécutable à lancer suivant la configuration (TCP/IP ou modem) - Répertoire de la configuration mailmax : endroit où l on retrouve le paramétrage de la configuration mailmax pour la BAL à atteindre - Répertoire des lots en arrivée : endroit où l on retrouve les lots reçus - Répertoire des lots au départ : endroit où l on retrouve les lots à envoyer - Journal : chemin d accès au journal ( que l on intègre dans la base de donnée et que l on vide (fichier)). - Sauvegarde : Lieu où sont sauvegardées les enveloppes et les lettres reçus via le RVA. Attention, ce dossier n est pas purgé par Genedi Impression du 13/09/2006 page 32

33 3.2.5 File d attente type X400 (pour fichier libre en réception) Pour utiliser la file d attente type X400 (exemple ATLAS, Carrefour), un agent de messagerie Atlas doit être utilisé. On devra créer une file d attente par boite à lettre utilisée. Cet agent a les mêmes fonctionnalités que l agent «agent.messagerie.uafi»), sauf qu il utilise les enveloppes pour détecter les paramètres de routage (Emetteur, destinataire et sujet) Voici l écran pour paramétrer cet agent de messagerie. On retrouve les paramètres suivants : - Sens : émission, réception ou émission/réception - Adresse IP de la ressource : adresse IP du poste sur lequel l agent de messagerie Atlas s exécutera (Note : Uafi doit être installé sur le poste). - Programme à lancer avant et après : programme spécifique à lancer avant ou après la connexion (l usage de «/env» dans le nom du programme à lancer après exécutera le code programme pour chaque lettre reçue (libre ou non) et remplacera «/env» par le nom de l enveloppe GENEDI3000). - Identifiant: Login lors du démarrage de Mailmax - Mot de passe : Mot de passe lors du démarrage de mailmax - Disque et répertoire d installation : disque et répertoire d installation du logiciel uafi - Exécutable à lancer : exécutable à lancer suivant la configuration (TCP/IP ou modem) - Répertoire de la configuration mailmax : endroit où l on retrouve le paramétrage de la configuration mailmax pour la BAL à atteindre - Répertoire des lots en arrivée : endroit où l on retrouve les lots reçus - Répertoire des lots au départ : endroit où l on retrouve les lots à envoyer - Journal : chemin d accès au journal ( que l on intègre dans la base de donnée et que l on vide (fichier)). - Sauvegarde : Lieux où sont sauvegardées les enveloppes et les lettres reçus via le RVA. Attention, ce dossier n est pas purgé par Genedi Impression du 13/09/2006 page 33

34 3.2.6 File d attente répertoire (agent.volume) Pour utiliser la file d attente type répertoire, un agent volume doit être utilisé. Ce fichier sert à prendre (ou déposer) des fichiers dans un répertoire avec un filtre. On peut exécuter un programme à lancer avant (ou après), on peut, par exemple, prendre ou récupérer des fichiers sur un serveur FTP. Voici l écran pour paramétrer cet agent. On retrouve les paramètres suivants : Sens : Si émission ou réception - Adresse de la ressource : correspond à l endroit où se trouvent les fichiers avec leur nom générique. Les? remplacent les chiffres de 0 à 9 (NB : maximum huit «?»). On déconseille d en utiliser plus de trois. - Programme à lancer avant et après : programmes spécifiques à lancer avant ou après la connexion. Si réception : - On exécute le programme à lancer avant, - On récupère l ensemble des fichiers - S il y a «/env» dans le nom du programme à lancer après, on exécute le programme pour chaque fichier récupéré et le paramètre «/env» est remplacé par le nom du fichier en question. Remarques : - Lorsque le sens est marqué réception, on traite les fichiers correspondants au masque de fichier dans le sens répertoire vers traduction. (ex : facture à traduire et à émettre, avis d expédition à traduire et à émettre) - Lorsque le sens est marqué émission, on vient juste le déposer dans le répertoire indiqué sous le nom calculé - Il est à noter qu en émission, le compteur pour remplacer les «?» est unique pour tous les agents de type «agent.volume». Impression du 13/09/2006 page 34

35 3.2.7 File d attente messagerie électronique Pour utiliser la file d attente messagerie électronique, un agent de messagerie Internet doit être utilisé. Voici l écran pour paramétrer cet agent de messagerie. En réception, on ne traitera que les mails comportant une et une seule pièce jointe nommée avec une extension. L'émetteur de ces messages doit effectuer un envoi "standard" en "MIME Encodé 64" pour que la pièce jointe soit reconnue. On retrouve les paramètres suivants : Sens (obligatoire) : émission, réception ou Emission/Réception Adresse IP de la ressource (obligatoire) : adresse IP du poste sur lequel l agent de messagerie s exécutera. Programme à lancer avant ou après. EMISSION : Adresse du serveur smtp (Obligatoire) Emetteur si envoi par smtp (obligatoire): adresse . Objet du mail : Texte qui sera l objet du mail envoyés Corps du mail : Texte du mail accompagnant le fichier émis. Nom du fichier à envoyer : Nom de la pièce jointe. Doit être vide ou fixe (pas d utilisation de joker tel que le?) Il est à noter que les adresses des destinataires sont à paramétrer dans le routage cible.( Adresse pour la file d'attente) RECEPTION : Impression du 13/09/2006 page 35

36 Adresse du serveur pop3 (obligatoire): Adresse IP du serveur pop3 (ou nom du serveur). Si EXCHANGE, indiquer l adresse du serveur EXCHANGE. Le port utilisé pour le protocole POP3 doit être le 110 L identifiant et le mot de passe sont obligatoires. Extensions acceptées : au moins une extension obligatoire. Séparer avec des ; Extensions à ne pas traiter : facultatif. Impression du 13/09/2006 page 36

37 3.2.8 File d attente (Remontée d alertes via mail) L agent permet de définir le paramétrage pour pouvoir envoyer les alertes fonctionnelle et évènement. Voici l écran pour paramétrer cet agent de messagerie . Le paramétrage permet de spécifier le titre de l pour les alertes fonctionnelles, ainsi que la configuration de l adresse expéditeur du mail, qui dépend du type de messagerie. MS EXCHANGE 4 : Sur le poste EDI, Outlook doit être paramétré avec le profil désiré. File d attente Adresse de la ressource Rien Identifiant Profil (a) Mot de passe Rien Note : (Fichier INI pour alertes d exploitation : remplir MAI_EXP avec le profil, ne pas renseigner MAI_SMT) (a) : Si le profil est faux et que l application veut envoyer un message, une fenêtre vous en proposera un et vous devrez appuyer sur «entrée». C est ce profil qu il faut mettre dans Identifiant. Impression du 13/09/2006 page 37

38 MICROSOFT OUTLOOK : Sur le poste EDI, Outlook doit être paramétré avec le profil désiré. File d attente Adresse de la ressource Rien Identifiant Rien Mot de passe Rien (Fichier INI : Ne pas renseigner MAI_SMT ni MAI_EXP) Note :pour certaines versions, aller dans le menu Outils/options, choisir l onglet Sécurité. La case «M avertir lorsque d autres applications..» doit être décochée, sinon l application demande confirmation avant l envoi des mails. SERVEUR SMTP (Ex : Lotus Notes) : Adresse de la ressource Identifiant Mot de passe Adresse du serveur SMTP Profil Mot de passe (Fichier INI pour alertes d exploitation : remplir MAI_SMT avec le serveur et remplir MAI_EXP avec le profil) Impression du 13/09/2006 page 38

39 3.3 Option Dictionnaire de documents Cette option permet de visualiser les documents paramétrés dans le système. Un document est un agencement de données d un dictionnaire qu il soit normatif ou privatif. La définition des documents et dictionnaires se fait par l intermédiaire de l outil IHM 1 (soit le mappeur). Cette page ne sert donc qu à la consultation. Rien ne peut être modifié. Ces informations sont importantes. En effet, si on reçoit un fichier reconnu comme Edifact et que dans le segment UNH de ce fichier figurent les informations : ORDERS, D, 93A, UN et EAN007 bien placées, alors un des mappings sélectionnables pourra avoir en document origine : Edifact.93a.orders. Le mapping devra toutefois avoir été paramétré pour le couple partenaire émetteur/destinataire. 1 IHM : Interface Homme Machine Impression du 13/09/2006 page 39

40 3.4 Option Mapping Cette option permet de visualiser les mappings paramétrés dans le système. Un mapping est une liaison entre deux documents. La définition des mappings se fait par l intermédiaire de l outil IHM. Cette page permet de visualiser l ensemble des mappings et aussi d affecter à ces derniers les codes partenaires expéditeur, destinataire et cible. Le code destinataire correspond à celui du partenaire dans le message. Le code cible correspond à celui du traitement du message. Exemple, pour un message envoyé par x et à destination de y, le code cible sera celui de la gestion commerciale de y. Par ce moyen, pour un même message, plusieurs mappings pourront être définis en fonction de la cible. L écran permet donc de gérer les codes partenaires expéditeur, destinataire et cible pour un mapping donné. Ce code partenaire doit exister dans l écran de gestion des partenaires. Il suffit de cliquer sur la loupe ou de se positionner dans la zone à modifier et de cliquer sur F4. Les liens routages sont expliqués au paragraphe «Routage», ainsi que l explication des différents partenaires utilisés. Notons au passage deux fonctionnalités intéressantes de Genedi 3000: Désactivation de mappings : Un mapping inactif agira de la même manière que si le mapping n existait pas. Dans une phase de test, vous pouvez être amené à désactiver un mapping en production pour traduire avec un nouveau mapping. Cela évite d avoir à supprimer et recréer chaque mapping. Double routage : Impression du 13/09/2006 page 40

41 Si on paramètre un mapping ainsi (Exemple simplifié): Identification Code partenaire expéditeur code partenaire destinataire 13 CARREFOUR MaSociété 13 CARREFOUR MaSociété Alors le mapping 13 sera appliqué 2 fois. C est bien un double routage. Une alerte pourra être générée si un double routage est détecté. Cela vous permettra de corriger l anomalie si vous n avez aucun doublon en cours. Vous pouvez paramétrer cette information dans l écran «Journal : Code et libellé» avec le code erreur «R01001» Ce concept peut être utilisé dans le cadre d une migration de gestion commercial : En utilisant 2 mappings différents, on mettra un fichier à disposition de la gestion commerciale actuelle, et un vers la future gestion commerciale. D autres usages sont possibles : 2 applications internes ont besoin d intégrer un même message, migration de norme pour des messages que vous envoyez vers un partenaire. Impression du 13/09/2006 page 41

42 3.5 Option routage Cette option permet de gérer les données de routage des partenaires pour un mapping. C est ici que l on paramètre les files d attentes pour les codes partenaires expéditeur, destinataire, cible en fonction du document origine et document final. Ce dossier correspond donc aux accords d interchange : pour tel message en entrée venant de x, à destination de y et pour la cible z, on paramètre les files d attente pour x, y et z. Les 2 iers liens sont identiques. Toutefois, les enregistrements seront filtrés selon le code partenaire expéditeur ou destinataire. Ils affichent une grille qui varie selon la norme du document. Les enregistrements affichés sont les identifications dans la file d attente de réception du nom du partenaire que Genedi utilisera, et éventuellement du nom message origine (selon norme et agent de la file d attente), et ce en fonction de la norme du document ainsi que de paramètres liés à la file d attente. Le 3 ème lien propose une fiche avec quatre groupes : Partenaire Norme File d attente Spécifique Le routage du partenaire cible permettra d envoyer les fichiers après traduction vers une file d attente avec des paramètres de norme et de file d attente (selon l agent paramétré). Les champs contenus dans «Spécifique» peuvent varier selon la norme. On peut distinguer 4 cas utilisé le plus fréquemment: - Fichier en entrée normé (gencod ou edifact, ) Fichier en sortie non normé - Fichier en entrée non normé (ascii, xml ) Fichier en sortie normé - Fichier en entrée normé - Fichier en sortie normé - Fichier en entrée non normé - Fichier en sortie non normé Impression du 13/09/2006 page 42

43 3.5.1 Fichier en entrée normé (gencod ou edifact) Fichier en sortie (ascii) En cliquant sur routage face à la zone «code partenaire expéditeur» ou «code partenaire destinataire», on obtient : Un filtre composé des paramètres code partenaire et file d attente permet d effectuer une sélection plus précise. En cliquant sur le bouton valider, l enregistrement peut soit être ajouté, modifié ou supprimé. Le code partenaire, la file d attente et le code qui permet d identifier dans le message le partenaire sont obligatoires. Eventuellement, l adresse pour la file d attente peut être clarifiée. Auto remplissage : Entrer l ensemble des partenaires pour chaque Norme/File d Attente peut s avérer fastidieux. Aussi, EXI permet l auto remplissage (activé par défaut) qui évite de définir, selon les files d attentes, quel partenaire envoie quel acte depuis quelle file d attente. Fonctionnement : Si l agent en charge de retrouver le partenaire permet l auto remplissage (exemple : agent.genacod, agent.acheminement si message normé) voici ce qui se passe : Rechercher si le code émetteur est défini dans les routages. SINON : Recherche du partenaire qui dans sa fiche (cf 3.1), à pour code EAN, ce même code émetteur. Si on ne le trouve pas, il faut le créer. Ce partenaire aura pour code générique, le partenaire correspondant au champ «rattachement avec code» le plus proche. Génération d une alerte non bloquante et à titre informatif : Ex : Partenaire identifié dans le message par : > > > > ajouté pour travailler en edifact avec la file d'attente allegro Routage cible : Impression du 13/09/2006 page 43

44 En cliquant sur routage face à la zone «code partenaire cible», on obtient l écran ci-dessous (pour ascii) : En règle générale, à ce niveau, seule la file d attente sera renseignée. On détaillera dans le paragraphe les informations du routage cible. Impression du 13/09/2006 page 44

45 3.5.2 Fichier en entré (ascii) Fichier en sortie normé (gencod ou edifact) En sélectionnant ce type de routage, on obtient : En cliquant sur routage face à la zone «code partenaire expéditeur», la fenêtre suivante apparaît : Cet écran est similaire à celui vu en Le champ «description routage» est utile pour les files d attentes n acceptant pas plusieurs messages dans un même fichier. Impression du 13/09/2006 page 45

46 Le champ «Sujet» peut être utilisé pour distinguer deux «code partenaire» différents, mais tel que le code «identifié dans le message par» est identique. Il ne peut être utilisé qu avec les files d attente de type «agent.messagerie.internet» ou «agent.messagerie.atlas», et uniquement pour un «code partenaire expéditeur» Le champ «Nom du fichier» peut être utilisé de la même manière que le champ sujet, mais uniquement pour des files d attente de type «agent.messagerie.internet». Pour cet agent on peut combiner ou non avec le champ sujet. Si la norme du document cible est «Edifact», en cliquant sur routage face à la zone «code partenaire cible», on obtient : Les informations sont détaillés au paragraphe suivant Routage cible Le code partenaire est le code du partenaire cible. La norme est la norme du document final. A ce niveau, sont gérées les données suivantes : La file d attente associée : C est la file d attente, dont le sens est «Emission» ou «Emission - Réception» où le message cible doit être envoyé ou déposé. Pour certains types de file d attente (Sintegrator : module supplémentaire + Licence ; dans certains cas : agent.messagerie.internet), une adresse de messagerie de secours peut être définie. Eventuellement, l adresse pour la file d attente o SI UAFI : On sépare les éléments de l adresse par des ; ex : C=FR ;A=ATLAS Impression du 13/09/2006 page 46

47 o SI INTERNET : On renseigne l adresse destinataire (s il existe plusieurs destinataires, essayer de les séparer avec des ;). Il est à noter que si vous utilisez un nom de pièce jointe, il faut le renseigner dans la file d attente. o SI ALLEGRO et Fichier Libre : Si on veut envoyer un fichier libre sous allegro, on mettra : emetteur=(emetteur):14;destinataire=(destinataire):14; A la place de (emetteur) et/ou de (destinataire), on peut directement mettre le code EAN. Pour les fichiers en norme gencod et edifact, il ne faut rien renseigner Toutes les données affichées dans «spécifique» dépendent de la «norme». La donnée «sujet» ne peut être utilisée que selon la file d attente cible : agent.messagerie.uafi ou agent.messagerie.internet La donnée «association» permet de regrouper en un seul fichier plusieurs messages. Il ne peut être utilisé que pour certaines normes et que pour certains agents. La donnée «Priorité UAFI» sera utilisée pour les envois vers une file d attente : Agent.messagerie.uafi. Par défaut, Genedi les envois avec le mode URGENT. Dans certains cas, il vaut mieux utiliser d autre mode d envoi, cela change le mode des relances si on arrive pas à déposer sur le serveur distant (Relance plus espacé, mais refaitent plus souvent). Les autres données «Spécifique» dépendent de la norme. En gencod : «compteur 190» : Ne pas modifier. En tradacom : «stx». Segment STX : utilisation possible de valeurs paramétrables détaillées pour Edifact (comme l UNB) En edifact o Unwrapper : Il est possible d envoyer un document Edifact en ajoutant un retour chariot entre chaque segment. Il faut alors cocher la case. o On renseignera l UNB et éventuellement l UNA Des paramètres tels que la date, l heure et le compteur peuvent être utilisés dans l UNB. Les différentes valeurs paramétrables sont (Attention : respecter la casse): Mot Clé (émetteur) (destinataire) (date) (heure) (cpt:) Remplacé par Le code de l émetteur dans la file d attente d origine Du test Date du jour au format AAMMJJ Heure système au format hhmm Compteur. Après les deux points, mettre le type de compteur Le compteur peut être formaté en utilisant les syntaxes suivantes : C représente un chiffre de 0 à 9 AA pour l année sur 2 caractères SSAA pour l année sur 4 caractères MM pour le mois en cours JJ pour le jour en cours Exemple : (cpt :CCCCCC) Sur l exemple, le compteur serait formaté avec 6 chiffres de 0 à 9, le compteur maxi étant N oublier pas la quote () à la fin. Impression du 13/09/2006 page 47

48 3.6 Priorité document A partir de cet écran, vous pouvez définir pour chaque code document son niveau de priorité. Cette priorité ne pourra s appliquer qu une fois le «code document» du fichier en cours identifié et que pour les taches de traduction (donc, les taches de mise à disposition, ne sont pas concernées). Le niveau de priorité va de 0 à 9. Par défaut, le niveau est à 0. Impression du 13/09/2006 page 48

49 3.7 Priorité file d attente A partir de cet écran, vous pouvez définir pour chaque file d attente son niveau de priorité. N est concernée par les priorités, que la partie réception des files d attente. La priorité «file d attente» ne s applique plus lorsque le message a été identifié. C est uniquement la priorité document qui s applique pour les traductions. Impression du 13/09/2006 page 49

50 4 L exploitation Le dossier Exploitation permet de configurer les plannings ou de lancer en mode manuel une tâche définie. La description des tâches permet la mise à jour de celle-ci. On peut les lancer manuellement grâce à l option «Lancement manuel». L option «fiches d exploitation» permet de gérer le planning automatiquement ou, de le couper temporairement. La liste des fiches d exploitation, permet une autre visualisation du planning. La liste des tâches à venir affiche les tâches qui seront lancées automatiquement jusqu à la fin de la journée. Impression du 13/09/2006 page 50

51 4.1 L option fiche d exploitation Un planning au sens de GENEDI correspond à l affectation d une fiche d exploitation à différentes journées. Une fiche d exploitation est le récapitulatif de la programmation du lancement d une ou plusieurs tâches à différentes heures de la journée. Ce dossier permet à la fois de gérer les fiches d exploitation et de les affecter à une ou plusieurs journées. La fiche d exploitation peut présenter 2 types de fonctionnement : - La planification du lancement d une tâche à heure fixe - La planification du lancement d une tâche de manière cyclique Génération du planning Arrêt du planning NB : La génération et l arrêt du planning concerne toutes les fiches d exploitation. Pour une fiche d exploitation, on peut gérer : - Le libellé de la fiche d exploitation - L heure de début d une tâche dans le cas du lancement de la tâche à heure fixe ou de manière périodique. - L heure de fin d une tâche dans le cas du lancement de la tâche de manière périodique - Le code de la tâche (qui doit être paramétré dans l écran défini en 4.4). On peut récupérer ce code et le libellé de la tâche en cliquant sur F4. - La fréquence si la tâche doit être exécutée de manière périodique La prise en compte du planning est conditionnée par la validation et la génération du planning. Impression du 13/09/2006 page 51

52 4.2 Option lancement manuel Il suffit de cliquer sur le bouton valider pour lancer manuellement la tâche présélectionnée. NB : La tache «analyse» est décrite dans le manuel d exploitation. Impression du 13/09/2006 page 52

53 4.3 Option liste des fiches d exploitation La liste à l écran peut faire l objet d un tri sur : - Le nom de la planification. - Les jours de la semaine. Cette page vous permet d activer ou de désactiver aussi la fiche d exploitation pour le jour choisi. Il est nécessaire de régénérer le planning pour la mise en place de cette modification. Impression du 13/09/2006 page 53

54 4.4 Option description des tâches A ce niveau, seuls sont gérés le libellé et le type de messagerie utilisée. La messagerie utilisée peut être : - La réception de messages venant des files d attentes qui sont en réception ou en réception/émission et mettant en œuvre des outils de RVA (agent.messagerie.allegro, agent.messagerie.uafi, agent.messagerie.internet). Par exemple, on y retrouve la réception de message EDI - Le traitement des fichiers à envoyer et donc des files d attentes en réception ou en réception/émission et mettant en œuvre un agent volume. Ce sont les tâches dédiées à l envoi de factures ou d avis d expéditions. - La purge ou conservation des données. N.B : Il est déconseillé de créer soi-même les tâches. Lorsque l on doit créer une tâche de réception, il est préférable d aller dans «Administration/Routage», puis de sélectionner un mapping pour lequel la file d attente en entrée peut être la file d attente dont on veut créer la tache de réception. On va sur le lien «Routage expéditeur» (ou «Routage destinataire» pour quelques types de file d attente ) et on identifie correctement un partenaire dans cette file d attente. Impression du 13/09/2006 page 54

55 4.5 Tâches à venir On retrouve dans la grille l ensemble des tâches devant être lancées avant minuit. Elles sont triées selon l heure de lancement et on ne tient pas compte des priorités «File d attente». Impression du 13/09/2006 page 55

56 5 Gestion des évènements Les évènements vous permettent de planifier des contrôles qui selon le résultat (événement produit ou non), vous renvoient un mail d information. Afin de mettre en place les évènements, il faut suivre les étapes suivantes : 1) Créer un évènement grâce à l option «Liste des évènements» 2) Rattacher l évènement créé à l étape 1 à une (ou plusieurs) fiches planification existante ou à créer. (option «Planification des évènements»). Recalculer le planning. 3) Vous abonnez à l événement et/ou au non évènement pour la fiche planification (Ce qui vous permet de recevoir un à l heure de fin suivant le résultat du contrôle de l événement). L option a utiliser est toujours «Planification des évènements», mais il faut aller sur le lien «abonnements» de chaque fiche utilisée à l étape 2. Environnements : Les informations portant sur le code environnement, ainsi que les écrans spécifiques que ceux-ci peuvent générer (Exemple : Non modifiable pour certains utilisateurs) sont détaillés dans la documentation spécifique. Impression du 13/09/2006 page 56

57 5.1 Listes des évènements Cet écran permet de créer des évènements. Type d évènement : o Message : Nombre de messages correspondant aux critères. o Fichier : Nombre de fichiers présents dans le répertoire. o Externe : Lance un programme qui génère un fichier résultat ne contenant que la valeur «nombre d occurrences». o Communication : Comptabilise dans le journal le nombre de fois que l agent a été lancé. Pour que cela fonctionne, il faut que dans le «journal %code et libellé», le code M00001 soit archivé. Impression du 13/09/2006 page 57

58 Seuil de non évènement : Il est possible de fixer un seuil de bascule évènement/non évènement. Auparavant (avant la version 3.1), ce seuil était fixé à 0. Par exemple, dans le cas où on a un évènement qui compte le nombre de commandes, on peut mettre le seuil à 10 ce qui signifie que le non évènement sera déclenché si le nombre est inférieur ou égal à 10. Le contenu des onglets communication, message, présence de fichiers, externe est à définir selon le type d environnement. On peut utiliser des codes génériques pour les partenaires On peut paramétrer le courriel que l on va recevoir en fonction de la réalisation ou non de l évènement. Dans les champs «objet» et «sujet», vous pouvez saisir des paramètres qui seront remplacés : (nbr) : nombre de fois que l évènement s est produit. (date) : date à laquelle on prépare le mail. (heure) : heure à laquelle on prépare le mail. Impression du 13/09/2006 page 58

59 5.2 Planification des évènements Documentation utilisateur Un click sur «Abonnement» permet de visualiser ou modifier l abonnement à l évènement ou au mouvement. C est à ce niveau que l on affecte l évènement que l on doit tester. L heure de fin est l heure à laquelle on déclenche le test de l évènement. Il est possible de planifier le contrôle d un évènement de manière récurrente sur une période et non pas de le contrôler seulement à la fin d une période donnée. Ex : à 17:16:00, on lance un agent.evenement pour contrôler que l événement «NbCDEGE» s est réalisé entre 6:00:00 et 17:16:00 (Ligne 5 de l exemple). Grâce à la «fréquence de contrôle», l évènement «NbCDEGE» est contrôlé à 7h, 8h, 9h, 10h et 12h (Ligne 1 de l exemple). Note : pour les évènements de type Message et Communication, c est le nombre depuis l heure de début qui est envoyé à chaque fois. Tout comme le planning, on peut faire une planification journalière et le planning doit être recalculé pour prendre en compte toute modification. NB : si le planning est arrêté, la planification des évènements le sera aussi. Impression du 13/09/2006 page 59

60 L adresse de messagerie ne peut être modifiée qu au niveau de l écran «Remontée des alertes». Impression du 13/09/2006 page 60

61 5.3 Journal des événements Cet écran permet de visualiser le compte rendu des évènements testés. La couleur de la ligne permet d interpréter le résultat : Foncé : aucune occurrence pour l événement en question. Clair : 1 ou plusieurs occurrences de trouvées. Impression du 13/09/2006 page 61

62 6 Le suivi Le tableau de bord correspond au suivi de l exploitation que ce soit pour le suivi des documents à émettre ou à recevoir, ou pour les journaux (de GENEDI et de communication) ou pour les statistiques. Dans fichier reçu : La référence document a la syntaxe suivante : nom_file_d'attente_réception.compteur Une ligne représente un fichier qui contient «n» messages. Ainsi en dépliant le lien hypertexte : lot, vous obtenez la même chose qu'à l'étape suivante ( message traduit (sauf si erreur en cours) Dans message traduit : Une ligne représente un message La référence document a la syntaxe suivante : nom_file_d'attente_réception.compteur.référence_document nom_file_d'attente_réception.compteur est hérité du fichier reçu d'appartenance Dans fichier émis : La référence document a la syntaxe suivante : nom_file_d'attente_émission.compteur Une ligne est pour un fichier qui contient n messages, ainsi en dépliant le lien hypertexte : message traduit, vous obtenez la même chose qu'à l'étape précédente Dans fichier en cours et en erreur : La référence document témoigne de l'étape de traduction (si couleur beige). La référence document témoigne du point d'arrêt du processus à cause de l'erreur (si couleur Marron clair = message recyclé et si couleur marron foncée = message en erreur). NB : Les références documents peuvent être précédées de «R.» (ce sont les messages recyclés) Impression du 13/09/2006 page 62

63 6.1 Option tableau de bord Le filtre permet de faire une sélection sur plusieurs critères : NB : le caractère «%» peut être utilisé et permet de remplacer le ou les caractères initiaux. Référence du document : correspond à la référence du document. N intervient que dans le cas où le document serait à l état message (voir explication page précédente). Code partenaire expéditeur Code partenaire destinataire Date et heure du premier état : Cas fichier reçu : correspond à la date et heure de réception Cas message : correspond à la date et heure du début de la traduction Il s agit d un écran «interrogation multicritères» : Le document peut être à l état fichier reçu (fichier reçu), à l état traduit (message), à l état fichier émis (fichier émis) et en cours de traitement (cette consultation restitue les messages effectivement en cours de traitement et les messages en erreur). Lors de la réception d un ensemble de document (par un agent de messagerie), cet ensemble de document passe à l état fichier reçu puis, il est découpé par message et entre ensuite dans le processus de traduction (état message). Enfin il est émis vers le système cible (état fichier émis). Si une erreur survient, le document est consigné à l état erreur (cf écran du paragraphe 5.1.4). Un même document peut donc se retrouver consigné trois fois (si aucune erreur survient). Il est intéressant de noter que le nombre de ligne à l état fichier émis doit être égal au nombre de lignes à l état message (sauf si association) et supérieur ou égal au nombre de lignes à l état fichier reçu. Impression du 13/09/2006 page 63

64 6.1.1 Cas fichiers reçus A l étape fichier reçu, le plus souvent, on n a pas encore ouvert le fichier. On ne sait donc pas ce qu il contient (ORDERS 96A, AE, FAC, Mixte?) on ne connaît ni l expéditeur ni le destinataire. Sur cet écran, sont proposées les données suivantes : - référence du document - Code partenaire expéditeur et destinataire - Fichier document origine et sa taille - Date et heure du premier état Impression du 13/09/2006 page 64

65 6.1.2 Cas Messages traduits Documentation utilisateur Sur cette page, obtenue après avoir cliqué sur le lien «fichier émis», on vous propose les données suivantes : - Référence du document - Code partenaire expéditeur et destinataire - Fichier document origine et sa taille - Fichier origine en clair - Fichier origine traduit en XML et sa taille - Date et heure du premier état - Code partenaire cible - N du mapping utilisé pour la traduction - Fichier cible traduit en XML et sa taille - Fichier en cible en clair - Fichier cible et sa taille En cliquant sur le lien, on obtient des précisions comme, le code du partenaire expéditeur et destinataire, les fichiers documents origine et cible ainsi que les fichiers XML. Lors du processus de traduction, un document est d abord traduit en XML (passage de l état origine à origine XML). Ensuite, ce document XML est transformé sous un autre format XML correspondant au fichier cible (passage de l état origine XML à cible XML). Enfin, il est retraduit dans le format final voulu (passage de l état cible XML à cible). En plus du fichier XML, un autre fichier intermédiaire peut être créé. On parle alors du fichier en clair. Pour chaque segment du message, le découpage des zones sera visible. Les fichiers intermédiaires (XML et «en clair») peuvent ne pas être archivés car ils ne sont pas indispensables au recyclage mais peuvent toutefois être utiles pour retrouver les erreurs. Plusieurs cibles peuvent être obtenues suivant le paramétrage défini. Par exemple, un fichier cible peut être obtenu pour une gestion commerciale et un autre pour une impression. Impression du 13/09/2006 page 65

66 6.1.3 Cas fichiers émis Sur cette page, sont proposées les données suivantes : - Référence du document - Code partenaire expéditeur et destinataire - Fichier document origine et sa taille - Date et heure du premier état Là encore, en cliquant sur un lien, on obtient des précisions sur le fichier désigné par ce lien. Cela concerne les codes partenaires expéditeur et destinataire, le fichier document origine. De plus, dans le filtre, on peut sélectionner l état de la transmission : - En cours : l application a préparé le fichier et il est en attente de transmission. - Transmis : le fichier a été émis et consulté. - En erreur : il y a eu un problème au cours de l émission du fichier. Impression du 13/09/2006 page 66

67 6.1.4 Cas Fichiers en cours de traitement ou en erreur Les fichiers en cours de traitement sont en beige. Lorsqu un problème survient une ligne surlignée marron foncé indique le fichier en erreur comme l écran ci dessous. Recycler ou traiter l ensemble des messages sélectionnés. Tout sélectionner/ désélectionner pour la page Message à considérer comme traité Message à comme recyclé Une fois le fichier recyclé, il est surligné en marron clair et prendra un préfixe R, quel que soit le résultat du recyclage. Il est possible de recycler un message à partir d un autre tableau de bord que celui-ci (exemple : fichier reçu), dans ce cas, l enregistrement resterait en marron foncé. Une option permettra de conférer à l enregistrement un caractère traité, vérifié et le fera passer en jaune. Impression du 13/09/2006 page 67

68 Le fait qu'un lien passe au marron clair veut dire qu'une action a été entreprise sur le message (la ligne en erreur) par l'utilisateur. Le changement de couleur est immédiat et consécutif à l'action de recyclage. En revanche, le message reprend son cycle de traduction là où il l'avait arrêté (cf lien hypertexte : historique). Ainsi si aucune action corrective n'a été réalisée, le message (la ligne) va réapparaître, après le temps de traitement et d'archivage, avec le préfixe R. et toujours surligné en marron foncé. En revanche si l'action corrective adéquate a été entreprise, la ligne apparaîtra dans l'onglet du tableau de bord qui correspond à l'état où l'erreur est survenue (fichier reçu, message traduit ou fichier émis) avec le préfixe R. Les lignes traitées ou recyclées resteront visibles selon le délai de conservation des données. Cependant, quel que soit l état de la ligne, l écran proposé permet d avoir un historique complet en cliquant sur le lien historique du traitement comme le montre l écran ci-dessous : Il est possible de recycler, ou de considérer comme traité, un ensemble de message. Pour cela, il faut cocher l ensemble des documents, puis cliquer sur le bouton de traitement désiré. Les deux boutons permettent de sélectionner/désélectionner l ensemble des messages de la page. Attention : Les flèches mémorisent les coches faîtes dans les pages précédentes. Pensez à tout désélectionner si vous soumettez à chaque page. Impression du 13/09/2006 page 68

69 6.2 Option journal A noter que les enregistrements sont affichés par ordre chronologique décroissant. On retrouve ici toutes les actions (à l exception de : purge, agent.genacod, envoyer) entreprises au sein de l application GENEDI et que l on consigne (cf : configuration journal et libellé). Dans la colonne message, on peut avoir un lien qui si on clique dessus, permet d avoir le libellé complet de l erreur ou du commentaire. Impression du 13/09/2006 page 69

70 6.3 Option journal de communication On retrouve ici l ensemble des consignations créées par les files d attentes possédant un journal exploitation (recopié par GENEDI). Chaque session de communication se distingue par un changement de couleur. Cette page affiche de plus les sessions de communication par ordre chronologique décroissant. Sur cet exemple, deux types de connexions sont affichées : l une pour une file d attente type Atlas, l autre pour une file d attente type Allegro. Il suffit d utiliser le paramètre file d attente pour sélectionner le résultat de communication adéquat. Impression du 13/09/2006 page 70

71 6.4 Option chronos allegro Cet écran est utilisé uniquement pour le RVA Allegro. Le paramètre type de chrono permet de choisir entre les chronos «arrivée» et «départ». Impression du 13/09/2006 page 71

72 6.5 Option statistiques Cette option permet d afficher des statistiques sur le flux EDI. En cliquant sur cette option, on obtient : Plusieurs paramètres permettent d affiner ces statistiques. Ainsi, on retrouve : une plage horaire, l agent de messagerie, la norme du document, et les codes partenaire expéditeur et destinataire. En cliquant sur le bouton OK, on obtient le calcul et l affichage de ces statistiques. NB : L utilisation des statistiques demande beaucoup de ressources. Aussi, afin de ne pas surcharger le serveur, nous vous conseillons de ne pas dépasser une semaine (tout dépend de l importance du flux) pour les critères de recherche Données générales Impression du 13/09/2006 page 72

73 6.5.2 Répartition par jour En cliquant sur un jour de la semaine, on obtient un affinage des statistiques par plage horaire. Impression du 13/09/2006 page 73

74 6.5.3 Répartition par heure Profil/Partenaire Impression du 13/09/2006 page 74

75 6.5.5 Profil/Document Document/Profil Impression du 13/09/2006 page 75

76 6.5.7 Profil/Files d attente Files d attente/profil Impression du 13/09/2006 page 76

77 6.5.9 Files d attente/documents Documents/Files d attente Impression du 13/09/2006 page 77

78 6.6 Option recherche archives Documentation utilisateur Il est possible de rechercher tous les flux comportant une chaîne de caractères spécifiée (hors enveloppe) dans les archives sous Genedi. Par exemple, il est possible de rechercher toutes les commandes comportant le code article "code article". Plusieurs critères de recherches sont disponibles : - la référence document - l expéditeur - le destinataire - l identification du document - le sens du flux - la date début, et le date de fin Plus les critères de sélection seront nombreux et plus la recherche sera rapide. Une fois enregistrée, la recherche peut être lancé à n importe quel moment avec le bouton. Le nombre d archive(s) trouvée(s) est présent sous l onglet résultat. Vous avez la possibilité de consulter le résultat de la dernière recherche en cliquant sur le lien «Résultat de la recherche». Une fenêtre s ouvre alors avec la possibilité de consulter les résultats, comme si vous étiez dans l option «tableau de bord». Impression du 13/09/2006 page 78

79 7 Les utilitaires Les utilitaires correspondent à des outils de diagnostic (lecture sur des tables propres à EXI) Les options «Traitements en cours» et «Tâches en cours» donnent une visualisation différentes sur la même table : Travail en cours par Genedi. Les options «Messages diffusés» et «Tâches en attente» donnent également une visualisation identique sur une autre table de Genedi : Les travail soumis à Genedi, et qui passeront à l état «en cours» lorsque Genedi aura fini ses en cours actuel. Impression du 13/09/2006 page 79

80 7.1 Traitements en cours Cet écran permet de visualiser les traitements en cours. Si vous possédez «n» stations, et que sur chacune d elle, «EXI» est démarré (1 maître, «n-1» esclaves), vous aurez obligatoirement (n+1) lignes. Exemple : 1 ligne «groupe.moniteur» «n» lignes «agent.moniteur» Vous constaterez que la description du message contient l adresse de vos «PC». Dans le cadre d un multipostes, l heure de fin permet à «EXI» de détecter que le traitement n est pas terminé. C est pour cela qu il est écrit «heure de fin» et que cette heure n est pas la même (décalage de quelques minutes) que celle de l heure du «PC» où s exécute la tâche. Si vous avez 1 agent.moniteur dont l heure de fin diffère systématiquement d un autre agent.moniteur, il faudra alors vérifier les heures sur chaque «PC». En cas de changement d heure sur un «PC», il faudra arrêter «EXI», sur le poste en question (et tous les «EXI», si l heure change sur le «PC» maître). Impression du 13/09/2006 page 80

81 7.2 Tâches en cours L option «Tâches en cours» restitue les mêmes informations que l option «Traitements en cours», mais présentées de manière plus lisible pour l utilisateur. On peut également filtrer sur des critères plus précis. Les tâches sont catégorisées en huit types : Administrative : On retrouve ici des tâches telles que : EXI lancé (en tant que Maître et élève, en tant qu élève seul ), Arrêt demandé, Evénement à contrôler, Archivage et remontée d alerte, Lancement par le portail (recyclage ), Flag. Connexion : Connexion à un réseau, à une machine, pour récupérer des fichiers. Exemple : Connexion au RVA Allegro. Dissociation : Tâches de dissociation effectuées par l «agent.acheminement», ou tâches de recyclage depuis l «analyse des répertoires temporaires». Les tâches de dissociation faites par les agents spécifiques (ex : agent.genacod) qui font également la récupération se retrouvent dans les tâches de Récupération. Dématérialisation : Tâches lançant l agent de dématérialisation du Module dématérialisation. Emission : Tâches permettant l envoi vers la file d attente spécifiée. Regroupement : Tâches qui permettent l association.(regroupement de plusieurs messages dans un seul fichier) Récupération : Tâches permettant d aller rechercher les fichiers dans un emplacement (Ex :Agent.messagerie.allegro pour récupérer les fichiers de lotarv, agent.genacod pour récupérer les fichiers en provenance de Genacod). Traduction : Ensemble des étapes pour passer du fichier avant traduction au fichier après traduction (exemple : agent.edi, agent.asc, agent.xslt,..) Impression du 13/09/2006 page 81

82 7.3 Messages diffusés On retrouve ici les messages non traités. EXI les répartira sur un poste ultérieurement. Si un message est présent et qu EXI ne le prend pas jamais en compte, vérifier qu un des postes peut lancer l agent cité dans «destinataire du message» (sauf s il s agit de l agent Archive). Une alerte d exploitation sera consignée si aucun agent n était paramétré dans le fichier INI des EXI lancés. Impression du 13/09/2006 page 82

83 7.4 Tâches en attente L option «Tâches en attente» restitue les mêmes informations que l option «Messages diffusés», mais présentées de manière plus lisibles pour l utilisateur (tout comme les «tâches en cours» par rapport au «Traitements en cours»). On peut également filtrer sur des critères plus précis, et modifier la priorité pour les messages. Lorsqu EXI est arrêté sur un gros traitement, ou lorsqu il a été arrêté de façon «brutale», il peut être intéressant de modifier les priorités afin d enchaîner, ou de repartir sur des messages prioritaires pour vous. Les types de tâches sont exactement les mêmes que pour l option «tâches en cours» Impression du 13/09/2006 page 83