Création d'un déclencheur de temps

Important : les déclencheurs de temps créés au moment de la conception à l'aide d'activités de déclencheur de temps peuvent être configurés davantage au moment de la création du processus, dans Orchestrator, car ces types de déclencheurs sont identifiés comme des exigences de package.

Consultez la section Gestion des exigences des packages > Ajout de déclencheurs de temps et de file d'attente (Managing package requirements > Adding time and queue triggers) pour en savoir plus.

1. Dans un dossier, accédez à Automatisations (Automations) > Déclencheurs (Triggers) et sur la page Déclencheurs de temps (Time Triggers), cliquez sur Ajouter un nouveau déclencheur (Add a new trigger). La page Créer un déclencheur (Create Trigger) s'affiche.
2. Dans le menu déroulant Nom du processus (Process Name), sélectionnez le processus pour lequel vous voulez configurer un déclencheur de temps.
3. Le champ Nom est prérempli avec le nom du processus, suivi du type de déclencheur au format <ProcessName>_<TriggerType>. Le nom du déclencheur peut cependant être modifié si vous le souhaitez.
4. Dans le menu déroulant Priorité de la tâche (Job Priority), sélectionnez la priorité de la tâche. La valeur par défaut est Inherited, ce qui signifie que la priorité de la tâche est la même que celle définie pour le processus sélectionné.
5. Dans le menu déroulant Licence de runtime (Runtime license), sélectionnez le runtime utilisé pour exécuter les tâches lancées par le déclencheur.
6. Dans l'onglet Cible d'exécution (Execution Target), sélectionnez le mécanisme d'affectation et la cible d'exécution de vos tâches.

   Description
   Allocation dynamique	Allouer dynamiquement L'allocation dynamique sans sélection explicite de compte et de machine vous permet d'exécuter plusieurs fois un processus de premier plan sous le compte et la machine qui deviennent disponibles en premier. Les processus d'arrière-plan sont exécutés sur n'importe quel compte, qu'il soit occupé ou non, tant que vous disposez de suffisamment de runtimes. À l'aide de l'option Allouer dynamiquement (Allocate Dynamically), vous pouvez exécuter un processus jusqu'à 10 000 fois dans une seule tâche.
   	Compte (Account) Le processus est exécuté sous un compte spécifique. Si vous spécifiez uniquement le compte, Orchestrator affectera dynamiquement la machine. Le fait de spécifier à la fois le compte et le modèle de machine signifie que la tâche se lance sur cette paire compte-machine spécifique.
   	Machine Le processus est exécuté sur l'une des machines hôtes associées au modèle de machine sélectionné. Si vous spécifiez uniquement le modèle de machine, Orchestrator affectera dynamiquement le compte. Le fait de spécifier à la fois le compte et le modèle de machine signifie que la tâche se lance sur cette paire compte-machine spécifique. Remarque : Assurez-vous que les licences de runtime requises pour exécuter la tâche sont affectées au modèle de machine associé.
   	Nom de l'hôte Après avoir sélectionné un modèle de machine, l'option Nom d'hôte (Hostname) s'affiche, vous permettant de sélectionner la session de poste de travail/Robot souhaitée pour exécuter le processus. Toutes les sessions disponibles dans le dossier actif sont affichées, qu'elles soient non connectées, déconnectées ou connectées. Remarque : Seuls des runtimes Unattended peuvent être utilisés pour configurer le mappage. Assurez-vous que les licences de runtime requises pour exécuter la tâche sont affectées au modèle de machine associé.
   Sélectionner des mappages compte-machine valides	Le processus peut être exécuté sur plusieurs paires utilisateur-machine. En savoir plus sur les mappages utilisateur-machine. Remarque : Un avertissement s'affiche lors de la sélection d'un nom d'hôte qui n'est pas actif (autrement dit, qui présente le statut Ne répond pas (Unresponsive) ou Déconnecté (Disconnected)). Les comptes faisant partie des mappages utilisés dans les déclencheurs ne peuvent pas être supprimés ou désaffectés du dossier dans lequel réside le déclencheur. Assurez-vous que le compte n'est pas défini comme cible d'exécution dans un déclencheur afin de pouvoir le supprimer.

   Remarque : Un avertissement s'affiche lors de la sélection d'un nom d'hôte qui n'est pas actif (autrement dit, qui présente le statut Ne répond pas (Unresponsive) ou Déconnecté (Disconnected)). Les tâches planifiées pour être exécutées par la session inactive restent à l'état En attente (Pending) jusqu'à ce que la connexion correspondante à Orchestrator soit établie.

   • Pour confirmer votre sélection du nom d'hôte inactif, cliquez sur Confirmer (Confirm).

   • Pour revenir en arrière et sélectionner un autre nom d'hôte, cliquez sur Annuler (Cancel).

   La configuration du même déclencheur avec le même mappage compte-machine, mais avec une sélection de nom d'hôte supplémentaire, double le nombre de tâches à exécuter.

   • Par exemple, supposons que vous ayez configuré un déclencheur T1 avec le compte A1 mappé au modèle de machine MT1. Des ensembles de 10 tâches sont mis en file d'attente pour exécution dans cette configuration.

     Puis, vous configurez le même déclencheur T1 avec le compte A1 mappé au modèle de machine MT1, tout en sélectionnant également un nom d'hôte H1. Les dix mêmes tâches sont à nouveau mises en file d'attente dans ce cas, car Orchestrator interprète la configuration comme étant nouvelle.

