PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Présentation
  • Tâches différées
  • Présentation
  • Mise en place via l'éditeur de code
  • Mise en place par programmation
  • Tâches planifiées
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Présentation
WEBDEV permet de mettre en place des tâches directement sur le serveur : chaque tâche est une procédure WLangage serveur.
Les tâches différées permettent de déporter des traitements qui prennent du temps sur le serveur d'application WEBDEV. Par exemple, l'envoi d'un email ou le calcul de statistiques.
Les tâches planifiées permettent d'exécuter de façon régulière une opération donnée. Par exemple, l'envoi d'un mailing sur les promotions en cours.
Remarques :
  • Les tâches planifiées et les tâches différées correspondent à des procédures Serveur.
  • La mise en place de ces fonctionnalités nécessite un serveur d'application WEBDEV en version 180046 ou supérieure.
  • Versions 22 et supérieures
    Le nombre de tâches planifiées associées à un site ou à un Webservice peuvent être visualisé dans l'administrateur WEBDEV (administrateur local ou distant).
    Nouveauté 22
    Le nombre de tâches planifiées associées à un site ou à un Webservice peuvent être visualisé dans l'administrateur WEBDEV (administrateur local ou distant).
    Le nombre de tâches planifiées associées à un site ou à un Webservice peuvent être visualisé dans l'administrateur WEBDEV (administrateur local ou distant).
  • Versions 22 et supérieures
    Il est possible de gérer les tâches planifiées depuis l'administrateur WEBDEV (local ou distant).
    Nouveauté 22
    Il est possible de gérer les tâches planifiées depuis l'administrateur WEBDEV (local ou distant).
    Il est possible de gérer les tâches planifiées depuis l'administrateur WEBDEV (local ou distant).
  • Versions 22 et supérieures
    Les tâches planifiées peuvent être définies par programmation.
    Nouveauté 22
    Les tâches planifiées peuvent être définies par programmation.
    Les tâches planifiées peuvent être définies par programmation.
Tâches différées

Présentation

Exemple de tâche différée : Quant l'internaute valide sa réservation, un email de confirmation lui est envoyé. L'envoi réel de l'email est effectué en différé sur le serveur. L'internaute n'est pas bloqué pendant l'envoi.

Mise en place via l'éditeur de code

Pour mettre en place une tâche différée dans un site WEBDEV :
  1. Affichez sous l'éditeur de code la procédure serveur à exécuter en différé.
  2. Cliquez sur l'icône dans le bandeau de l'éditeur de code.
    Remarque : Il est également possible d'effectuer une des manipulations suivantes :
    • Sélectionner l'option "Paramétrer les automatismes de la procédure" dans le menu contextuel de la procédure (volet "Explorateur de projet").
    • Sélectionner l'option "Propriétés" du menu contextuel de la procédure dans le volet "Code".
    Attention :
    • Les procédures multi-syntaxes ne peuvent pas être différées.
    • Il n'est pas possible d'ajouter une syntaxe à une procédure différée.
  3. Dans la fenêtre de configuration de l'automatisme de la procédure, sélectionnez "Tâche différée (WEBDEV)" et configurez les différents paramètres de la tâche différée : Dans la fenêtre de configuration de l'automatisme de la procédure, sélectionnez "Tâche WEBDEV", puis "Tâche différée" et configurez les différents paramètres de la tâche différée :
    • Utilisation ou non du contexte HyperFileSQL en cours. Utilisation ou non du contexte HFSQL en cours.
    • Durée maximale d'exécution.
  4. Validez.
  5. Pour lancer l'exécution de la procédure différée dans votre projet :
    • soit utilisez la fonction ExécuteProcédureDifférée.
    • soit saisissez directement le nom de la fonction : une icône spécifique apparaît à coté du nom de la fonction :
    Remarque : La fonction EnModeProcédureDifférée permet de savoir si la procédure en cours est exécutée en mode différée ou non.
  6. Lors du prochain déploiement du site, la tâche différée pourra être exécutée sur le serveur.
