DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques au WEB / Fonctions diverses WEBDEV
  • Principe
  • Notes
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
SessionHeartBeatActive (Fonction)
En anglais : SessionHeartBeatEnable
Active ou désactive le "heartbeat" de la session courante.
Remarque : Par défaut, le "heartbeat" de la session courante est de 5 minutes.
Exemple
SessionHeartBeatActive(Vrai, 10 min)
Syntaxe
SessionHeartBeatActive(<Active> [, <Intervalle>])
<Active> : Booléen
  • Vrai pour activer le "Heart beat",
  • Faux pour le désactiver.
<Intervalle> : Durée ou chaîne de caractères optionnelles
Intervalle entre deux appels. Ce paramètre peut correspondre à :
  • une variable de type Durée,
  • l'indication directe de la durée (par exemple 5min).
Par défaut, l'intervalle est de 5 minutes (sauf si le timeout de session est plus court).
Remarque : le Serveur d'application WEBDEV fait dans tous les cas, une attente de 1 minute quel que soit l'intervalle configuré. L'intervalle spécifié par ce paramètre est donc toujours augmenté de cette minute d'attente.
Remarques

Principe

Le but du "heartbeat" de session est de décharger le serveur en fermant plus tôt les sessions du serveur (par exemple en détectant les sessions pour lesquelles le client a navigué hors du site).
La fonctionnalité "heartbeat" ("battement de coeur" en anglais) est un traitement automatique sur le navigateur qui envoie régulièrement (toutes les 5 mn par exemple) une information au serveur pour indiquer que le navigateur est ouvert. Lorsque l'internaute a refermé son navigateur, le serveur ne reçoit plus de HeartBeat et peut donc fermer la session immédiatement, sans attendre le timeout défini pour le site.
Attention : Le HeartBeat ne permet pas de prolonger la session au-delà du délai d'inactivité de l'utilisateur (défini dans le Serveur d'Application WEBDEV). Si vous avez défini un timeout de session à 10 minutes, la session sera fermée au bout de 10 minutes sans action de l'utilisateur même si le navigateur n'est pas fermé.
Le choix de l'intervalle est donc important :
  • Si l'intervalle est trop long, les sessions restent trop longtemps.
  • Si l'intervalle est trop court, le serveur est inutilement chargé par des appels "battements" pour maintenir en vie les sessions.
Attention : Ces appels "battement" consomment des ressources (réseau et batterie) dans le cas des clients mobile.
Le Serveur d'application WEBDEV tente de détecter dynamiquement si le maintien de la session est possible. La terminaison anticipée des sessions est effectuée uniquement si le serveur d'application détecte que la page affichée chez le client est une page complète du site. Dans le cas contraire (la réponse est une image générée, un buffer, ou l'affichage d'une page externe, de paiement par exemple), la terminaison anticipée des sessions est désactivée, jusqu'à la prochaine demande pour la session qui retourne une page complète du site.

Notes

  • L'appel de la fonction SessionHeartBeatActive est pris en compte à partir de la prochaine page renvoyée par le Serveur d'application WEBDEV.
  • Si le paramétrage doit être appliqué à toutes les pages d'un site, la fonction SessionHeartBeatActive doit être appelée dans le code d'initialisation du projet, ou de la première page (ou tout code appelé avant que la première page ne soit renvoyée).
  • La fonction SessionHeartBeatActive active le heartbeat également en mode test (Go de projet ou Go de page). Il n'est généralement pas pris en compte car la fermeture du navigateur est détectée par le mode test et la session est immédiatement terminée.
Composante : wd290page.dll
Version minimum requise
  • Version 26
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 13/11/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale