Activité de workflow du minuteur

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 5 minutes de lecture
  • L’activité Minuteur suspend le workflow pendant une période spécifié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 pendant une période indéterminée 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 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 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 .
    • 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 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

    S’affiche 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 l’option Minuteur basé sur a la valeur Une durée relative ou un champ de date/heure ou de durée.

    Réglage de minuteur supplémentaire lorsque l’option Minuteur basé sur a la valeur Une durée relative ou un champ de date/heure ou de durée. Les options sont les suivantes :
    • La durée complète : Pas de 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 (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 heures.
    Pourcentage

    S’affiche uniquement lorsque l’option 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 quand l’option Minuteur basé sur a la valeur Une durée relative ou un champ de date/heure ou de durée.
    Temps avant

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

    La valeur temporelle du modificateur lorsque Wait a la valeur Un peu avant.
    Temps après

    S’affiche uniquement lorsque l’option Minuteur basé sur a la valeur d’une durée relative ou d’un champ de date/heure ou de durée et que l’option Attendre est un peu après.

    La valeur de temps du modificateur lorsque Wait est Some time after.
    Champ

    S’affiche uniquement lorsque l’option Minuteur basé sur a la valeur 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 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 utilisé par le minuteur pour compter les heures de travail. Si un calendrier est spécifié, la durée sera prise en compte uniquement 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 planning (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 facultatif de contexte de workflow basé sur la valeur.
    • Planification 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 l’option Calendrier basé sur a la valeur Un calendrier spécifique.

    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.

    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 utilisé pour le calcul de la durée. Le fuseau horaire peut être basé sur :
    • Aucun fuseau horaire : Par défaut. Le workflow utilise le fuseau horaire GMT.
    • 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 du 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 faut 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 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 de travail.

    Figure 1. Exemple de minuteur

    Dans cet exemple, le script évalue le temps écoulé entre la variable now et la variable eod . La variable EOD est définie dans 24 heures comme étant 16 :00. 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');