7. Dans l'onglet Arguments, fournissez des valeurs pour les arguments d'entrée, si votre processus en possède. Plus de détails sur les arguments d'entrée et de sortie.
8. Dans le menu déroulant Fuseau horaire (Timezone), sélectionnez le fuseau horaire en fonction duquel le déclencheur doit être activé.
   Remarque :

   • Le fuseau horaire du déclencheur ne dépend pas du fuseau horaire du locataire. Vous pouvez définir un fuseau horaire différent pour l'exécution de votre déclencheur horaire.
   • Les emplacements qui utilisent l'heure d'été (DST) sont répertoriés dans leur décalage UTC. Le décalage UTC n'est pas augmenté lorsque l'heure d'été (DST) est en vigueur. Par exemple, pendant la période de l'heure d'été, le fuseau horaire de Londres s'affiche sous la forme UTC+00:00.
   • Vous n'avez pas besoin d'ajuster le fuseau horaire pour prendre en compte l'heure d'été, car le mécanisme de planification d'Orchestrator le prend automatiquement en compte lors du lancement d'une tâche. Une tâche planifiée pour s'exécuter à 12 h 00 s'exécute à 12 h 00 en hiver et en été.
9. Sélectionnez la fréquence d’exécution du déclencheur. Les options disponibles sont les suivantes :
   • Minute par minute (Minute by minute) : choisissez le nombre de minutes qui doivent s’écouler entre les exécutions du déclencheur. Exemple : Toutes les 5 minutes.
   • Toutes les heures (Hourly) : choisissez le nombre d’heures qui doivent s’écouler entre les exécutions de déclencheur, ainsi que la minute qui doit marquer le début d’une nouvelle exécution. Exemple : Toutes les 2 heures à 20 minutes.
   • Quotidien (Daily) : choisissez le nombre de jours qui doivent s’écouler entre les exécutions de déclencheur, ainsi que l’heure à laquelle une nouvelle exécution doit démarrer. Exemple : tous les 4 jours à 12 h 30.
   • Hebdomadaire (Weekly) : choisissez le jour et l’heure spécifiques de la semaine où vous souhaitez que le déclencheur s’exécute. Exemple : le lundi à 11 h 45.
   • Mensuel (jour du mois) (Monthly (day of month)) : choisissez le nombre de mois qui doivent s’écouler entre les exécutions de déclencheur, ainsi que le jour et l’heure où une nouvelle exécution doit commencer. Exemple : tous les 2 mois à 11 h 30, le dernier jour ouvrable du mois.
   • Mensuel (jour de la semaine) (Monthly (day of week)) : choisissez le nombre de mois qui doivent s’écouler entre les exécutions de déclencheur, ainsi que le jour de la semaine et l’heure où une nouvelle exécution doit commencer. Exemple : tous les 2 mois à 11 h 30, tous les lundis.
   • Avancé (Advanced) : définir une expression Cron personnalisée. Pour plus de détails, consultez la page Utilisation d’expressions Cron .
   Orchestrator utilise une bibliothèque en open source pour analyser et afficher les descriptions Cron, qui sont disponibles ici.

   Remarque :

   Les expressions Cron peuvent être utilisées en combinaison avec les jours non ouvrables. Cela signifie que, si un déclencheur est configuré via une expression Cron pour s’exécuter un jour qui tombe à une date exclue, ce jour est ignoré et le déclencheur est replanifié au jour disponible suivant, et ainsi de suite.

