You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: tutorials/btp-integration-suite-nonsapconnectivity-integration/btp-integration-suite-nonsapconnectivity-integration.md
# Design an Integration Flow to Connect with Open Connectors
12
-
<!-- description --> Design an integration flow to integrate the capabilities Cloud Integration and Open Connectors that creates an endpoint to fetch data from BambooHR trial system.
12
+
<!-- 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.
5. Choose **Save** and open the integration flow by selecting it.
42
+
6. Choose **Save** and open the integration flow by selecting it.
41
43
42
-
6. Choose **Edit** to start editing the integration flow.
44
+
7. Choose **Edit** to start editing the integration flow.
43
45
44
46
Choose **Restore** at the bottom right corner to bring up the **Property Sheet**. Property sheet is the place where you configure the parameters for every step in the integration flow.
In this step, you define your sender channel and sender adapter. In this case, we use an HTTPS sender adapter. This will help you create a simple HTTP endpoint which you can invoke to execute the integration scenario.
53
+
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.
52
54
53
55
1. Choose the **Sender** step. Create the sender channel by clicking the arrow icon on **Sender** and dragging it to the **Start** step.
54
56
@@ -58,7 +60,7 @@ In this step, you define your sender channel and sender adapter. In this case, w
3.In the property sheet, select the **Connection** tab. In the **Address** field, enter **`/employees/getdetails`**.
63
+
3.On the property sheet, select the **Connection** tab. In the **Address** field, enter **`/employees/getdetails`**.
62
64
63
65
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).
64
66
@@ -67,16 +69,18 @@ In this step, you define your sender channel and sender adapter. In this case, w
67
69
68
70
### Add Request Reply Step
69
71
70
-
From the palette, choose **Call** > **External Call** > **Request Reply**. Connect it to the message path.
72
+
1. From the palette, choose **Call** > **External Call** > **Request Reply**.
1. Move the **Receiver** step right below the **Request Reply** step by selecting it and dragging it. You do this to ensure that your integration flow is elegantly designed.
83
+
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.
80
84
81
85
> **TIP:** Use the pan and zoom controls for resizing the canvas.
82
86
@@ -86,7 +90,7 @@ From the palette, choose **Call** > **External Call** > **Request Reply**. Conne
86
90
87
91
3. In the **Adapter Type** dialog, select **OpenConnectors**.
88
92
89
-
4. Select the **Connection** tab in the Property Sheet.
93
+
4. Select the **Connection** tab on the Property Sheet.
90
94
91
95
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).
92
96
@@ -115,11 +119,13 @@ Now you have configured the Open Connectors receiver adapter to fetch a list of
115
119
116
120
Now that you have designed your integration flow, let's deploy it for further execution.
117
121
118
-
1. Choose **Deploy** to deploy the integration flow. Choose **Yes** in the confirmation dialog for deployment. Upon deployment confirmation, choose the **Deployment Status** tab in the property sheet.
122
+
1. Choose **Deploy** to deploy the integration flow.
2. In 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**.
126
+
2. Choose **Yes** in the confirmation dialog for deployment. Upon deployment confirmation, choose the **Deployment Status** tab on the property sheet.
127
+
128
+
3. 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**.
Copy file name to clipboardExpand all lines: tutorials/btp-integration-suite-nonsapconnectivity-openconnectors/btp-integration-suite-nonsapconnectivity-openconnectors.md
4. In the **Company Name** field, enter the domain name that you created for your BambooHR trial. You've copied this value in [Preparing Your BambooHR Trial Account](btp-integration-suite-nonsapconnectivity-settingup-thirdparty).
48
+
4. In the **Company Name** field, enter the domain name that you created for your BambooHR trial. You've copied this value in [Preparing Your BambooHR Trial Account](btp-integration-suite-nonsapconnectivity-settingup-thirdparty).
49
49
50
-
5. In the **API Key** field, enter the API Key that you generated for your BambooHR trial. You've copied this value in [Preparing Your BambooHR Trial Account](btp-integration-suite-nonsapconnectivity-settingup-thirdparty).
50
+
5. In the **API Key** field, enter the API Key that you generated for your BambooHR trial. You've copied this value in [Preparing Your BambooHR Trial Account](btp-integration-suite-nonsapconnectivity-settingup-thirdparty).
51
51
52
52
6. Choose **Create Instance**.
53
53
@@ -79,7 +79,7 @@ You've now successfully created a BambooHR connector instance. In this step, you
79
79
80
80
### Create a Security Material in Cloud Integration
81
81
82
-
In a further tutorial in the mission, you'll establish integration between Cloud Integration and BambooHR through Open Connectors. For this integration to work as expected, Open Connectors must authenticate you via a user credential.
82
+
In a later tutorial of this mission, you'll establish an integration between Cloud Integration and BambooHR through Open Connectors. For this integration to work as expected, Open Connectors must authenticate you via a user credential.
83
83
84
84
In this step, you'll create a security material in Cloud Integration that takes care of this authentication.
85
85
@@ -106,7 +106,7 @@ In this step, you'll create a security material in Cloud Integration that takes
106
106
107
107
### Copy the Request URL
108
108
109
-
In a further tutorial in the mission, you will have to provide a request to this **GET /employees** API so that Cloud Integration invokes it.
109
+
In a later tutorial of this mission, you will have to provide a request to this **GET /employees** API so that Cloud Integration invokes it.
110
110
111
111
In the successful API response, copy the **Request URL**.
Copy file name to clipboardExpand all lines: tutorials/btp-integration-suite-nonsapconnectivity-settingup-suite/btp-integration-suite-nonsapconnectivity-settingup-suite.md
<!-- description --> Prepare your existing SAP Integration Suite tenant or set up a trial account.
13
13
14
14
## Prerequisites
15
-
- If you don't have an SAP Integration Suite tenant, create a **trial account on SAP Business Technology Platform:**[Get a Free Trial Account on SAP BTP](hcp-create-trial-account)
15
+
- If you don't have an SAP Integration Suite tenant, create a **trial account on SAP Business Technology Platform:**[Get a Free Trial Account on SAP BTP](hcp-create-trial-account).
16
16
- If you have an SAP Integration Suite tenant, start from **Step 3**.
17
17
18
18
## You will learn
@@ -41,9 +41,9 @@ This step is relevant only if you're setting up your trial account. If you alrea
41
41
42
42
> - If you have already subscribed to Integration Suite in your existing trial account, proceed to **Step 3**. You can consume only one SAP Integration Suite tenant per trial account.
43
43
44
-
1. In your web browser, open the [SAP BTP trial cockpit](https://cockpit.hanatrial.ondemand.com/).
44
+
1. In your web browser, open [SAP BTP trial cockpit](https://cockpit.hanatrial.ondemand.com/).
45
45
46
-
2. Navigate to the trial global account by choosing **Go To Your Trial Account**.
46
+
2. Navigate to the trial global account by choosing **Enter Your Trial Account**.
47
47
48
48
<!-- border -->
49
49
@@ -52,9 +52,9 @@ This step is relevant only if you're setting up your trial account. If you alrea
This step is relevant only if you're setting up your trial account. If you already have an SAP Integration Tenant, start with **Step 3**.
57
+
This step is relevant only if you're setting up your trial account. If you already have an SAP Integration Suite tenant, start with **Step 3**.
58
58
59
59
1. Select **Services > Instances and Subscriptions**.
60
60
@@ -66,7 +66,7 @@ This step is relevant only if you're setting up your trial account. If you alrea
66
66
67
67
>If SAP Integration Suite is not visible in the **Services** list, you must assign SAP Integration Suite trial entitlements. To assign entitlements, see [Manage Entitlements on SAP BTP Trial](cp-trial-entitlements).
68
68
69
-
>- In the tutorial referred above, after **Step 3.5**, there is a list of available services on the left pane.
69
+
>- In the tutorial [Manage Entitlements on SAP BTP Trial](cp-trial-entitlements), after **Step 3.5**, there is a list of available services on the left pane.
70
70
71
71
>- Filter for **Integration Suite** and select the service.
72
72
@@ -118,11 +118,11 @@ This step is relevant only if you're setting up your trial account. If you alrea
118
118
119
119
<!-- border -->
120
120
121
-
4. Verify that the activated capabilities are seen in the home page.
121
+
4. Verify that the activated capabilities are seen on the home page.
>Though activation is complete you can't access the activated capabilities. To access each capability, you must first assign capability-specific roles which is explained in the next step.
125
+
>Though activation is complete, you can't yet access the activated capabilities. To access each capability, you must first assign capability-specific roles which is explained in the next step.
Copy file name to clipboardExpand all lines: tutorials/btp-integration-suite-nonsapconnectivity-settingup-thirdparty/btp-integration-suite-nonsapconnectivity-settingup-thirdparty.md
+4-2Lines changed: 4 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -43,8 +43,10 @@ For the sake of providing an example, we're using a BambooHR trial system that a
43
43
44
44
SAP Integration Suite communicates with BambooHR via APIs. Each API request that is sent from SAP Integration Suite will be authenticated by BambooHR - for which you must generate an API Key. You can find more information [here](https://documentation.bamboohr.com/docs/getting-started#authentication).
45
45
46
-
1.In any page of the BambooHR system, in the upper right corner, choose **Account > API Keys**.
46
+
1.On any page of the BambooHR system, in the upper right corner, choose **Account > API Keys**.
47
47
48
-
2. Add a new API Key by providing a name. Copy the actual key which you will need in the subsequent steps of the mission.
48
+
2. Add a new API Key by providing a name.
49
+
50
+
3. Copy the actual key. You need the key to perform the subsequent steps of the mission.
In this step, you test your integration design using Postman. You can use any testing platform of your choice.
36
+
During this step, you test your integration design using Postman. You can use any testing platform of your choice.
37
37
38
38
1. Open your **Postman** application.
39
39
@@ -45,7 +45,8 @@ In this step, you test your integration design using Postman. You can use any te
45
45
46
46
5. Hit the **Send** button. You receive a HTTP status 200 with the data from BambooHR system in the **Body** field.
47
47
48
-
You've now successfully solved the integration problem that was shown in [The Use Case for the Challenge](btp-integration-suite-nonsapconnectivity-usecase).
48
+
Congratulations!
49
+
You've now successfully solved the integration problem that was shown in [The Use Case for the Challenge](btp-integration-suite-nonsapconnectivity-usecase). You see the data coming from your BambooHR trial system.
49
50
50
51
51
52
### Optional Step: Integrate with your own application
Copy file name to clipboardExpand all lines: tutorials/btp-integration-suite-nonsapconnectivity-usecase/btp-integration-suite-nonsapconnectivity-usecase.md
+11-12Lines changed: 11 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,35 +8,34 @@ author_name: Karunaharan V
8
8
author_profile: https://github.com/Karunaharan
9
9
---
10
10
11
-
# The Use Case for the Mission
12
-
<!-- description --> Understand the integration problem that you're going to solve before you get started
11
+
# The Use Case: Connectivity to Non-SAP Applications using SAP Integration Suite
12
+
<!-- description --> Understand the integration problem that you're going to solve before you get started.
13
13
14
14
## You will learn
15
15
- What is SAP Integration Suite
16
-
-The integration problem that you're going to solve
16
+
-About the integration problem that you're going to solve
17
17
18
-
---
19
18
20
19
### What is SAP Integration Suite
21
20
22
21
SAP Integration Suite is an enterprise-grade integration platform as a service (EiPaaS) that allows you to smoothly integrate on-premise and cloud-based applications and processes with tools and prebuilt content managed by SAP.
23
22
24
-
SAP Integration Suite combines the integration capabilities such as Cloud Integration (Process Integration), API Management, Integration Advisor, Trading Partner Management, Integration Assessment, Open Connectors, and Migration Assessment into a cohesive and simplified toolkit for enterprise integrations. To provide a comprehensive integration experience, these services are not available separately, but only as part of the SAP Integration Suite.
23
+
SAP Integration Suite combines the integration capabilities such as Cloud Integration (Process Integration), API Management, Integration Advisor, Trading Partner Management, Integration Assessment, Open Connectors, and Migration Assessment into a cohesive and simplified toolkit for enterprise integrations. To provide a comprehensive integration experience, these services are not available separately, but only as part of SAP Integration Suite.
25
24
26
-
SAP Integration Suite is available in simple service plans. To know more about these plans, see the SAP Integration Suite [service catalog](https://discovery-center.cloud.sap/#/serviceCatalog/f810c887-8d25-4942-9849-354837951066).
25
+
SAP Integration Suite is available in simple [service plans](https://help.sap.com/docs/btp/sap-business-technology-platform/commercial-models?version=Cloud). To know more about these plans, see the SAP Integration Suite [service catalog](https://discovery-center.cloud.sap/#/serviceCatalog/f810c887-8d25-4942-9849-354837951066).
27
26
28
27
29
28
### The Use Case
30
29
31
-
Using this integration scenario, you design and execute an integration flow that reads information from a third-party software. To accomplish the scenario, you use SAP Integration Suite, and in particular, its capabilities *Cloud Integration* and *Open Connectors*.
30
+
By using this integration scenario, you design and execute an integration flow that reads information from a third-party software. To accomplish the scenario, you use SAP Integration Suite, and in particular, its capabilities *Cloud Integration* and *Open Connectors*.
32
31
33
-
You use *Open Connectors* to
32
+
You use *Open Connectors* to:
34
33
1. identify and establish connection to a third-party software
35
-
2. fetch data from the third-party software via APIs
34
+
1. fetch data from the third-party software via APIs
36
35
37
-
You use *Cloud Integration* to
38
-
1. design a custom integration artifact to fetch data from Open Connectors
39
-
2. deploy the integration artifact to a cloud-based runtime location
36
+
You use *Cloud Integration* to:
37
+
1. design a custom integration flow to fetch data from Open Connectors
38
+
1. deploy the integration flow to a cloud-based runtime location
40
39
41
40
Finally, use an open API platform like Postman to securely invoke the deployed integration artifact to see that you're able to fetch data from a third-party software using SAP Integration Suite.
0 commit comments