---
parser: v2
auto_validation: true
time: 30
tags: [tutorial>beginner, software-product>sap-business-technology-platform, software-product>sap-btp--cloud-foundry-environment]
primary_tag: software-product>sap-integration-suite
author_name: Melanie Cueppers
author_profile: https://github.com/MelanieCueppers
slug: btp-integration-suite-nonsapconnectivity-integration
canonical_url: https://developers.sap.com/tutorials/btp-integration-suite-nonsapconnectivity-integration
---

# Design an Integration Flow to Connect with Open Connectors 
<!-- description --> Design an integration flow that fetches data from the third-party system. This integration flow uses the capabilities Cloud Integration and Open Connectors.. In this scenario, Open Connectors provides the endpoint to fetch data from BambooHR trial system.


## You will learn
  - How to design and deploy an integration flow using Cloud Integration's web-based integration flow editor
  - How to design an integration flow to fetch data via an API of Open Connectors


### Create an Integration Package and Integration Flow

1. Back in SAP Integration Suite, go to **Design** > **Integrations and APIs** and choose **Create** to create an integration package.
    
    > An integration flow must be associated to an integration package.

2. On the **Header** tab, provide a **Name** and **Short Description** for your integration package.

    >The **Technical Name** gets populated automatically based on the name that you provide.

3. Choose **Save**.

    ![Package-Header](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/btp-integration-suite-nonsapconnectivity-integration/1-2-Package-Header.png)

4. Choose the **Artifacts** tab. Here you will create your first integration flow. Choose **Add** > **Integration Flow**.

5. Enter a **Name** for the integration flow and choose **Add and Open in Editor** to open directly.

      ![1-4-Integration-Flow](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/btp-integration-suite-nonsapconnectivity-integration/1-4-Integration-Flow.png)

6. Alternatively, choose **Add** and open the integration flow by selecting it.

7. Choose **Edit** to start editing the integration flow.

    Choose **Restore** at the bottom right corner to bring up the **Property Sheet**. The property sheet is where you configure the parameters for every step in the integration flow.

      ![1-6-Edit-Iflow](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/btp-integration-suite-nonsapconnectivity-integration/1-6-Edit-Iflow.png)


### Connect Sender Channel with HTTPS Adapter

During this step, you define your sender channel and sender adapter. We use an HTTPS sender adapter to create a simple HTTP connection to invoke the execution of the integration scenario.

1. Choose the **Sender** step. Create the sender channel by clicking the arrow icon on **Sender** and dragging it to the **Start** step.

    ![Create the sender channel](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/btp-integration-suite-nonsapconnectivity-integration/2-1-connect-sender-channel.png)

2. In the **Adapter Type** prompt, select the **HTTPS** adapter.

    ![Select HTTPS adapter](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/btp-integration-suite-nonsapconnectivity-integration/2-2-select-https-adapter.png)

3. On the property sheet, select the **Connection** tab. In the **Address** field, enter **`/employees/getdetails`**.

    Optionally, you can enter any value of your choice, but ensure that you use **"/"** symbol before specifying the endpoint name. Deselect the **CSRF Protected** checkbox (this will be selected by default).

    ![Configure HTTPS connection](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/btp-integration-suite-nonsapconnectivity-integration/2-3-Configure-HTTPS-Connection.png)


### Add Request Reply Step

1. From the palette, choose **Call** > **External Call** > **Request Reply**.

    ![Select Request Reply](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/btp-integration-suite-nonsapconnectivity-integration/3-1-Request-Reply.png)

2. Connect it to the message path.

    ![Add request reply](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/btp-integration-suite-nonsapconnectivity-integration/3-1-Request-Reply-Add.png)


### Connect Request Reply to Receiver

1. Move the **Receiver** step right below the **Request Reply** step by selecting and dragging it. You do this to ensure that your integration flow is elegantly designed.

    > **TIP:** Use the pan and zoom controls for resizing the canvas.

2. Drag the arrow icon on **Request Reply** to the **Receiver** step.

    ![Connect Request Reply to Receiver](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/btp-integration-suite-nonsapconnectivity-integration/4-2-Connect Request Reply to Receiver.png)

3. In the **Adapter Type** dialog, select **OpenConnectors**.

4. Select the **Connection** tab on the Property Sheet. 

5. In the **Base URI** field, paste the copied request URL from **Step 5** of [Establish Connection Between Your BambooHR Trial and Open Connectors](btp-integration-suite-nonsapconnectivity-openconnectors).

    > Do not paste the full URL. Paste only till **/api-v2**. If your request URL is **`https://<request-URL>/elements/api-v2/employees`**, paste only **`https://<request-URL>/elements/api-v2`**.

6. For the **Credential Name**, choose **Select**. A list of available user credentials that are applicable for Open Connectors come up. Select the user credential that you created.

    ![4-6-Credential-Name](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/btp-integration-suite-nonsapconnectivity-integration/4-6-Credential-Name.png)

7. For the **Resource**, enter **/employees**.

    > At this point, Cloud Integration tests the connection to the mentioned Base URI using the mentioned credential name. This is a way for you to check if everything is going as expected. This connection testing helps you choose the right API resource.

    ![4-7-Resource](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/btp-integration-suite-nonsapconnectivity-integration/4-7-Resource-workaround.png)

8. For **Method**, choose **GET** operation.

    ![4-8-Connection-Tab](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/btp-integration-suite-nonsapconnectivity-integration/4-8-Connection-Tab.png)

9. Leave the other fields as is. Choose **Save** to keep all your configuration changes.

Now you have configured the Open Connectors receiver adapter to fetch a list of employees from your BambooHR trial account when you attempt to invoke the HTTP endpoint.


### Deploy the integration flow

Now that you have designed your integration flow, let's deploy it for further execution.

1. Choose **Deploy** to deploy the integration flow.

    ![5-1-Deploy-Status](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/btp-integration-suite-nonsapconnectivity-integration/5-1-Deploy-Status.png)

2. Choose **Yes** in the confirmation dialog for deployment. 

3. Upon deployment confirmation, choose the **Deployment Status** tab on the property sheet.

4. On the **Deployment Status** tab, you can see details about the deployment for the integration flow. The expected deployment status is **Deployed** and runtime status is **Started**.

    ![5-2-Deployment-Status](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/btp-integration-suite-nonsapconnectivity-integration/5-2-Deployment-Status.png)


Later in the mission, you will use the endpoint of the deployed integration flow. Using **Postman**, you will invoke the endpoint to fetch data from your BambooHR trial system.

---