Gestion des déclencheurs

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 voulez configurer un déclencheur de temps.
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é (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 tâche (Job Type), sélectionnez le type de runtime, c'est-à-dire le type d'emplacement d'exécution utilisé pour exécuter les tâches lancées par le déclencheur.
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 l'utilisateur 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. Le fait de spécifier uniquement le compte entraîne l'allocation dynamique de la machine par Orchestrator. Si vous spécifiez à la fois le compte et la machine, la tâche sera lancée sur cette paire compte-machine.
   	Machine Le processus est exécuté sur l'une des machines hôtes connectées au modèle de machine sélectionné. Si vous spécifiez uniquement la machine, Orchestrator alloue le compte de manière dynamique. Si vous spécifiez à la fois le compte et la machine, la tâche sera lancée sur cette paire compte-machine. Assurez-vous que les runtimes correspondant au type de tâche sont affectés au modèle de machine associé. Seules les machines hôtes connectées associées au dossier actif sont affichées.
   Sélectionner des mappages compte-machine valides	Le processus peut être exécuté sur plusieurs paires utilisateur-machine. Remarque : Les utilisateurs faisant partie des mappages utilisés dans les déclencheurs ne peuvent pas être supprimés ou désaffectés du dossier dans lequel est situé 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.

8. Dans l'onglet Arguments, fournissez des valeurs pour les arguments d'entrée, si votre processus en possède.
9. Dans le menu déroulant Fuseau horaire (Timezone), sélectionnez le fuseau horaire en fonction duquel le déclencheur doit être activé.
   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 tenir compte de l'heure d'été, car le mécanisme de planification d'Orchestrator la prend automatiquement en compte lors du lancement d'une tâche. Une tâche planifiée pour s'exécuter à 12h00 s'exécute à 12h00 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. 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.
12. Activez l'option Fin de l'exécution de la tâche (End job execution) 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 l'exécution est en file d'attente. Par exemple, si vous planifiez le lancement d'une exécution à 13 h et que vous la configurez pour qu'elle s'arrête après 20 minutes, l'exécution 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é.

    Par ailleurs, 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 le bouton bascule Désactiver le déclencheur à (Disable Trigger at) 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. 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.

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

Remarque : 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 seule 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 (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 File d'attente(Queue) 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 voulez configurer un déclencheur de temps.
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é (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 tâche (Job Type), sélectionnez le type de runtime, c'est-à-dire le type d'emplacement d'exécution utilisé pour exécuter les tâches lancées par le déclencheur.
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
   Compte (Account)	Le processus est exécuté sous un compte spécifique. Le fait de spécifier uniquement le compte entraîne l'allocation dynamique de la machine par Orchestrator. Si vous spécifiez à la fois le compte et la machine, la tâche sera lancée sur cette paire compte-machine.
   Machine	Le processus est exécuté sur l'une des machines hôtes connectées au modèle de machine sélectionné. Si vous spécifiez uniquement la machine, Orchestrator alloue le compte de manière dynamique. Si vous spécifiez à la fois le compte et la machine, la tâche sera lancée sur cette paire compte-machine. Remarque : Assurez-vous que les runtimes correspondant au type de tâche sont affectés au modèle de machine associé. Seules les machines hôtes connectées associées au dossier actif sont affichées.

8. Dans l'onglet Arguments, fournissez des valeurs pour les arguments d'entrée, si votre processus en possède.
9. Renseignez les champs Nombre minimal d'éléments pour déclencher la première tâche (Minimum number of items to trigger the first job), Nombre maximal de tâches en attente et en cours autorisées simultanément (Maximum number of pending and running jobs allowed simultaneously), Une autre tâche est déclenchée pour tous les __ nouveaux éléments (Another job is triggered for each _ new item(s)).

   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.

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é. Notez que le fuseau horaire du déclencheur ne dépend pas de celui du locataire.
11. Dans le menu déroulant Jours non ouvrables (Non-Working Days), sélectionnez un calendrier des jours non ouvrables si vous voulez que votre déclencheur arrête de s'activer certains jours non ouvrables.
12. Activez le bouton bascule Désactiver le déclencheur à (Disable Trigger at) et saisissez la date et l’heure à laquelle le déclencheur doit être désactivé. Le fuseau horaire sélectionné à l'étape 10 influence le moment où le déclencheur de file d'attente est désactivé.
13. 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.

Modification d'un déclencheur

Cliquez sur le bouton Modifier (Edit) correspondant, effectuez les modifications nécessaires et cliquez sur Mettre à jour (Update) dans la fenêtre Modifier le déclencheur (Edit Trigger).

Désactivation d'un déclencheur

Pour désactiver un déclencheur, cliquez sur le bouton Autres actions (More Actions) correspondant, puis sur Désactiver (Disable). Un déclencheur de temps désactivé est indiqué par l'icône en face. Un déclencheur de file d'attente désactivé est indiqué par l'icône en face.

Sinon, vous pouvez la sélectionner, puis cliquer sur l'icône Désactiver (Disable).

Vous pouvez également configurer votre déclencheur afin de le désactiver automatiquement à une date et heure spécifiques dans le futur. Vous pouvez procéder comme suit :

1. Cliquez sur le bouton Modifier (Edit) correspondant.
2. Activez l'option Désactiver le déclencheur à (Disable Trigger at).
3. Remplissez la date et l'heure souhaitées. Le fuseau horaire du déclencheur influence le moment où le déclencheur est désactivé.
4. Cliquez sur Mettre à jour (Update) pour que vos modifications prennent effet.
   Par défaut, un déclencheur est désactivé automatiquement après 10 lancements échoués s’il n’avait pas été lancé avec succès dans la journée passée.
   Cette valeur peut être personnalisée à l'aide du paramètre Triggers.DisableWhenFailedCount.

Activation d'un déclencheur

Pour activer un déclencheur, cliquez sur le bouton Autres actions (More Actions) correspondant, puis sur Activer (Enable). Un déclencheur de temps activé est indiqué par l'icône en face. Un déclencheur de file d'attente activé est indiqué par l'icône en face.

Sinon, vous pouvez la sélectionner, puis cliquer sur l'icône Activer (Enable).

Suppression d'un déclencheur

Pour supprimer un déclencheur, cliquez sur le bouton Autres actions (More Actions) correspondant, puis sur Supprimer (Remove).

Sinon, vous pouvez la sélectionner, puis cliquer sur l'icône Supprimer (Remove).

Affichage des exécutions démarrées par un déclencheur

Pour afficher les exécutions démarrées par un déclencheur spécifique, cliquez sur le bouton Autres actions (More Actions), puis sur Afficher les exécutions (View jobs). Cela affiche la fenêtre Exécutions (Jobs), qui comprend toutes les exécutions lancées antérieurement via le déclencheur sélectionné (le cas échéant).

Gestion des jours non ouvrables

Création de calendriers

1. Ouvrez l'onglet Jours non ouvrables (Non-Working Days) sur la page Paramètres (Settings). Une liste contenant tous les calendriers auparavant définis s'affiche, classée par ordre alphabétique.

   Le calendrier BankHoliday s'affiche ici, s’il existe. Ce calendrier est créé lors de la mise à niveau d'Orchestrator vers la version 19.10 si vous aviez des jours non ouvrables définis dans votre version précédente.

2. Cliquez sur Ajouter (Add) pour créer un nouveau calendrier et saisissez son nom dans le champ vierge mis en évidence. Le nom doit être unique, et il peut contenir un maximum de 150 caractères alphanumériques. Vous ne pouvez pas créer de calendriers sans nom ou contenant uniquement des caractères spatiaux.
3. Cliquez sur Enregistrer (Save) ou appuyez sur Entrée (Enter) sur votre clavier pour enregistrer le nouveau calendrier. Celui-ci est enregistré et affiché dans la liste des calendriers.
4. Pour le calendrier sélectionné, définissez les jours non ouvrables manuellement ou en téléchargeant un fichier .csv, ou une combinaison de ceux-ci.
5. Su la page Déclencheurs (Triggers), lors de la création d'un déclencheur ou de la modification d'un existant, sélectionnez le calendrier souhaité dans la liste déroulante Restrictions relatives aux jours non ouvrables (Non-working days restrictions).
   Remarque : Lorsque vous utilisez des jours non ouvrables, le fuseau horaire du déclencheur doit être le même que le fuseau horaire du locataire (onglet Locataire (Tenant) > Paramètres (Settings) > Général (General)), car les restrictions de calendrier ne peuvent pas être appliquées dans différents fuseaux horaires. Un locataire sans fuseau horaire explicitement défini l'hérite de l'hôte.
6. Cliquez sur Mettre à jour (Update) pour que les modifications prennent effet. Toutes les modifications apportées à un calendrier se propagent ensuite à tous les déclencheurs associés à ce calendrier.

Sélection manuelle des jours non ouvrables

1. Cliquez sur un calendrier pour le sélectionner. Le calendrier dans la partie droite de la fenêtre est mis à jour en conséquence.
2. Dans le calendrier affiché, cliquez sur les dates auxquelles vous souhaitez que vos déclencheurs cessent de s'activer. Cliquez de nouveau sur une date sélectionnée pour la désélectionner.
3. Cliquez sur Enregistrer (Save) pour enregistrer les dates sélectionnées en tant que jours non ouvrables.
   
   

   

   
   

En chargeant un fichier .csv Fichiers

Permet de télécharger une série de dates dans un calendrier sélectionné, directement à partir d'un fichier .csv. Veuillez noter que le fichier doit être préalablement rempli en utilisant un format prédéfini pour que l'opération de téléchargement réussisse. Les nouvelles dates de votre fichier téléchargé écrasent toutes les dates déjà contenues dans le calendrier.

Remarque :

Le fichier .csv doit contenir l’en-tête de colonne ExcludedDate. Tous les jours non ouvrables doivent être dans cette colonne, écrits au format YYYY-MM-DD, YYYY/MM/DD ou YYYY MM DD.

Développez la section d'exemple ci-dessous pour plus d’informations.

Option 1

1. Dans le calendrier sélectionné, cliquez sur Télécharger un fichier CSV (Upload CSV).
2. Accédez au fichier .csv souhaité, sélectionnez-le et cliquez sur Ouvrir (Open). Orchestrator analyse le fichier pour confirmer qu'il respecte les règles de formatage (voir la section des exemples ci-dessous).
3. Cliquez sur Oui (Yes) dans la boîte de dialogue de confirmation pour remplacer les dates déjà contenues dans le calendrier par les nouvelles dates de votre fichier téléchargé.
4. Cliquez sur Enregistrer (Save) pour enregistrer le calendrier modifié.

Option 2

1. Faites glisser et déposez le fichier . souhaité sur la partie supérieure du calendrier sélectionné. Orchestrator analyse le fichier pour confirmer qu'il respecte les règles de formatage (voir la section des exemples ci-dessous).
2. Cliquez sur Oui (Yes) dans la boîte de dialogue de confirmation pour remplacer les dates déjà contenues dans le calendrier par les nouvelles dates de votre fichier téléchargé.
3. Cliquez sur Enregistrer (Save) pour enregistrer le calendrier modifié.  

Exemple

Imaginons que vous téléchargiez le contenu du fichier .csv dans un calendrier. Pour créer facilement ce fichier, vous pouvez renseigner les données dans un fichier Excel et l'enregistrer comme fichier .csv :

Ou vous pouvez télécharger un fichier .csv avec tous les en-têtes de colonne pré-remplis et le personnaliser en fonction de vos besoins.

Télécharger le fichier

Notez que ce fichier contient un en-tête de colonne prédéfini, ExcludedDate. Saisissez tous vos jours non ouvrables dans cette colonne, en utilisant le format JJ-MM-AAAA, JJ/MM/AAAA ou JJ MM AAAA.

 

Changement de nom des calendriers

1. Sélectionnez un calendrier dans l'onglet Jours non ouvrables (Non-Working Days) de la page Paramètres (Settings).
2. Modifiez le nom du calendrier.
3. Cliquez sur Enregistrer (Save) pour enregistrer le nom modifié.

Suppression de calendriers

1. Sélectionnez un calendrier dans l'onglet Jours non ouvrables (Non-Working Days) de la page Paramètres (Settings).
2. Cliquez sur Supprimer (Delete).
3. Cliquez sur Oui (Yes) dans la fenêtre contextuelle pour confirmer votre intention. Le calendrier est supprimé.
   Remarque : Vous pouvez uniquement supprimer des calendriers qui ne sont associés à aucun déclencheur.

Vous pouvez également supprimer des jours non ouvrables d'un calendrier. Après avoir cliqué sur un jour non ouvrable, il n'est plus marqué. N'oubliez pas d'enregistrer vos modifications.