Activité du workflow du minuteur

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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éfinies. Il est préférable d’ajuster la durée afin que le workflow puisse progresser en temps opportun. Pour mettre en pause un workflow indéfiniment jusqu’à ce qu’une condition soit remplie, reportez-vous à la section 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 de l’activité du minuteur
    Résultat Description
    Terminé L’activité a atteint 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 d’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 Durée , tels que les jours et les heures.
    • Durée relative : La durée est basée sur les champs Durée relative (par exemple, Fin du jour ouvrable suivant) et Attendre .
    • Un champ de date/heure ou de durée : La durée est basée sur la valeur Champ et le champ Attendre .
    • 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 est 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

    S’affiche uniquement lorsque le minuteur basé sur a la valeur d’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 d’une durée relative ou d’un champ de date/heure ou de durée.

    Ajustement du minuteur supplémentaire lorsque le minuteur basé sur a la valeur d’une durée relative ou d’un champ de date/heure ou de durée. Les options sont les suivantes :
    • La durée entière : 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 avant : La durée est raccourcie par le Temps avant les jours et les heures.
    • Quelque temps après : La durée est allongée par le Temps après les jours et les heures.
    Pourcentage

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

    Valeur du pourcentage d’attente lorsque la minuteur est basée sur a la valeur d’une durée relative ou d’un champ de date/heure ou de durée.
    Temps avant

    S’affiche uniquement lorsque le minuteur basé sur a la valeur d’un champ de durée relative ou d’une date/heure ou d’une durée et que l’attente est un peu avant.

    La valeur du temps du modificateur lorsque l’option Attendre a la valeur Un peu avant.
    Temps après

    S’affiche uniquement lorsque l’option Minuteur basé sur a la valeur Un champ de durée relative ou de date/heure ou de durée et que l’Attente 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 le minuteur basé sur est un champ de date/heure ou de durée.

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

    S’affiche 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 un calendrier est spécifié, la durée ne sera prise en compte que pour les heures spécifiées dans le calendrier. Par exemple, si la durée est de 2 heures et que le workflow commence à 16h00 selon un calendrier de 8h00 à 17h00, il se termine à 9h00 le lendemain. Les options sont les suivantes :
    • Planification de ce workflow : Le calendrier utilise la date, l’heure et un fuseau horaire de contexte de workflow 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.
    • Un champ de planification : Le calendrier utilise une valeur d’une table et un fuseau horaire facultatif basé sur la valeur.
    Calendrier

    S’affiche uniquement lorsque l’option 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 l’option Calendrier basé sur a la valeur Un champ de calendrier.

    Un champ de date et heure ou de durée pour le calendrier, qui est 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.
    • Un fuseau horaire spécifique :Fuseau horaire prédéfini.
    • Champ de fuseau horaire : Un champ de fuseau horaire pour suivre la durée à partir 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.

    Le 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.

    Un champ de date et heure ou de durée pour le calendrier, qui est 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 avec l’activité.

    Tableau 3. États d’activité 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 transfère ensuite 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 un délai de 24 heures, comme 16h00. Le script définit ensuite la variable de réponse sur la différence entre ces variables, en 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');