viewing Apigee X documentation.
View Apigee Edge documentation.
An edge is a connection between any two elements in an integration. The connection denotes the direction of the control flow from one element(task or trigger) to another. The connection can be between a trigger and a task or between a task and another task. By using an edge along with fork and join, you can implement complex branching and conditions in your integration. For more information, see Forks and joins.
For example, if there is an edge from a Send Email task to a Call Integration task, it means that after the Send Email task is run, the next task to run is the Call Integration task. An edge also supports conditional checks. Before the control passes to the next task, you can check for a condition in the edge and based on the result, decide to run the task or not. For more information about the supported conditional checks, see Edge conditions.
Edge conditions let you specify the conditions that must be met for control of an integration to pass to the task connected by the edge. The task is run only if the specified conditions are met. Edge conditions are useful in cases where there are multiple incoming edges to a task, where each edge checks for specific conditions before the task.
Specify edge conditions using the following steps:
- In the Apigee UI, select your Apigee Organization.
- Click Develop > Integrations.
- Select an existing integration or create a new integration by clicking CREATE INTEGRATION.
If you are creating a new integration:
- Enter a name and description in the Create Integration dialog.
- Select a Region for the integration from the list of supported regions.
- Click Create.
This opens the integration in the integration designer.
- In the integration designer navigation bar, click +Add a task/trigger > Tasks to view the list of available tasks.
- Select an existing integration or create a new one.
- In the integration designer, click on the edge to open the Edge configuration pane.
- Configure the edge:
The following table describes the supported operators available for use in edge conditions.
|=||Checks for equality between two values||
|!=||Checks for inequality between two values||
|<||Checks if a value is less than another value||
|<=||Checks if a value is less than or equal to another value||
|>||Checks if a value is greater than another value||
|>=||Checks if a value is greater than or equal to another value||
|:||Checks if a string contains a substring within it, or checks if a list contains a specific primitive value.||
|AND||Checks two expressions and returns true if both the expressions evaluate to true.||
|OR||Checks two expressions and returns true if any one of the expressions evaluates to true.||
|NOT||Negation operator. Flips the result of an expression.||
The following table describes supported functions available for use in edge conditions.
|exists(variable)||Checks if a given variable exists|
|does_not_exist(variable)||Checks if a given variable does not exist|
|is_empty(variable)||Checks if a given variable is a list AND is empty|
|is_not_empty(variable)||Checks if a given variable is a list AND is not empty|