Remarque : Il est possible de limiter la durée d'exécution des tâches planifiées ou différées : dans l'administrateur WEBDEV, dans l'onglet "Configuration", spécifiez la durée maximum d'une tâche. Si les tâches utilisées dépassent cette durée, elles seront automatiquement arrêtées. Cette durée peut également être configurée pour les tâches d'un site spécifique (onglet "Sites", bouton "Paramètres") ou pour les tâches d'un Webservice spécifique (onglet "Webservices", bouton "Paramètres").
Versions 22 et supérieures

Mise en place par programmation

WEBDEV propose de définir les procédures différées dynamiquement par programmation à l'aide de la famille de fonctions ServeurApplixxx.
La mise en place est simple. Vous devez :
  1. Définir les caractéristiques de la tâche planifiée grâce à une variable de type serveurAppliTâchePlanifiée.
  2. Ajouter la tâche planifiée avec la fonction ServeurAppliAjouteTâchePlanifiée.
  3. Différentes fonctions permettent ensuite de manipuler les tâches planifiées :
    Versions 22 et supérieures
    ServeurAppliExécuteTâchePlanifiée
    ServeurAppliExécuteTâchePlanifiée
    Lance immédiatement l'exécution d'une tâche planifiée sur un Serveur d'Application WEBDEV.
    Versions 22 et supérieures
    ServeurAppliInfoTâchePlanifiée
    ServeurAppliInfoTâchePlanifiée
    Lit la description d'une tâche planifiée.
    Versions 22 et supérieures
    ServeurAppliListeTâchePlanifiée
    ServeurAppliListeTâchePlanifiée
    Renvoie la liste des tâches planifiées de l'application (site ou Webservice).
    Versions 22 et supérieures
    ServeurAppliModifieTâchePlanifiée
    ServeurAppliModifieTâchePlanifiée
    Modifie une tâche planifiée existante.
    Versions 22 et supérieures
    ServeurAppliSupprimeTâchePlanifiée
    ServeurAppliSupprimeTâchePlanifiée
    Supprime une tâche planifiée associée à l'application (site ou Webservice).
Nouveauté 22

Mise en place par programmation

WEBDEV propose de définir les procédures différées dynamiquement par programmation à l'aide de la famille de fonctions ServeurApplixxx.
La mise en place est simple. Vous devez :
  1. Définir les caractéristiques de la tâche planifiée grâce à une variable de type serveurAppliTâchePlanifiée.
  2. Ajouter la tâche planifiée avec la fonction ServeurAppliAjouteTâchePlanifiée.
  3. Différentes fonctions permettent ensuite de manipuler les tâches planifiées :
    Versions 22 et supérieures
    ServeurAppliExécuteTâchePlanifiée
    ServeurAppliExécuteTâchePlanifiée
    Lance immédiatement l'exécution d'une tâche planifiée sur un Serveur d'Application WEBDEV.
    Versions 22 et supérieures
    ServeurAppliInfoTâchePlanifiée
    ServeurAppliInfoTâchePlanifiée
    Lit la description d'une tâche planifiée.
    Versions 22 et supérieures
    ServeurAppliListeTâchePlanifiée
    ServeurAppliListeTâchePlanifiée
    Renvoie la liste des tâches planifiées de l'application (site ou Webservice).
    Versions 22 et supérieures
    ServeurAppliModifieTâchePlanifiée
    ServeurAppliModifieTâchePlanifiée
    Modifie une tâche planifiée existante.
    Versions 22 et supérieures
    ServeurAppliSupprimeTâchePlanifiée
    ServeurAppliSupprimeTâchePlanifiée
    Supprime une tâche planifiée associée à l'application (site ou Webservice).

Mise en place par programmation

