Design an Application Integration

This section describes how to use the integration canvas to design an application integration. It also provides an overview of the integration canvas in which you design your integration.

  1. Follow the steps in Create an Integration to create an application integration.

    An empty integration canvas with the following sections is displayed:
    • The empty integration canvas is identified by a + sign and a Triggers menu of available trigger adapter connections in the middle of the canvas. The Triggers menu is automatically displayed the first time. After that, you need to click the + sign to invoke an inline menu for designing your integration. Click an adapter to display the number of configured adapter connections available for adding to an integration. This invokes the Adapter Endpoint Configuration Wizard to create an inbound connection in the integration.


      The canvas is shown after integration creation. The integration name, version, and status of draft are shown. Seven icons appear below. At the far right are the Share drop-down list and Save button. Two icons appear horizontally below and five icons appear vertically below. In the middle of the canvas are the expand button and a list of triggers from which to choose. Below to the right is the palette for adjusting the layout of your integration.

    • You can also select Triggers Triggers icon in the right pane to display the same menu of available trigger adapter connections.

    • Click the following items to design the integration:

      • Selection Mode Selection mode icon: Select elements in the canvas for cutting and pasting.
      • Cut Cut icon: Cut actions and invokes to paste elsewhere in the integration.
      • Paste Paste icon: Paste actions and invokes to other sections of the integration.
      • Collapse All Collections Collapse collections icon: Collapse logic actions such as a scope, for each, switch, while, and others that include child actions.
      • Refresh Endpoints Refresh endpoints icon: Click to refresh endpoints in the integration. This icon appears if your integration includes connections that can be regenerated, See Refresh Endpoints for Integrations.
      • Vertical Vertical layout icon: Display a vertical view of the integration.
      • Horizontal Horizontal layout icon: Display a horizontal view of the integration.
      • Outline Outline view icon: Display the integration vertically with child actions indented. Details about each action in the integration are displayed to the right. You can edit the integration by selecting the + sign to display an inline menu for adding invokes and actions. You can also edit actions or add routes to switches by clicking the appropriate action.



      • Test integration icon/End test: Start and end integration testing from within the integration canvas. These icons only appear for REST Adapter connection trigger-based integrations and scheduled integrations. See Test Integrations from Inside the Integration Canvas.
      • Share drop-down list: Export the integration or print the design of the integration.
      • Primary Info Primary information icon: Display a panel showing integration creation properties (identifier, name, version, package, documentation URL, keywords, smart tags, and description), a button to delete the integration. and a report that shows details about the actions and invokes used in the integration. You can change the name, package, documentation URL, and description in this panel.
      • Business Identifiers Business identifiers icon: Create business identifiers for the integration. At least one identifier is required. Business identifiers enable you to track integration instances during runtime. See Track Integration Instances.
      • Minimize Minimize icon and Maximize Maximize icon: Minimize to show the options above the integration canvas and maximize to hide the options above the integration canvas.
      • View Global Fault Handler Toggle between main integration and global faults icon: View the global fault action and re-throw fault action. You can add and delete re-throw faults and other actions, as necessary.
      • Triggers Triggers icon: Create inbound triggers for the integration. This icon does not appear after you create the trigger for your integration.
      • Invokes Available invokes icon: Create outbound invokes for the integration.
      • Actions Integration actions icon: Display a pane of action that you can add to the integration. See Define Inbound Triggers and Outbound Invokes.
      • Global Variables Global variables icon: Add a global variable to the integration that can be selected for use in actions.
      • Search Search icon: Search for triggers, invokes, and actions in the integration. You can select the element in the drop-down list or the structure.

    At the bottom right of the integration canvas is a small box with icons for adjusting the integration view, including zooming in, zooming out, expanding the integration to 100%, fitting the integration into the canvas, and minimizing/maximizing the box.


    The canvas box shows a graphical view and four icons for viewing the integration.