PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Structure HTâchePlanifiée
En anglais : HScheduledTask structure
HFSQLDisponible uniquement avec ce type de connexion
La structure HTâchePlanifiée est conservée uniquement pour compatibilité (cette structure sera encore supportée dans la prochaine version).
A partir la version 14, la structure HTâchePlanifiée a été remplacée par le type hTâchePlanifiée. Il suffit de déclarer une variable de type hTâchePlanifiée pour manipuler les tâches planifiée.
Pour plus de détails, consultez la page d'aide concernant le type hTâchePlanifiée.
Voici la documentation de la structure HTâchePlanifiée disponible avec WINDEV, WEBDEV et WINDEV Mobile 14.
 
Présentation
La structure HTâchePlanifiée permet de gérer la planification des tâches sur le serveur. Cette structure permet de décrire les caractéristiques de répétition de la tâche.
Lorsque la tâche planifiée est décrite à l'aide de la structure, la fonction HAjouteTâche permet d'ajouter la tâche sur le serveur HFSQL en liant la structure HTâchePlanifiée et la procédure à exécuter.
Détail de la structure HTâchePlanifiée
Les variables suivantes permettent de gérer les tâches planifiées sur le serveur :
HTâchePlanifiée.DescriptionChaîne de caractères.
Description de la tâche
HTâchePlanifiée.HeureChaîne de caractères.
Heure à laquelle la tâche planifiée doit être exécutée (par exemple "13"). Ce nombre est compris entre 0 et 23.
Ce paramètre peut également correspondre à :
  • une liste de nombres séparés par des virgules : permet de spécifier plusieurs heures.
  • un intervalle. Par exemple "9-13" (la tâche est planifiée pour 9 heures, 10, 11, 12, et 13 heures).
  • une étoile "*" pour indiquer toute la plage.
  • un intervalle avec un pas, par exemple "*/2" pour lancer la tâche à toutes les heures paires.
HTâchePlanifiée.JourDeLaSemaineChaîne de caractères.
Numéro du jour de la semaine pour lequel la tâche planifiée doit être exécutée (par exemple "2"). Ce nombre est compris entre 1 et 7 (1 = Lundi, 2 = Mardi, ...).
Ce paramètre peut également correspondre à :
  • une liste de nombres séparés par des virgules : permet de spécifier plusieurs jours.
  • un intervalle. Par exemple "1-3" (la tâche est planifiée pour Lundi, Mardi et Mercredi).
  • une étoile "*" pour indiquer toute la plage.
  • un intervalle avec un pas, par exemple "*/2" pour lancer la tâche à tous les jours de la semaine pairs.
  • le jour de la semaine en toutes lettres ("lundi", "mardi", "mercredi", "jeudi", "vendredi").
HTâchePlanifiée.JourDuMoisChaîne de caractères.
Numéro du jour du mois pour lequel la tâche planifiée doit être exécutée (par exemple "31"). Ce nombre est compris entre 0 et 31.
Ce paramètre peut également correspondre à :
  • une liste de nombres séparés par des virgules : permet de spécifier plusieurs jours.
  • un intervalle. Par exemple "9-13" (la tâche est planifiée du 9 au 13 du mois).
  • une étoile "*" pour indiquer toute la plage.
  • un intervalle avec un pas, par exemple "*/2" pour lancer la tâche à tous les jours du mois pairs.
HTâchePlanifiée.JourDuMoisOuDeLaSemaineBooléen
Permet de gérer les cas suivants : exécution tous les lundis 1er jour du mois.
  • Vrai permet l'exécution tous les lundis ET le premier jour du mois (conditions cumulées).
  • Faux permet l'exécution uniquement les lundis 1er (conditions exclusives).
HTâchePlanifiée.MinuteChaîne de caractères.
Minutes de l'heure à laquelle la tâche planifiée doit être exécutée (par exemple "13"). Ce nombre est compris entre 0 et 59.
Ce paramètre peut également correspondre à :
  • une liste de nombres séparés par des virgules : permet de spécifier plusieurs minutes.
  • un intervalle.
  • une étoile "*" pour indiquer toute la plage.
  • un intervalle avec un pas, par exemple "*/2" pour lancer la tâche à toutes les minutes paires.
HTâchePlanifiée.MoisChaîne de caractères.
Numéro du mois pour lequel la tâche planifiée doit être exécutée (par exemple "11"). Ce nombre est compris entre 1 et 12.
Ce paramètre peut également correspondre à :
  • une liste de nombres séparés par des virgules : permet de spécifier plusieurs mois.
  • un intervalle. Par exemple "9-12" (la tâche est planifiée pour tous les mois du dernier trimestre).
  • une étoile "*" pour indiquer toute la plage.
  • un intervalle avec un pas, par exemple "*/2" pour lancer la tâche tous les mois pairs.
HTâchePlanifiée.NombreExécutionChaîne de caractères.
Nombre de fois où la tâche doit être exécutée.
Ce paramètre peut également correspondre à :
  • La constante Infini.
La tâche sera déclenchée si le numéro du mois, les heures et les minutes correspondent aux informations définies dans la structure et qu'au moins l'un des JourDuMois et JourDeLaSemaine correspondent avec le jour en cours.
Exemples
// Tous les lundis à 13h45
HTâchePlanifiée.JourDuMois = "*"
HTâchePlanifiée.JourDeLaSemaine = "1"
HTâchePlanifiée.Mois = "*"
HTâchePlanifiée.Heure = "13"
HTâchePlanifiée.Minute = "45"
HTâchePlanifiée.NombreExécution = Infini
// Toutes les heures, 10 minutes après l'heure
HTâchePlanifiée.JourDuMois = "*"
HTâchePlanifiée.JourDeLaSemaine = "*"
HTâchePlanifiée.Mois = "*"
HTâchePlanifiée.Heure = "*"
HTâchePlanifiée.Minute = "10"
HTâchePlanifiée.NombreExécution = Infini
// Tous les 31 décembre à 23h50
HTâchePlanifiée.JourDuMois = "31"
HTâchePlanifiée.JourDeLaSemaine = "0"
HTâchePlanifiée.Mois = "12"
HTâchePlanifiée.Heure = "23"
HTâchePlanifiée.Minute = "50"
HTâchePlanifiée.NombreExécution = Infini
Version minimum requise
  • Version 11
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire