Création d'un déclencheur de file d'attente

Important :

Les déclencheurs de file d'attente créés au moment de la conception à l'aide d'activités de déclencheur de file d'attente 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.

Vous ne pouvez pas créer de déclencheurs de file d'attente pour les processus qui contiennent déjà une activité de déclencheur de file d'attente.

Les déclencheurs de file d’attente et les prévisions SLA sont interdépendants en termes d'association file d’attente/processus. Lorsque vous en configurez un, l'autre est prérempli de façon à assurer la parité entre les configurations. Imaginons que je définisse un déclencheur de file d’attente afin que la file d’attente Y utilise le processus X. Les prévisions SLA pour la file d’attente Y ne peuvent être effectuées qu'à l'aide du processus X. Par conséquent, X est prérempli et en lecture seul lors de l'activation du SLA de la file d'attente pour Y.

1. Dans un dossier, accédez à Automatisations (Automations) > Déclencheurs (Triggers) et sur la page Déclencheurs de file d’attente (Queue Triggers), cliquez sur Ajouter un nouveau déclencheur (Add a new trigger). La page Créer un déclencheur de file d'attente (Create Queue 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 Type de runtime ( Runtime type ), sélectionnez le type de licence de runtime.
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
   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é.

   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 effectuer une autre sélection de nom d'hôte ou aucune (c'est-à-dire que la première machine disponible dans le pool de modèles est sélectionnée), cliquez sur 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, supposons que vous ayez configuré un déclencheur T1 avec le compte A1 mappé au modèle de machine MT1. Dix tâches sont mises 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. Sélectionnez la file d'attente utilisée pour déclencher l'exécution.
9. Définissez les paramètres de configuration décrits dans cette table.

   Description
   Nombre minimal d'éléments pour déclencher la première tâche	La tâche de traitement d'éléments n'est démarrée qu'après que la file d'attente ciblée comporte au moins ce nombre de nouveaux éléments. Les éléments de file d'attente différés ne sont pas comptés.
   Nombre maximal d'exécutions en attente et en cours autorisées simultanément	Nombre maximal de tâches en attente et en cours autorisés, comptées ensemble. Pour 2 tâches ou plus autorisées simultanément, la troisième option doit être définie, comme décrit ci-dessous.
   Une autre tâche est déclenchée pour tous les __ nouveau(x) élément(s)	Le nombre de nouveaux éléments de file d'attente (en plus du nombre configuré pour l'option Nombre minimal d'éléments qui déclenchent la première tâche (Minimum number of items that trigger the first job)) afin de déclencher une nouvelle tâche.
   Une fois les tâches terminées, réévaluez les conditions et démarrez de nouvelles tâches si possible	Si cette option est sélectionnée, le déclencheur de file d’attente est évalué à la fin de chaque tâche, et de nouvelles tâches sont démarrées si des robots sont disponibles. Cela complète la vérification automatique qui se produit toutes les 30 minutes et permet de garantir que les éléments de file d’attente restants sont traités sans décalages dans la mesure du possible.

10. Dans le menu déroulant Fuseau horaire (Timezone), sélectionnez le fuseau horaire en fonction duquel le déclencheur de file d'attente est désactivé (voir l'étape 13).
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 à laquelle 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 0, ce qui signifie que le déclencheur est désactivé dès que la tâche échoue, sans temps d'attente.

    Remarque :

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

    Cela ne s’applique à vous que si vous êtes sur le plan de licence Community.

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.