Déclencheurs (Triggers)

Les déclencheurs fournissent un mécanisme uniforme d'abonnement aux événements à partir des plates-formes du connecteur. Il vous donne la possibilité de démarrer automatiquement des automatisations ou des processus dans Orchestrator.

Prérequis

Avant de pouvoir configurer des déclencheurs, assurez-vous que les conditions suivantes sont remplies :

• Integration Service est activé et enregistré pour votre locataire.
• L'onglet Déclencheurs (Triggers) est affiché dans la fenêtre Intégrations (Integrations).
• Vous avez déjà configuré un Robot Unattended ou Non-production dans votre instance d'Orchestrator.

• Vous utilisez des dossiers modernes (les processus à l'intérieur des dossiers classiques ne sont pas visibles lors de la définition des déclencheurs).

  Remarque :

  Les déclencheurs ne sont pris en charge que dans les dossiers modernes. Les dossiers classiques ne prennent pas en charge le paradigme d’identité utilisateur moderne. Ils ne peuvent donc pas prendre en charge les connexions en général ni les déclencheurs.

Création de votre processus

Créez votre processus dans UiPath® Studio comme vous le feriez normalement. À l'aide d'Integration Service, toute automatisation peut être déclenchée pour n'importe quel processus.

Pour recevoir les détails d’un enregistrement, vous pouvez également suivre les indications ci-dessous :

• Si vous souhaitez connaître le connecteur, l'événement, le type d'enregistrement ou l'enregistrement qui a déclenché le processus dans votre workflow, vous pouvez définir les arguments d'entrée suivants de type String dans votre processus.

  Integration Service les remplira automatiquement lorsqu'il démarrera la tâche.

  • ConnecteurÉvénementUiPath
  • ÉvénementUiPath
  • TypeObjetÉvénementUiPath
  • IDObjetÉvénementUiPath
    Remarque : Pour en savoir plus sur le fonctionnement et la gestion des arguments , cliquez ici.
• Pour récupérer et utiliser un enregistrement qui a un déclencheur sur une exécution de tâche, utilisez l'argument d'entrée UiPathEventObjectId pour récupérer l'enregistrement à partir du système source.

Voici un exemple de la façon dont les valeurs d'argument d'entrée sont transmises par Integration Service.

Publication de votre processus

Publiez votre processus dans Orchestrator comme vous le feriez normalement. Vous pouvez le publier dans un dossier partagé ou dans un espace de travail personnel. Assurez-vous de créer un processus à partir de votre package.

Configuration de votre déclencheur

Pour ajouter un déclencheur, procédez comme suit :

1. Accédez à Automation Cloud^TM.
2. Dans le menu de gauche, cliquez sur Service d' intégration (Integration Service). La fenêtre Integration Service comprend trois onglets distincts : Connecteurs (Connectors), Connexions (Connections) et Déclencheurs (Triggers).
3. Accédez à l'onglet Déclencheurs (Triggers) et cliquez sur le bouton Ajouter un déclencheur (Add Trigger ).
4. Sélectionnez le Connecteur et la Connexion souhaités dans leurs menus déroulants respectifs. Si une seule connexion est configurée pour ce connecteur particulier, elle sera sélectionnée automatiquement.

5. Sélectionnez l’ événement et l’ enregistrement souhaités dans leurs menus déroulants respectifs.

   Remarque : les types d'événements peuvent varier en fonction du connecteur.
6. Sur la droite, sélectionnez le Processus à exécuter (Process to execute) .

7. Sélectionnez la Licence de runtime (le runtime utilisé pour exécuter les tâches lancées par le déclencheur) dans la liste déroulante. Options disponibles : NonProduction, Unattended, Sans interface graphique, TestAutomation, AutomationCloud, Sans serveur, Développement.

   • La liste de runtimes affichée est basée sur la réponse reçue d'Orchestrator, c'est-à-dire sur les licences de runtime « affectées » à ce dossier. Pour le runtime sélectionné, un message indique le nombre de runtimes affectées.
   • Pour plus d'informations, consultez Gestion des déclencheurs dans Orchestrator et la documentation sur les runtimes (licences robot) .
8. Cliquez sur le bouton Ajouter un déclencheur (Add Trigger ) pour créer votre déclencheur et l'activer.

Vous pouvez également créer un nouveau déclencheur à partir de l'onglet Connexions (Connections). Pour ce faire :

1. Cliquez sur le bouton Autres actions ( More Actions ) d'une connexion.
2. Sélectionnez l'option Ajouter un déclencheur (Add trigger).
3. Sélectionnez l' événement et le type d'enregistrement souhaités dans leurs menus déroulants respectifs. Dans ce cas, le Connecteur et la Connexion sont déjà sélectionnés et ne peuvent pas être modifiés.
4. Sur la droite, sélectionnez le Processus à exécuter (Process to execute ) et la Licence runtime correspondante.

5. Cliquez sur le bouton Ajouter un déclencheur (Add Trigger ) pour créer votre déclencheur et l'activer.

   Remarque :

   La surveillance des événements est actuellement configurée pour interroger toutes les 5 minutes. Par conséquent, le démarrage du processus associé peut prendre jusqu'à 5 minutes.

   Vous pouvez voir les détails d'une tâche dans l'onglet Tâches ( Jobs ) de votre dossier Orchestrator. Une tâche démarrée depuis Integration Service affichera sa source en tant que Integration Trigger.

Events

Les connecteurs prennent en charge les événements via un mécanisme d'interrogation. Ceci est pris en charge pour la majorité du catalogue de connecteurs.

Integration Service prend en charge les deux types d'événements suivants :

1. Générique, qui représentent les opérations de création, de mise à jour et de suppression classiques. Lorsque vous sélectionnez un événement générique, vous devez également définir l'enregistrement d'événement à surveiller. Par exemple, Nouvel enregistrement créé pour l'enregistrement Calendrier .

   
   

   

   
   

2. Prédéfinies, qui représentent des actions spécifiques sur des objets spécifiques. Par exemple, un événement de calendrier est créé.

   
   

   

   
   

Plus d'informations sur les événements sont disponibles sur la page de chaque connecteur.

Filtres de données

Lorsque vous définissez un événement pour votre déclencheur, vous pouvez ajouter un filtrage plus spécifique.

Grâce aux filtres de données, vous pouvez configurer des déclencheurs qui correspondent à des modèles de données spécifiques. Cela signifie moins de lancements de votre robot et ne pas avoir à appliquer de filtrage supplémentaire dans votre automatisation.

Intervalle d'interrogation

Lorsque vous créez une nouvelle connexion et que vous configurez un déclencheur d'événement sur cette connexion, l'intervalle d'interrogation est défini par défaut sur cinq minutes.

Vous pouvez personnaliser cet intervalle à l'aide de la fonctionnalité Intervalle d'interrogation ajustable ( Ajustable Polling Interval ), qui vous permet de choisir l'intervalle selon lequel les déclencheurs d'événement recherchent de nouveaux événements d'objet.

Attention : Vous ne pouvez avoir qu'un seul intervalle d'interrogation par connexion, même si vous pouvez configurer plusieurs déclencheurs par connexion. La modification de l'intervalle d'interrogation affecte tous les déclencheurs associés sur une connexion.

L’interrogation s’exécute sur la connexion à l’intervalle sélectionné. Une fois les données récupérées, tous les déclencheurs actifs pour cette connexion sont appliqués à l'ensemble de données. Si une interrogation est en cours d'exécution lorsque vous modifiez l'intervalle, le service attend la fin de l'interrogation existante, puis en démarre une autre.

Modification de votre intervalle d'interrogation

Vous pouvez modifier votre intervalle d'interrogation à partir de la page d'un connecteur spécifique ou de l'onglet Connexions (Connections).

1. Dans Automation Cloud^TM, accédez à Integration Service.
2. Accédez à la page Connecteurs et sélectionnez un connecteur.
3. Dans la page du connecteur, sélectionnez une connexion pour ouvrir la page des détails de la connexion.

4. Cliquez sur l'intervalle situé sous le nom de la connexion, comme suit. L'intervalle d'interrogation s'affiche uniquement pour les connexions avec des déclencheurs ajoutés.

   
   

   

   
   

Vous pouvez également configurer votre intervalle d'interrogation à partir de l'onglet Connexions (Connections) :

1. Dans Integration Service, accédez à l'onglet Connexions (Connections).
2. Sélectionnez une connexion spécifique pour ouvrir la page des détails de la connexion.
3. Cliquez sur l'intervalle situé sous le nom de la connexion.
4. La fenêtre Mettre à jour l'intervalle d'interrogation ( Update polling interval ) s'affiche.

5. Vous pouvez choisir l'une des options disponibles ou configurer un intervalle personnalisé , en minutes ou en heures. L'intervalle d'interrogation doit être supérieur à une minute et ne doit pas dépasser 24 heures ou 1 440 minutes.

   
   

   

   
   

   Le message d'erreur suivant vous avertit si vous saisissez une valeur incorrecte : « L'intervalle d'interrogation doit être un nombre naturel de 1 à 1 440 minutes ou 24 heures. »

6. Sélectionnez Intervalle de mise à jour.

Historique des exécutions de déclencheur

Vous pouvez afficher l'historique d'exécution d'un déclencheur en cliquant simplement dessus dans l'onglet Déclencheurs (Triggers). Dans la nouvelle page, l' historique des Tentatives (Attempts) s'affiche dans la partie inférieure de l'interface.

Cet historique affiche les événements reçus par Integration Service et indique si le processus a été lancé avec succès. Dans ce cas, il affiche le mot Réussite ( Successful ) dans la colonne État (State).

Remarque : L'état Réussi ( Successful ) indique uniquement que la tâche a été lancée avec succès. Il n'indique pas si la tâche a été exécutée avec succès jusqu'à la fin ou non.

Attention : dans le cas où une tâche ne démarre pas, son État (State) apparaît comme Échec ( Failed) . Pointez avec le curseur de la souris sur l'état Échec (Failed) pour afficher le message d'erreur.

Pour vérifier si une tâche a été exécutée avec succès, cliquez sur le bouton Afficher les journaux des tâches ( View job logs ). Il vous redirige vers Orchestrator, où toutes les informations nécessaires sur l'exécution des tâches sont affichées.

Suppression d'un déclencheur

Accédez à l'onglet Déclencheurs (Triggers) dans la fenêtre Integration Service . Cliquez sur le bouton Autres actions (More Actions ) correspondant à votre déclencheur et sélectionnez Supprimer ( Delete).

Vue des détails du déclencheur

Cliquez simplement sur un déclencheur pour afficher ses détails.

Activer/désactiver un déclencheur

Pour activer ou désactiver un déclencheur, vous devez d'abord cliquer dessus pour afficher ses détails. Cliquez ensuite sur le commutateur situé dans le coin supérieur gauche de la fenêtre.

Désactivation automatique d'un déclencheur en cas d'échec

Un déclencheur est désactivé et défini sur l'état d'erreur si vous n'êtes pas en mesure de démarrer la tâche après 11 tentatives (environ 34 heures) pour un seul événement ou si la tâche ne démarre pas après les 100 derniers événements.

Les 10 nouvelles tentatives pour chaque événement sont effectuées avec une stratégie d'interruption exponentielle. Chaque nouvelle tentative suivante intervient après un délai deux fois plus long que la tentative précédente.

Renommer un déclencheur

Suivez les étapes ci-dessous pour renommer un déclencheur :

1. Accédez à l'onglet Déclencheurs (Triggers).

2. Pointez avec le curseur de la souris sur le nom du déclencheur que vous souhaitez modifier et vous devriez maintenant voir le bouton Modifier (Edit) affiché.

   Remarque : Vous pouvez également sélectionner votre déclencheur dans la liste pour accéder à la vue détaillée. Le bouton Modifier (Edit) est situé sur le côté droit du nom de votre déclencheur.
3. Cliquez sur le bouton Modifier (Edit) et vous pouvez choisir un nouveau nom pour votre déclencheur.

Limitations

Nous n'exposons actuellement pas les API d'Integration Service via Swagger.