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é de l'utilisateur moderne ; il ne peut 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, procédez comme suit :

• 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 à 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, sélectionnez 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 sélectionnez 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 la section Gestion des déclencheurs dans Orchestrator et Runtimes (licences robot) .
8. Sélectionnez 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. Sélectionnez 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. Sélectionnez 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 (Generic), qui représentent les opérations Create (Création), Mettre à jour (Update) et Supprimer (Delete) standard. Lorsque vous sélectionnez un événement générique, vous devez également définir l'enregistrement d'événement à surveiller. Par exemple, Enregistrement créé pour l'enregistrement Calendrier .

2. Prédéfinis, qui représentent des actions spécifiques sur des objets spécifiques. Par exemple, Événement du calendrier 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. Sélectionnez l'intervalle trouvé 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. Sélectionnez l'intervalle trouvé 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 le sélectionnant simplement dans l'onglet Déclencheurs (Triggers) . Dans la nouvelle page, l' historique des tentatives est affiché 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é correctement exécutée, sélectionnez le bouton Afficher les journaux de la tâche (View job logs) . Il vous redirigera vers Orchestrator, où toutes les informations nécessaires sur l’exécution de la tâche seront affichées.

Suppression d'un déclencheur

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

Renommer un déclencheur

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

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. Le bouton Modifier (Edit) s'affiche.

   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. Sélectionnez le bouton Modifier (Edit) et vous pouvez choisir un nouveau nom pour votre déclencheur.

Vue des détails du déclencheur

Sélectionnez un déclencheur pour afficher ses détails.

Activation ou désactivation d'un déclencheur

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

Limitations

Cette section répertorie les limitations connues des déclencheurs Integration Service.

Limitation maximale d'enregistrements

Description

Les déclencheurs Integration Service ont actuellement une limite maximale de 1 000 enregistrements par exécution de déclencheur. Si un déclencheur tente de récupérer plus de 1 000 enregistrements dans l'intervalle de temps configuré (par exemple, une minute ou cinq minutes) et que le système du fournisseur émet plus d'enregistrements que cette limite, tous les enregistrements dépassant le seuil ne sont pas capturés et peuvent être perdus.

Impact

Cette limitation peut affecter les workflows ou les automatisations qui nécessitent de traiter de grands ensembles de données, car le déclencheur peut ne pas récupérer tous les enregistrements.

Solution de contournement

Nous travaillons activement pour répondre à cette contrainte. Jusque-là, pour minimiser l'impact, vous pouvez configurer l'intervalle de déclenchement sur la durée minimale possible, comme expliqué dans Intervalle d'interrogation (Polling interval). L'augmentation de la fréquence d'exécution des déclencheurs garantit que tous les enregistrements soient capturés sur plusieurs exécutions de déclencheur.

Désactivation automatique des déclencheurs

Si un déclencheur rencontre 100 erreurs consécutives causées par des problèmes dans des applications tierces lors de l'interrogation pour des événements nouveaux ou mis à jour, le système désactive automatiquement le déclencheur. Ce mécanisme permet de maintenir la stabilité du système.

Lorsque l'un de vos déclencheurs est désactivé, vous recevez une notification par e-mail. Vous devez réactiver manuellement le déclencheur une fois que le problème sous-jacent à l'origine des erreurs a été résolu.

Modification des déclencheurs

La modification d'un déclencheur existant n'est actuellement pas prise en charge. Les seules options de gestion des déclencheurs sont la création ou la suppression de déclencheurs. Pour toutes les modifications souhaitées, vous devez supprimer le déclencheur existant et en ajouter un nouveau.