ENREGISTRER EVENEMENT

4D - Documentation   Français   English   German   Español   Japanese   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant

version 11.2 (Modifiée)


ENREGISTRER EVENEMENT ({typeSortie; }message{; importance})

ParamètreTypeDescription
typeSortieEntierType de sortie du message
messageAlphaContenu du message
importanceEntierNiveau d'importance du message (Windows uniquement)

Description

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" :

ConstanteTypeValeur
Vers Observateur WindowsEntier long0
Vers message débogageEntier long1
Vers historique requêtes 4DEntier long2
Vers historique commandes 4DEntier long3

Note : Si vous omettez le paramètre typeSortie, la commande utilise le canal 0 (Vers Observateur Windows).

Vers Observateur Windows : cette valeur 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.

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.

Vers message débogage : cette valeur 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 historique requêtes 4D : cette valeur indique à 4D d'inscrire le message dans le fichier d'historique des requêtes de 4D, si ce fichier a été activé.

Vers historique commandes 4D : cette valeur indique à 4D d'inscrire le message dans le fichier d'historique des commandes de 4D, si ce fichier a été activé.

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).

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" :

ConstanteTypeValeur
Message d'information (valeur par défaut)Entier long0
Message d'avertissementEntier long1
Message d'erreurEntier long2

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.


4D - Documentation   Français   English   German   Español   Japanese   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant