Création d'un déclencheur

Vous pouvez créer un déclencheur dans le cadre d'un connecteur personnalisé. Vous pouvez utiliser des déclencheurs de connecteur personnalisés pour démarrer automatiquement des automatisations ou des processus en fonction des événements des fournisseurs.

Mode de fonctionnement

Les déclencheurs du générateur de connecteurs utilisent l’interrogation de ressource pour détecter les modifications du fournisseur. L'interrogation de ressource consiste à appeler une ressource API sur un intervalle régulier pour détecter lorsque de nouveaux événements sont renvoyés.

Une fois qu'un connecteur personnalisé est publié et que le déclencheur est utilisé dans une automatisation publiée, l'URL définie est utilisée comme ressource d'interrogation pour récupérer les événements et démarrer un flux d'automatisation.

Détection de nouveaux événements

L'URL d'interrogation du déclencheur doit inclure des paramètres de requête pour filtrer les résultats du fournisseur.

L'interrogation se produit à un intervalle planifié (toutes les 5, 10, 15 minutes, etc.). Par conséquent, l'un des paramètres de requête du fournisseur doit être une date pour le filtrage des résultats. De cette façon, le moteur d'interrogation peut remplir la valeur du paramètre de requête pour inclure uniquement les événements qui se sont produits depuis la dernière interrogation.

Limitations

• Vous pouvez créer un déclencheur par ressource. Si plusieurs cas d'utilisation sont nécessaires, utilisez une URL d'interrogation plus générale et configurez des champs de filtre de réponse qui peuvent répondre à plusieurs cas d'utilisation.

• Les API du fournisseur doivent permettre le filtrage des paramètres de requête basé sur la date. Si aucun paramètre de requête basé sur la date n'est disponible auprès du fournisseur, il ne doit pas être utilisé comme déclencheur.

Prérequis

Exigences pour le fournisseur

L'API du fournisseur doit offrir une ressource avec un point de terminaison GET qui renvoie une liste d'objets. De plus, le point de terminaison doit vous permettre d'interroger la ressource en fonction d'un paramètre de date.

Exemple de ressource valide

Pipedrive propose un point de terminaison Obtenir toutes les activités (Get all activities), qui renvoie une collection d'activités. Ce point de terminaison comprend un paramètre de requête since qui filtre les résultats par toutes les activités avec une date update_time supérieure à la date since fournie comme valeur dans le paramètre de requête. Vous pouvez utiliser le paramètre since dans le cadre de l'URL d'interrogation pour détecter les mises à jour des activités Pipedrive. Le moteur d'interrogation UiPath remplit automatiquement ce champ de date pour capturer les événements.

Exigences pour le connecteur

Les déclencheurs du générateur de connecteurs utilisent des ressources déjà disponibles sur le connecteur comme URL d’interrogation. Lors de la création d'un déclencheur, il doit y avoir une ressource existante côté connecteur à laquelle le déclencheur doit être associé.

Les déclencheurs utilisent la configuration de la ressource. Il est donc important que la ressource existante dispose déjà des éléments suivants :

• Paramètres de requête ( Query parameters) : les déclencheurs peuvent importer des paramètres de requête existants, de sorte que la ressource doit déjà avoir des paramètres configurés avant de créer le déclencheur.

• Champs de réponse: les déclencheurs génèrent l'objet de réponse de la ressource associée, ainsi que permettent la configuration de l'activité en fonction de ces champs. Il est nécessaire de générer les champs de réponse de la ressource en appelant avec succès le point de terminaison.

Création d'un déclencheur personnalisé

Pour créer un déclencheur dans le générateur de connecteurs, procédez comme suit :

Ajouter un déclencheur

1. Tout d'abord, assurez-vous de remplir les conditions préalables.
2. Dans Integration Service, ouvrez Générateur de connecteurs (Connector Builder), puis sélectionnez votre connecteur personnalisé.
3. Sélectionnez les options Plus à côté de Déclencheurs ( Triggers).
4. Sélectionnez Ajouter un déclencheur (Add trigger).

Définir le nom et la ressource

