Skip to content

Commit fb23aba

Browse files
committed
updated all screenshots
1 parent 4cb2d8e commit fb23aba

26 files changed

+102
-84
lines changed
Binary file not shown.
-69.4 KB
Binary file not shown.
-64.9 KB
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.

tutorials/opps-basic-scenario/opps-basic-scenario.md

Lines changed: 72 additions & 84 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ primary_tag: products>sap-business-technology-platform
1010
<!-- description --> Use SAP Omnichannel Promotion Pricing to calculate the effective sales price for a product in a specific location by applying promotional rules on top of the regular sales price.
1111

1212
## Prerequisites
13-
- You have registered for a trial account on [SAP BTP](hcp-create-trial-account).
13+
- You have registered for a trial account on [SAP BTP](hcp-create-trial-account) in the Singapore - Azure region.
1414
- You should be familiar with the SAP BTP trial landscape and terminology (see [Take a Tour of SAP BTP Trial](cp-trial-quick-onboarding)).
1515
- You have a subaccount in the Cloud Foundry environment, with Microsoft Azure as provider and the Singapore region (AP21).
1616
- You have set up SAP Omnichannel Promotion Pricing as described in [Set Up SAP Omnichannel Promotion Pricing](opps-manual-setup)
@@ -23,11 +23,6 @@ primary_tag: products>sap-business-technology-platform
2323
- How to view the uploaded master data
2424
- How to create a calculation request to determine the effective sales price
2525

26-
## Intro
27-
>This tutorial includes steps and screenshots based on the classic design of the SAP API Business Hub. To use the classic design, navigate to the upper right corner and disable the **New SAP API Business Hub** option.
28-
<!-- border -->![Switch API Business Hub Layout](Switch API Business Hub Layout.png)
29-
30-
---
3126

3227
### Get to know the business scenario
3328

