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.

Vue d'ensemble (Overview)

Il existe deux types de déclencheurs d'événement basés sur les connexions Integration Service :

• Connecté : créé avec des activités de déclencheur dans Studio, utilisé à l'intérieur d'un processus.
• Déconnecté : créé dans Orchestrator ou dans Integration Service, utilisé pour démarrer une automatisation.

Remarque :

Les déclencheurs dépendent des connexions. La suppression d'une connexion supprime également tous les déclencheurs associés.

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.
• 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).
• Les utilisateurs qui travaillent avec des déclencheurs disposent des autorisations nécessaires dans Orchestrator. Pour créer un déclencheur, un utilisateur doit disposer de l'autorisation Déclencheurs - Création dans le dossier cible. Pour plus d'informations sur les autorisations, consultez Configurer l'accès pour les comptes dans le guide de l'utilisateur Orchestrator.

Fonctionnement des déclencheurs

Les déclencheurs basés sur l'interrogation tels que Enregistrement créé ou Incident créé sont disponibles pour plusieurs connecteurs UiPath. Ce type de déclencheur détecte les nouveaux enregistrements en utilisant un mécanisme d'interrogation par rapport aux API publiques de l'application cible.

Les déclencheurs fonctionnent comme suit :

1. Intervalle d'interrogation : Integration Service interroge le système cible à un intervalle défini (par défaut toutes les cinq minutes). L'intervalle d'interrogation est défini au niveau de la connexion. Par conséquent, la modification de l'intervalle d'interrogation affecte tous les déclencheurs associés à cette connexion.

2. Détection basée sur l'API : au cours de chaque cycle d'interrogation, Integration Service interroge l'objet ou la table pertinent à l'aide des API REST standard du fournisseur.

3. Identification incrémentielle des enregistrements : les nouveaux enregistrements sont identifiés à l'aide des paramètres de requête de l'API, le plus souvent en fonction des éléments suivants :

   • Horodatage sys_created_on création de l'enregistrement
   • Dans certains scénarios, les horodatages de modification

   Integration Service stocke l'horodatage de création le plus récent (ou marqueur équivalent) du dernier cycle d'interrogation réussi. Lors de l'interrogation suivante, la requête reprend à partir de cette valeur stockée, garantissant la continuité et évitant le traitement en double.

   Par exemple, une requête visant à interroger les nouveaux incidents de ServiceNow peut ressembler à ceci : GET https://{instance}.service-now.com/api/now/v1/table/incident?sysparm_query=sys_created_on>={last_max_created_date}

   Remarque :

   Des paramètres supplémentaires tels que la pagination, les limites, les décalages ou l'expansion du champ peuvent être inclus pour prendre en charge le filtrage et le façonnement des données. Ceux-ci ne modifient pas la logique d'interrogation de base.

Mise à jour de l'intervalle d'interrogation

Les connecteurs prennent en charge les événements via un mécanisme d'interrogation.

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

L'intervalle d'interrogation est défini au niveau de la connexion. Cela signifie que vous ne pouvez avoir qu'un seul intervalle d'interrogation par connexion, même si vous créez plusieurs déclencheurs par connexion. La modification de l'intervalle d'interrogation affecte tous les déclencheurs associés à 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.

Pour mettre à jour l'intervalle d'interrogation :

1. Dans Integration Service, accédez à l'onglet Connexions .
2. Sélectionnez une connexion spécifique pour ouvrir la page des détails de connexion. L'intervalle d'interrogation s'affiche uniquement pour les connexions avec des déclencheurs ajoutés.
3. Sélectionnez l'intervalle de temps pour ouvrir la fenêtre Mettre à jour l'intervalle d'interrogation .
4. 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.
5. Sélectionnez Mettre à jour et vérifier.

Afficher l'historique des exécutions de déclencheur

Pour afficher l'historique des exécutions de déclencheur :

1. Dans Integration Service, sélectionnez l'onglet Déclencheurs .
2. Pour tout déclencheur répertorié, sélectionnez Afficher le déclencheur à l’aide du Menu Autres actions :

La table Historique des tentatives indique :

