viewing Apigee X documentation.
View Apigee Edge documentation.
The Connectors task lets you configure a connection using any supported Connector type previously configured in the Connectors UI. With a connection, you can quickly and easily call out to Google Cloud services and third-party business applications from your integration.
Before you begin
Before you can use the Connectors task in Apigee Integration, you must create a Connector using the Connectors UI in the Cloud Console. For the steps required, see Create and manage connections. Once a Connector is configured, you can use the Connectors task to create a connection of that type in your integration.
Supported Connectors types include the following:
- BigQuery (Preview) connection
- Salesforce connection
- CloudSQL for MySQL connection
- CloudSQL for PostgreSQL connection
- Cloud Pub/Sub connection
Configure the Connectors task
This page describes the general steps required to configure the Connectors task in Apigee Integration. Some configuration details will vary, depending upon the connection type selected in the task. For detailed descriptions of the steps required to configure the Connectors task for each connection type, see:
- Configure a BigQuery (Preview) connection
- Configure a Salesforce connection
- Configure a CloudSQL for MySQL connection
- Configure a CloudSQL for PostgreSQL connection
- Configure a Cloud Pub/Sub connection
To configure the Connectors task:
- Go to the Apigee UI and sign in.
- Select your organization using the drop-down menu in the upper left corner of the UI.
- Click Develop > Integrations.
- Search for or select the integration to edit from the Integrations list and click to open the integration designer.
- Click +Add a task/trigger > Tasks to view the list of available tasks.
- Drag the Connectors element to the integration designer.
- Click the Connectors task element on the designer to view the Connectors task configuration pane.
- Optionally, click the to edit the task name. This enables you to change the task name from the generic Connectors to a meaningful name for your integration.
- On the Configuration tab in the Configuration section, click the Configure task button to open the Configure connector task pane.
- In the Connection column, choose the connection type you created in the Connectors UI from the list of available connections.
- Once a connection is chosen, the Type column appears. Select either an Entity or Action from the
list of available Entities and Actions.
- An Entity can be thought of as an object, or a collection of properties, in the connected application
or service, that can be exposed to an integration through the Connector interface.
Selecting an Entity from the available list generates a list of available Operations that are available for the Entity.
Select an Operation from the available list.
- An Action is a first class function that is made available to the integration through the Connector interface.
Functions are defined in the connected application or service and define a change or series of changes that can be made to
an entity or entities.
Select an Action from the available list.
- An Entity can be thought of as an object, or a collection of properties, in the connected application or service, that can be exposed to an integration through the Connector interface.
- Click Done to complete the connection configuration and close the pane.
- The Connectors task configuration pane also displays Task Input variables
and Task Output variables automatically generated by the Entity and Operation or Action
selected in the previous step for use in the connection. These variables
are configurable and are accessible as inputs to the current task or outputs to subsequent tasks
or conditionals configured in the current integration.
To configure the Task Input or Task Output:
- Click on the Connector input payload or Connector output payload variable pill to open the Configure Variable pane.
- Configure the JSON payload or default value as desired.
- Select the Use as an input to integration checkbox or the Use as an output to integration, as desired.
- Click Save.
Retry on failure
You can configure various retry strategies to handle errors in a task. The retry strategies allow you to specify how to rerun the task in case of an error. For more information, see Error handling strategies.