WEBDEV propose de définir les procédures différées dynamiquement par programmation à l'aide de la famille de fonctions ServeurApplixxx.
La mise en place est simple. Vous devez :
  1. Définir les caractéristiques de la tâche planifiée grâce à une variable de type serveurAppliTâchePlanifiée.
  2. Ajouter la tâche planifiée avec la fonction ServeurAppliAjouteTâchePlanifiée.
  3. Différentes fonctions permettent ensuite de manipuler les tâches planifiées :
    Versions 22 et supérieures
    ServeurAppliExécuteTâchePlanifiée
    ServeurAppliExécuteTâchePlanifiée
    Lance immédiatement l'exécution d'une tâche planifiée sur un Serveur d'Application WEBDEV.
    Versions 22 et supérieures
    ServeurAppliInfoTâchePlanifiée
    ServeurAppliInfoTâchePlanifiée
    Lit la description d'une tâche planifiée.
    Versions 22 et supérieures
    ServeurAppliListeTâchePlanifiée
    ServeurAppliListeTâchePlanifiée
    Renvoie la liste des tâches planifiées de l'application (site ou Webservice).
    Versions 22 et supérieures
    ServeurAppliModifieTâchePlanifiée
    ServeurAppliModifieTâchePlanifiée
    Modifie une tâche planifiée existante.
    Versions 22 et supérieures
    ServeurAppliSupprimeTâchePlanifiée
    ServeurAppliSupprimeTâchePlanifiée
    Supprime une tâche planifiée associée à l'application (site ou Webservice).
Tâches planifiées
Exemple de tâche planifiée : Tous les jours de la semaine, à 3 heures du matin, un email de relance est envoyé aux clients qui n'ont pas confirmé leur réservation.
Pour mettre en place une tâche planifiée dans un site WEBDEV :
  1. Affichez sous l'éditeur de code la procédure serveur à planifier.
  2. Cliquez sur l'icône dans le bandeau de l'éditeur de code.
    Remarque : Il est également possible d'effectuer une des manipulations suivantes :
    • Sélectionner l'option "Paramétrer les automatismes de la procédure" dans le menu contextuel de la procédure (volet "Explorateur de projet").
    • Sélectionner l'option "Propriétés" du menu contextuel de la procédure dans le volet "Code".
  3. Attention :
    • Les procédures multi-syntaxes ne peuvent pas être planifiées.
    • Il n'est pas possible d'ajouter une syntaxe à une procédure planifiée.
  4. Dans la fenêtre de configuration de l'automatisme de la procédure, sélectionnez "Tâche planifiée (WEBDEV)" et configurez les différents paramètres de la planification :
    • Mois d'exécution.
    • Jour d'exécution.
    • Heure d'exécution.
    • Durée maximale d'exécution.
    Dans la fenêtre de configuration de l'automatisme de la procédure, sélectionnez "Tâches WEBDEV", puis Tâche planifiée" et configurez les différents paramètres de la planification :
    • Mois d'exécution.
    • Jour d'exécution.
    • Heure d'exécution.
    • Durée maximale d'exécution.
  5. Validez.
  6. Lors du prochain déploiement du site, la tâche planifiée sera exécutée sur le serveur selon les paramètres de planification indiqués.
Remarque : Il est possible de limiter la durée d'exécution des tâches planifiées ou différées : dans l'administrateur WEBDEV, dans l'onglet "Configuration", spécifiez la durée maximum d'une tâche. Si les tâches utilisées dépassent cette durée, elles seront automatiquement arrêtées. Cette durée peut également être configurée pour les tâches d'un site spécifique (onglet "Sites", bouton "Paramètres") ou pour les tâches d'un Webservice spécifique (onglet "Webservices", bouton "Paramètres").
Version minimum requise
  • Version 18
Commentaires
Durée maximale d'exécution
Attention, malgré la possibilité de mettre en place une durée maximale d'exécution sur les tâches différées, celles-ci sont tout de même limitées par la valeur pour "Déconnecter les utilisateurs inactifs depuis: [...]"

Ainsi si votre tâche dure plus longtemps que la durée maximale inscrite pour une session, celle-ci sera coupée en pleine exécution.
Benjamin
22 aoû. 2019
Comment tester
Comment tester cette fonctionnalité sur un poste avec l'éditeur Webdev 22 ?

Dans un projet avec des tâches planifiées définies sii on fait GO sur le projet, le bouton "Tâches planifiées" est grisé dans l'administrateur Webdev et les tâches planifiées ne s'exécutent apparemment pas.
LofteurUpAndDown
07 mar. 2017