4D v14.3

ENREGISTRER EVENEMENT

Accueil

 
4D v14.3
ENREGISTRER EVENEMENT

ENREGISTRER EVENEMENT 


 

ENREGISTRER EVENEMENT ( {typeSortie ;} message {; importance} ) 
Paramètre Type   Description
typeSortie  Entier long in Type de sortie du message
message  Chaîne in Contenu du message
importance  Entier long in Niveau d’importance du message (Windows uniquement)

La commande ENREGISTRER EVENEMENT vous permet de mettre en place un système personnalisé d'enregistrement des événements internes qui se produisent au cours de l'utilisation de votre application. Vous pouvez ainsi contrôler le déroulement d’une session de travail.

Passez dans le paramètre message les informations personnalisées à noter en fonction de l'événement.  

Le paramètre facultatif typeSortie vous permet de préciser le canal de sortie emprunté par le message. Vous pouvez passer dans ce paramètre une des constantes suivantes, placées dans le thème Journal d'événements :

Constante Type Valeur Commentaire
Vers historique commandes 4D Entier long 3 Indique à 4D d'inscrire le message dans le fichier d’historique des commandes de 4D, si ce fichier a été activé. Ce fichier d'historique peut être activé à l’aide de la commande FIXER PARAMETRE BASE (sélecteur 34).
Note : Les fichiers d’historique de 4D sont regroupés dans le dossier Logs, créé à côté du fichier de structure de la base (cf. commande Dossier 4D).
Vers historique diagnostic Entier long 5 Indique à 4D d’inscrire le message dans le fichier de diagnostic de 4D, si ce fichier a été activé.
Le fichier de diagnostic peut être activé à l’aide de la commande FIXER PARAMETRE BASE (sélecteur 79).
Vers historique requêtes 4D Entier long 2 Indique à 4D d'inscrire le message dans le fichier d’historique des requêtes de 4D, si ce fichier a été activé
Vers message débogage Entier long 1 Indique à 4D d'envoyer le message dans l'environnement de débogage du système. Le résultat dépend de la plate-forme :
  • sous Mac OS : la commande envoie le message à la Console
  • sous Windows : la commande envoie le message en tant que message de débogage. Pour pouvoir lire ce message, vous devez disposer de Microsoft Visual Studio ou de l’utilitaire DebugView pour Windows (http://technet.microsoft.com/en-us/sysinternals/bb896647.aspx)
Vers observateur Windows Entier long 0 Indique à 4D d'envoyer le message vers l’“Observateur d’événements” de Windows. Ce journal reçoit et stocke des messages en provenance des applications en cours d’exécution. Dans ce cas, vous pouvez définir le niveau d'importance du message via le paramètre importance (cf. ci-dessous).
Notes :

  • Pour que cette fonctionnalité soit disponible, le service Observateur d’événements de Windows doit être démarré.
  • Sous Mac OS, la commande ne fait rien avec ce type de sortie.

Si vous ne passez pas le paramètre typeSortie, la valeur 0 (Vers Observateur Windows) est utilisée par défaut.

Si vous avez défini un typeSortie de type Vers Observateur Windows, vous pouvez attribuer au message un niveau d’importance via le paramètre facultatif importance afin de faciliter la lecture du journal d’événements. Il existe trois niveaux d’importance : Information, Avertissement et Erreur. 4D vous propose les constantes prédéfinies suivantes, placées dans le thème Journal d'événements :

Constante Type Valeur
Message d'erreur Entier long 2
Message d’avertissement Entier long 1
Message d’information Entier long 0
Si vous ne passez pas le paramètre importance ou passez une valeur invalide, la valeur par défaut (0) est utilisée.

Exemple  

Afin de conserver une trace des lancements de votre base sous Windows, vous pouvez écrire, dans la Méthode base Sur ouverture :

 ENREGISTRER EVENEMENT(Vers observateur Windows;"Démarrage de la base Facturation")

A chaque ouverture de la base, cette information sera inscrite dans l’Observateur d’événements de Windows, avec le niveau d’importance 0.

 
PROPRIÉTÉS 

Produit : 4D
Thème : Environnement système
Numéro : 667
Nom intl. : LOG EVENT

Comportement spécifique sous Mac OSComportement spécifique sous Windows

 
HISTORIQUE 

Modifié : 4D v11 SQL Release 2
Modifié : 4D v13

 
VOIR AUSSI  

FIXER PARAMETRE BASE

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)

Hérité de : ENREGISTRER EVENEMENT ( 4D v11 SQL Release 6)