|
|
|
|
|
|
|
|
Structure HTâchePlanifiée En anglais : HScheduledTask structure
 Disponible 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. 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.Description | Chaîne de caractères. Description de la tâche | | HTâchePlanifiée.Heure | Chaî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.JourDeLaSemaine | Chaî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.JourDuMois | Chaî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.JourDuMoisOuDeLaSemaine | Boolé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.Minute | Chaî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.Mois | Chaî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écution | Chaîne de caractères.
Nombre de fois où la tâche doit être exécutée.
Ce paramètre peut également correspondre à : |
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
|
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|