La fenêtre contextuelle Créer un événement (Create event) s’affiche. Ici, vous pouvez sélectionner le type d'événement à créer. Actuellement, l' interrogation est la seule option disponible.

1. Sélectionnez le type d'événement.
2. Ajoutez un nom pour votre déclencheur.
3. Sélectionnez la ressource utilisée pour détecter ces événements.
4. Sélectionnez Créer (Create) pour démarrer le processus de configuration de vos déclencheurs.

Configurer le déclencheur

Le processus de création d'un déclencheur comprend trois étapes :

1. Configurer la requête.
2. Configurer la réponse.
3. Configurez les filtres de déclencheur.

Ces étapes correspondent au processus d'interrogation d'une URL de ressource et d'utilisation de la réponse.

Astuce : Utilisez la fonctionnalité Tester le déclencheur tout au long du processus de configuration du déclencheur pour vous assurer qu'il fonctionne comme prévu.

Configurer la requête

Tout d'abord, vous configurez la configuration de l'URL d'interrogation et la façon dont le déclencheur s'affiche dans Studio lorsqu'il est utilisé dans une automatisation.

La mise en page d'aperçu représente la façon dont le déclencheur est affiché dans Studio. Vous pouvez configurer les paramètres et les champs de réponse pour modifier les champs affichés et utilisés dans Studio lors de la configuration du déclencheur d'une automatisation.

URL d'interrogation

L'URL d'interrogation s'affiche en haut de la page de configuration. Il s'agit de l'URL utilisée pour envoyer des demandes au fournisseur afin de détecter de nouveaux événements.

Cette URL doit être configurée de manière à filtrer les événements d'intérêt. L'URL d'interrogation utilise un paramètre de date pour filtrer les nouveaux événements depuis la dernière requête d'interrogation. Il est obligatoire d'inclure un paramètre de date que le moteur d'interrogation peut remplir.

Importer les paramètres

Les déclencheurs peuvent importer des paramètres de ressource à utiliser dans l'URL d'interrogation.

Si un paramètre n'est pas disponible dans la ressource, accédez à la ressource et ajoutez-la, puis revenez à la fenêtre de configuration du déclencheur pour l'importer.

1. Sélectionnez Importer les paramètres (Import parameters) pour afficher la liste des paramètres disponibles pour une ressource spécifique.
2. Sélectionnez le paramètre à utiliser dans l'URL d'interrogation.
3. Une fois qu'un paramètre est ajouté, il est inclus dans l'aperçu de l'URL en haut de la page.

Vous pouvez marquer les paramètres importés comme Obligatoires(Required), afin qu'ils apparaissent sur la zone de dessin du déclencheur. Cela signifie que vous devez saisir une valeur pour le paramètre de requête lors de l'utilisation du déclencheur dans une automatisation.

Important : au moins un paramètre de requête basé sur la date est nécessaire pour l'URL d'interrogation. Un paramètre de requête basé sur date est n'importe quel paramètre avec un format DateTime . Les formats DateTime peuvent être trouvés pour un paramètre avec un type de données de fournisseur String ou Integer .

Sauf si une valeur de date spécifique est spécifiée, les paramètres de requête basés sur la date sont automatiquement renseignés avec une valeur égale à celle de la date et de l'heure de la précédente requête d'interrogation.

Déclencheur de test

Utilisez l'option Tester le déclencheur (Test trigger ) pour vous assurer que les résultats attendus sont renvoyés.

Lorsque vous sélectionnez Tester le déclencheur ( Test trigger), la fenêtre Essayer la demande (Try the request) s'affiche et indique :

• Période d'interrogation ( Look-back Period) : ce champ définit la date à insérer dans les paramètres de requête basés sur la date et réplique le comportement de notre moteur d'interrogation, qui renseigne automatiquement cette valeur en fonction de la date de la dernière demande d'interrogation.
• Les paramètres de requête spécifiés comme requis.

Sélectionnez Essayer de demander ( Try request) pour ouvrir le panneau Débogage des événements (Events Debug ) et voir le traçage de la demande avec une répartition étape par étape du processus de demande. Le nombre de résultats renvoyés est également affiché.