@@ -62,39 +57,38 @@ For step-by-step instructions, go to the tutorial [Set Up SAP Omnichannel Promot
6257
<!-- Now that you have created the service instances and corresponding credentials, you can set up the environments in the SAP API Business Hub for each SAP Omnichannel Promotion Pricing service. -->
6358
With the service instances and corresponding credentials that you set up (as described in [Set Up SAP Omnichannel Promotion Pricing](opps-manual-setup) ), you can set up the environments in the SAP API Business Hub for each SAP Omnichannel Promotion Pricing service.
6459

65-
### Data Upload service
60+
## Data Upload service
6661
1. Navigate to [SAP Omnichannel Promotion Pricing on SAP API Business Hub](https://api.sap.com/package/OPPS/overview). Log on with the same login information you use for your SAP BTP account.
6762

6863
2. Select **Data Upload**.
6964

70-
<!-- border -->![API Business Hub Starting Page](API Business Hub Starting Page.PNG)
71-
72-
3. Choose the **Configure Environment** icon.
65+
<!-- border -->![API Business Hub Starting Page](v2_API Business Hub Starting Page.png)
7366

74-
<!-- border -->![Data Upload Configure Environment](Data Upload Configure Environment.PNG)
67+
3. Navigate to the **Try Out** section and choose **Add New Environment**.
7568

76-
4. Choose **Create New Environment**.
69+
<!-- border -->![Data Upload Configure Environment](v2_Data Upload Configure Environment.png)
7770

78-
<!-- border -->![Data Upload Configure Environment2](Data Upload Configure Environment2.PNG)
7971

80-
5. In the following screen, enter the information from the table below:
72+
4. In the following screen, enter the information from the table below:
8173

82-
![Data Upload Configure Environment 3](Data Upload Configure Environment 3.png)
74+
![Data Upload Configure Environment 3](v2_Data Upload Configure Environment 3.png)
8375

8476

8577
| Field Name | Value
8678
| :------------- | :-------------
79+
| Display Name | Enter any name, for example **`OPPS trial data upload`**.
8780
| Starting URL | **`https://ppservice-inbound-cf-oppstrialap21-trial.cfapps.ap21.hana.ondemand.com/`**
88-
| Display Name for Environments | Enter any name, for example **`OPPS trial data upload`**.
89-
| Authentication Type | **`Application Flow`**
90-
| Client Id | **`clientid`** **
91-
| Secret | **`clientsecret`** **
92-
| Identity Zone | **`identityzone`** **
93-
| region | **`ap21`**
94-
| Apply this environment to all APIs in this package that are not yet configured |Please make sure that this is NOT selected.
95-
96-
* Select **Save this environment for future sessions**.
97-
* Choose **Save**.
81+
| Resulting URL | (prefilled)
82+
| Authentication Type | **`OAuth 2.0 Application Flow`**
83+
| Client ID | **`your clientid`** **
84+
| Client Secret | **`your clientsecret`** **
85+
| Token URL | (prefilled)
86+
| Identityzone | **`your identityzone`** **
87+
| Region | **`ap21`**
88+
| Apply this environment to all APIs in this package that are not yet configured | Make sure that this is NOT selected.
89+
| Save this environment for future sessions | Make sure that this is selected.
90+
91+
* Choose **Configure**.
9892

9993
>** From the service key that you have created for the Data Upload service in your SAP BTP account. For a detailed description, go to step 4 in the tutorial [Set Up SAP Omnichannel Promotion Pricing](opps-manual-setup).
10094
![Service Key](v3_Service_Key.png)
@@ -111,17 +105,16 @@ Having created the trial environments in the SAP API Business Hub, you can now s
111105

112106
Navigate to the [Data Upload service of SAP Omnichannel Promotion Pricing on SAP API Business Hub](https://api.sap.com/api/DataUpload/resource). Log on with the same login information that you use for your SAP BTP account.
113107

114-
### Upload regular sales price ###
108+
## Upload regular sales price
115109

116-
<!-- border -->![Data Upload Regular Sales Price 1](Data Upload Regular Sales Price 1.png)
117-
<!-- border -->![Data Upload Regular Sales Price 1b](Data Upload Regular Sales Price 1b.png)
110+
<!-- border -->![Data Upload Regular Sales Price 1](v2_Data Upload Regular Sales Price 1.png)
118111

119-
1. For **API Environment**, select the trial environment you have just created for the Data Upload service.
120-
2. On the left-hand side, choose **Upload prices using OAuth2**.
121-
3. Open the **POST** request `/idocinbound`
122-
4. Choose **Try Out**.
123-
5. For the **Request body**, choose `application/xml`.
124-
6. Copy the following raw data and paste it into the body:
112+
1. Navigate to the **Try Out** section.
113+
2. For **Environment**, select the trial environment you have just created for the Data Upload service.
114+
3. On the left-hand side, choose **Upload Prices Using OAuth2**.
115+
4. Open the **POST** request `/idocinbound`
116+
5. For the **Content Type**, choose `XML`.
117+
6. Copy the following raw data and paste it into the **Body** section:
125118
```XML
126119
<?xml version="1.0" encoding="UTF-8"?>
127120
<_-ROP_-BASE_PRICE01>
@@ -151,25 +144,23 @@ Navigate to the [Data Upload service of SAP Omnichannel Promotion Pricing on SAP
151144
</IDOC>
152145
</_-ROP_-BASE_PRICE01>
153146
```
154-
7. Choose **Execute**.
147+
7. Choose **Run**.
155148
8. Make sure you get the HTTP response **200**.
156149

157150
<!-- border -->![Data Upload Regular Sales Price 2](Data Upload Regular Sales Price 2.png)
158151

159152
With this, you uploaded the regular sales price of **10 Euro** for the product **sunglasses** (material number: `CHA2111010`) for the **Heidelberg** store (business unit ID: `FC01`) and the validity period **September 8th, 2020 to September 10th, 2021**.
160153

161-
### Upload promotional rule ###
162-
163-
<!-- border -->![Data Upload Regular Promotional Rule 1](Data Upload Regular Promotional Rule 1.png)
154+
## Upload promotional rule
164155

165-
<!-- border -->![Data Upload Regular Promotional Rule 1b](Data Upload Regular Promotional Rule 1b.png)
156+
<!-- border -->![Data Upload Regular Promotional Rule 1](v2_Data Upload Regular Promotional Rule 1.png)
166157

167-
1. For **API Environment**, select the trial environment you have just created for the Data Upload service.
168-
2. On the left-hand side, choose **Upload promotions using OAuth2**.
169-
3. Open the **POST** request `/idocinbound`.
170-
4. Choose **Try Out**.
171-
5. For the **Request body**, choose `application/xml`.
172-
6. Copy the following raw data and paste it into the body:
158+
1. Navigate to the **Try Out** section.
159+
2. For **Environment**, select the trial environment you have just created for the Data Upload service.
160+
3. On the left-hand side, choose **Upload Promotions Using OAuth2**.
161+
4. Open the **POST** request `/idocinbound`.
162+
5. For the **Content Type**, choose `XML`.
163+
6. Copy the following raw data and paste it into the **Body** section:
173164
```XML
174165
<?xml version="1.0" encoding="UTF-8"?>
175166
<_-ROP_-PROMOTION02>
@@ -255,7 +246,7 @@ With this, you uploaded the regular sales price of **10 Euro** for the product *
255246
</IDOC>
256247
</_-ROP_-PROMOTION02>
257248
```
258-
7. Choose **Execute**.
249+
7. Choose **Run**.
259250
8. Make sure you get the HTTP response **200**.
260251

261252
With this you uploaded the promotional rule "Buy sunglasses and get 40% off" (promotion ID: `1429`) for the **Heidelberg** store (business unit ID: `FC01`) and the validity period **January 1st, 2021 to January 7th, 2021**.
@@ -266,35 +257,33 @@ With this you uploaded the promotional rule "Buy sunglasses and get 40% off" (pr
266257

267258
You can use the **Data Access** service for checking your uploaded data.
268259

269-
Navigate to the [Data Access service of SAP Omnichannel Promotion Pricing on the SAP API business Hub](https://api.sap.com/api/OData/resource).
260+
Navigate to the [Data Access service of SAP Omnichannel Promotion Pricing on the SAP API Business Hub](https://api.sap.com/api/OData/resource).
270261

271-
### Check uploaded regular sales price ###
262+
## Check uploaded regular sales price
272263

273-
<!-- border -->![Data Access Service Base Price 1](Data Access Service Base Price 1_new.png)
264+
<!-- border -->![Data Access Service Base Price 1](v2_Data Access Service Base Price 1.png)
274265

275-
<!-- border -->![Data Access Service Base Price 1b](Data Access Service Base Price 1b.png)
276-
277-
1. For **API Environment**, select your trial environment for the Data Access service.
278-
2. On the left-hand side, choose `Regular Prices` to read the list of regular sales prices.
279-
3. Select **Try Out**.
280-
4. Choose **Execute**.
281-
5. Make sure you get the HTTP response **200**.
282-
6. Check the data in the **Response Body**. For this, scroll down in the response body until you find the respective entry.
266+
1. Navigate to the **Try Out** section.
267+
2. For **Environment**, select your trial environment you have created for the Data Access service.
268+
3. On the left-hand side, choose `Regular Price`.
269+
4. Open the GET request `/BasePrices` to read the list of regular sales prices.
270+
5. Choose **Run**.
271+
6. Make sure you get the HTTP response **200**.
272+
7. Check the data in the **Response Body**. For this, scroll down in the response body until you find the respective entry.
283273

284274
<!-- border -->![Data Access Service Base Price 2](Data Access Service Base Price 2.png)
285275

286-
### Check uploaded promotional rule ###
287-
288-
<!-- border -->![Data Access Service Promotional Rule 1](Data Access Service Promotional Rule 1.png)
276+
### Check uploaded promotional rule
289277

290-
<!-- border -->![Data Access Service Promotional Rule 1b](Data Access Service Promotional Rule 1b.png)
278+
<!-- border -->![Data Access Service Promotional Rule 1](v2_Data Access Service Promotional Rule 1.png)
291279

292-
1. For **API Environment**, select your trial environment for the Data Access service.
293-
2. On the left-hand side, choose `PromotionTexts`.
294-
3. Select **Try Out**.
295-
4. Choose **Execute**.
296-
5. Make sure you get the HTTP response **200**.
297-
6. Check the data in the **Response Body**. For this, scroll down in the response body until you find the respective entry.
280+
1. Navigate to the **Try Out** section.
281+
2. For **Environment**, select your trial environment for the Data Access service.
282+
3. On the left-hand side, choose `Promotion Texts`.
283+
4. Open the GET request `/PromotionTexts`.
284+
5. Choose **Run**.
285+
6. Make sure you get the HTTP response **200**.
286+
7. Check the data in the **Response Body**. For this, scroll down in the response body until you find the respective entry.
298287

299288
<!-- border -->![Data Access Service Promotional Rule 2](Data Access Service Promotional Rule 2.png)
300289

@@ -308,20 +297,19 @@ You can now calculate the effective sales price based on the data you have uploa
308297

309298
**Desired Result**: The effective sales price for the sunglasses should be **6 Euro**: 10 Euro (regular sales price) minus 40% discount, as the customer is eligible for the promotion "Buy sunglasses and get 40% off".
310299

311-
Let's check if this is the case:
300+
Let's check if this is the case. Navigate to the [Calculation service on the SAP API Business Hub](https://api.sap.com/api/PriceCalculation/resource).
312301

313-
<!-- border -->![Calculation](Calculation 2.png)
302+
<!-- border -->![Calculation](v2_Calculation 2.png)
314303

315-
<!-- border -->![Calculation2b](Calculation 2b.png)
304+
<!-- border -->![Calculation2b](v2_Calculation 2b.png)
316305

317-
1. Navigate to the [Calculation service on the SAP API Business Hub](https://api.sap.com/api/PriceCalculation/resource).
318-
2. For **API Environment**, select your trial environment for the Calculation service.
319-
3. Open the **POST** request `/restapi/{tenantName}` and choose **Try Out**.
320-
4. In the field `tenantName` enter the `identityzone` from the service key you have created for the Calculation service in your SAP BTP account.
306+
1. Navigate to the **Try Out** section.
307+
2. For **Environment**, select your trial environment for the Calculation service.
308+
3. Open the **POST** request `/restapi/{tenantName}`.
309+
4. In the field **tenantName** enter the `identityzone` from the service key you have created for the Calculation service in your SAP BTP account.
321310
>If you need a more detailed description, go to step 4 in the tutorial [Set Up SAP Omnichannel Promotion Pricing](opps-manual-setup).
322-
323-
5. For the **Request body**, choose `application/xml`.
324-
6. Copy the following raw data and paste it into the body:
311+
5. For the **Content Type**, choose `XML`.
312+
6. Copy the following raw data and paste it into the **Body** section:
325313

326314
```XML
327315
<PriceCalculate xmlns="http://www.sap.com/IXRetail/namespace/" InternalMajorVersion="2" InternalMinorVersion="1">
@@ -351,8 +339,8 @@ Let's check if this is the case:
351339
</PriceCalculateBody>
352340
</PriceCalculate>
353341
```
354-
355-
Make sure you get the HTTP response **200**.
342+
7. Choose **Run**.
343+
8. Make sure you get the HTTP response **200**.
356344

357345
The response should look similar to this:
358346
```JSON
@@ -527,16 +515,16 @@ The response should look similar to this:
527515

528516

529517

530-
### What to Do Next ###
518+
## What to Do Next
531519

532520
Navigate to the intermediate group [Set up Complex Promotions with SAP Omnichannel Promotion Pricing](group.opps-complex-promotion) and continue with the next tutorial [Apply Mix-and-Match Promotion with SAP Omnichannel Promotion Pricing](opps-advanced-scenario-mixandmatch).
533521

534522

535-
### Additional Information
523+
## Additional Information
536524

537-
* [Official Product Documentation](https://help.sap.com/viewer/product/OPP/Cloud/en-US)
538-
* [Trial Documentation](https://help.sap.com/viewer/0c145d124b784b548b618cda8a5b2aba/Cloud/en-US/31b8aedc8ce14fcd9f6021ad4f6323c9.html)
539-
* [SAP Omnichannel Promotion Pricing on the SAP API Business hub](https://help.sap.com/viewer/0c145d124b784b548b618cda8a5b2aba/Cloud/en-US/67a9da084cf84e058cb3a3911971bdd0.html)
525+
* [Official Product Documentation](https://help.sap.com/docs/OPP)
526+
* [Trial Documentation](https://help.sap.com/docs/OPP/0c145d124b784b548b618cda8a5b2aba/31b8aedc8ce14fcd9f6021ad4f6323c9.html)
527+
* [SAP Omnichannel Promotion Pricing on the SAP API Business Hub](https://help.sap.com/docs/OPP/7c87270e23c64c2aa922ce297a6df23d/67a9da084cf84e058cb3a3911971bdd0.html?version=Cloud)
540528
* [Video: SAP Omnichannel Promotion Pricing in a nutshell](https://www.sap.com/assetdetail/2020/07/9060b3a5-a67d-0010-87a3-c30de2ffd8ff.html)
541529

542530
---
Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
[VALIDATE_2]
2+
###Rule
3+
single-choice
4+
5+
###Question
6+
For which services do you have to create a trial environment in the SAP API Business Hub to complete this tutorial?
7+
8+
###Match
9+
[ ] Data Upload service, Data Access service, Administration service
10+
[ ] None
11+
[ ] Only for the Data Upload service
12+
[x] Data Upload service, Data Access service, Calculation service
13+
14+
[VALIDATE_2]
15+
16+
17+
[VALIDATE_5]
18+
###Rule
19+
single-choice
20+
21+
###Question
22+
What is the calculated effective sales price that you get as a result?
23+
24+
###Match
25+
[ ] 5 Euro
26+
[x] 6 Euro
27+
[ ] 10 Euro
28+
[ ] For free
29+
30+
[VALIDATE_5]
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading

0 commit comments

Comments
 (0)