Skip to content

Commit d16c27b

Browse files
committed
2 parents 021cbbc + abe3b96 commit d16c27b

7 files changed

Lines changed: 57 additions & 49 deletions

File tree

-1.72 KB
Loading

tutorials/btp-integration-suite-nonsapconnectivity-integration/btp-integration-suite-nonsapconnectivity-integration.md

Lines changed: 24 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ author_profile: https://github.com/Karunaharan
99
---
1010

1111
# 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.
1313

1414

1515
## You will learn
@@ -19,27 +19,29 @@ author_profile: https://github.com/Karunaharan
1919

2020
### Create an Integration Package and Integration Flow
2121

22-
1. In your SAP Integration Suite home page, choose **Design** > **Integrations** > **Create** to create an integration package.
22+
1. On the SAP Integration Suite home page, choose **Design** > **Integrations** > **Create** to create an integration package.
2323

2424
<!-- border -->![Create-Package](1-1-Create-Package.png)
2525

2626
> An integration flow is always associated to an integration package.
2727
28-
2. In the **Header** tab, provide a **Name** and **Short Description** for your integration package. Choose **Save**.
29-
30-
<!-- border -->![Package-Header](1-2-Package-Header.png)
28+
2. On the **Header** tab, provide a **Name** and **Short Description** for your integration package.
3129

3230
>The **Technical Name** gets populated automatically based on the name that you provide.
3331
34-
3. Choose **Artifacts** tab. Here you will create your first integration flow. Choose **Add** > **Integration Flow**.
32+
3. Choose **Save**.
33+
34+
<!-- border -->![Package-Header](1-2-Package-Header.png)
3535

36-
4. Enter a **Name** for the integration flow and choose **OK**.
36+
4. Choose the **Artifacts** tab. Here you will create your first integration flow. Choose **Add** > **Integration Flow**.
37+
38+
5. Enter a **Name** for the integration flow and choose **OK**.
3739

3840
<!-- border -->![1-4-Integration-Flow](1-4-Integration-Flow.png)
3941

40-
5. Choose **Save** and open the integration flow by selecting it.
42+
6. Choose **Save** and open the integration flow by selecting it.
4143

42-
6. Choose **Edit** to start editing the integration flow.
44+
7. Choose **Edit** to start editing the integration flow.
4345

4446
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.
4547

@@ -48,7 +50,7 @@ author_profile: https://github.com/Karunaharan
4850

4951
### Connect Sender Channel with HTTPS Adapter
5052

51-
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.
5254

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

@@ -58,7 +60,7 @@ In this step, you define your sender channel and sender adapter. In this case, w
5860

5961
<!-- border -->![Select HTTPS adapter](2-2-select-https-adapter.png)
6062