Remarque: Vérifiez que le nombre de résultats renvoyés est le nombre de résultats attendus. L'utilisation incorrecte des paramètres de requête peut entraîner un niveau élevé d'objets de sortie et une utilisation inutile du robot une fois le connecteur publié et le déclencheur utilisé dans un workflow.

Il est recommandé d'avoir des attentes de réponse (nombre d'événements, types d'événements, etc.) lors du test d'un déclencheur afin de vérifier que les filtres de paramètres de requête fonctionnent comme prévu.

Configurer la réponse

À cette étape, vous spécifiez quel champ de réponse correspond à la clé primaire ou à la sortie du déclencheur.

1. Utilisez la liste déroulante sous la clé primaire pour sélectionner un champ.
2. Le champ sélectionné est ajouté à l'aperçu du déclencheur, sous Sortie ( Output). Vous pouvez utiliser cette sortie dans les étapes ultérieures de votre workflow.

L'étape Configurer la réponse (Configure response) fournit également une vue de l'objet de réponse associé à la ressource d'interrogation pour révision.

Configurer les filtres de déclencheur

Une fois que vous avez configuré la requête et la réponse, vous pouvez configurer davantage le déclencheur à l'aide de filtres.

Vous configurez le filtrage des événements en définissant des valeurs spécifiques pour les champs de réponse. Ces valeurs sont spécifiées lors de la configuration de l'automatisation (dans Studio), mais le concepteur de déclencheur vous permet également de configurer les champs affichés à des fins de filtrage.

Hydratation

Si la ressource utilisée comme URL d'interrogation ne renvoie pas l'objet entier nécessaire pour la sortie du déclencheur, il est possible d'hydrater la réponse à l'aide d'un point de terminaison GETBYID . Ce processus est appelé ingestion.

Sélectionnez l'onglet Hydratation (Azure), activez le bouton bascule Utiliser l' indiqué dans l'option d'adhésion, et spécifiez le point de terminaison à utiliser pour l'adhésion, ainsi que l'ID utilisé pour interroger l'objet.

Remarque : la liste des ressources d'hydratées possibles est extraite de la liste Obtenir les enregistrements (Get recordings) du panneau de navigation de gauche. Configurez la ressource GETBYID avant de l'utiliser comme ressource d'actualisation pour un déclencheur.

L'utilisation de l'option d'hydratée remplace les champs de réponse des champs de ressource de réponse d'interrogation par les champs de réponse de ressource hydratés. Ensuite, les champs de réponse d'ingestion deviennent les seuls champs disponibles pour les paramètres de déclencheur et la configuration des filtres.

Filtres

Le processus de configuration du déclencheur offre trois options d'affichage des champs utilisés pour le filtrage. Ces champs sont extraits des champs de réponse de la ressource d'interrogation ou de la ressource d'hydraté. Ces options sont disponibles dans la colonne Afficher sous (Show as) du tableau des paramètres de filtre :

• Masqué ( Hidden) : le champ est masqué dans la zone de dessin et n'est pas disponible dans le Générateur de filtres. Si tous les champs sont marqués comme Masqués, le Générateur de filtres est également masqué.

• Facultatif(Optional) : au moment de la conception, le champ est affiché en tant qu'option dans le générateur de filtres.

• Obligatoire(Required) : au moment de la conception, le champ est affiché directement sur la zone de dessin du déclencheur et nécessite une intervention de l'utilisateur. Seuls les événements dont la valeur du champ de réponse correspond à la valeur fournie entraînent un événement d'automatisation.

Enregistrer le déclencheur

Une fois que vous avez terminé de configurer le filtre, sélectionnez le bouton Enregistrer (Save). Une fois enregistré, le déclencheur sera inclus en tant qu'événement lorsque le connecteur est publié.

Utilisation du déclencheur

Une fois qu'un déclencheur est enregistré et qu'il n'est plus en mode brouillon, le déclencheur peut être utilisé dès que vous avez publié votre connecteur personnalisé.