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 s’affiche dans la fenêtre Intégrations.
• 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. Grâce à 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
  • UiPathEventObjectId Remarque : pour en savoir plus sur le fonctionnement des Arguments et leur gestion, cliquez ici.

• To retrieve and work with a record that has a trigger on a job run, use the UiPathEventObjectId input argument to retrieve the record from the source system.

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, Connexions et Déclencheurs.
3. Accédez à l'onglet Déclencheurs et sélectionnez le bouton Ajouter un déclencheur .
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 spécifique, elle est 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. Ensuite, sélectionnez le processus à exécuter.
7. Dans la liste déroulante, sélectionnez la Licence de runtime . La liste des runtimes affichées est basée sur la réponse reçue d'Orchestrator, c'est-à-dire les licences de runtime « attribuées » à ce dossier. Pour le runtime sélectionné, un message indique le nombre de runtimes affectés. Pour de plus amples informations, consultez la documentation Gestion des déclencheurs dans Orchestrator et Runtimes (licences robot) .
8. Sélectionnez le bouton Ajouter un déclencheur pour créer votre déclencheur et l'activer.

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

1. Sélectionnez le bouton Autres actions d'une connexion.
2. Select the Add trigger option.
3. Select the desired Event and Record Type from their respective dropdown menus. In this case, the Connector and Connection are already selected and cannot be changed.
4. On the right, select the Process to execute and the respective Runtime license.
5. Sélectionnez le bouton Ajouter un déclencheur pour créer votre déclencheur et l'activer.

Remarque :

La surveillance des événements est actuellement définie pour interroger toutes les cinq minutes. Par conséquent, le processus associé peut prendre jusqu'à cinq minutes avant le démarrage du processus associé. Vous pouvez voir les détails d’une tâche dans l’onglet Tâches de votre dossier Orchestrator. Une tâche démarrée à partir d’Integration Service affichera sa source sous la forme Déclencheur d’intégration.

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 standard. Lorsque vous sélectionnez un événement générique, vous devez également définir l'enregistrement de l'événement à surveiller. Par exemple, Enregistrement créé pour l'enregistrement Calendrier .
2. Prédéfini, qui représentent des actions spécifiques sur des objets spécifiques. Par exemple, Événement de 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.

With Data filters, you can configure triggers that match specific data patterns. This means fewer launches of your robot and not having to apply additional filtering within your automation.

Intervalle d'interrogation

Les connecteurs prennent en charge les événements via un mécanisme 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.

Le champ Intervalle d'interrogation ajustée vous permet de personnaliser l'intervalle sur lequel les déclencheurs d'événement vérifient les nouveaux événements d'objet.

Important :

You can have only one polling interval per connection, even though you can have several triggers set up per connection. Changing the polling interval affects all the associated triggers on a connection.

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 .

1. Dans Automation Cloud^TM, accédez à Integration Service.

2. Go to the Connectors page and select a connector.

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.

   

Alternatively, you can configure your polling interval from the Connections tab:

1. Dans Integration Service, accédez à l'onglet Connexions .

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. The Update polling interval window is displayed.

5. Vous pouvez choisir l’une des options disponibles, ou bien 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 . Sur la nouvelle page, l' historique des Tentatives s'affiche dans la partie inférieure de l'interface.

Cet historique indique les événements qui ont été reçus par Integration Service et si le processus a été lancé avec succès, auquel cas il affiche le mot Réussi dans la colonne État .

Remarque :

The Successful state only indicates that the job was successfully launched. It does not reflect whether the job was successfully executed to the end or not.

Important :

In case a job fails to start, its State will appear as Failed. Hover with the mouse cursor over the Failed state to view the error message.

Pour vérifier si une tâche a été exécutée correctement, sélectionnez le bouton View job logs . Il vous redirigera vers Orchestrator, où toutes les informations nécessaires à l'exécution de la tâche seront affichées.

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.

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

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