10. Choisissez la fréquence en minutes à laquelle vous souhaitez que le déclencheur s’exécute.
    Important :

    La norme cron utilisée par nos expressions cron utilise un système de temps basé sur 60 minutes à une heure. Cela signifie que la seule façon d’exécuter un déclencheur à l’intervalle exact configuré dans le champ Répéter tous les (Repeat all) est si la valeur de cet intervalle est un diviseur de 60. Sinon, la récurrence ne respectera pas entièrement le nombre de minutes dans ce champ, ce qui entraînera des anomalies d’exécution. Pour éviter cela, nous vous recommandons d’ajuster les paramètres de vos déclencheurs ou d’utiliser des déclencheurs d’événement.

    Exemple : vous définissez un déclencheur à exécuter toutes les 21 minutes et vous démarrez une tâche à 09 h 00. Cela génère la planification d’exécution suivante :

    • La première tâche démarre à 09 h 00.
    • La deuxième tâche démarre à 09 h 21.
    • La troisième tâche démarre à 09 h 42.
    • La quatrième tâche démarre à 10 h 00.

    La raison pour laquelle la quatrième tâche démarre après 18 minutes au lieu de 21 est que le composant Cron correspond à tous les 21^e élément dans un ensemble de minutes compris entre 1 et 59. Dans cet exemple, ces éléments sont 00, 21 et 42.

11. Dans le menu déroulant Restrictions relatives aux jours non ouvrables (Non-Working Days Restrictions), sélectionnez un calendrier des jours non ouvrables si vous voulez que votre déclencheur arrête de s'activer certains jours non ouvrables. Plus de détails sur les jours non ouvrables.
12. Activez le bouton bascule Planifier la fin de l'exécution de la tâche pour sélectionner une stratégie de fin de tâche.
    Remarque :

    • Le délai spécifié ici expire en fonction des spécifications, même si la tâche est en file d'attente. Par exemple, si vous planifiez le lancement d'une tâche à 13 h et que vous la configurez pour qu'elle s'arrête après 20 minutes, la tâche s'arrête à 13 h 20, même si elle est restée dans une file d'attente jusqu'à 13 h 15, puis a démarré.
    • Les options Planifier la fin de l'exécution des tâches (Schedule ending of job execution) d'un déclencheur sont conservées pour les tâches démarrées manuellement.

    Supposons que vous ayez créé le déclencheur T1 et que vous ayez activé les planifications de fin de tâche suivants :

    • Planifier la fin de l'exécution de la tâche (Schedule ending of job execution) : Arrêter la tâche après 10 minutes (Stop a job after 10 mins)

    • Planifier l’arrêt forcé automatique si la tâche ne s’arrête pas (Schedule automatic "Kill", if the job does not stop) : Forcer l'arrêt de la tâche après 2 minutes (Kill job after 2 mins)

      Sur la page Automatisations (Automations) > Déclencheurs (Triggers), lorsque vous cliquez sur Démarrer une tâche maintenant (Start a Job Now) pour le déclencheur T1, la page Démarrer la tâche (Start Job) s'ouvre avec les planifications de fin de la tâche déjà appliqués, les mêmes que ceux que vous avez configurés lorsque vous avez créé le déclencheur.

    Exemple : si vous planifiez d'arrêter une tâche toujours en attente ou en cours d’exécution après 2 heures, et que vous configurez également l’arrêt forcé de la même tâche après 3 heures, l’arrêt de la tâche sera forcé après 5 heures au total. Cela se produit parce que le signal est d'abord envoyé à Orchestrator pour indiquer que la tâche a bien été arrêtée après 2 heures. Une fois le signal reçu, l'action d'arrêt forcé de la tâche ne doit se déclencher que 3 heures plus tard, soit un total de 5 heures.

    • Sélectionnez Arrêter dans la liste déroulante afin d’essayer de mettre fin normalement à l’exécution une fois l’intervalle de temps défini écoulé depuis que la tâche est bloquée dans l’état En attente (Pending) ou En cours d’exécution (Running) (définissez l’heure sur un minimum de 1 minute, et un maximum de 10 jours, 23 heures et 59 minutes) ;
      Exemple : Orchestrator tentera d’arrêter les tâches bloquées en attente (Pending) ou en cours d’exécution (Running) depuis au moins 10 minutes.

      

    • Sélectionnez Forcer l’arrêt dans la liste déroulante afin d’essayer de forcer l’arrêt de l’exécution une fois l’intervalle de temps défini écoulé depuis que la tâche est bloquée dans l’état En attente (Pending) ou En cours d’exécution (Running) (définissez l’heure sur un minimum de 1 minute, et un maximum de 10 jours, 23 heures et 59 minutes) ;

      Exemple : Orchestrator tentera de forcer l’arrêt des tâches bloquées en attente (Pending) ou en cours d’exécution (Running) depuis au moins 10 minutes.

    • Sélectionnez Arrêter dans la liste déroulante et activez l’option Forcer l’arrêt de la tâche si elle ne s’arrête pas afin de mettre fin normalement à l’exécution une fois l’intervalle de temps défini écoulé depuis que le travail est bloqué dans un état En attente (Pending) ou En cours d’exécution (Running), puis tenter d’en forcer l’arrêt une fois que l’intervalle de temps défini s’est écoulé depuis que le travail est bloqué dans un état En cours d’arrêt (Stopping) (définissez le temps sur un minimum de 1 minute, un maximum de 10 jours, 23 heures et 59 minutes).

      Exemple : Orchestrator tentera d’arrêter les tâches bloquées sur le statut En attente (Pending) ou En cours d’exécution (Running) pendant au moins 10 minutes. Si l’arrêt ne se produit pas, Orchestrator tentera de forcer l’arrêt des tâches en tentative d’arrêt depuis au moins 20 minutes.

