- Démarrage
- Notifications
- Résolution des problèmes
- Générateur de connecteurs
- ActiveCampaign
- Active Directory - Aperçu
- Adobe Acrobat Sign
- Adobe PDF Services
- Amazon Bedrock
- Amazon Connect
- Amazon Polly
- Amazon Ses
- Amazon Transcribe
- Amazon Web Services
- Anthropic Claude
- Asana
- AWeber
- Azure AI Document Intelligence
- Azure Maps
- BambooHR
- Box
- Brevo
- Calendly
- Campaign Monitor
- Cisco Webex Teams
- Citrix ShareFile
- ClearBit
- Cloud Confluence
- Constant Contact
- Coupa
- Customer.io
- Datadog
- Deputy
- Discord
- DocuSign
- Arrêter
- Dropbox
- Egnyte
- Eventbrite
- Échanges
- Serveur Exchange - Aperçu
- Expensify
- Facebook
- Freshbooks
- Freshdesk
- Freshservice
- GetResponse
- GitHub
- Gmail
- Plateforme Google Cloud
- Google Docs
- Google Drive
- Google Maps
- Google Sheets
- Google Speaking-to-Text
- Google Text-to-Speech
- Google Tasks – Aperçu
- Google Vertex
- Google Vision – Aperçu
- Espace de travail Google – Aperçu
- GoToWebinar
- Greenhouse
- HTTP Webhook - Aperçu
- HubSpot CRM
- Hubspot Marketing
- HyperV - Aperçu
- iContact
- Insightly CRM
- Intercom
- Jira
- Keap
- Klaviyo
- LinkedIn
- Mailchimp
- Mailgun
- Mailjet
- MailerLite
- Marketo
- Microsoft 365
- Microsoft Azure
- Microsoft Azure Active Directory
- Microsoft Azure OpenAI
- Microsoft Dynamics 365 CRM
- Microsoft OneDrive et SharePoint
- Microsoft Outlook 365
- Microsoft Sentiment
- Microsoft Teams
- Microsoft Traduction
- Microsoft Vision
- Miro
- Okta
- OpenAI
- Oracle Eloqua
- Oracle NetSuite
- PagerDuty
- SAP
- SingePDF
- Pinecone
- Pipedrive
- QuickBooksOnline
- Quip
- Salesforce
- Salesforce Marketing Cloud
- SAP BAPI - Aperçu
- SAP Concur
- SendGrid
- ServiceNow
- Shopify
- Slack
- SmartRecruiters
- Smartsheet
- Stripe
- Sugar Enterprise
- Sugar Professional
- Sugar Sell
- Sugar Serve
- System Center - Aperçu
- TangoCard
- Todoist
- Trello
- Twilio
- X (anciennement Twitter)
- Xero
- watsonx.ai
- WhatsApp Business
- Google Business
- Utilisable
- Workday
- YouTube
- Zendesk
- Zoho Campaigns
- ZohoDesktop
- Zoho Mail
- ZoomInfo
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.
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.
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.
-
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.
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
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.
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.
Pour créer un déclencheur dans le générateur de connecteurs, procédez comme suit :
- Tout d'abord, assurez-vous de remplir les conditions préalables.
- Dans Integration Service, ouvrez Générateur de connecteurs (Connector Builder), puis sélectionnez votre connecteur personnalisé.
- Sélectionnez les options Plus à côté de Déclencheurs ( Triggers).
- Sélectionnez Ajouter un déclencheur (Add trigger).
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.
- Sélectionnez le type d'événement.
- Ajoutez un nom pour votre déclencheur.
- Sélectionnez la ressource utilisée pour détecter ces événements.
- Sélectionnez Créer (Create) pour démarrer le processus de configuration de vos déclencheurs.
Le processus de création d'un déclencheur comprend trois étapes :
- Configurer la requête.
- Configurer la réponse.
- 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.
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.
- Sélectionnez Importer les paramètres (Import parameters) pour afficher la liste des paramètres disponibles pour une ressource spécifique.
- Sélectionnez le paramètre à utiliser dans l'URL d'interrogation.
- 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.
DateTime
. Les formats DateTime
peuvent être trouvés pour un paramètre avec un type de données de fournisseur String
ou Integer
.
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é.
Configurer la réponse
À cette étape, vous spécifiez quel champ de réponse correspond à la clé primaire ou à la sortie du déclencheur.
- Utilisez la liste déroulante sous la clé primaire pour sélectionner un champ.
- 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.
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
GETBYID
. Ce processus est appelé ingestion.
GETBYID
avant de l'utiliser comme ressource d'actualisation pour un déclencheur.
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.