• 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 et affichez la description du serveur ou d'une de ses bases (double-clic sur le nom du serveur ou de la base dans l'arborescence).
2. Cliquez sur l'onglet "Eléments planifiés".
3. Dans le ruban, dans le groupe "Eléments planifiés", déroulez "Nouvelle planification" et sélectionnez "Planifier une tâche". L'assistant de création d'une tâche planifiée se lance.
4. 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.
5. 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.
6. Définissez la fréquence de la tâche : mois, jour, heure.
7. Donnez une description à votre tâche planifiée et validez l'assistant.
8. La tâche planifiée apparaît dans l'onglet "Eléments planifiés" du Centre de Contrôle HFSQL.

Supprimer une tâche planifiée

1. Connectez-vous si nécessaire à un serveur HFSQL et affichez l'onglet du serveur ou de la base de données voulu.
2. Cliquez sur l'onglet "Eléments planifiés".
3. Sélectionnez la tâche planifiée à supprimer.
4. 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 et affichez l'onglet du serveur ou de la base de données voulu.
2. Cliquez sur l'onglet "Eléments planifiés".
3. Sélectionnez la tâche planifiée à modifier.
4. 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").
5. 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).
   • Nouveauté 2025
     Onglet "Historique des exécutions" : Cet onglet apparaît lorsque la tâche planifiée a été exécutée automatiquement. Cet onglet liste les différentes exécutions automatiques de la tâche planifiée, en indiquant :

     • la date de début de la tâche,
     • l'état de la tache : terminée, en cours, en erreur,
     • la durée d'exécution,
     • l'utilisateur qui a lancé la tâche,
     • si le lancement a été fait manuellement (lancement via la fonction HExécutePlanification).
6. Validez.

Création d'une tâche planifiée

1. Créez une variable de type hTâchePlanifiée et décrivez les différentes caractéristiques de la tâche planifiée.
2. Ajoutez la tâche planifiée grâce à la fonction HAjoutePlanification (ou la fonction HAjouteTâche).

• Pour ajouter une tâche planifiée, il est nécessaire de posséder :
  • 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.
• La tâche sera exécutée avec l'identité de l'utilisateur défini par la connexion.
• Par compatibilité, il est également possible de créer une tâche planifiée permettant la sauvegarde de la base. Il est cependant conseillé de créer une sauvegarde planifiée. Pour plus de détails, consultez Comment sauvegarder des bases de données HFSQL Client/Serveur ?.

Manipulation des tâches planifiées en WLangage

• les fonctions de gestion des tâches planifiées :
  

  HAjouteTâche	Ajoute une tâche planifiée sur le serveur défini par la connexion.
  HGèreTâche	Active ou désactive une tâche planifiée d'un serveur HFSQL Client/Serveur.
  HInfoTâche	Renvoie les caractéristiques d'une tâche planifiée dans une variable de type hTâchePlanifiée.
  HListeTâche	Liste les tâches planifiées d'un serveur HFSQL Client/Serveur pour une connexion donnée.
  HModifieTâche	Modifie une tâche planifiée sur le serveur HFSQL défini par la connexion.
  HSupprimeTâche	Supprime une tâche planifiée d'un serveur HFSQL Client/Serveur.
• les fonctions de gestion des éléments planifiés (conseillées) :
  

  HAjoutePlanification	Ajoute un nouvel élément planifié sur un serveur HFSQL : tâche planifiée (procédure stockée), sauvegarde, optimisation ou rafraîchissement d'une vue matérialisée.
  HExécutePlanification	Exécute immédiatement un élément planifié sans tenir compte de sa planification : tâche planifiée (procédure stockée), sauvegarde, optimisation, rafraîchissement d'une vue matérialisée.
  HListePlanification	Liste les éléments planifiés définis sur un serveur HFSQL : tâches planifiées (procédure stockée), sauvegarde, optimisation, rafraîchissement d'une vue matérialisée.
  HModifiePlanification	Modifie un élément planifié sur un serveur HFSQL : tâche planifiée (procédure stockée), sauvegarde, optimisation, rafraîchissement d'une vue matérialisée.
  HSupprimePlanification	Supprime un élément planifié sur un serveur HFSQL : tâche planifiée (procédure stockée), sauvegarde, optimisation, rafraîchissement d'une vue matérialisée.