Création de déclencheurs d'événements

Dans le cas des déclencheurs d'événements connectés, vous créez le déclencheur lors de la conception, dans Studio. Vous pouvez ensuite configurer le déclencheur dans Orchestrator lorsque vous déployez le processus auquel il est associé. Pour de plus amples informations, consultez la section Configurer les déclencheurs d'événements connectés.

Dans le cas des déclencheurs d'événements déconnectés, vous créez le déclencheur dans Orchestrator.

Créer un déclencheur d'événement déconnecté

Pour créer un déclencheur d'événement déconnecté, procédez comme suit :

1. Dans le contexte du dossier, accédez à Automations (Automatisations), puis sélectionnez Triggers (Déclencheurs).
2. Sélectionnez Event Triggers (Déclencheurs d'événements), puis +Add a new trigger (Ajouter un nouveau déclencheur).
3. Dans la fenêtre Add Event Trigger (Ajouter un déclencheur d'événement), sur la page General details (Détails généraux), donnez un nom unique à votre déclencheur dans le champ Name (Nom).
4. Dans le menu déroulant Process (Processus), sélectionnez le processus pour lequel vous souhaitez créer le déclencheur.
5. Dans le menu déroulant Job Priority (Priorité de la tâche), sélectionnez la priorité de la tâche. La valeur par défaut est Inherited (Héritée), ce qui signifie que la priorité de la tâche est la même que celle définie pour le processus sélectionné.
6. Dans la liste déroulante Runtime type (Type de runtime), sélectionnez le runtime qui doit exécuter les tâches que lance le déclencheur.
7. Dans la section Execution Target (Cible de l'exécution), sélectionnez le mécanisme d'affectation et la cible de l'exécution de vos tâches.

   Option	Description
   Compte (Account)	Le processus est exécuté sous un compte spécifique. Si vous spécifiez uniquement le compte, Orchestrator affecte la machine de manière dynamique. La spécification simultanée du compte et du modèle de machine signifie que la tâche se lance sur cette paire compte-machine spécifique.
   Machine	Le processus s'exécute 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 affecte le compte de manière dynamique. La spécification simultanée du compte et du modèle de machine signifie que la tâche se lance sur cette paire compte-machine spécifique. Remarque : veillez à affecter au modèle de machine associé les licences de runtime nécessaires pour exécuter la tâche.
   Nom de l'hôte	Après avoir sélectionné un modèle de machine, l'option Hostname (Nom d'hôte) s'affiche, ce qui vous permet de sélectionner la station de travail ou la session de robot souhaitée pour exécuter le processus. Toutes les sessions disponibles dans le dossier actif s'affichent, qu'elles soient non connectées, déconnectées ou connectées. Remarque : vous ne pouvez utiliser que des runtimes sans assistance pour configurer le mappage. Veillez à affecter au modèle de machine associé les licences de runtime nécessaires pour exécuter la tâche.

   Remarque :

   Un avertissement s'affiche lorsque vous sélectionnez un nom d'hôte dont le statut est Unresponsive ou Disconnected . Les tâches qui doivent être exécutées par une session inactive restent dans l'état Pending jusqu'à ce que la connexion correspondante à Orchestrator soit rétablie. Dans ce scénario, effectuez l'une des actions suivantes :

   • 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 ou Any connected machine (Toute machine connectée), sélectionnez Cancel (Annuler). La configuration du même déclencheur avec le même mappage compte-machine, mais en sélectionnant un nom d'hôte supplémentaire, double le nombre de tâches à exécuter. Par exemple, vous configurez le déclencheur D1 avec le compte C1 mappé au modèle de machine MM1. Dix tâches sont mises dans la file d'attente dans cette configuration. Plus tard, vous configurez le même déclencheur D1 avec le compte C1 mappé au modèle de machine MM1, mais vous sélectionnez également le nom d'hôte H1. Les dix mêmes tâches sont à nouveau mises dans la file d'attente de ce cas, car Orchestrator interprète la configuration comme nouvelle.
   8. Dans la section Runtime Arguments (Arguments de runtime), sélectionnez le point d'entrée à utiliser pour l'exécution de la tâche dans le menu déroulant Entry point (Point d'entrée). Pour de plus amples informations, consultez la section Points d'entrée.
   9. Si votre processus comporte des arguments d'entrée, fournissez-leur les valeurs appropriées. Pour de plus amples informations, consultez la section À propos des arguments d'entrée et de sortie.
   10. Pour sélectionner une stratégie de fin de tâche, activez la bascule Schedule ending of job execution (Planifier la fin de l'exécution de la tâche).
       Remarque :

       La durée que vous spécifiez expire conformément aux spécifications, même si la tâche est en file d'attente. Par exemple, si vous planifiez l'exécution d'une tâche à 13 h 00 et son arrêt après 20 minutes, la tâche s'arrête à 13 h 20, même si elle se trouvait en file d'attente jusqu'à 13 h 15 avant d'être lancée. En outre, si vous choisissez d'arrêter une tâche en attente ou en cours d'exécution après deux heures, puis forcez l'arrêt de la même tâche après trois heures, la tâche est arrêtée de force après cinq heures. Cela se produit tout d'abord parce qu'Orchestrator reçoit le signal indiquant que la tâche a été arrêtée au bout de deux heures. Dès réception du signal, Orchestrator prévoit que l'action d'arrêt forcé se déroule dans un délai de trois heures, ce qui porte le total à cinq heures.

   Vous disposez des options suivantes : * Sélectionnez Arrêter dans le menu déroulant : cette option lance une tentative de fin d'exécution ordonnée de la tâche lorsque celle-ci s'est trouvée en attente ou en cours d'exécution pendant la durée que vous avez définie. Vous pouvez définir un intervalle minimum d'une minute et un intervalle maximum de 10 jours, 23 heures et 59 minutes. * Sélectionnez Kill dans le menu déroulant : cette option lance une tentative d'arrêt forcé de l'exécution de la tâche lorsque celle-ci s'est trouvée en attente ou en cours d'exécution pendant la durée que vous avez définie. Vous pouvez définir un intervalle minimum d'une minute et un intervalle maximum de 10 jours, 23 heures et 59 minutes. * Sélectionnez Arrêter dans le menu déroulant et activez l'option Si le travail ne s'arrête pas, forcer l'arrêt . Cette option lance une tentative de fin d'exécution ordonnée de la tâche lorsque celle-ci se trouvait en attente ou en cours d'exécution pendant la durée que vous avez définie pour l'action d'arrêt. Si cette tentative a pour conséquence que la tâche reste dans un état d'arrêt, Orchestrator tente ensuite de forcer l’arrêt de la tâche une fois le délai que vous avez défini pour l'action d'arrêt a expiré. Vous pouvez définir un intervalle minimum d'une minute et un intervalle maximum de 10 jours, 23 heures et 59 minutes. 11. Pour recevoir une alerte si une tâche est restée en état d'attente ou de reprise pendant un certain temps, activez la bascule Generate an alert if the job is stuck in pending or resumed status et définissez la durée acceptable pour que la tâche reste dans un état en attente ou repris. La durée minimale configurable est d'une minute et la durée maximale est de onze jours. Si la tâche dépasse la durée configurée, une fenêtre contextuelle d'alerte indiquant la gravité de l'erreur s'affiche, avec le texte suivant : « N jobs for #process have been pending or resumed for more than X hours and Y minutes » où : * N correspond au nombre de tâches qui ont déclenché l'alerte. * {process_number} est l'identificateur du processus. * X correspond au nombre d'heures configurées que la tâche a dépassé lorsqu'elle était en état d'attente ou de reprise. Les jours sont convertis en heures. * Y correspond au nombre de minutes configurées que la tâche a dépassé lorsqu'elle était en état d'attente ou de reprise. 12. Pour recevoir une alerte si une tâche ne s'est pas achevée dans un intervalle défini, activez la bascule Generate an alert if the job started and has not completed et définissez la durée acceptable pour que la tâche s'accomplisse. La durée minimale configurable est d'une minute et la durée maximale est de onze jours. Si la tâche dépasse la durée configurée, une fenêtre contextuelle d'alerte indiquant la gravité de l'erreur s'affiche, avec le texte suivant : « Job for #process has been running for more than X hours and Y minutes » où : * {process_number} est l'identificateur du processus. * X correspond au nombre d'heures configurées que la tâche a dépassé sans s'achever. Les jours sont convertis en heures. * Y correspond au nombre de minutes configurées que la tâche a dépassé sans s'achever. 13. Pour déterminer quand désactiver le déclencheur après des échecs d'exécution d'une tâche, activez la bascule l'option Set execution-based trigger disabling . Lorsque vous activez la bascule, vous devez définir les options suivantes :

   | Option | Description |
   | --- | --- |
   | **Disable when consecutive job execution fail count** | The trigger is disabled after the number of failed executions you specify. You can choose a value between 0 and 100. The default is 0, meaning that the trigger is never disabled. Stopped jobs are not counted toward this value. |
   | **Grace period on disabling the trigger (days)** | The number of days to wait before disabling the trigger after the first failure of a job. You can choose a value between 0 and 30. The default is 0, meaning that the trigger is disabled as soon as the job fails, with no waiting time. |
   

   14. Pour conserver le même contexte compte-machine configuré pour démarrer la tâche, sélectionnez Keep Account/Machine allocation on job resumption. La sélection de cette option optimise l'utilisation de vos licences et de vos ressources. 15. Lorsque vous avez terminé la configuration des détails généraux , accédez à la page Event details en sélectionnant Next. 16. Sélectionnez le connecteur approprié dans le menu déroulant Select connector . 17. Sélectionnez une connexion existante dans le menu déroulant Connection . Si aucune connexion n'est définie, un bouton Connect to... s'affiche, ce qui vous permet de créer une nouvelle connexion à la volée. 18. Sélectionnez un événement dans la liste déroulante Event . 19. Sous Data filters, utilisez Add condition et Add group pour définir les filtres souhaités. 20. Lorsque vous avez terminé, sélectionnez Add pour créer le déclencheur. Le déclencheur d'événement s'affiche dans la grille Event Triggers , indiquant la valeur Disconnected dans la colonne Type .