• L'heure de l'événement : le moment où l'événement a été capturé
• Le nombre de tentatives
• L'état du déclencheur : indique si le processus a été lancé ou non.

Remarque :

L'état Réussi indique uniquement que la tâche a été lancée avec succès. Il n'indique pas si la tâche a été correctement exécutée jusqu'à la fin ou non. Si une tâche ne démarre pas, son état apparaîtra comme Échec. Pointez avec le curseur de la souris sur l’état Échec pour afficher le message d’erreur.

Pour vérifier si une tâche a été exécutée correctement, sélectionnez le bouton View job logs . Cette action vous redirige vers Orchestrator, où vous pouvez voir toutes les informations nécessaires sur l'exécution de la tâche.

Gestion des déclencheurs

Les actions suivantes sont disponibles pour les déclencheurs créés dans Integration Service.

Renommer un déclencheur

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

1. Access the Triggers tab.
2. Pointez avec le curseur de la souris sur le nom du déclencheur que vous souhaitez modifier. Le bouton Modifier s'affiche.

Vous pouvez également sélectionner votre déclencheur dans la liste pour accéder à la vue détaillée. Le bouton Modifier se trouve à droite du nom de votre déclencheur. 3. Sélectionnez le bouton Modifier pour choisir un nouveau nom pour votre déclencheur

Suppression d'un déclencheur

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

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.

Arguments d'événement

Les déclencheurs déconnectés vous permettent de récupérer des données concernant le connecteur et l'événement qui déclenche un processus.

Si vous souhaitez connaître le connecteur réel, l'événement, le type d'enregistrement ou l'enregistrement qui a déclenché le processus dans votre workflow, définissez les arguments d'entrée suivants de type String dans votre processus. Integration Service les remplit automatiquement lorsqu'il démarre la tâche :

• UiPathEventConnector : Détermine quel connecteur a démarré l'automatisation.
• UiPathEvent : détermine le type d'événement qui s'est produit.
• UiPathEventObjectType : définit le type d'enregistrement spécifique résultant de l'événement.
• UiPathEventObjectId : fournit l'identifiant unique de l'objet impliqué dans l'événement.

Remarque :

Cela s'applique uniquement aux déclencheurs déconnectés. Pour les déclencheurs connectés, l'objet entier devrait déjà être disponible lorsque vous concevez votre processus.

Vous ne pouvez affecter aucune valeur à ces arguments. Ils sont remplis automatiquement au moment de l'exécution du déclencheur et vous ne pouvez pas les afficher ou les modifier à partir du panneau Arguments dans Studio. En savoir plus sur le fonctionnement des Arguments et leur gestion dans la documentation de Studio : Gestion des arguments.

Pour récupérer et utiliser un enregistrement disposant d'un déclencheur sur une exécution de tâche, utilisez l'argument d'entrée UiPathEventObjectId pour récupérer l'enregistrement du système source.

Voici un exemple de la façon dont Integration Service transmet les valeurs d'argument d'entrée dans les journaux Orchestrator :

Sorties spécifiques au déclencheur

Les déclencheurs connectés ont des sorties spécifiques aux objets. Par exemple, le déclencheur Microsoft OneDrive & SharePoint E-mail reçu génère un objet de type Office365Message, avec des propriétés telles que AttachmentsNamesList, FromAddress, InternetMessageId, SentDateTime etc. Pour plus de détails, consultez la section Événements Microsoft OneDrive & SharePoint.

Utilisez l' éditeur d'expressions dans Studio pour afficher toutes les propriétés disponibles pour tout objet de sortie de déclencheur.

Questions fréquemment posées

Si une connexion est interrompue, qu'arrive-t-il aux déclencheurs associés à cette connexion ?

Si une connexion est déconnectée, les déclencheurs associés s'arrêteront temporairement de s'exécuter. Une fois la connexion reconnectée avec succès, les déclencheurs reprennent automatiquement l'exécution. Assurez-vous également que le déclencheur n'est pas dans un état désactivé.

Pour les déclencheurs déconnectés, comment puis-je associer la sortie du déclencheur à mon processus ?

