Skip to content

Automatic commit: Move 'btp-app-cap-business-logic', 'btp-app-cap-mta… #18411

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
May 11, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,6 @@ The deployment is based on MTA ( *Multi-Target Application*, sometimes also call
[ACCORDION-BEGIN [Step 2: ]((For Windows) Install make tool)]
> ### To earn your badge for the whole mission, you will need to mark all steps in a tutorial as done, including any optional ones that you may have skipped because they are not relevant for you.


The `make` tool is required by the `mbt` tool. Linux and macOS are already shipped with `make`. For Windows you can download it from the GNU Make site:

1. Go to <http://gnuwin32.sourceforge.net/packages/make.htm>.
Expand Down Expand Up @@ -395,4 +394,4 @@ The result of this tutorial can be found in the [`cap-mta-deployment`](https://g


[ACCORDION-END]
---
---
6 changes: 4 additions & 2 deletions tutorials/btp-app-ci-cd-btp/btp-app-ci-cd-btp.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,8 @@ primary_tag: software-product-function>sap-cloud-application-programming-model
---

[ACCORDION-BEGIN [Step 1: ](Introduction)]
> ### To earn your badge for the whole mission, you will need to mark all steps in a tutorial as done, including any optional ones that you may have skipped because they are not relevant for you.

[SAP Continuous Integration and Delivery (CI/CD)](https://help.sap.com/viewer/product/CONTINUOUS_DELIVERY/Cloud/en-US) is a service on SAP BTP, which lets you configure and run predefined continuous integration and delivery pipelines. It connects with your Git SCM repository and builds, tests, and deploys your code changes. In its user interface, you can easily monitor the status of your builds and detect errors as soon as possible, which helps you prevent integration problems before completing your development.

SAP Continuous Integration and Delivery has a ready-to-use pipeline for CAP, that is applicable to multi-target application (MTA) and Node.js based projects. It does not require you to host your own Jenkins instance and it provides an easy, UI-guided way to configure your pipelines.
Expand Down Expand Up @@ -178,7 +180,7 @@ If your GitHub repository is not private, you can skip this section. If your Git

1. Navigate to the **Credentials** tab in SAP Continuous Integration and Delivery.

2. Choose **+** to create credentials.
2. Choose ( &#x2B; ) to create credentials.

!![Credentials](CICD_credentials.png)

Expand Down Expand Up @@ -218,7 +220,7 @@ If your GitHub repository is not private, you can skip this section. If your Git
[ACCORDION-END]
---
[ACCORDION-BEGIN [Step 6: ](Configure a CI/CD job)]
1. In the **Jobs** tab in SAP Continuous Integration and Delivery, choose **+** to create a new job.
1. In the **Jobs** tab in SAP Continuous Integration and Delivery, choose ( &#x2B; ) to create a new job.

!![Jobs](CICD_jobs.png)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -117,7 +117,7 @@ If you don't want to start from scratch, but from a specific example of the tuto

4. Check out the example's branch.

``` bash
```Shell/Bash
cd tutorial
git checkout <branch>
```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,8 @@ time: 40
tags: [tutorial>intermediate, tutorial>license, software-product-function>sap-cloud-application-programming-model, programming-tool>node-js, software-product>sap-business-technology-platform, software-product>sap-api-management, software-product>sap-hana-cloud, software-product>sap-s-4hana-cloud]
primary_tag: software-product-function>sap-cloud-application-programming-model
---


## Prerequisites
- [Add the Consumption of an External Service to Your CAP Application](btp-app-ext-service-add-consumption)
- [Consume the External Service in the UI of Your Application](btp-app-ext-service-consume-ui)
Expand All @@ -26,14 +28,21 @@ primary_tag: software-product-function>sap-cloud-application-programming-model
- You must be an administrator of the SAP S/4HANA Cloud system.
- You need to connect this system to your SAP BTP global account, if you'd like to build extension applications for your SAP S/4HANA Cloud system.


## Details
### You will learn
- How to configure your CAP application for eventing
- How to locally test your changes
- How to deploy your CAP application


To start with this tutorial use the result in the [`ext-service-s4hc-use`](https://github.com/SAP-samples/cloud-cap-risk-management/tree/ext-service-s4hc-use) branch.

---

[ACCORDION-BEGIN [Step 1: ](Configure your CAP application for eventing)]
> ### To earn your badge for the whole mission, you will need to mark all steps in a tutorial as done, including any optional ones that you may have skipped because they are not relevant for you.

CAP provides native support for emitting and receiving events. Hence, CAP applications can receive events for changes in remote systems. In CAP, the messaging follows a publish subscribe (pub/sub) model. Pub/sub means that sources publish messages and interested consumers can subscribe to receive them. This helps with scalability, decoupling of services, and robustness.

Using the Business Partner service that you added in `Step 1: Get the Business Partner service definition` from the tutorial [Add the Consumption of an External Service to Your CAP Application](btp-app-ext-service-add-consumption), you will configure the CAP application to listen and react to events from your SAP S/4HANA Cloud system. As in the previous tutorials, let's again use the example of business partners that are suppliers. So, you will use suppliers when referring to business partners. First you will add event definitions for the SAP S/4HANA events.
Expand Down Expand Up @@ -246,7 +255,7 @@ Currently, business partner (that is, supplier) data is stored only in the SAP S
[ACCORDION-END]
---
[ACCORDION-BEGIN [Step 3: ](Test your changes locally)]
So, you have added logic to create a new risk when an event for a newly created supplier is received.You have also added logic to update our risks when an event for an updated supplier is received from our SAP HANA Cloud system. This is achieved by listening to events from the SAP S/4HANA Cloud system.
So, you have added logic to create a new risk when an event for a newly created supplier is received. You have also added logic to update our risks when an event for an updated supplier is received from our SAP HANA Cloud system. This is achieved by listening to events from the SAP S/4HANA Cloud system.

Now simulate locally business partner creation and update, and see the results:

Expand Down
4 changes: 3 additions & 1 deletion tutorials/btp-app-events-s4hc-use/btp-app-events-s4hc-use.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ time: 30
tags: [tutorial>intermediate, tutorial>license, software-product-function>sap-cloud-application-programming-model, programming-tool>node-js, software-product>sap-business-technology-platform, software-product>sap-api-management, software-product>sap-hana-cloud, software-product>sap-s-4hana-cloud]
primary_tag: software-product-function>sap-cloud-application-programming-model
---

## Prerequisites
- [Add the Consumption of an External Service to Your CAP Application](btp-app-ext-service-add-consumption)
- [Consume the External Service in the UI of Your Application](btp-app-ext-service-consume-ui)
Expand All @@ -32,6 +33,7 @@ primary_tag: software-product-function>sap-cloud-application-programming-model
### You will learn
- How to create and change a Business Partner in your SAP S/4HANA Cloud system
- How to check if the Business Partner creation and change events sent from your SAP S/4HANA Cloud system have updated your CAP application

---

[ACCORDION-BEGIN [Step 1: ](Create a Business Partner and check updates in your CAP application)]
Expand Down Expand Up @@ -67,9 +69,9 @@ Congratulations! You have completed all tutorials.

[VALIDATE_1]


<p style="text-align: center;">Give us 55 seconds of your time to help us improve.</p>

<p style="text-align: center;"><a href="https://sapinsights.eu.qualtrics.com/jfe/form/SV_0im30RgTkbEEHMV?TutorialID=btp-app-events-s4hc-use" target="_blank"><img src="https://raw.githubusercontent.com/SAPDocuments/Tutorials/master/data/images/285738_Emotion_Faces_R_purple.png"></a></p>
<!--TAIL END-->
[ACCORDION-END]
---
Original file line number Diff line number Diff line change
Expand Up @@ -205,7 +205,7 @@ Later in the tutorial [Use SAP S/4HANA Cloud Service](btp-app-ext-service-s4hc-u

4. Run `cds watch` with the sandbox profile:

```
```Shell/Bash
cds watch --profile sandbox
```

Expand Down Expand Up @@ -258,7 +258,7 @@ To solve this issue, you add some handler code to delegate the call from the `Su

2. Run `cds watch` with the sandbox profile:

```
```Shell/Bash
cds watch --profile sandbox
```

Expand Down Expand Up @@ -329,7 +329,7 @@ This code is required for the sandbox only. The authentication for SAP S/4HANA s

6. Run `cds watch` with the sandbox profile:

```
```Shell/Bash
cds watch --profile sandbox
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ To start with this tutorial use the result in the [`ext-service-add-consumption`

3. Run `cds watch` with the sandbox profile:

```
```Shell/Bash
cds watch --profile sandbox
```

Expand Down Expand Up @@ -194,7 +194,7 @@ Next, you add the name of the supplier and the blocked status to the `Risks` UI.

5. Run `cds watch` with the sandbox profile:

```
```Shell/Bash
cds watch --profile sandbox
```

Expand Down Expand Up @@ -254,7 +254,7 @@ The last thing you add is the value help to select a supplier from the remote sy

3. Run `cds watch` with the sandbox profile:

```
```Shell/Bash
cds watch --profile sandbox
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -225,14 +225,12 @@ When creating new entries in the **Risks** application, you should be able to us
Congratulations! You have completed all tutorials.


<p style="text-align: center;">Give us 55 seconds of your time to help us improve.</p>

<p style="text-align: center;"><a href="https://sapinsights.eu.qualtrics.com/jfe/form/SV_0im30RgTkbEEHMV?TutorialID=btp-app-ext-service-s4hana-consume" target="_blank"><img src="https://raw.githubusercontent.com/SAPDocuments/Tutorials/master/data/images/285738_Emotion_Faces_R_purple.png"></a></p>
<!--TAIL END-->

[DONE]
The result of this tutorial can be found in the [`ext-service-s4hana-consume`](https://github.com/SAP-samples/cloud-cap-risk-management/tree/ext-service-s4hana-consume) branch.

<p style="text-align: center;">Give us 55 seconds of your time to help us improve.</p>

<p style="text-align: center;"><a href="https://sapinsights.eu.qualtrics.com/jfe/form/SV_0im30RgTkbEEHMV?TutorialID=btp-app-ext-service-s4hana-consume" target="_blank"><img src="https://raw.githubusercontent.com/SAPDocuments/Tutorials/master/data/images/285738_Emotion_Faces_R_purple.png"></a></p>
[ACCORDION-END]
---
Original file line number Diff line number Diff line change
Expand Up @@ -202,7 +202,7 @@ When creating new entries in the **Risks** application, you should be able to us

You'll see a message `No data found. Try adjusting filter or search criteria.`

> In case you get an error `Forbidden`.
> In case you get an error `Forbidden`.

> The following error is displayed when you haven't assigned your user to the `RiskManager-<your space>` role:

Expand Down Expand Up @@ -232,12 +232,11 @@ Congratulations! You have completed all tutorials.

[VALIDATE_1]

<p style="text-align: center;">Give us 55 seconds of your time to help us improve.</p>

<p style="text-align: center;"><a href="https://sapinsights.eu.qualtrics.com/jfe/form/SV_0im30RgTkbEEHMV?TutorialID=btp-app-ext-service-s4hc-use" target="_blank"><img src="https://raw.githubusercontent.com/SAPDocuments/Tutorials/master/data/images/285738_Emotion_Faces_R_purple.png"></a></p>
<!--TAIL END-->
The result of this tutorial can be found in the [`ext-service-s4hc-use`](https://github.com/SAP-samples/cloud-cap-risk-management/tree/ext-service-s4hc-use) branch.

<p style="text-align: center;">Give us 55 seconds of your time to help us improve.</p>

<p style="text-align: center;"><a href="https://sapinsights.eu.qualtrics.com/jfe/form/SV_0im30RgTkbEEHMV?TutorialID=btp-app-ext-service-s4hc-use" target="_blank"><img src="https://raw.githubusercontent.com/SAPDocuments/Tutorials/master/data/images/285738_Emotion_Faces_R_purple.png"></a></p>
[ACCORDION-END]
---
---
11 changes: 5 additions & 6 deletions tutorials/btp-app-launchpad-service/btp-app-launchpad-service.md
Original file line number Diff line number Diff line change
Expand Up @@ -334,7 +334,6 @@ The newly added modules `nsrisks` and `nsmitigations` do the build of the SAP Fi
supported-platforms: []
```


2. Check the `mitigations` application module `nsmitigations`:

<!-- snippet mta.yaml --branch launchpad-service modules: "- name: nsmitigations" -->
Expand Down Expand Up @@ -433,13 +432,13 @@ app/*/package-lock.json

!![Choose Subaccount](choose_subaccount.png)

2. Choose **Services** **&rarr;** **Service Marketplace** on the left.
4. Choose **Services** **&rarr;** **Service Marketplace** on the left.

3. Search for the **Launchpad Service** tile and choose **Create**.
5. Search for the **Launchpad Service** tile and choose **Create**.

!![Create Launchpad Service](create_launchpad_service.png)

4. Keep the default settings for **Service** and **Plan** and choose **Create**.
6. Keep the default settings for **Service** and **Plan** and choose **Create**.

!![New Instance or Subscription](new_instance_dialog.png)

Expand All @@ -455,11 +454,11 @@ You need to assign your user to the `Launchpad_Admin` role collection, so you do

2. Choose your user.

4. Under **Role Collections** on the right, choose **Assign Role Collection** and assign the `Launchpad_Admin` role collection to your user.
3. Under **Role Collections** on the right, choose **Assign Role Collection** and assign the `Launchpad_Admin` role collection to your user.

!![Add role](add_launchpad_admin_role.png)

5. Open another browser or clear your browser's cache.
4. Open another browser or clear your browser's cache.

> See section [Initial Setup](https://help.sap.com/viewer/8c8e1958338140699bd4811b37b82ece/Cloud/en-US/fd79b232967545569d1ae4d8f691016b.html) in the SAP Launchpad service's documentation for more details.

Expand Down
11 changes: 6 additions & 5 deletions tutorials/btp-app-logging/btp-app-logging.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@ To start with this tutorial use the result in the [`launchpad-service`](https://
[ACCORDION-END]
---
[ACCORDION-BEGIN [Step 3: ](Analyze logs using Kibana dashboard)]
1. In SAP BTP cockpit navigate to your **Subaccount**.
1. In SAP BTP Cockpit, navigate to your **Subaccount**.

2. Choose **Cloud Foundry** **&rarr;** **Spaces**.

Expand Down Expand Up @@ -206,9 +206,9 @@ In our experience, the `development` plan wasn't sufficient for test scenarios.
[ACCORDION-END]
---
[ACCORDION-BEGIN [Step 5: ](Test it)]
1. Build the MTAR file and deploy it to your Cloud Foundry space.
1. Build the MTAR file and deploy it to your Cloud Foundry space:

```
```Shell/Bash
mbt build -t ./
cf deploy cpapp_1.0.0.mtar
```
Expand All @@ -225,10 +225,11 @@ In our experience, the `development` plan wasn't sufficient for test scenarios.

!![Kibana: Components](kibana_components.png)

You can also browse all logs using the *Discover* button (compass icon) on the left navigation bar.
You can also browse all logs using the **Discover** button (compass icon) on the left navigation bar.
The available fields are displayed on the left side of the screen. You can add fields to the message display or quickly filter for any of the top values.

The time filter is on the right top of the screen. Don't forget to choose *Refresh*.
The time filter is on the right top of the screen. Don't forget to choose **Refresh**.



[DONE]
Expand Down
24 changes: 13 additions & 11 deletions tutorials/btp-app-prepare-btp/btp-app-prepare-btp.md
Original file line number Diff line number Diff line change
Expand Up @@ -104,25 +104,25 @@ At least the services for the tutorials [Set Up the SAP HANA Cloud service](btp-
[ACCORDION-BEGIN [Step 4: ](Create a subaccount)]
1. Enter your **Global Account**. If you are using a trial account, choose **Go To Your Trial Account**.

4. Choose **Account Explorer** in the left navigation pane.
2. Choose **Account Explorer** in the left navigation pane.

5. Choose **Create** **&rarr;** **Subaccount**.
3. Choose **Create** **&rarr;** **Subaccount**.

!![Create subaccount](create_subaccount.png)

6. To fill the **New Subaccount** dialog, enter a **Display Name**.
4. To fill the **New Subaccount** dialog, enter a **Display Name**.

> Use a short name for your project and add the prefix for the landscape, for example: `<project name>-cf-us10`. Don't select the checkbox **Neo**!

7. Enter a subdomain.
5. Enter a subdomain.

> Only valid HTTP domain characters are allowed.

8. Choose **Create**.
6. Choose **Create**.

9. Wait for the completion of the subaccount creation.
7. Wait for the completion of the subaccount creation.

10. Choose the tile with your new subaccount.
8. Choose the tile with your new subaccount.

[DONE]
[ACCORDION-END]
Expand Down Expand Up @@ -152,7 +152,7 @@ In this section, you assign a portion of the entitlements that you've bought for

4. Go through the Entitlements according to the table in the previous step **Create a Live Account** and add the required plans for each of them.

5. Choose the + or - symbol to change the quota for the services according to the table in the previous step **Create a Live Account**.
5. Choose the ( &#x2B; ) or ( &#8209; ) symbol to change the quota for the services according to the table in the previous step **Create a Live Account**.

6. Choose **Save**.

Expand All @@ -168,21 +168,23 @@ Next to Cloud Foundry orgs there are also [Spaces](https://docs.cloudfoundry.org

3. Choose **Create Space**.

4. Enter a space name (suggestion: If different sub projects exist in the org: `<sub project name>-<stage name>`, otherwise: `<stage name>`; where stage name is the release stage, for example: `dev`, `val`, `prod`)
4. Enter a space name.

> If different sub projects exist in the org, use `<sub project name>-<stage name>`, otherwise use `<stage name>`; where stage name is the release stage, for example: `dev`, `val`, `prod`.

5. Choose **Create**.

[DONE]
[ACCORDION-END]
---
[ACCORDION-BEGIN [Step 8: ](Assign users in the Cloud Foundry space)]
1. Open the **Spaces** overview in SAP BTP cockpit (you can just choose the tile for the space that was created).
1. Open the **Spaces** overview in SAP BTP cockpit. You can just choose the tile for the space that was created.

2. Choose **Members** in the left navigation pane.

3. (Optional) Choose **Add Members** to add all required users, again your own user should already be part of the list.

4. (Optional) Add a DL of your `CFDeployment` technical user as Space Manager if you have one.
4. (Optional) Add a distribution list of your `CFDeployment` technical user as Space Manager if you have one.

[DONE]
[ACCORDION-END]
Expand Down
4 changes: 2 additions & 2 deletions tutorials/btp-app-role-assignment/btp-app-role-assignment.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ Instead of creating the role collection automatically using the `xs-security.jso

3. Choose **Security** **&rarr;** **Role Collections** on the left.

4. Choose the **+** (new role collection) button.
4. Choose the ( &#x2B; ) icon to create a new role collection.

5. Enter **Name** `RiskManager`.

Expand Down Expand Up @@ -109,4 +109,4 @@ The new role collection appears now in the list, but it doesn't contain any role

[DONE]
[ACCORDION-END]
---
---