|
|
|
|
- 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
Structure HoraireTâchePlanifiée
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. 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.Date | Date
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ébut | Date
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.DateFin | Date
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étition | Entier 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.Heure | Heure
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.Intervalle | Entier
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.Jour | Entier
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.JourSemaine | Entier
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.Mois | Entier
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étition | Entier 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.Type | Cette variable peut être égale à une des constantes suivantes : | | htConnexion | Exécution à l'ouverture d'une session. | htDémarrage | Exécution au démarrage du système. | htHebdomadaire | Planification à la semaine. | htInactivité | Exécution lorsque le système est inactif. | htMensuel | Planification au mois. | htQuotidien (valeur par défaut) | Planification par jour | htUneFois | Exé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é : | | htConnexion | Aucune variable spécifique | htDémarrage | Aucune variable spécifique | htHebdomadaire | HoraireTâ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 | htMensuel | HoraireTâ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é | htQuotidien | HoraireTâ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é | htUneFois | HoraireTâ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 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
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|