Configuring polled events
What's a polled event
An event refers to any change or activity that takes place in an application. Some applications allow you to configure events that can initiate a flow by periodically checking for new or updated objects, called polled events. For instance, if you want to trigger a flow every time a new order is created in Salesforce, you can use the polled event node as a starting point in an event-driven flow in App Connect.
Setting up polled events
You can create polled events and add them to App Connect to use as triggers for your flows. To display events in the Events tab on the Connector Development Kit, you need to have an associated configured action with the action type 'RetrieveWithWhere' and this action should not have a required parameter without default values or relationships.
If you don't have any actions in your connector with the action type 'RetrieveWithWhere' or if that action does not have a required parameter without default values, the Events tab remains empty containing a description to configure an action.
Similar to actions, the events are classified into groups. A group is also known as an object in App Connect and refers to the group to which a set of events belongs. However, these groups are not manually created but are derived from the associated action groups. The default event names are generated based on the name of the associated action, which can be (the 'event name' is automatically derived from the name of the associated action group):
- New 'event name'
- Updated 'event name'
- New or updated 'event name'
The following screenshot captures how the event names are generated in the Connector Development Kit and App Connect user interface:
In this example, the action group 'Accounts' contains an action that is called 'Retrieve accounts' with the action type 'RetrieveWithWhere'. A corresponding polled event group (Accounts) and polled events (New accounts, Updated accounts, and New or updated accounts) are automatically generated based on the name of the action group'. When you import this connector on App Connect, these polled events are displayed under the configurable events section of the connector.
Only one event group can currently be generated from a single action group. You cannot make changes to the event names from the Events tab, for that, you need to go to the Actions tab and update the name of the action group according to your requirements. However, you have the option to enable or disable events from the Events tab if you want to exclude them.
Each event has an Event details tab and a Response tab. You can configure the event based on your requirements by filling out the polling configuration information in the Event details tab. Only some fields in the Event details tab can be edited, and the response properties cannot be edited from the Events tab.