Création d'un déclencheur de temps

1. Dans un dossier, accédez à Automatisations (Automations) > Déclencheurs (Triggers) et sur la page Déclencheurs (Triggers), cliquez sur Ajouter un nouveau déclencheur (Add a new trigger). La page Créer un déclencheur (Create Trigger) s'affiche.

2. Sélectionnez Heure (Time) comme type de déclencheur.

3. Dans le champ Nom (Name), ajoutez un nom pour le déclencheur afin de l'identifier facilement.

4. Dans le menu déroulant Nom du processus (Process Name ), sélectionnez le processus pour lequel vous souhaitez configurer un déclencheur temporel.

5. 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é.

6. From the Runtime type drop-down menu, select the runtime used to execute the jobs that are launched by the trigger.

7. 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. 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. 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	The process can be executed on specific account-machine pairs. Learn more about account-machine mappings. 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.

8. On the Arguments tab, provide values for input arguments if your process has any. More details about input and output arguments.

9. Dans le menu déroulant Fuseau horaire (Timezone), sélectionnez le fuseau horaire selon lequel le déclencheur doit être déclenché.

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

10. Sélectionnez la fréquence d'exécution du déclencheur (Minutes, Toutes les heures (Hourly), Tous les jours (Daily), Toutes les semaines (Weekly), Tous les mois (Monthly), Avancé (Advanced)). Dans la partie droite de cette section, configurez les détails en fonction de l'option choisie (fréquence, heure exacte ou expression 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.

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

    Important :

    The cron standard employed by our cron expressions uses a time system based on 60 minutes to an hour. This means that the only way it can execute a trigger at the exact interval configured in the Repeat every field is if the value of that interval is a divisor of 60. Otherwise, the recurrence will not entirely abide by the number of minutes in that field, thus causing execution discrepancies. To avoid this, we recommend adjusting your trigger settings or using event triggers.

    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.

    The reason why the fourth job starts after 18 minutes instead of 21 is that the cron component matches every 21^st item from a set of minutes between 1 and 59. In this example, these items are 00, 21, 42.

12. From the Non-working days restrictions drop-down menu, select a non-working days calendar, if you want your trigger to stop firing on certain non-business days. More details about non-working days.

13. 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)

    • Schedule automatic "Kill", if the job does not stop: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.

    Example: If you schedule to stop a Pending or Running job after 2 hours and also configure to kill the same job after 3 hours, the job will be killed after 5 hours. This happens because, first, the signal is sent to Orchestrator that the job was indeed stopped after 2 hours. Once the signal has been received, the kill job action is triggered to occur in 3 hours, thus resulting a total of 5 hours.

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

      

14. Turn on the Schedule automatic trigger disabling toggle, and enter the date and time when the trigger is to be disabled. The selected time zone selected influences when the time trigger gets disabled.

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

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

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.