Consultez la section Arguments d'événement pour plus de détails sur la façon de récupérer les données concernant le connecteur et l'événement qui déclenche un processus.

À l'aide de l'argument UiPathEventObjectId , vous pouvez ajouter un appel d'activité Obtenir l'enregistrement ou HTTP dans votre processus pour récupérer les données d'enregistrement correspondantes.

Remarque :

Cela s'applique uniquement aux déclencheurs déconnectés. Pour les déclencheurs connectés, l'objet entier devrait déjà être disponible lorsque vous concevez votre processus.

Comment modifier l'intervalle d'interrogation pour mon déclencheur ?

Vous pouvez modifier l'intervalle d'interrogation directement à partir de la configuration du déclencheur. Reportez-vous à ce guide pour obtenir des étapes détaillées : Mise à jour de l'intervalle d'interrogation.

Puis-je filtrer les enregistrements qui déclenchent mon automatisation ?

Oui. Vous pouvez ajouter des filtres de données afin de contrôler les enregistrements qui déclencheront votre processus.

Remarque :

Les filtres sont appliqués une fois les enregistrements récupérés par Integration Service.

Par exemple :

• Créez un filtre dans Studio Web :

  

• Créez un filtre dans Orchestrator :

  

Pourquoi mon déclencheur ne s'active-t-il pas immédiatement ?

Le temps d'exécution du déclencheur peut varier en fonction du type de déclencheur, du volume de données et de la disponibilité du robot.

Pour les déclencheurs basés sur l'interrogation :

• Le déclencheur récupère les enregistrements nouveaux ou mis à jour en fonction de l' intervalle d'interrogation configuré dans Integration Service.

• Selon le volume de données récupérés, Integration Service applique tous les filtres ou conditions de déclencheur définis avant de transmettre les événements cela à Orchestrator.

• Ce traitement peut introduire une latence mineure, surtout lors de la gestion d'ensembles de données volumineux ou de filtres complexes.

• Une fois les événements transmis à Orchestrator, l'automatisation ne démarre que si un Robot Unattended est disponible à ce moment.

• Si l'intervalle d'interrogation est défini trop long, un grand volume de données peut être récupéré immédiatement, ce qui peut ralentir votre processus. Dans de tels cas, envisagez de réduire l’intervalle pour améliorer les performances.

  Remarque :

  Si votre déclencheur apparaît retardé, vérifiez votre intervalle d'interrogation, examinez l'efficacité des filtres et assurez-vous qu'un robot Unattended est disponible pour exécuter la tâche.

Pour les déclencheurs basés sur des Webhooks (p. ex. HTTP Webhook) :

• Les déclencheurs de Webhook sont conçus pour s’activer presque instantanément, car les événements sont envoyés directement par l’application externe à Integration Service.
• Étant donné que les webhooks gèrent généralement un enregistrement par transaction, la latence est minimale.
• Cependant, si les filtres de déclencheur ou la logique de traitement sont appliqués avant que l'événement ne soit transmis à Orchestrator, il est possible que vous observiez toujours un petit délai.

Comment dépanner un déclencheur qui ne s'active pas ?

• Vérifiez que la connexion associée est active.
• Vérifiez que le déclencheur est activé.
• Vérifiez si votre connexion nécessite une étendue ou un rôle spécifique pour accéder au point de terminaison de l’API cible qui est en cours d’interrogation.
• Confirmez que le filtre correspond aux données attendues.
• Pour les déclencheurs de Webhook, confirmez que l’enregistrement du Webhook soit valide sur l’application externe.

Quand un déclencheur récupère-t-il les enregistrements pour la première fois ?

La première exécution d'un déclencheur commence à partir du moment où le déclencheur est créé.

Les enregistrements créés avant la création du déclencheur ne sont pas récupérés et tous les enregistrements créés/mis à jour après l’horodatage de création du déclencheur sont éligibles pour le traitement en fonction des filtres du déclencheur.

Limitations

Les limitations de déclencheur sont documentées dans la section Résolution des problèmes de ce guide. Voir Limitations des déclencheurs.