• soit à l'appel d'une procédure stockée,
• soit à la sauvegarde de la base.

• soit dans le Centre de Contrôle HFSQL.
• soit par programmation.

Créer une tâche planifiée

1. Connectez-vous si nécessaire à un serveur HFSQL.
2. Double-cliquez sur le nom du serveur HFSQL dans l'arborescence.
3. La partie droite du Centre de Contrôle affiche un onglet au nom du serveur.
4. Cliquez sur l'onglet "Eléments planifiés".
5. Dans le ruban, dans le groupe "Eléments planifiés", déroulez "Nouvelle planification" et sélectionnez "Planifier une tâche".
6. Sélectionnez le mode d'exécution de la tâche : la tâche peut être exécutée :
   • Périodiquement. L'assistant vous permet ensuite de définir la fréquence d'exécution de la tâche.
   • et/ou à chaque démarrage du serveur HFSQL. Si cette option est sélectionnée, il est nécessaire d'indiquer si :
     • la tâche est bloquante : dans ce cas, le serveur HFSQL sera inaccessible pendant l'exécution de la tâche.
     • la tâche doit être exécutée en tâche de fond : dans ce cas, le serveur HFSQL pourra être utilisé dès son démarrage.
7. Sélectionnez :
   • la base de données contenant la procédure stockée à exécuter.
   • la collection contenant la procédure stockée à exécuter.
   • la procédure stockée à exécuter.
     Attention : Pour qu'une procédure stockée lancée depuis une tâche planifiée accède aux données, il faut utiliser la fonction HDéclareExterne. Cette fonction permet de déclarer des sources de données qui seront utilisées dans les traitements de la procédure stockée. En effet, lorsqu'une procédure stockée est lancée depuis le centre de contrôle HFSQL, il n'y a pas d'analyse en cours et les données HFSQL Client/Serveur ne sont pas immédiatement accessibles.
     Si la fonction HDéclareExterne n'est pas utilisée dans le code de la procédure stockée, la procédure provoquera une erreur fatale, notée dans le journal des événements du système.
     Remarque : lorsqu'une procédure stockée est lancée depuis une application WINDEV, WEBDEV ou WINDEV Mobile avec la fonction HExécuteProcédure, elle utilise l'analyse de l'application et peut donc utiliser directement des données HFSQL Client/Serveur.
8. Définissez la fréquence de la tâche : mois, jour, heure.
9. Donnez une description à votre tâche planifiée et validez.
10. La tâche planifiée apparaît dans le Centre de Contrôle HFSQL.

Supprimer une tâche planifiée

1. Connectez-vous si nécessaire à un serveur HFSQL.
2. Double-cliquez sur le nom du serveur HFSQL dans l'arborescence.
3. La partie droite du Centre de Contrôle affiche un onglet au nom du serveur.
4. Cliquez sur l'onglet "Eléments planifiés".
5. Sélectionnez la tâche planifiée à supprimer.
6. Dans le ruban, dans le groupe "Eléments planifiés", cliquez sur "Supprimer".
   Vous pouvez également utiliser le menu contextuel de l'élément planifié (option "Supprimer").

Modifier une tâche planifiée

1. Connectez-vous si nécessaire à un serveur HFSQL.
2. Double-cliquez sur le nom du serveur HFSQL dans l'arborescence.
3. La partie droite du Centre de Contrôle affiche un onglet au nom du serveur.
4. Cliquez sur l'onglet "Eléments planifiés".
5. Sélectionnez la tâche planifiée à modifier.
6. Dans le ruban, dans le groupe "Eléments planifiés", cliquez sur "Editer".
   Vous pouvez également utiliser le menu contextuel de l'élément planifié (option "Editer").
7. Une fenêtre de description de l'élément planifié apparaît. Toutes les caractéristiques saisies dans l'assistant sont regroupées sur plusieurs onglets :
   • Onglet "Général" : Définit si la tâche est active et son type (sauvegarde ou procédure stockée).
   • Onglet "Planification" : Définit les options d'exécution de la tâche planifiée (mois, jour, heure, nombre d'exécutions, exécution au démarrage).
   • Onglets "Sauvegarde" : Ces deux onglets définissent les options prises en compte si la tâche planifiée correspond à une sauvegarde.
8. Validez.

1. Créez une variable de type hTâchePlanifiée. Spécifiez les différentes caractéristiques de la tâche planifiée grâce aux propriétés du type hTâchePlanifiée.
2. Ajoutez la tâche planifiée grâce à la fonction HAjouteTâche.

• le droit de gérer les tâches (constante hDroitGèreTâche).
• le droit d'exécuter la commande liée à la tâche planifiée.