PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


  • Présentation
  • Historique des incidents/notifications
  • Présentation
  • Historique des notifications affiché dans le Centre de Contrôle HFSQL
  • Accéder à l'historique des notifications par programmation
  • Recevoir les notifications (via email ou WDBal)
  • Présentation
  • Centre de Contrôle HFSQL
  • Programmation
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Présentation
Un serveur HFSQL peut réaliser plusieurs opérations qui nécessitent l'envoi d'une notification :
  • Un serveur peut rencontrer différents problèmes sans qu'aucun utilisateur (ou développeur) ne s'en aperçoive.
    Par exemple :
    • une tâche planifiée peut être en échec.
    • une sauvegarde automatique peut échouer.
    • un noeud peut devenir inactif dans un cluster HFSQL, ...
  • Versions 22 et supérieures
    Un serveur peut également réaliser des opérations automatiquement (mise à jour automatique, recherche de clés pour optimiser les requêtes, ...). La réalisation et le compte-rendu de ces opérations nécessitent une notification.
    Nouveauté 22
    Un serveur peut également réaliser des opérations automatiquement (mise à jour automatique, recherche de clés pour optimiser les requêtes, ...). La réalisation et le compte-rendu de ces opérations nécessitent une notification.
    Un serveur peut également réaliser des opérations automatiquement (mise à jour automatique, recherche de clés pour optimiser les requêtes, ...). La réalisation et le compte-rendu de ces opérations nécessitent une notification.
Le Centre de Contrôle HFSQL permet de :
Remarque : Ces manipulations sont également disponibles par programmation.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Historique des incidents/notifications

Présentation

Pour chaque problème rencontré sur le serveur HFSQL, une notification est créée. Les caractéristiques de cette notification sont les suivantes :
  • Date et heure de l'incident.
  • Message détaillant l'incident.
  • Catégorie de l'incident : Information, Avertissement, Critique, Erreur.
    • Versions 22 et supérieures
      Information : Informations sur les événements survenus sur le serveur.
      Exemple :
      • Mise à jour automatique du serveur HFSQL avec redémarrage.
      • Suggestion d'ajout de clés et de clés composées pour optimiser la vitesse des requêtes.
      Nouveauté 22
      Information : Informations sur les événements survenus sur le serveur.
      Exemple :
      • Mise à jour automatique du serveur HFSQL avec redémarrage.
      • Suggestion d'ajout de clés et de clés composées pour optimiser la vitesse des requêtes.
      Information : Informations sur les événements survenus sur le serveur.
      Exemple :
      • Mise à jour automatique du serveur HFSQL avec redémarrage.
      • Suggestion d'ajout de clés et de clés composées pour optimiser la vitesse des requêtes.
    • Avertissement : Evénements qui n’amènent pas de dysfonctionnement mais sur lesquels il faut réfléchir.
      Exemple : Résolution d'un conflit de modification pour la réplication. S'il y en a beaucoup il faut sûrement revoir l'architecture de l'application (si cela reste rare, il n'y a pas lieu de s'inquiéter).
    • Critique : Dysfonctionnements dont on ne peut pas renvoyer l'erreur à l'utilisateur.
      Exemples : Erreur WLangage dans une procédure stockée utilisée par une tâche planifiée, échec de la connexion vers un serveur répliqué, ...
    • Erreur : Problème de gestion de cache Windows.
L'historique des notifications est consultable :
  • depuis le Centre de Contrôle HFSQL.
  • par programmation.

Historique des notifications affiché dans le Centre de Contrôle HFSQL

Le Centre de Contrôle HFSQL permet de consulter à tout moment l'historique des incidents survenus sur le serveur.
Pour consulter cet historique :
  1. Lancez le Centre de Contrôle HFSQL.
  2. Sélectionnez le serveur voulu.
  3. Affichez l'onglet "Notifications".
  4. La liste des notifications envoyées par le serveur est affichée. Il est possible de :
    • supprimer une notification.
    • actualiser la liste.

Accéder à l'historique des notifications par programmation

L'historique des notifications est enregistré dans un fichier HFSQL présent dans la base de données système du serveur : "Alert.fic".
Il est possible de manipuler ce fichier de données par programmation de la façon suivante :
PROCEDURE HFCS_RécupèreNotifications(sServeur, sUser="Admin", sPassword="", bNettoyer=Faux)

oNotif est une STNotif
tabRetour est un tableau de STNotif

cnxConnexion est une Connexion
cnxConnexion..Provider = hAccèsHFClientServeur
cnxConnexion..Serveur = sServeur
cnxConnexion..Utilisateur = sUser
cnxConnexion..MotDePasse = sPassword
cnxConnexion..BaseDeDonnées = "__System"

sdAlert est une Source de Données
SI HDéclareExterne("Alert.fic", sdAlert, cnxConnexion) ALORS
POUR TOUT sdAlert sur Date
oNotif:dhDateHeure = sdAlert.Date
oNotif:nNiveau = sdAlert.Level
oNotif:sMessage = sdAlert.Message
Ajoute(tabRetour, oNotif)
SI bNettoyer ALORS
HSupprime(sdAlert)
FIN
FIN
HAnnuleDéclaration(sdAlert)
HFermeConnexion(cnxConnexion)
SINON
Erreur("Erreur lors de la récupération des notifications : " + HErreurInfo(hErrComplet))
FIN