61-
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`**.
6264

6365
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).
6466

@@ -67,16 +69,18 @@ In this step, you define your sender channel and sender adapter. In this case, w
6769

6870
### Add Request Reply Step
6971

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**.
73+
74+
<!-- border -->![Select Request Reply](3-1-Request-Reply.png)
7175

72-
<!-- border -->![Select Request Reply](3-1-Request-Reply.png)
76+
2. Connect it to the message path.
7377

74-
<!-- border -->![Add request reply](3-1-Request-Reply-Add.png)
78+
<!-- border -->![Add request reply](3-1-Request-Reply-Add.png)
7579

7680

7781
### Connect Request Reply to Receiver
7882

79-
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.
8084

8185
> **TIP:** Use the pan and zoom controls for resizing the canvas.
8286
@@ -86,7 +90,7 @@ From the palette, choose **Call** > **External Call** > **Request Reply**. Conne
8690

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

89-
4. Select the **Connection** tab in the Property Sheet.
93+
4. Select the **Connection** tab on the Property Sheet.
9094

9195
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).
9296

@@ -115,11 +119,13 @@ Now you have configured the Open Connectors receiver adapter to fetch a list of
115119

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

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.
119123

120124
<!-- border -->![5-1-Deploy-Status](5-1-Deploy-Status.png)
121125

122-
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**.
123129

124130
<!-- border -->![5-2-Deployment-Status](5-2-Deployment-Status.png)
125131

tutorials/btp-integration-suite-nonsapconnectivity-openconnectors/btp-integration-suite-nonsapconnectivity-openconnectors.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -45,9 +45,9 @@ author_profile: https://github.com/Karunaharan
4545

4646
3. Enter a name for the instance.
4747

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).
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).
4949

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).
5151

5252
6. Choose **Create Instance**.
5353

@@ -79,7 +79,7 @@ You've now successfully created a BambooHR connector instance. In this step, you
7979

8080
### Create a Security Material in Cloud Integration
8181

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.
8383

8484
In this step, you'll create a security material in Cloud Integration that takes care of this authentication.
8585

@@ -106,7 +106,7 @@ In this step, you'll create a security material in Cloud Integration that takes
106106

107107
### Copy the Request URL
108108

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.
110110

111111
In the successful API response, copy the **Request URL**.
112112

tutorials/btp-integration-suite-nonsapconnectivity-settingup-suite/btp-integration-suite-nonsapconnectivity-settingup-suite.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ author_profile: https://github.com/Karunaharan
1212
<!-- description --> Prepare your existing SAP Integration Suite tenant or set up a trial account.
1313

1414
## 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).
1616
- If you have an SAP Integration Suite tenant, start from **Step 3**.
1717

1818
## You will learn
@@ -41,9 +41,9 @@ This step is relevant only if you're setting up your trial account. If you alrea
4141

4242
> - 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.
4343
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/).
4545

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**.
4747

4848
<!-- border -->![Trial global account](1-2-FoundationsCockpit_trial page.png)
4949

@@ -52,9 +52,9 @@ This step is relevant only if you're setting up your trial account. If you alrea
5252
<!-- border -->![Access Trial account](1-3-access_trial_account.png)
5353

5454

55-
### Subscribe to SAP Integration Suite service
55+
### Subscribe to SAP Integration Suite
5656

57-
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**.
5858

5959
1. Select **Services > Instances and Subscriptions**.
6060

@@ -66,7 +66,7 @@ This step is relevant only if you're setting up your trial account. If you alrea
6666

6767
>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).
6868
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.
7070
7171
>- Filter for **Integration Suite** and select the service.
7272
@@ -118,11 +118,11 @@ This step is relevant only if you're setting up your trial account. If you alrea
118118
119119
<!-- border -->![Wait for activation](3-3-Ok.png)
120120

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.
122122

123123
<!-- border -->![Activation-complete](3-4-Activation-complete.png)
124124

125-
>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.
126126
127127

128128
### Assign roles for the activated capabilities

tutorials/btp-integration-suite-nonsapconnectivity-settingup-thirdparty/btp-integration-suite-nonsapconnectivity-settingup-thirdparty.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,8 +43,10 @@ For the sake of providing an example, we're using a BambooHR trial system that a
4343

4444
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).
4545

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**.
4747

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.
4951

5052
---

tutorials/btp-integration-suite-nonsapconnectivity-test/btp-integration-suite-nonsapconnectivity-test.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ author_profile: https://github.com/Karunaharan
99
---
1010

1111
# Test Your Integration Scenario
12-
<!-- description --> ****
12+
<!-- description --> During this step, you will test the end-to-end integration scenario that you have built so far.
1313

1414

1515
## You will learn
@@ -22,18 +22,18 @@ In this step, you copy the endpoint address of the deployed integration flow.
2222

2323
1. Open your integration flow.
2424

25-
2. In the **Deployment Status** tab of the property sheet, choose the **Navigate to Manage Integration Content**.
25+
2. On the **Deployment Status** tab of the property sheet, choose the **Navigate to Manage Integration Content**.
2626

2727
<!-- border -->![Access Deployed Artifact](1-2-Monitoring.png)
2828

29-
3. In the **Endpoints** tab, choose **Copy** icon. If you don't see an endpoint, wait for a few minutes until the endpoint appears.
29+
3. On the **Endpoints** tab, choose **Copy** icon. If you don't see an endpoint, wait for a few minutes until the endpoint appears.
3030

3131
<!-- border -->![Copy Endpoint URL](1-3-Copy-Endpoint.png)
3232

3333

3434
### Test the integration scenario
3535

36-
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.
3737

3838
1. Open your **Postman** application.
3939

@@ -45,7 +45,8 @@ In this step, you test your integration design using Postman. You can use any te
4545

4646
5. Hit the **Send** button. You receive a HTTP status 200 with the data from BambooHR system in the **Body** field.
4747

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.
4950

5051

5152
### Optional Step: Integrate with your own application

tutorials/btp-integration-suite-nonsapconnectivity-usecase/btp-integration-suite-nonsapconnectivity-usecase.md

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -8,35 +8,34 @@ author_name: Karunaharan V
88
author_profile: https://github.com/Karunaharan
99
---
1010

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.
1313

1414
## You will learn
1515
- 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
1717

18-
---
1918

2019
### What is SAP Integration Suite
2120

2221
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.
2322

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.
2524

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).
2726

2827

2928
### The Use Case
3029

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*.
3231

33-
You use *Open Connectors* to
32+
You use *Open Connectors* to:
3433
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
3635

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
4039

4140
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.
4241

0 commit comments

Comments
 (0)