Activité du workflow du minuteur

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 5 minutes de lecture
  • L’activité de minuteur suspend le workflow pendant une période donnée.

    Cette durée peut être une valeur de temps absolue ou une valeur relative basée sur une création et une utilisation de calendriers définis. Il est préférable d’ajuster la durée afin que le workflow puisse progresser en temps voulu. Pour interrompre indéfiniment un workflow jusqu’à ce qu’une condition soit remplie, voir Attendre une condition.
    Remarque :
    Les activités du minuteur s’exécutent en tant qu’utilisateur système, car le planificateur système fait avancer le workflow.

    Résultats

    Tableau 1. Résultats d’activité du minuteur
    Résultat Description
    Terminé L’activité a atteint avec succès la durée spécifiée.
    Annulé L’activité ou le workflow a été annulé avant que le minuteur n’atteigne la durée spécifiée.

    Variables d’entrée

    Les variables d'entrée déterminent le comportement initial de l'activité.

    Tableau 2. Variables d’entrée de l’activité du minuteur
    Champ Description
    Informations sur le minuteur
    Minuteur basé sur Comment la durée du minuteur est calculée. Les options sont les suivantes :
    • Durée spécifiée par l’utilisateur : La durée est basée sur les champs de durée , tels que les jours et les heures.
    • Durée relative : La durée est basée sur les champs Durée relative (comme la fin du jour ouvrable suivant) et Attente .
    • Champ de date/heure ou de durée : La durée est basée sur la valeur du champ et le champ Attente .
    • Script: La durée est basée sur un script qui renvoie le nombre de secondes.
    Durée

    S’affiche uniquement lorsque le minuteur basé sur a la valeur Une durée spécifiée par l’utilisateur.

    Nombre spécifique de jours et d’heures à attendre avant de passer à l’activité suivante du workflow.
    Durée relative

    Apparaît uniquement lorsque le minuteur basé sur a la valeur Une durée relative

    Nombre général et durée des jours ouvrables à attendre avant de passer à l’activité de workflow suivante. .
    Attente

    S’affiche uniquement lorsque le minuteur basé sur a la valeur Une durée relative ou un champ de date/heure ou de durée.

    Ajustement du minuteur supplémentaire lorsque l’option Minuteur basé sur a la valeur Une durée relative ou un champ Date/heure ou Durée. Les options sont les suivantes :
    • La durée complète : Aucune modification de la durée calculée.
    • Un % de la durée : La durée est ajustée en multipliant le nombre de secondes par le (Pourcentage / 100).
    • Quelque temps auparavant : La durée est raccourcie par le temps avant jours et heures.
    • Quelque temps après : La durée est allongée par le délai après jours et heures.
    Pourcentage

    S’affiche uniquement lorsque le minuteur basé sur a la valeur Une durée relative ou un champ de date/heure ou de durée.

    Valeur du pourcentage d’attente lorsque le minuteur basé sur a la valeur Une durée relative ou un champ Date/heure ou Durée.
    Temps avant

    S’affiche uniquement lorsque le minuteur basé sur a la valeur Une durée relative ou un champ Date/heure ou Durée et Attendre est Un peu avant.

    Valeur de durée du modificateur lorsque l’option Attendre est Un peu avant.
    Temps après

    S’affiche uniquement lorsque le minuteur basé sur a la valeur Une durée relative ou un champ Date/heure ou Durée et Attendre est un certain temps après.

    Valeur de temps du modificateur lorsque l’option Attendre est Un peu après.
    Champ

    S’affiche uniquement lorsque Minuteur basé sur a la valeur Un champ de date/heure ou de durée.

    Champ date/heure ou durée qui contient le temps d’attente écoulé avant de passer à l’activité de workflow suivante.
    Script

    Apparaît uniquement lorsque le minuteur basé sur est un script

    Script qui définit « réponse » sur le nombre de secondes de la durée.
    Calendrier du minuteur
    Calendrier basé sur Calendrier de base que le minuteur utilise pour compter les heures de travail. Si une planification est spécifiée, la durée sera prise en considération uniquement pour les heures spécifiées dans la planification. Par exemple, si la durée est de 2 heures et que le workflow commence à 16h00 selon un calendrier allant de 8h à 17h00, il se termine à 9h00 le lendemain. Les options sont les suivantes :
    • Planification de ce workflow : La planification utilise la date et l’heure du contexte du workflow, ainsi qu’un fuseau horaire facultatif basé sur la valeur.
    • Un calendrier spécifique : Le calendrier utilise une planification prédéfinie et un fuseau horaire facultatif basé sur la valeur.
    • Champ de planification : Le calendrier utilise une valeur provenant d’une table et un fuseau horaire facultatif basé sur la valeur.
    Calendrier

    S’affiche uniquement lorsque Calendrier basé sur a la valeur d’un calendrier spécifique.

    La planification prédéfinie à partir d’une liste.
    Champ de calendrier

    S’affiche uniquement lorsque Calendrier basé sur a la valeur Un champ de calendrier.

    Champ de date et heure ou de durée pour le calendrier associé à la table. Les champs valides apparaissent en bleu dans la boîte de dialogue Sélectionner l’élément dans une arborescence.
    Fuseau horaire du minuteur
    Fuseau horaire basé sur Fuseau horaire pour le calcul de la durée. Le fuseau horaire peut être basé sur :
    • Aucun fuseau horaire : Faire défaut. Le workflow utilise le fuseau horaire GMT.
    • Fuseau horaire spécifique :Fuseau horaire prédéfini.
    • Champ de fuseau horaire :Champ de fuseau horaire pour suivre la durée d’un champ sur le formulaire.
    Fuseau horaire

    S’affiche uniquement lorsque l’option Fuseau horaire basé sur a la valeur Un fuseau horaire spécifique.

    Fuseau horaire prédéfini.
    Champ de fuseau horaire

    S’affiche uniquement lorsque l’option Fuseau horaire basé sur a la valeur Un champ de fuseau horaire.

    Champ de date et heure ou de durée pour le calendrier associé à la table. Les champs valides apparaissent en bleu dans la boîte de dialogue Sélectionner l’élément dans une arborescence.

    États

    L’état de l’activité indique au moteur de workflow ce qu’il doit faire de l’activité.

    Tableau 3. États des activités du minuteur
    État Description
    Exécution L’activité du minuteur est dans cet état très brièvement lors de l’initialisation, après quoi elle passe immédiatement en attente.
    En attente Le moteur de workflow attend que le minuteur atteigne la durée spécifiée. Le moteur fait ensuite passer le workflow à l’activité suivante.
    Terminé L'activité s'est terminée. Affichez la valeur de résultat pour connaître le résultat de l'activité.
    Annulé Cette activité, ou le workflow qui contient cette activité, a été annulée.
    Erreur Une erreur JavaScript s’est produite. Examinez les journaux pour connaître les détails de l'erreur.

    Exemple

    Vous pouvez utiliser une activité de minuteur pour mettre en pause le workflow jusqu’à la fin de la journée ouvrable.

    Figure 1. Exemple de minuteur

    Dans cet exemple, le script évalue le délai entre la variable now et la variable EOD . La variable EOD est définie, dans une période de 24 heures, comme étant 16h00. Le script définit ensuite la variable de réponse à la différence entre ces variables, en quelques secondes, et consigne un message.

    // get now and calc end of day (4:00pm)
     
    var now =new Date();
     
    var eod =new Date();
    eod.setHours(16);
    eod.setMinutes(0);
    eod.setSeconds(0);
     
    answer =(eod.getTime()- now.getTime())/1000;
     
    workflow.debug('Timer will fire @: '+ eod +'  '+(answer/60)+' minutes from now');