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. Pour de plus amples informations, consultez les sections suivantes :

• Créer un déclencheur d'événement déconnecté
• Créer un déclencheur d'événement déconnecté pour un agent
• Créer un déclencheur d'événement déconnecté pour un processus agentique.

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 (Ne répond pas) ou Disconnected (Déconnecté). Les tâches qui doivent être exécutées par une session inactive restent dans l'état Pending (En attente) 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 délai total à cinq heures.

    Choisissez une des options suivantes :
    • Sélectionnez Stop (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 (Forcer l’arrêt) 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 Stop (Arrêter) dans le menu déroulant et activez l'option If the job does not stop, kill it (Si la tâche 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 (Générer une alerte si la tâche est bloquée en état d'attente ou de reprise) et définissez la durée acceptable pour que la tâche reste en état d'attente ou de reprise. 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 » (N tâches de #process sont en attente ou ont repris depuis plus de X heures et 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 (Générer une alerte si la tâche a commencé et ne s'est pas achevée) 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 » (La tâche de #process s'exécute depuis plus de X heures et 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 (Définir la désactivation du déclencheur en fonction de l'exécution). Lorsque vous activez la bascule, vous devez définir les options suivantes :

    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'échecs d'exécution que vous spécifiez. 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)	Le nombre de jours à attendre avant de désactiver le 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 0, ce qui signifie que le déclencheur est désactivé dès que la tâche échoue, sans temps d'attente.

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 (Conserver l'affectation compte/machine lors de la reprise de la tâche). 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 (General details), accédez à la page Event details (Détails de l'événement) en sélectionnant Next (Suivant).
16. Sélectionnez le connecteur approprié dans le menu déroulant Select connector (Sélectionner le connecteur).
17. Sélectionnez une connexion existante dans le menu déroulant Connection (Connexion). Si aucune connexion n'est définie, un bouton Connect to... (Connecter à...) 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 (Événement).
19. Sous Data filters (Filtres de données), utilisez Add condition (Ajouter une condition) et Add group (Ajouter un groupe) pour définir les filtres souhaités.
20. Lorsque vous avez terminé, sélectionnez Add (Ajouter) pour créer le déclencheur. Le déclencheur d'événement s'affiche dans la grille Event Triggers (Déclencheurs d'événements), indiquant la valeur Disconnected (Déconnecté) dans la colonne Type.

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

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. Sur la page General details (Détails généraux), dans le menu déroulant Process (Processus), sélectionnez le processus pour lequel vous souhaitez créer le déclencheur.
4. Donnez à votre déclencheur un nom unique dans le champ Name (Nom).
5. Dans la section Execution Target (Cible de l'exécution), sélectionnez un compte dans le menu déroulant Account (Compte). Pour activer l'affectation dynamique du compte, sélectionnez Any User/Robot account (Tout compte d'utilisateur/robot).
6. 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 délai total à cinq heures.

   Choisissez une des options suivantes :
   • Sélectionnez Stop (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 (Forcer l’arrêt) 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 Stop (Arrêter) dans le menu déroulant et activez l'option If the job does not stop, kill it (Si la tâche 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.
7. 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 (Générer une alerte si la tâche a commencé et ne s'est pas achevée) 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 » (La tâche de #process s'exécute depuis plus de X heures et 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.
8. Si votre processus comporte des arguments d'entrée, utilisez la section Runtime Arguments (Arguments de runtime) pour fournir les valeurs appropriées de ces arguments. Pour de plus amples informations, consultez la section À propos des arguments d'entrée et de sortie.
9. Lorsque vous avez terminé la configuration des détails généraux (General details), accédez à la page Event details (Détails de l'événement) en sélectionnant Next (Suivant).
10. Sélectionnez le connecteur approprié dans le menu déroulant Select connector (Sélectionner le connecteur).
11. Sélectionnez une connexion existante dans le menu déroulant Connection (Connexion). Si aucune connexion n'est définie, un bouton Connect to... (Connecter à...) s'affiche, ce qui vous permet de créer une nouvelle connexion à la volée.
12. Sélectionnez un événement dans la liste déroulante Event (Événement).
13. Sous Data filters (Filtres de données), utilisez Add condition (Ajouter une condition) et Add group (Ajouter un groupe) pour définir les filtres souhaités.
14. Lorsque vous avez terminé, sélectionnez Add (Ajouter) pour créer le déclencheur. Le déclencheur d'événement s'affiche dans la grille Event Triggers (Déclencheurs d'événements), indiquant la valeur Disconnected (Déconnecté) dans la colonne Type.

Créer un déclencheur d'événement déconnecté pour un processus agentique.

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. Sur la page General details (Détails généraux), dans le menu déroulant Process (Processus), sélectionnez le processus pour lequel vous souhaitez créer le déclencheur.
4. Donnez à votre déclencheur un nom unique dans le champ Name (Nom).
5. Dans la section Execution Target (Cible de l'exécution), sélectionnez un compte dans le menu déroulant Account (Compte). Pour activer l'affectation dynamique du compte, sélectionnez Any User/Robot account (Tout compte d'utilisateur/robot).
6. 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 délai total à cinq heures.

   Choisissez une des options suivantes :
   • Sélectionnez Stop (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 (Forcer l’arrêt) 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 Stop (Arrêter) dans le menu déroulant et activez l'option If the job does not stop, kill it (Si la tâche 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.
7. 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 (Générer une alerte si la tâche a commencé et ne s'est pas achevée) 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 » (La tâche de #process s'exécute depuis plus de X heures et 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.
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. Lorsque vous avez terminé la configuration des détails généraux (General details), accédez à la page Event details (Détails de l'événement) en sélectionnant Next (Suivant).
11. Sélectionnez le connecteur approprié dans le menu déroulant Select connector (Sélectionner le connecteur).
12. Sélectionnez une connexion existante dans le menu déroulant Connection (Connexion). Si aucune connexion n'est définie, un bouton Connect to... (Connecter à...) s'affiche, ce qui vous permet de créer une nouvelle connexion à la volée.
13. Sélectionnez un événement dans la liste déroulante Event (Événement).
14. Sous Data filters (Filtres de données), utilisez Add condition (Ajouter une condition) et Add group (Ajouter un groupe) pour définir les filtres souhaités.
15. Lorsque vous avez terminé, sélectionnez Add (Ajouter) pour créer le déclencheur. Le déclencheur d'événement s'affiche dans la grille Event Triggers (Déclencheurs d'événements), indiquant la valeur Disconnected (Déconnecté) dans la colonne Type.