RENVOYER tabRetour
PROCEDURE HFCS_RécupèreDernièreNotifications(sServeur, sUser="Admin", sPassword="") : chaîne
// Paramètres de la connexion au serveur dont on veut la dernière notification
cnxConnexion est une Connexion
cnxConnexion..Provider = hAccèsHFClientServeur
cnxConnexion..Serveur = sServeur
cnxConnexion..Utilisateur = sUser
cnxConnexion..MotDePasse = sPassword
cnxConnexion..BaseDeDonnées = "__System"

// Par défaut, ne renvoie rien
RETOUR = ""
// Fichiers des notifications du serveur
sdAlert est une Source de Données
SI HDéclareExterne("Alert.fic", sdAlert, cnxConnexion) ALORS
// Dernière notification en date
SI HLitDernier(sdAlert,Date) ALORS
// Récupère l'enregistrement
RETOUR = HRécupèreEnregistrement(sdAlert)
FIN
// Libère le fichier déclaré
HAnnuleDéclaration(sdAlert)
// Libère la connexion
HFermeConnexion(cnxConnexion)
SINON
// Echec de l'accès au serveur
Erreur("Erreur lors de la récupération des notifications : " + HErreurInfo(hErrComplet))
FIN
Recevoir les notifications (via email ou WDBal)

Présentation

Par défaut, les notifications sont présentes dans le Centre de Contrôle HFSQL. Mais il est également possible d'être averti en temps réel lorsqu'un problème survient sur le serveur HFSQL. Il suffit de configurer le système de notification du serveur HFSQL.
Cette configuration peut être effectuée :
  • via le Centre de Contrôle HFSQL.
  • par programmation.

Centre de Contrôle HFSQL

Pour configurer l'envoi des notifications HFSQL depuis le Centre de Contrôle HFSQL :
  1. Lancez le Centre de Contrôle HFSQL.
  2. Sélectionnez le serveur voulu.
  3. Affichez l'onglet "Configuration". Dans le ruban, dans le groupa "Paramètres", cliquez sur "Configuration du serveur".
  4. Dans la liste des configurations possibles, cliquez sur "Notifications". L'écran de configuration des notifications apparaît :
    Configuration des notifications
    Dans la liste des configurations possibles, cliquez sur "Notifications". L'écran de configuration des notifications apparaît :
    Configuration des notifications
  5. Configurez le ou les modes d'envoi des notifications :
    • dans la zone "Configuration du serveur SMTP pour l'envoi par email", indiquez les caractéristiques du serveur SMTP qui sera utilisé pour l'envoi des notifications par email. dans l'onglet "Envoi par email", indiquez les caractéristiques du serveur SMTP qui sera utilisé pour l'envoi des notifications par email.
    • dans la zone "Configuration des Centres de Contrôle pour l'envoi par messagerie (WDBal)", indiquez les caractéristiques de la base des Centres de Contrôle qui sera utilisée pour l'envoi des notifications.dans la zone "Envoi par messagerie (WDBal)", indiquez les caractéristiques de la base des Centres de Contrôle qui sera utilisée pour l'envoi des notifications.
    Remarques :
    • Le bouton "Récupérer la configuration de la machine" permet de récupérer la configuration du poste en cours.
    • La base des Centres de Contrôle peut aussi bien être en mode Classic qu'en mode Client/Serveur.
  6. Créez les destinataires des notifications :
    • Le bouton permet d'ajouter un destinataire pour l'envoi par email. Indiquez l'adresse email du destinataire et validez.
    • Le bouton permet d'ajouter un destinataire pour l'envoi via la messagerie WDBal des Centres de Contrôle. Sélectionnez les intervenants concernés et validez.
    • Dans la liste des destinataires, pour chaque destinataire, sélectionnez le niveau de gravité minimum des incidents concernés par l'envoi de notifications.
  7. Cliquez sur le bouton "Appliquer" pour valider la configuration.

Programmation

Pour configurer l'envoi des notifications HFSQL par programmation, le WLangage met à votre disposition plusieurs fonctions WLangage :
Versions 18 et supérieures
HNotifAjouteDestinataireCC
HNotifAjouteDestinataireCC
Ajoute des destinataires pour les notifications envoyées via les Centres de Contrôle (outil de messagerie WDBal).
Versions 18 et supérieures
HNotifAjouteDestinataireEmail
HNotifAjouteDestinataireEmail
Ajoute des destinataires pour les notifications envoyées par email.
Versions 18 et supérieures
HNotifConfigure
Nouveauté 18
HNotifConfigure
HNotifConfigure
Spécifie et configure le serveur utilisé pour l'envoi des notifications par le serveur HFSQL.
Versions 18 et supérieures
HNotifListeDestinataireCC
HNotifListeDestinataireCC
Renvoie la liste des destinataires d'une notification envoyée via les Centres de Contrôle (outil de messagerie WDBal).
Versions 18 et supérieures
HNotifListeDestinataireEmail
HNotifListeDestinataireEmail
Renvoie la liste des destinataires d'une notification par email.
Versions 18 et supérieures
HNotifSupprimeDestinataireCC
HNotifSupprimeDestinataireCC
Supprime les destinataires d'une notification envoyée via les Centres de Contrôle (outil de messagerie WDBal).
Versions 18 et supérieures
HNotifSupprimeDestinataireEmail
HNotifSupprimeDestinataireEmail
Supprime les destinataires d'une notification par email.
Version minimum requise
  • Version 18
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire