Propriétés spécifiques à la description des variables de type serveurAppliTâchePlanifiée
Les propriétés suivantes peuvent être utilisées pour manipuler une Tâche planifiée :
| | |
| Nom de la propriété | Type manipulé | Effet |
|---|
| Activé | Booléen | Indique si la tâche est active ou non : - Vrai si la planification de la tâche est active.
- Faux dans le cas contraire.
|
| EnExécution | Booléen | Indique si la tâche est en cours d'exécution : - Vrai si la tâche est en cours d'exécution.
- Faux dans le cas contraire.
Cette propriété est disponible en lecture seulement. |
| Heure | Chaîne de caractères | Heure d'exécution de la tâche planifiée. Si la propriété HeureUTC est à Vrai, cette heure est au format UTC (temps universel). Les valeurs possibles sont : - un chiffre compris entre 0 et 23.
- une liste de nombres séparés par des virgules : permet de spécifier plusieurs heures.
- un intervalle. Par exemple "9-13".
- une étoile "*" pour indiquer toute la plage.
- un intervalle avec un pas, par exemple "*/2" pour lancer la tâche à toutes les heures paires.
|
| HeureUTC | Booléen | - Vrai (valeur par défaut) si l'heure est exprimée en heure UTC, c'est-à-dire en temps universel (propriétés Heure et Minute).
- Faux dans le cas contraire.
|
| 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, ...). Cette propriété 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").
|
| 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. Cette propriété peut également correspondre à : - une liste de nombres séparés par des virgules : permet de spécifier plusieurs mois.
- 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 impairs du mois.
|
| JourDuMoisOuDeLaSemaine | Booléen | Permet de gérer l'exécution d'une tâche planifiée en précisant le numéro de jour de la semaine ou le numéro de jour du mois. Exemple : exécution tous les lundis 1er jour du mois. Cette propriété peut correspondre à : - Vrai pour exécuter la tâche planifiée tous les lundis ET le premier jour du mois (conditions cumulées).
- Faux pour exécuter la tâche uniquement les lundis 1er (conditions exclusives).
|
| Minute | Chaîne de caractères | Minutes de l'heure d'exécution de la tâche planifiée. Si la propriété HeureUTC est à Vrai, cette heure est au format UTC (temps universel). Les valeurs possibles sont : - un chiffre compris entre 0 et 59.
- une liste de nombres séparés par des virgules : permet de spécifier plusieurs minutes.
- un intervalle. Par exemple "9-13".
- une étoile "*" pour indiquer toute la plage.
- un intervalle avec un pas, par exemple "*/2" pour lancer la tâche à toutes les minutes paires.
|
| Mois | Chaîne de caractères | Numéro du mois d'exécution de la tâche planifiée (par exemple "11"). Les valeurs possibles sont : - un chiffre compris entre 1 et 12
- une liste de nombres séparés par des virgules : permet de spécifier plusieurs mois.
- un intervalle. Par exemple, "9-11".
- une étoile "*" pour indiquer toute la plage.
- un intervalle avec un pas, par exemple "*/2" pour lancer la tâche tous les mois impairs.
|
| MotDePasse | Chaîne de caractères | Mot de passe de l'utilisateur. |
| Nom | Chaîne de caractères | Nom de la tâche. Ce nom permet de différencier les tâches associées à une même procédure. Si cette propriété n'est pas renseignée, le nom de la tâche correspondra au nom complet de la procédure (par exemple : MaColletion.NomDeLaProcédure). |
| NomProcédure | Chaîne de caractères | Nom de la procédure à exécuter. Cette propriété est en lecture seule et permet de récupérer le nom de la procédure associée à la tâche (pour l'afficher dans un écran spécifique par exemple). |
| Paramètre | Tableau | Paramètres à transmettre à la tâche planifiée lors de son exécution. Chacun des paramètres doit pouvoir être transformé par la fonction Sérialise (la sérialisation utilisée est une sérialisation binaire). |
| Procédure | Nom de la procédure | Procédure à exécuter par la tâche planifiée. Ce nom est de la forme :- pour une procédure présente dans une collection de procédures : <Nom de la collection de procédures>.<Nom de la procédure>.
- pour une procédure présente dans un composant : <Nom du composant>.<Nom de la collection de procédures>.<Nom de la procédure>.
Cette propriété n'accepte pas : - Les procédures locales. Une procédure locale existe uniquement dans le contexte de l'appel de sa procédure parente. Ce contexte n'existera plus lors de l'appel de la tâche planifiée.
- Une variable de type Procédure (sauf si celle-ci ne désigne une procédure appartenant à une collection de procédures).
|
| Utilisateur | Chaîne de caractères | Indique l'utilisateur du système d'exploitation qui exécutera la tâche. Si cette valeur n'est pas remplie, l'utilisateur utilisé est l'utilisateur par défaut de l'application (site ou webservice). |