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.

Déclencheurs dans Orchestrator

Important :

À partir de fin avril 2025, vous pouvez créer de nouveaux déclencheurs Integration Service uniquement dans Orchestrator.

Les déclencheurs créés dans Orchestrator ne seront pas répertoriés dans l'onglet Déclencheurs d'Integration Service (Integration Service Triggers) . Les déclencheurs Integration Service existants continueront de s'exécuter et resteront visibles dans l'onglet Déclencheurs Integration Service (Integration Service Triggers) jusqu'au 31 juillet 2025 (cette date est soumise à d'éventuelles extensions). Passée cette date, les déclencheurs Integration Service existants seront migrés vers Orchestrator et l'onglet Déclencheurs (Triggers ) dans Integration Service sera supprimé.

Cette modification devrait d'abord être disponible pour les utilisateurs Community, puis progressivement pour les utilisateurs Enterprise, en fonction des régions de l'organisation et du locataire. Suivez le guide des notes de publication d'Integration Service pour savoir quand la modification est annoncée pour la première fois.

Principaux avantages des déclencheurs dans Orchestrator

Le déplacement des déclencheurs Integration Service vers Orchestrator constitue un grand changement, mais comporte de nombreux avantages. Voici les principales raisons pour lesquelles cette mise à jour est à l’origine :

1. Mappage compte-machine: Orchestrator permet le contrôle au niveau de la machine des processus déclenchés par Integration Service.
2. Contrôle d'exécution des processus spécifiques aux bots: Orchestrator vous permet de spécifier quel robot doit exécuter un processus dans un dossier où plusieurs bots sont alloués. Cela fournit un contrôle précis sur lequel bot exécute un processus déclenché, élimine le besoin de solutions de contournement telles que les dossiers à bot unique et améliore l'évolutivité en permettant plusieurs bots sans perdre le contrôle de l'exécution.
3. Arguments d'entrée et affectation dynamique des processus: Orchestrator active les arguments d'entrée dynamiques et vous permet de définir le nombre maximal d'instances de processus actives. Cela réduit les doublons de processus en autorisant des arguments dynamiques, optimise l'utilisation des ressources en limitant les processus actifs et améliore l'efficacité des processus qui gèrent les requêtes de manière séquentielle.
4. Gestion améliorée des processus de longue durée: les déclencheurs créés dans Orchestrator prennent en charge les options « Arrêter après » et « Forcer l'arrêt après », permettant la fin automatique des processus après une durée ou une condition spécifiée. Cela empêche la surutilisation des ressources en mettant fin aux processus de longue durée et garantit une exécution rapide en arrêtant les workflows qui ne répondent pas.
5. Fonctionnalités de modification: Orchestrator vous permet de modifier les déclencheurs existants.
6. Expérience de déclenchement unifiée: créez et gérez tous les types de déclencheurs à partir d'un seul emplacement.
7. Vue de déclencheur unique: le déplacement de la création de déclencheurs vers Orchestrator garantit que tous les déclencheurs basés sur Integration Service conservent une vue unique. Vous pouvez désormais créer un déclencheur basé sur Integration Service de deux manières : depuis Integration Service, en créant un déclencheur pour un connecteur spécifique, et depuis Studio, en utilisant une activité de déclencheur pour démarrer une automatisation. Les informations de configuration affichées pour les deux déclencheurs peuvent différer légèrement, même s'ils capturent le même événement.

Vue d'ensemble (Overview)

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

• Connecté (Connected ) : créé avec des activités de déclencheur dans Studio, utilisé à l'intérieur d'un processus.
• Déconnecté (Disconnected ) : créé dans Orchestrator ou Integration Service, utilisé pour démarrer n'importe quelle 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).

Création de déclencheurs

Vous créez des déclencheurs d'événements déconnectés directement depuis Orchestrator. Pour plus de détails, consultez la section Déclencheurs d'événements (Event triggers) dans le guide de l'utilisateur d'Orchestrator.

Orchestrator fournit une gestion directe de ces déclencheurs. Dans Integration Service, votre seule option de modification de déclencheur consiste à ajuster l'intervalle d'interrogation, qui est défini au niveau de la connexion.

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 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.

Pour mettre à jour l'intervalle d'interrogation :

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.

   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 (Update polling interval) .

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 (Update and Check).

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

Important : la table de l'historique des tentatives est disponible exclusivement pour les déclencheurs créés dans Integration Service et répertoriés dans l'onglet Déclencheurs (Triggers) . L'historique des tentatives n'est pas disponible pour les déclencheurs créés dans Orchestrator.

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

1. Dans Integration Service, sélectionnez l'onglet Déclencheurs (Triggers) .
2. Pour tout déclencheur répertorié, sélectionnez Afficher le déclencheur (View trigger) en utilisant le Menu Autres actions (More Actions) :

La table de l'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 (Successful) indique uniquement que la tâche a été lancée avec succès. Cela ne signifie 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 (Failed). Survolez l'état Échec (Failed ) avec le curseur de la souris 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) . 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. Les déclencheurs créés directement dans Orchestrator peuvent être gérés à partir d'Orchestrator.

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.
   Vous pouvez également sélectionner votre déclencheur dans la liste afin d'accéder à la vue détaillée. Le bouton Modifier (Edit) est situé à droite de votre nom de déclencheur.
3. Sélectionnez le bouton Modifier (Edit) pour choisir un nouveau nom pour votre déclencheur

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).

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 concerné par l'événement.

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 à partir de la documentation de Studio : Gestion des arguments (Managing 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 à l'objet. 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énementsMicrosoft 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.

Limitations

Les limitations de déclencheur sont documentées dans la section Dépannage de ce guide. Voir Limitations des déclencheurs.