Les propriétés suivantes peuvent être utilisées pour manipuler une variable de type
| | |
| Nom de la propriété | Type manipulé | Effet |
|---|
 Versions 20 et supérieuresActivé  Nouveauté 20Activé | Booléen | - Vrai si la planification de la tâche est activée,
- Faux dans le cas contraire.
|
Versions 23 et supérieuresAuDémarrage Nouveauté 23AuDémarrage AuDémarrage | Constante de type Entier | Indique si la tâche doit être effectuée au démarrage du serveur HFSQL et son mode d'exécution : - hBloquant : La tâche est bloquante. Le serveur HFSQL sera inaccessible pendant l'exécution de la tâche.
- hTâcheDeFond : La tâche n'est pas bloquante. Le serveur HFSQL sera accessible pendant l'exécution de la tâche. La tâche est exécutée en tâche de fond.
- Non : La tâche ne doit pas être exécutée au démarrage du serveur (valeur par défaut).
|
| Description (*) | Chaîne de caractères | Description associée à la tâche planifiée. Par défaut, la description de la tâche planifiée correspond à une chaîne vide.
Cette propriété est optionnelle. |
| Heure | Chaîne de caractères | Heure d'exécution de la tâche planifiée au format UTC (temps universel). 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.
|
Versions 19 et supérieuresHeureUTC Nouveauté 19HeureUTC 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, ...).
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").
|
| 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 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 du mois pairs.
|
| 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 au format UTC (temps universel). 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 pairs.
|
| NombreExécution | Entier | Nombre de fois où la tâche doit être exécutée. Cette propriété peut également correspondre à la constante Infini. |
| Paramètre | Tableau | Paramètres de la procédure stockée à exécuter par la tâche planifiée. Pour plus de détails, consultez le paragraphe "Comment manipuler les paramètres passés à la procédure stockée ?". |
| Procédure | Chaîne de caractères | Nom de la procédure stockée à exécuter par la tâche planifiée.
Cette propriété est de la forme : <Nom de la base>:<Nom de la collection de procédures>.<Nom de la procédure stockée>.
Pour exécuter une sauvegarde, cette propriété doit correspondre à "HSauvegarde" ou "HBackup". |
Versions 20 et supérieuresUtilisateur Nouveauté 20Utilisateur Utilisateur | Chaîne de caractères | Utilisateur ayant créé la tâche planifiée.
Cette propriété est en lecture uniquement. |
Les propriétés suivies du caractère (*) sont optionnelles.