Voir la source de Guide de l'Utilisateur sur le log de traitement

{{Version800}}

= Avant-Propos =

Il est à présent possible d’enregistrer des logs de traitements de différents niveaux.
Pour cela, du code spécifique a été implémenté pour les traitements non exhaustifs suivants :  

* Comptabilisation des écritures bancaires.
* Confirmation des coordonnées bancaires.
* Constitution des remises.
* Consultation des sessions d’import.
* Conversion de fichiers.
* Création d'un nouveau format.
* Épuration des remises.
* Import des relevés et notifications.
* Import des remises.
* Import des tiers.
* Purge des logs de traitement.
* Rapprochement des rejets avec les transactions d’origine.
* Récupération des relevés auprès du module de communication.
* Réinitialisation des remises.
* Suppression des sessions d’import.
* Transfert des remises.
* Validation des comptes.
* Validation des remises.
* ...

= Paramétrage =

L’accès au paramétrage des logs de traitement s’effectue par le menu :

'''Menu''' : ''Paramètres / Paramètres / Paramètres log''.

== Paramétrage des niveaux de log ==

=== Onglet : Valeurs par défaut ===

[[Fichier:UserGuideLog-Paramètres.jpg|Paramètres du log de traitement]]

4 paramètres distincts sont accessibles :


==== 1 - Stratégie de stockage du log ==== 

* Désactivé : La sélection de cette valeur signifie qu’aucun log ne sera associé au traitement.
La sélection de cette valeur interdit la sélection de valeur sur les paramètres :
 Stratégie de regroupement de log
 Stratégie de débogage des formats.

* Standard : Entraîne la génération du log conformément au code associé sur le traitement.

* Activé : Permet de forcer la génération du log du traitement même si celui-ci n’est pas activé nativement dans le code.


==== 2 - Stratégie de regroupement du log ====

* Désactivé : La sélection de cette valeur n’effectue aucun regroupent de log.

* Standard : Cette sélection effectue les regroupements prévus nativement dans le code des traitements.

* Regroupement : Cette sélection effectue un regroupement des logs en cas d’enchaînement de traitements et sous réserve que le code des traitements le prévoit (Exemple : Import remise + Constitution).
Il est recommandé d'utiliser cette option plutôt qu'avoir une multitude de logs différents.


==== 3 - Stratégie de débogage des formats ====

* Désactivé : Cette sélection permet de désactiver les logs lors de l’utilisation des formats (Import, génération, conversion …)

* Standard : Cette option génère le log si prévu dans le code du traitement.

* Local : Permet de forcer la génération du log du traitement même si celui-ci n’est pas activé nativement dans le code.
S'applique à la partie du traitement concerné.

* Parent : Cette option entraîne l’enregistrement d’un log s’il est également autorisé sur le traitement parent. 
Le traitement qui est appelé hérité du log du parent sinon aucun log ne sera généré. 

* Complet : Cette option entraîne la création d’un log pour le traitement parent et les traitements qui en découlent.


==== 4 - Gestion des exceptions ====

Le fait de cocher cette option permet d’affiner le paramétrage de l’onglet ‘valeurs par défaut’, soit par processus, soit par utilisateur, soit par la combinaison des deux.

Par exemple : Si on définit un niveau standard pour la stratégie de stockage, il est possible de définir un niveau plus élevé (activé) pour un utilisateur spécifique.

A noter : Si on revient sur le paramétrage des valeurs par défaut et qu’on décoche l’option, les exceptions seront temporairement désactivées.
En cochant à nouveau l’option, ils seront à nouveau visibles et réactivés.


=== Onglet : Liste des exceptions ===

