Gestion des statuts
L’objectif est d’avoir, en dehors de l’application Cegid Retail Y2, le statut des différentes tâches planifiées. Ces fichiers seront analysés par des automates qui seront à même de déclencher des alertes en cas de problèmes. Des fichiers de logs peuvent ainsi être générés : ils respectent un format spécifique bien précis, pour pouvoir être analysés correctement.
Paramétrages préalables
Back-Office > Administration > Société > Paramètres société
Ouvrez la branche Gestion commerciale > Tâches planifiées et renseignez les informations détaillées ici.
Fonctionnement des fichiers générés
Pour chaque tâche, deux fichiers sont générés :
-
le fichier LOG qui contiendra des informations de type commentaire,
-
le fichier DONE qui sert de déclencheur pour l’EAI. Ce fichier doit être généré à la fin de la tâche.
Ces fichiers seront générés sur un répertoire accessible depuis le serveur de tâches.
Un premier fichier est généré au lancement de la tâche avec le code statut "01 – Traitement lancé". Ce fichier reprendra le formalisme du fichier DONE mais avec une extension temporaire en .RUN :
Fichier RUN : LOG-xxx-2008-01-16-10-08-25-125.RUN
A la fin du traitement, le fichier RUN est remplacé par le fichier DONE, et le fichier LOG est généré.
Exemple :
Nom des fichiers
Les noms des fichiers de log sont uniques et ont la structure suivante :
EntêteFichier+‘-’+Date(YYYY-MM-DD-HH-NN-SS-ZZZ)+‘-TACHE-’+ NuméroTâche.Extension
Avec :
-
EntêteFichier = En-tête du fichier paramétrable
-
NN correspondant aux minutes
-
ZZZ correspondant aux millisecondes
Par exemple, fichiers générés pour une tâche lancée le 16/09/2011 à 10h08min25s :
Fichier LOG : LOG-xxx-2011-09-16-10-08-25-125.TXT
Fichier DONE : LOG-xxx-2011-09-16-10-08-25-125.DONE
Exemple de fichier LOG
Le contenu du fichier de log est le suivant :
|
Description |
|
Tâche 6 : EXPORT DES ARTICLES
Export du 06/25/2011 09:30:52 AM
Fichier : C:\logs\exp.ASC Génération du fichier le 06/25/2011 09:30:52 AM
Export du 06/25/2011 09:30:52 AM
Fichier : C:\logs\exp.ASC Génération du fichier le 06/25/2011 09:30:52 AM
Export du 06/25/2011 09:30:52 AM
Fichier : C:\logs\exp.ASC Génération du fichier le 06/25/2011 09:30:52 AM
Export du 06/25/2011 09:30:52 AM
Fichier : C:\logs\exp.ASC Génération du fichier le 06/25/2011 09:30:52 AM |
Structure du fichier DONE
Le contenu du fichier de log est le suivant :
|
LOGAPPLI |
CHAR(20) |
Application |
|
LOGSDA |
CHAR(10) DATE ISO (AAAA-MM-JJ) |
Date de début |
|
LOGSTI |
CHAR(08) TIME ISO (HH.MN.SS) |
Heure de début |
|
LOGEDA |
CHAR (10) DATE ISO |
Date de fin |
|
LOGETI |
CHAR (08) TIME ISO |
Heure de fin |
|
LOGJOB |
VARCHAR (256) |
Nom du travail |
|
LOGNBR |
CHAR (06) NUMERIC |
N° de travail |
|
LOGUSR |
VARCHAR(256) |
Utilisateur |
|
LOGPGM |
VARCHAR(256) |
Programme |
|
LOGERR |
CHAR(02) |
Code erreur |
|
LOGTXT |
VARCHAR(5000) |
Texte libre |
Notez que chaque ligne doit comporter une seule zone (retour chariot en fin de ligne - CRLF) :
Par exemple, fichier généré pour une tâche (n° 6) lancée le 25/06/2011 à 9h30min51s :
|
Description |
|
Cegid Retail Y2 2011-06-25 09.30.51 2011-06-25 09.30.52 CGIMODE 0 Tâche 6 - EXPORT DES ARTICLES EXPORT_DONNEES 00 Fichier généré |
Gestion des codes erreurs
Cinq codes erreurs sont gérés :
|
Code |
Signification |
|
00 |
Fin normale : Le traitement s’est exécuté sans incident. |
|
01 |
Warning : La tâche a été lancée. |
|
02 |
Warning : Le traitement a une fin normale, mais un problème non bloquant a été constaté. L’attribution des codes se fait par application. |
|
51 |
Erreur applicative : L’erreur est due non pas à un bug, mais à l’application. Exemple : données en entrée incorrectes, aucune donnée à traiter |
|
99 |
Erreur : Incident fatal. L’attribution des codes se fait par application. Par défaut une erreur fatale a un code ‘99’. |
Exemples de tâches planifiées générant des fichiers de statuts