DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions Planificateur Windows
  • Présentation
  • Structure TâchePlanifiée
  • 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 TâchePlanifiée permet de définir les caractéristiques d'une tâche planifiée. Les variables de cette structure sont ré-initialisées grâce à la fonction PlanificateurRAZ.
Remarque : Lors de la création d'une nouvelle tâche, la structure TâchePlanifiée est utilisée ainsi que la structure HoraireTâchePlanifiée.
Structure TâchePlanifiée
Les différentes variables de la structure TâchePlanifiée sont les suivantes :
TâchePlanifiée.ApplicationChaîne de caractères.
Nom et chemin du programme à lancer.
TâchePlanifiée.ArrêtSurActivitéBooléen.
Vrai si la tâche doit être arrêtée dès que le système reprend une activité.
Par défaut, cette variable est à Faux.
TâchePlanifiée.ArrêtSurBatteriesBooléen.
Vrai si le système doit terminer la tâche quand l'ordinateur passe à une alimentation sur batteries.
Par défaut, cette variable est à Vrai.
TâchePlanifiée.CodeErreurEntier.
Dernier code d'erreur renvoyé par la tâche (0 si la tâche a été correctement exécutée, ou si le programme n'a jamais été lancé).
Cette variable est en lecture seule et elle est mise à jour grâce à la fonction PlanificateurPropriétésTâche.
TâchePlanifiée.CommentaireChaîne de caractères.
Commentaire associé à la tâche. Ce commentaire sera visible dans les propriétés de la tâche. Ce commentaire peut être multilingue.
TâchePlanifiée.DélaiAttenteInactivitéEntier en minutes.
Délai pendant lequel le système attendra une inactivité avant de lancer la tâche.
Si la variable TâchePlanifiée.DélaiInactivité est différente de 0, cette variable permet de dire au bout de combien de temps le système doit abandonner l'exécution d'une tâche, s'il n'a jamais été actif assez longtemps.
Par défaut, cette variable vaut 60 minutes.
TâchePlanifiée.DélaiInactivitéEntier en minutes.
Délai d'inactivité du système après lequel la tâche peut être effectuée. Permet d'exécuter une tâche uniquement si le système est inactif.
Exemple : Exécution d'un antivirus à 13H tous les jours, uniquement si le système est inactif depuis 30 minutes.
Par défaut, cette variable a pour valeur 0 (délai immédiat).
TâchePlanifiée.DernièreExécutionDateHeure.
Date de la dernière exécution de la tâche.
Cette variable est en lecture seule et elle est mise à jour grâce à la fonction PlanificateurPropriétésTâche.
TâchePlanifiée.DuréeMaximumDurée.
Durée maximum de la tâche. Au-delà de cette durée, la tâche sera terminée de force par le système.
Si cette variable vaut 0, la tâche s'exécutera aussi longtemps que nécessaire.
Par défaut, la valeur de cette variable est 72 heures.
Remarque : Cette variable peut correspondre à :
  • un entier correspondant au nombre de centièmes de seconde,
  • une variable de type Durée,
  • l'indication directe de la durée (par exemple 1 h).
TâchePlanifiée.EveilBooléen.
  • Vrai si l'ordinateur doit être mis en éveil pour exécuter cette tâche (le système ne doit pas être en veille),
  • Faux dans le cas contraire.
Par défaut, la valeur de cette variable est Faux.
TâchePlanifiée.ExécuteSiSessionOuverteBooléen.
  • Vrai si l'exécution de la tâche doit être réalisée uniquement lorsque une session interactive (avec identification de l'utilisateur) est ouverte sur le poste pour l'utilisateur TâchePlanifiée.Utilisateur,
  • Faux dans le cas contraire.
Ceci autorise de ne pas spécifier le mot de passe de l'utilisateur (mais son nom doit être renseigné).
Par défaut, la valeur de cette variable est Faux : la tâche s'exécutera même si la session est fermée.
Remarque : Cette variable fonctionne uniquement à partir de Windows XP (ne fonctionne pas en 2000).
TâchePlanifiée.LigneCommandeChaîne de caractères.
Paramètres à passer en ligne de commande à l'application qui sera lancée.
TâchePlanifiée.MotDePasseChaîne de caractères.
Mot de passe de l'utilisateur. Cet utilisateur a été choisi grâce à la variable TâchePlanifiée.Utilisateur. Permet d'exécuter la tâche planifiée en fonction d'un compte utilisateur.
Si ce mot de passe est modifié, cette modification sera également prise en compte par l'ensemble des tâches liées à ce même utilisateur.
TâchePlanifiée.NombreHorairesEntier.
Nombre d'horaires de la tâche (c'est-à-dire le nombre d'événements déclenchant la tâche).
Cette variable est en lecture seule et elle est mise à jour grâce à la fonction PlanificateurPropriétésTâche.
TâchePlanifiée.PasSurBatteriesBooléen.
Vrai si la tâche ne doit pas être exécutée quand l'ordinateur est alimenté par des batteries.
Par défaut, la valeur de cette variable est Vrai.
TâchePlanifiée.ProchaineExécutionDateHeure.
Date de la prochaine exécution planifiée de la tâche.
Cette variable est en lecture seule et elle est mise à jour grâce à la fonction PlanificateurPropriétésTâche.
TâchePlanifiée.RépertoireTravailChaîne de caractères.
Répertoire de travail de l'application à lancer (chaîne vide si le répertoire de travail correspond au répertoire du planificateur (MSTASK.EXE).
Attention : Si ce répertoire n'est pas renseigné, il correspond au répertoire de TâchePlanifiée.Application.
TâchePlanifiée.SuppressionAutomatiqueBooléen.
Vrai si la tâche doit être supprimée automatiquement quand il n'existe plus de conditions d'exécution possible (par exemple la date limite de chaque horaire est dépassée).
Par défaut, la valeur de cette variable est Faux.
TâchePlanifiée.UtilisateurChaîne de caractères.
Nom d'utilisateur dont le compte est utilisé pour exécuter la tâche.
Remarque : si vous utilisez un domaine, il est nécessaire de préciser le domaine.
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
// nTypeSauvegarde est un sélecteur proposant une sauvegarde
// unique, hebdomadaire, mensuelle...
 
HoraireTâchePlanifiée.Type = nTypeSauvegarde
 
// Date d'exécution de la sauvegarde unique
SI nTypeSauvegarde = 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 nTypeSauvegarde = 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 nTypeSauvegarde = 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