App Connect has some pre-configured events that you can select as triggers for your flows. For some applications, you can configure more events that can trigger a flow by polling an application for new or updated objects.
This tutorial shows you how to configure those events.
If you can’t find what you want, or have comments about the “how to” information, please either add comments to the bottom of this page or send us comments by email.
How it works
To create a polled event that triggers a flow, you configure App Connect so that it knows when something has changed in your application. This requires the application to add a timestamp when an object is created, and an additional timestamp each time that object is updated. This is common practice for most applications. App Connect polls the application at regular intervals that you specify, and if an update has a timestamp after the time when your flow was started, the flow is triggered and the actions in your flow are completed. To do this, App Connect requires the application to filter by timestamp, so that it retrieves all objects since a particular time.
You can see which applications have configurable events on the Applications tab on the Catalog page. When you expand an application, if you can configure events for it, you’ll see Show more configurable events under the list of pre-configured events. Click the link and expand an object to see which events you can configure.
Configuring a polled event
- Click New > Event-driven flow, expand an appropriate source application (for example, Salesforce), and then click Configure more events.
- Expand the object that you want to monitor and select the type of event.
For example, we might want to trigger our flow every time a new order is created in Salesforce, so we’d choose the New order event.
- If prompted, provide any required information about the object that will trigger your flow. For example, if you’re configuring the New worksheet row event in Google Sheets, you’ll be prompted for the names of the appropriate spreadsheet and worksheet.
- Select the field from your application that contains the timestamp for when the object was created.
The list of fields that are shown for both timestamps are the ones that are provided by the application for use in filters.
- Select the field from your application that contains the timestamp for when the object was updated.
- Enter a format for the timestamp by using letters. In most cases, the field will already contain the correct formatting for the timestamp of the selected application.
For some applications, timestamps might not be in a standard format that App Connect can recognize. So you need to convert the actual timestamp that’s produced by the application to a letter-based format that App Connect can interpret; for example, for a timestamp of 2017-10-04T10:58:33+05:30, set the field to YYYY-MM-DDTHH:mm::ssZ.
- Select the time zone that applies to the timestamps. The default time zone is UTC (Coordinated Universal Time), so you only need to select a time zone if it’s not UTC.
It’s important to ensure that App Connect knows what time zone the timestamps relate to so that it can detect updates that happen after the flow is started. For many systems, timestamps are returned in Coordinated Universal Time (UTC), which is the default time zone for App Connect. Some applications have a system-wide setting that causes all timestamps to be returned in a particular time zone. In other applications, the time zone is configured on a per-user basis.
- Select the frequency with which App Connect polls the application for changes to the object.
App Connect will check the application at the specified interval, and if it detects an update with a timestamp that’s after the time when the flow started, it will trigger the flow to complete its actions. If you specify a short interval, App Connect will detect events more quickly, but it will use more API calls.
- Complete your flow in the usual way by adding whatever actions and logic you need.
- To start the flow, open the options menu [⋮] in the banner and click Start flow. Then click Dashboard to exit the flow.
- Test your flow by creating or updating the configured object in your application and ensuring that any actions are completed.