[[Fichier:UserGuideLog-ParamètresExceptions.jpg|Paramètres d'exceptions du log de traitement]]

Cette section permet de définir des exceptions prioritaires sur les options par défaut.

Dans tous les cas, c'est l'exception qui sera la plus prioritaire qui sera employée : c'est celle qui répondra au mieux à la situation.

On peut renseigner l'utilisateur et/ou la processus concerné : renseigner ici les deux sera celle qui sera utilisée pour l'utilisateur concerné.


= Consultation et purge des logs de traitements =

== Consultation ==

La consultation des logs s’effectue par le menu : 

'''Menu''' : ''Outils / Consultation des logs de traitement''.

[[Fichier:UserGuideLog-Consultation.jpg|Consultation des logs de traitement]]

NB : Le champ de recherche ‘Référence’ peut utiliser le caractère joker ‘%’

La sélection renvoie ici 3 lignes de logs.

[[Fichier:UserGuideLog-ConsultationLogs.jpg|Liste des logs de traitement]]

On sélectionne l’enregistrement se rapportant à l’import.

'''La constitution de remise a été demandée à la suite du traitement d’import sur le paramétrage'''.

[[Fichier:UserGuideLog-ConsultationLog.jpg|Log d'un traitement]]
 
[[Fichier:UserGuideLog-ConsultationLogFiltre.jpg|Filtre détail du Log d'un traitement]]

La case à cocher '''Sélection état''' permet de définir le niveau d’affichage du log.
Dans l’exemple, en fonction de la valeur, les données suivantes sont restituées :


=== Sans aucun filtre (Par défaut) ===

[[Fichier:UserGuideLog-ConsultationLogDetailAll.jpg|Détails du Log de traitement]]

Le log porte bien sur les deux traitements, les classes impactées par les traitements sont précisées.
NB : Elles pourront être utilisées pour paramétrer classe sur pour exceptions.


=== Filtre : ''Démarrage'' ===

[[Fichier:UserGuideLog-ConsultationLogDetailStart.jpg|Détail filtré sur le démarrage du Log de traitement]]


=== Filtre : ''Exécution'' ===

[[Fichier:UserGuideLog-ConsultationLogDetailExec.jpg|Détail filtré sur exécution du Log de traitement]]


=== Filtre : ''Informations'' ===

[[Fichier:UserGuideLog-ConsultationLogDetailInfos.jpg|Détail filtré sur les avertissements du Log de traitement]]


=== Filtre : ''Avertissements'' ===

[[Fichier:UserGuideLog-ConsultationLogDetailAlerts.jpg|Détail filtré sur les avertissements du Log de traitement]]


=== Filtre : ''Erreurs'' ===

[[Fichier:UserGuideLog-ConsultationLogDetailErrors.jpg|Détail filtré sur les erreurs du Log de traitement]]


=== Filtre : ''Fatal'' ===

[[Fichier:UserGuideLog-ConsultationLogDetailFatals.jpg|Détail filtré sur les erreurs fatales du Log de traitement]]


=== Filtre : ''Succès (fin du traitement)'' ===

[[Fichier:UserGuideLog-ConsultationLogDetailOK.jpg|Détail filtré sur la fin correcte du Log de traitement]]


== Purge ==

L’épuration des logs enregistrés peut être réalisée par le menu suivant :

'''Menu''' : ''Outils / Purge des logs de traitement''.

[[Fichier:UserGuideLog-PurgeLogCriteres.jpg|Critères de la purge du Log de traitement]]

Notons également les points suivantes :
* La purge effectue un log de tous les logs qui ont été purgés afin d'en garder la trace.
* Les critères sont hérités automatiquement de l'écran de consultation si chaîné directement.
* Le champ de recherche '‘Référence'’ peut utiliser le caractère joker ‘%’?

Exemple :

On sélectionne les valeurs suivantes sur l’assistant de traitement :

[[Fichier:UserGuideLog-PurgeLogCriteresExemple.jpg|Exemple de critères de la purge de Logs de traitements]]

Les trois logs de traitement sont retournés :

[[Fichier:UserGuideLog-PurgeLogCriteresResSelect.jpg|Résultat de la sélection de la purge de Logs de traitements]]

Le traitement affiche un compte rendu qui fait lui-même l’objet d’un log :

[[Fichier:UserGuideLog-PurgeLogExecResults.jpg|Résultat de la purge de Logs de traitement]]


[[Fichier:UserGuideLog-PurgeLogResultLog.jpg|Résultat de la purge de Logs de traitement]]

= Voir aussi =

*[[Traitement du Log|Traitement du Log]].

{{Footer|Importation (patterns)}}
[[category:Importation]]
[[category:Logs]]