DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions Planificateur Windows
  • Présentation
  • Détail de la structure HoraireTâchePlanifiée
  • Variables pouvant être utilisées selon le type de tâche
  • Exemple
  • Exemple d'ajout d'une tâche
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
Présentation
La structure HoraireTâchePlanifiée permet de définir tous les événements qui vont définir l'exécution d'une tâche. Les variables de cette structure sont ré-initialisées grâce à la fonction PlanificateurRAZ.
Cette structure doit être remplie avant d'utiliser la fonction PlanificateurAjouteHoraire ou la fonction PlanificateurAjouteTâche.
L'horaire défini par défaut est une tâche quotidienne à 9h00.
Détail de la structure HoraireTâchePlanifiée
Les paramètres à saisir dans la structure HoraireTâchePlanifiée dépendent du type de l'horaire de la tâche planifiée.
En effet, une tâche planifiée peut être : quotidienne, hebdomadaire, mensuelle, exécutée une seule fois, exécutée au démarrage, exécutée lorsque le système est inactif.
Le type de l'horaire de la tâche planifiée est déterminé par la variable HoraireTâchePlanifiée.Type. Nous allons détailler cette variable, puis toutes les autres variables de la structure HoraireTâchePlanifiée.
HoraireTâchePlanifiée.ArrêtForcéBooléen.
Si ce paramètre est à Vrai, arrête la tâche quand elle est en cours d'exécution et que la durée de répétition est écoulée.
Par défaut, cette variable est à faux.
Type de tâche associée : Tâche hebdomadaire, tâche mensuelle, quotidienne et une seule fois.
HoraireTâchePlanifiée.DateDate
Date à laquelle la tâche sera exécutée.
Type de tâche associée : Tâche exécutée une seule fois.
HoraireTâchePlanifiée.DateDébutDate
Date à partir de laquelle la tâche pourra être exécutée. Par défaut, cette date correspond à la date de création de la tâche.
Type de tâche associée : Tâche hebdomadaire, tâche mensuelle et quotidienne.
HoraireTâchePlanifiée.DateFinDate
Date à partir de laquelle la tâche ne sera plus du tout exécutée. Pour ne pas définir de date de fin, il suffit d'utiliser une chaîne vide.
Par défaut, il n'y a pas de date de fin.
Type de tâche associée : Tâche hebdomadaire, tâche mensuelle et quotidienne.
HoraireTâchePlanifiée.DuréeInactivitéEntier en minutes
Durée d'inactivité après laquelle la tâche doit être exécutée. Par défaut, cette durée est égale à 10 minutes.
Type de tâche associée : Exécution lorsque le système est inactif
HoraireTâchePlanifiée.DuréeRépétitionEntier en minutes.
Durée pendant laquelle la tâche sera répétée. Par défaut, cette durée est égale à 60 minutes.
Type de tâche associée : Tâche hebdomadaire, tâche mensuelle et quotidienne.
HoraireTâchePlanifiée.HeureHeure
Heure à laquelle la tâche sera exécutée. Par défaut, cette variable a pour valeur 9 Heures
Type de tâche associée : Tâche hebdomadaire, tâche mensuelle, quotidienne et une seule fois.
HoraireTâchePlanifiée.IntervalleEntier
Nombre de jours ou semaines entre chaque exécution. Par défaut, cette variable a pour valeur 1.
Type de tâche associée : Tâche hebdomadaire, tâche quotidienne.
HoraireTâchePlanifiée.JourEntier
Jour d'exécution de la tâche dans le mois. Peut correspondre :
  • soit à un numéro de jour (entre 1 et 31)
  • soit à un nom de jour + sa position dans le mois
Exemple : 1er Lundi du mois : htLundi + htPremier
Les valeurs disponibles sont :
  • htLundi, htMardi, htMercredi, htJeudi, htVendredi, htSamedi, htDimanche
  • htPremier, htDeuxième, htTroisième, htQuatrième, htDernier.
