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

Dans le cas de déclencheurs d'événement connectés, vous créez le déclencheur au moment de la conception, dans Studio. Vous pouvez ensuite configurer le déclencheur dans Orchestrator lors du déploiement du processus auquel il est associé. Pour plus d'informations, consultez la section Configuration des déclencheurs d'événements connectés.

Dans le cas de déclencheurs d'événement déconnectés, vous créez le déclencheur dans Orchestrator. Pour plus d'informations, consultez les rubriques suivantes :

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

Création d'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 à Automatisations, puis sélectionnez Déclencheurs.
2. Sélectionnez Déclencheurs d'événement (Event Triggers), puis +Ajouter un nouveau déclencheur (Add a new trigger).
3. Dans la fenêtre Ajouter un déclencheur d'événement (Add Event Trigger) , sur la page Informations générales (General details ), saisissez un nom unique pour votre déclencheur dans le champ Nom (Name) .
4. Dans le menu déroulant Processus (Process) , sélectionnez le processus pour lequel vous souhaitez créer le déclencheur.
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 Héritée (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. Dans la liste déroulante Type de runtime (Runtime type) , sélectionnez le runtime pour exécuter les tâches que le déclencheur lance.
7. Dans la section Cible d'exécution (Execution Target) , sélectionnez le mécanisme d'affectation et la cible d'exécution pour 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 affectera dynamiquement la machine. Le fait de spécifier à la fois le compte et le modèle de machine garantit 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 attaché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 garantit que la tâche se lance sur cette paire compte-machine spécifique. Remarque : assurez-vous d'affecter les licences de runtime requises pour exécuter la tâche 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 ou de 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 : vous ne pouvez utiliser que des runtimes Unattended pour configurer le mappage. Assurez-vous d'allouer les licences de runtime requises pour exécuter la tâche au modèle de machine associé.

   Remarque : Un avertissement s'affiche lors de la sélection d'un nom d'hôte avec un statut Ne répond pas (Unresponsive) ou Déconnecté (Disconnected) . Les tâches planifiées pour être exécutées par une session inactive restent à l'état En attente (Pending ) jusqu'à ce que la connexion correspondante à Orchestrator reprenne. 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 Toute machine connectée(Any connected machine), sélectionnez Annuler (Cancel).

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

   Par exemple, vous configurez le déclencheur T1 avec le compte A1 mappé au modèle de machine MT1. Dix tâches sont mises en file d'attente 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 le 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. Dans la section Arguments de runtime (Runtime Arguments ), sélectionnez le point d'entrée à utiliser pour l'exécution de la tâche dans le menu déroulant Point d'entrée (Entry point) . Pour plus de détails, consultez la section Points d’entrée.
9. Si votre processus comprend des arguments d'entrée, indiquez les valeurs appropriées. Pour plus de détails, consultez la section À propos des arguments d'entrée et de sortie (About input and output arguments).
10. Pour sélectionner une stratégie de fin de tâche, activez le bouton Planifier la fin de l'exécution de la tâche (Schedule ending of job execution) .
    Remarque :

    Le délai que vous spécifiez expire en fonction des spécifications, même si la tâche est en file d'attente. Par exemple, si vous planifiez qu'une tâche soit exécutée à 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 a été dans une file d'attente jusqu'à 13 h 15, puis a démarré.

    De plus, si vous choisissez d'arrêter une tâche en attente ou en cours d’exécution après deux heures et de forcer l’arrêt de la même tâche après trois heures, l’arrêt de la tâche sera forcé après cinq heures. Cela se produit parce qu'Orchestrator reçoit d'abord le signal indiquant que la tâche a été arrêtée après deux heures. À la réception du signal, Orchestrator minute l'action d'arrêt forcé pour qu'elle se produise en trois heures, soit un total de cinq heures.

    Choisissez une des options suivantes :
    • Sélectionnez Arrêter (Stop) dans le menu déroulant : cette option lance une tentative de mettre fin normalement à l’exécution de la tâche lorsque la tâche est 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 Forcer l'arrêt (Kill) dans la liste déroulante : cette option lance une tentative de forcer l'arrêt de l'exécution de la tâche lorsque la tâche est 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 (Stop) dans le menu déroulant et activez l'option Si la tâche ne s'arrête pas, forcez l'arrêt (Kill it) . Cette option lance une tentative de mettre fin normalement à l’exécution de la tâche lorsque la tâche est en attente ou en cours d’exécution pendant la durée définie pour l’action d’arrêt. Si cette tentative entraîne le maintien de la tâche dans un état d'arrêt, Orchestrator tente alors de forcer l'arrêt de la tâche après le délai que vous avez défini pour l'action d'arrêt forcé. 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 dans un état en attente ou repris pendant un certain temps, activez le bouton Générer une alerte si la tâche est bloquée au statut en attente ou repris (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 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 de gravité d'erreur apparaît, 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 est le nombre de tâches qui ont déclenché l'alerte.
    • {process_number} est l'identifiant du processus.
    • X est le nombre d'heures configuré que la tâche a dépassé lorsqu'elle était dans un état en attente ou repris. Les jours sont convertis en heures.
    • Y est le nombre configuré de minutes que la tâche a dépassé lorsqu'elle était dans un état en attente ou repris.
12. Pour recevoir une alerte si une tâche ne s'est pas terminée dans un intervalle défini, activez le bouton 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 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 de gravité d'erreur apparaît, avec le texte suivant : « La tâche pour #process {process_number} est en cours d'exécution depuis plus de X heures et Y minutes. », Où :
    • {process_number} est l'identifiant du processus.
    • X est le nombre d'heures configuré que la tâche a dépassé sans se terminer. Les jours sont convertis en heures.
    • Y est le nombre configuré de minutes que la tâche a dépassé sans se terminer.
13. Pour déterminer quand désactiver le déclencheur après l'échec de l'exécution de la tâche, activez le bouton Définir une désactivation du déclencheur basée sur l'exécution (Set execution-based trigger disabling) . Lors de l'activation de 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écutions 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 pour cette valeur.
    Délai de grâce lors de la désactivation du déclencheur (jours)	Le nombre de jours d’attente 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 Conserver l'allocation de compte/machine à la reprise de la tâche. La sélection de cette option optimise votre utilisation des licences et des ressources.
15. Lorsque vous avez terminé la configuration des détails généraux , accédez à la page Détails de l'événement (Event details ) en sélectionnant Suivant (Next).
16. Sélectionnez le connecteur approprié dans le menu déroulant Sélectionner le connecteur (Select connector) .
17. Sélectionnez une connexion existante dans le menu déroulant Connexion (Connection) . Si aucune connexion n'est définie, un bouton Connecter à... apparaît, vous permettant de créer une nouvelle connexion à tout moment.
18. Sélectionnez un événement dans la liste déroulante Événement (Event) .
19. Sous Filtres de données (Data filters), utilisez Ajouter une condition (Add condition et Ajouter un groupe (Add group) pour définir les filtres souhaités.
20. Lorsque vous avez terminé, sélectionnez Ajouter (Add) pour créer le déclencheur. Le déclencheur d'événement apparaît dans la grille Déclencheurs d'événement (Event Triggers) , avec la valeur Déconnecté (Disconnected) 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 à Automatisations, puis sélectionnez Déclencheurs.
2. Sélectionnez Déclencheurs d'événement (Event Triggers), puis +Ajouter un nouveau déclencheur (Add a new trigger).
3. Sur la page Informations générales (General details) , dans le menu déroulant Processus (Process ), sélectionnez le processus pour lequel vous souhaitez créer le déclencheur.
4. Saisissez un nom unique pour votre déclencheur dans le champ Nom (Name) .
5. Dans la section Cible d'exécution (Execution Target) , sélectionnez un compte dans le menu déroulant Compte (Compte) . Pour activer l'attribution dynamique de comptes, sélectionnez Tout compte Utilisateur/Robot (Any User/Robot account).
6. Pour sélectionner une stratégie de fin de tâche, activez le bouton Planifier la fin de l'exécution de la tâche (Schedule ending of job execution) .
   Remarque :

   Le délai que vous spécifiez expire en fonction des spécifications, même si la tâche est en file d'attente. Par exemple, si vous planifiez qu'une tâche soit exécutée à 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 a été dans une file d'attente jusqu'à 13 h 15, puis a démarré.

   De plus, si vous choisissez d'arrêter une tâche en attente ou en cours d’exécution après deux heures et de forcer l’arrêt de la même tâche après trois heures, l’arrêt de la tâche sera forcé après cinq heures. Cela se produit parce qu'Orchestrator reçoit d'abord le signal indiquant que la tâche a été arrêtée après deux heures. À la réception du signal, Orchestrator minute l'action d'arrêt forcé pour qu'elle se produise en trois heures, soit un total de cinq heures.

   Choisissez une des options suivantes :
   • Sélectionnez Arrêter (Stop) dans le menu déroulant : cette option lance une tentative de mettre fin normalement à l’exécution de la tâche lorsque la tâche est 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 Forcer l'arrêt (Kill) dans la liste déroulante : cette option lance une tentative de forcer l'arrêt de l'exécution de la tâche lorsque la tâche est 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 (Stop) dans le menu déroulant et activez l'option Si la tâche ne s'arrête pas, forcez l'arrêt (Kill it) . Cette option lance une tentative de mettre fin normalement à l’exécution de la tâche lorsque la tâche est en attente ou en cours d’exécution pendant la durée définie pour l’action d’arrêt. Si cette tentative entraîne le maintien de la tâche dans un état d'arrêt, Orchestrator tente alors de forcer l'arrêt de la tâche après le délai que vous avez défini pour l'action d'arrêt forcé. 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 terminée dans un intervalle défini, activez le bouton 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 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 de gravité d'erreur apparaît, avec le texte suivant : « La tâche pour #process {process_number} est en cours d'exécution depuis plus de X heures et Y minutes. », Où :
   • {process_number} est l'identifiant du processus.
   • X est le nombre d'heures configuré que la tâche a dépassé sans se terminer. Les jours sont convertis en heures.
   • Y est le nombre configuré de minutes que la tâche a dépassé sans se terminer.
8. Si votre processus a des arguments d'entrée, utilisez la section Arguments de runtime (Runtime Arguments) pour leur fournir les valeurs appropriées. Pour plus de détails, consultez la section À propos des arguments d'entrée et de sortie (About input and output arguments).
9. Lorsque vous avez terminé la configuration des détails généraux , accédez à la page Détails de l'événement (Event details ) en sélectionnant Suivant (Next).
10. Sélectionnez le connecteur approprié dans le menu déroulant Sélectionner le connecteur (Select connector) .
11. Sélectionnez une connexion existante dans le menu déroulant Connexion (Connection) . Si aucune connexion n'est définie, un bouton Connecter à... apparaît, vous permettant de créer une nouvelle connexion à tout moment.
12. Sélectionnez un événement dans la liste déroulante Événement (Event) .
13. Sous Filtres de données (Data filters), utilisez Ajouter une condition (Add condition et Ajouter un groupe (Add group) pour définir les filtres souhaités.
14. Lorsque vous avez terminé, sélectionnez Ajouter (Add) pour créer le déclencheur. Le déclencheur d'événement apparaît dans la grille Déclencheurs d'événement (Event Triggers) , avec la valeur Déconnecté (Disconnected) dans la colonne Type .

Création d'un déclencheur d'événement déconnecté pour un processus agent

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

1. Dans le contexte du dossier, accédez à Automatisations, puis sélectionnez Déclencheurs.
2. Sélectionnez Déclencheurs d'événement (Event Triggers), puis +Ajouter un nouveau déclencheur (Add a new trigger).
3. Sur la page Informations générales (General details) , dans le menu déroulant Processus (Process ), sélectionnez le processus pour lequel vous souhaitez créer le déclencheur.
4. Saisissez un nom unique pour votre déclencheur dans le champ Nom (Name) .
5. Dans la section Cible d'exécution (Execution Target) , sélectionnez un compte dans le menu déroulant Compte (Compte) . Pour activer l'attribution dynamique de comptes, sélectionnez Tout compte Utilisateur/Robot (Any User/Robot account).
6. Pour sélectionner une stratégie de fin de tâche, activez le bouton Planifier la fin de l'exécution de la tâche (Schedule ending of job execution) .
   Remarque :

   Le délai que vous spécifiez expire en fonction des spécifications, même si la tâche est en file d'attente. Par exemple, si vous planifiez qu'une tâche soit exécutée à 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 a été dans une file d'attente jusqu'à 13 h 15, puis a démarré.

   De plus, si vous choisissez d'arrêter une tâche en attente ou en cours d’exécution après deux heures et de forcer l’arrêt de la même tâche après trois heures, l’arrêt de la tâche sera forcé après cinq heures. Cela se produit parce qu'Orchestrator reçoit d'abord le signal indiquant que la tâche a été arrêtée après deux heures. À la réception du signal, Orchestrator minute l'action d'arrêt forcé pour qu'elle se produise en trois heures, soit un total de cinq heures.

   Choisissez une des options suivantes :
   • Sélectionnez Arrêter (Stop) dans le menu déroulant : cette option lance une tentative de mettre fin normalement à l’exécution de la tâche lorsque la tâche est 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 Forcer l'arrêt (Kill) dans la liste déroulante : cette option lance une tentative de forcer l'arrêt de l'exécution de la tâche lorsque la tâche est 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 (Stop) dans le menu déroulant et activez l'option Si la tâche ne s'arrête pas, forcez l'arrêt (Kill it) . Cette option lance une tentative de mettre fin normalement à l’exécution de la tâche lorsque la tâche est en attente ou en cours d’exécution pendant la durée définie pour l’action d’arrêt. Si cette tentative entraîne le maintien de la tâche dans un état d'arrêt, Orchestrator tente alors de forcer l'arrêt de la tâche après le délai que vous avez défini pour l'action d'arrêt forcé. 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 terminée dans un intervalle défini, activez le bouton 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 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 de gravité d'erreur apparaît, avec le texte suivant : « La tâche pour #process {process_number} est en cours d'exécution depuis plus de X heures et Y minutes. », Où :
   • {process_number} est l'identifiant du processus.
   • X est le nombre d'heures configuré que la tâche a dépassé sans se terminer. Les jours sont convertis en heures.
   • Y est le nombre configuré de minutes que la tâche a dépassé sans se terminer.
8. Dans la section Arguments de runtime (Runtime Arguments ), sélectionnez le point d'entrée à utiliser pour l'exécution de la tâche dans le menu déroulant Point d'entrée (Entry point) . Pour plus de détails, consultez la section Points d’entrée.
9. Si votre processus comprend des arguments d'entrée, indiquez les valeurs appropriées. Pour plus de détails, consultez la section À propos des arguments d'entrée et de sortie (About input and output arguments).
10. Lorsque vous avez terminé la configuration des détails généraux , accédez à la page Détails de l'événement (Event details ) en sélectionnant Suivant (Next).
11. Sélectionnez le connecteur approprié dans le menu déroulant Sélectionner le connecteur (Select connector) .
12. Sélectionnez une connexion existante dans le menu déroulant Connexion (Connection) . Si aucune connexion n'est définie, un bouton Connecter à... apparaît, vous permettant de créer une nouvelle connexion à tout moment.
13. Sélectionnez un événement dans la liste déroulante Événement (Event) .
14. Sous Filtres de données (Data filters), utilisez Ajouter une condition (Add condition et Ajouter un groupe (Add group) pour définir les filtres souhaités.
15. Lorsque vous avez terminé, sélectionnez Ajouter (Add) pour créer le déclencheur. Le déclencheur d'événement apparaît dans la grille Déclencheurs d'événement (Event Triggers) , avec la valeur Déconnecté (Disconnected) dans la colonne Type .