13. Activez la bascule Planifier la désactivation automatique du déclencheur (Schedule automatic trigger disabling) et saisissez la date et l'heure auxquelles le déclencheur doit être désactivé. Le fuseau horaire sélectionné lorsque le déclencheur de temps est désactivé.
14. Activez la bascule Générer une alerte si la tâche est bloquée (dans le statut En attente ou Reprise) (Generate an alert if the job is stuck (in pending or resumed status)) et définissez la durée acceptable pendant laquelle la tâche doit rester dans le statut En attente ou Reprise. La durée minimale configurable est d'une minute. La durée maximale configurable est de onze jours. Si la tâche dépasse la durée configurée, une fenêtre contextuelle d'alerte de gravité « Erreur » vous en informe avec le texte suivant : « La tâche pour #process {process_number} est en attente/en cours d'exécution depuis plus de X heures et Y minutes. », où :
    • N : correspond au nombre de tâches qui ont déclenché l'alerte ;
    • {process_number} : l'identifiant du processus ;
    • X : le nombre d'heures configuré que la tâche a dépassée tout en ayant le statut en attente ou repris ; Les jours sont convertis en heures.
    • Y : le nombre configuré de minutes que la tâche a dépassé tout en ayant le statut En attente ou Reprise.
15. Activez la bascule Générer une alerte si la tâche a démarré et ne s'est pas terminée (Generate an alert if the job started and has not completed), et définissez la durée acceptable pour la tâche. La durée configurable est d'une minute au minimum et de onze jours au maximum. Si la tâche dépasse la durée configurée, une fenêtre contextuelle d'alerte de gravité « Erreur » vous en informe avec le texte suivant : « La tâche pour #process {process_number} est en attente/en cours d'exécution depuis plus de X heures et Y minutes. », Où :
    • {process_number} : l'identifiant du processus ;
    • X - le nombre d'heures configuré que la tâche a dépassé lors de sa tentative d'achèvement ; Les jours sont convertis en heures.
    • Y : le nombre configuré de minutes que la tâche a dépassé lors de sa tentative d'achèvement.
16. Activez le bouton Définir une désactivation du déclencheur basée sur l'exécution (Set execution-based trigger disabling) si vous souhaitez contrôler le moment où le déclencheur est désactivé une fois qu'une tâche échoue. Ce bouton révèle deux options :

    Option	Description
    Désactiver en cas d'échec d'exécutions de tâches consécutifs	Le déclencheur est désactivé après le nombre d'exécutions échouées que vous choisissez pour ce paramètre. Vous pouvez choisir une valeur comprise entre 0 et 100. La valeur par défaut est 0, ce qui signifie que le déclencheur n'est jamais désactivé. Les tâches arrêtées ne sont pas prises en compte dans cette valeur.
    Délai de grâce lors de la désactivation du déclencheur (jours)	Nombre de jours à attendre avant la désactivation du déclencheur après le premier échec d'une tâche. Vous pouvez choisir une valeur comprise entre 0 et 30. La valeur par défaut est de 0, ce qui signifie que le déclencheur est désactivé dès que le nombre d’exécutions de tâches défini dans le champ ci-dessus est atteint pour la journée en cours.

    Remarque :

    Si vous utilisez le plan de licence Community et que vous choisissez un runtime Cloud - Serverless pour le processus sous-jacent, l’option Définir une désactivation du déclencheur basée sur l’exécution, est automatiquement désactivée, avec les valeurs par défaut suivantes (les champs sont en lecture seule) :

    • Désactiver en cas d’échec d’exécutions de tâches consécutifs est défini sur 10.

    • Délai de grâce lors de la désactivation du déclencheur (jours) est défini sur 0.

17. Pour conserver le même contexte compte-machine configuré pour démarrer la tâche, cochez la case Conserver l'allocation de compte/machine à la reprise de la tâche . Cela optimise votre utilisation des licences et des ressources.