Par défaut, l'exécution est effectuée le 1er de chaque mois.
Type de tâche associée : Tâche mensuelle
HoraireTâchePlanifiée.JourSemaineEntier
Jour d'exécution de la tâche dans la semaine. Correspond à un nom de jour + sa position dans le mois
Exemple : 1er Lundi du mois : htLundi + htPremier
Les valeurs disponibles sont : htLundi, htMardi, htMercredi, htJeudi, htVendredi, htSamedi, htDimanche
Par défaut, l'exécution est effectuée le Lundi.
Type de tâche associée : Tâche hebdomadaire
HoraireTâchePlanifiée.LibelléChaîne de caractères
Libellé de l'horaire, c'est-à-dire de l'événement déclenchant la tâche planifiée.
Cette variable est en lecture seulement et elle est mise à jour lors de la lecture d'un horaire (fonction PlanificateurPropriétésHoraire)
HoraireTâchePlanifiée.MoisEntier
Mois d'exécution de la tâche dans l'année. Correspond à un ou plusieurs noms de mois : htJanvier, htFévrier, htMars, htAvril, htMai, htJuin, htJuillet, htAout, htSeptembre, htOctobre, htNovembre, htDécembre.
Exemple : htJanvier + htAout : effectue la tâche en Janvier et Août.
Par défaut, l'exécution est effectuée tous les mois.
Type de tâche associée : Tâche mensuelle
HoraireTâchePlanifiée.PériodeRépétitionEntier en minutes
Intervalle de répétition de la tâche (0 si elle ne doit être exécutée qu'une fois). Par défaut, il n'y a pas de répétition.
Type de tâche associée : Tâche hebdomadaire, tâche mensuelle, quotidienne et une seule fois.
HoraireTâchePlanifiée.TypeCette variable peut être égale à une des constantes suivantes :
htConnexionExécution à l'ouverture d'une session.
htDémarrageExécution au démarrage du système.
htHebdomadairePlanification à la semaine.
htInactivitéExécution lorsque le système est inactif.
htMensuelPlanification au mois.
htQuotidien
(valeur par défaut)
Planification par jour
htUneFoisExécution une seule fois.
Variables pouvant être utilisées selon le type de tâche
Ce tableau présente la liste des variables pouvant être utilisées selon le type de tâche sélectionné :
htConnexionAucune variable spécifique
htDémarrageAucune variable spécifique
htHebdomadaireHoraireTâchePlanifiée.Heure
HoraireTâchePlanifiée.Intervalle
HoraireTâchePlanifiée.DateDébut
HoraireTâchePlanifiée.DateFin
HoraireTâchePlanifiée.PériodeRépétition
HoraireTâchePlanifiée.DuréeRépétition
HoraireTâchePlanifiée.ArrêtForcé
htInactivitéAucune variable spécifique
htMensuelHoraireTâchePlanifiée.Heure
HoraireTâchePlanifiée.Jour
HoraireTâchePlanifiée.Mois
HoraireTâchePlanifiée.DateDébut
HoraireTâchePlanifiée.DateFin
HoraireTâchePlanifiée.PériodeRépétition
HoraireTâchePlanifiée.DuréeRépétition
HoraireTâchePlanifiée.ArrêtForcé
htQuotidienHoraireTâchePlanifiée.Heure
HoraireTâchePlanifiée.Intervalle
HoraireTâchePlanifiée.DateDébut
HoraireTâchePlanifiée.DateFin
HoraireTâchePlanifiée.PériodeRépétition
HoraireTâchePlanifiée.DuréeRépétition
HoraireTâchePlanifiée.ArrêtForcé
htUneFoisHoraireTâchePlanifiée.Heure
HoraireTâchePlanifiée.Date
HoraireTâchePlanifiée.PériodeRépétition
HoraireTâchePlanifiée.DuréeRépétition
HoraireTâchePlanifiée.ArrêtForcé
Exemple

Exemple d'ajout d'une tâche

PlanificateurRAZ()
// Création de la tache planifiée
TâchePlanifiée.Application = "MonExécutable.exe"
TâchePlanifiée.LigneCommande = ReqToutSurUneBackup.Nom
TâchePlanifiée.Eveil = Vrai
TâchePlanifiée.Commentaire = "Programme WINDEV"
 
// Création des horaires de la tâche planifiée
// SEL_TypeSauvegarde est un sélecteur proposant
// une sauvegarde unique, hebdomadaire, mensuelle ...
 
HoraireTâchePlanifiée.Type = SEL_TypeSauvegarde
 
// Date d'exécution de la sauvegarde unique
SI SEL_TypeSauvegarde = htQuotidien ALORS
SI SAI_DateUnique <> "" ALORS
SI SAI_HoraireUnique <> "" ALORS
HoraireTâchePlanifiée.Date = SAI_DateUnique
HoraireTâchePlanifiée.Heure = SAI_HoraireUnique
SINON
Info("Vous devez saisir une heure valide de sauvegarde.")
RETOUR
FIN
SINON
Info("Vous devez saisir une date valide de sauvegarde.")
RETOUR
FIN
FIN
// Sauvegarde Chaque mois
SI SEL_TypeSauvegarde = htMensuel ALORS
SI SAI_HoraireUnique <> "" ALORS
HoraireTâchePlanifiée.Jour = SEL_JourDuMois
HoraireTâchePlanifiée.Heure = SAI_HoraireUnique
SINON
Info("Vous devez saisir une heure valide de sauvegarde.")
RETOUR
FIN
FIN
// Sauvegarde chaque semaine
SI SEL_TypeSauvegarde = htHebdomadaire ALORS
SI SAI_HoraireUnique <> "" ALORS
HoraireTâchePlanifiée.JoursSemaine = SEL_JourDeLaSemaine
HoraireTâchePlanifiée.Heure = SAI_HoraireUnique
SINON
Info("Vous devez saisir une heure valide de sauvegarde.")
RETOUR
FIN
FIN
SI PAS PlanificateurAjouteTâche("MaTache") ALORS
Erreur(ErreurInfo())
SINON
Info("L'application a été ajoutée au gestionnaire de tâches de Windows")
FIN
Version minimum requise
  • Version 10
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 26/08/2022

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