Tour: Explore a Multiple Verbs and Resources Invoke Integration

This example demonstrates how to use multiple HTTP verbs and resources configured in the REST Adapter trigger connection of an integration.

You can configure a single REST Adapter to include multiple HTTP verbs such as GET, PUT, POST, PATCH, and DELETE. You can also configure the REST Adapter with multiple resources. For this example, a single /emp resource and an /emp/loc subresource are used.

Step 1. View the Integration Design

  1. Install the Use Multiple Verbs and Resources Invoke recipe from the Integration Store.
  2. In the navigation pane, click Design, then Integrations.

    This integration consists of the following:


    EmployeeAPI REST Adapter with six operations from which to select: modifyEmployee, updateEmployee, getEmployee, getEmployeeLocation, deleteEmployee, and addEmployee. Each operation goes to a mapper and a return action.

    • A REST Adapter connection (EmployeeAPI) is configured as a trigger (inbound) connection in the integration. The REST Adapter connection is configured with multiple operations: modifyEmployee (PATCH), updateEmployee (PUT), getEmployee (GET), getEmployeeLocation (GET), deleteEmployee (DELETE), and addEmployee (POST).


      The image

    • The REST Adapter is triggered when you specify the URL.
    • Each operation is shown as a different path that branches out from the trigger connection.
    • Each branch has a map and a reply action configured.
    • The tracking configuration for each branch can be viewed by clicking Actions Actions icon, then tracking on each pick action.

Step 2. Run the Integration

  1. In the navigation pane, click Design, then Integrations.

  2. Hover your cursor over Sample Multiple Verbs and Resources Invoke, then click Activate Activate icon.

  3. Click Activate when prompted.
  4. Wait for the icon to turn green and the word Active to appear in the Status column, indicating that the integration is activated.
  5. Hover your cursor over Sample Multiple Verbs and Resources Invoke, then click Actions Actions icon and select Run. The Configure and run page is displayed with details about running, tracking, and testing the integration.
  6. Click the Operation drop-down list to view all configured options and HTTP verbs.
  7. From the drop-down list, select the operation to perform. For this example, addEmployee (POST) is selected.


    Operation list selections: getEmployeeLocation, getEmployee, addEmployee, updateEmployee, deleteEmployee, and modifyEmployee.

    The section following the drop-down list shows all the options available for the selected operation such as URI Parameters and Body.

  8. Click Run to run the selected operation.

Step 3. View the Movement of Messages Through the Integration

The Activity Stream panel slides open on the Configure and run page. The activity stream shows the status of message processing through the major milestones of the integration.

This image

Step 4. Monitor the integration

  1. Click the instance ID at the top of the Activity Stream panel. The Instance Details page provides a graphical view of the integration flow. The path taken by this instance is highlighted in green, indicating it was successful. The same Activity Stream panel is also visible on the right.


    This image

  2. Click < to return to the Configure and run page.
  3. Click Track Instances and note that the Sample Multiple Verbs and Resources Invoke integration instance is listed as Succeeded in the Status column.


    The instance is shown in the table with columns for Primary Identifier, Instance Id, Status, Business Identifiers, and Duration.

  4. In the navigation pane, click Observability, then Integrations.

    The message is listed as successfully received and processed without any errors.


    The Integrations page shows a table with columns for Name, Received, Processed, Succeeded, Errored, Aborted, and Last Scheduled By. For this example, one message each has been received, processed, and succeeded.