Abap build 2305

.vscode/settings.json

@@ -0,0 +1 @@
+{}

README.md

@@ -1,26 +1,39 @@
-[![REUSE status](https://api.reuse.software/badge/github.com/SAP-samples/low-code-applications)](https://api.reuse.software/info/github.com/SAP-samples/low-code-applications)
-
-# Hands On Projects For Low Code Application Development
+# Create SAP S/4HANA Extensions Using ABAP Cloud and SAP Build
 
 ## Description
 
-This repository contains descriptions for hands on projects on low code development using SAP tools.
+This repository contains the material for the workshop "Create SAP S/4HANA Extensions Using ABAP Cloud and SAP Build".  
+We will create a new service using the ABAP RESTful Application Programming Model (RAP) in an on premise SAP S/4HANA system and then create a process using SAP Build on the SAP Business Technology Platform (BTP). 
+
+## Overview
+
+This session covers the basic app development steps using the ABAP Development Tools (ADT) to create a new OData service based on the ABAP RESTful Application Programming Model (RAP) in an on premise SAP S/4HANA system. This service will then be used in a new process that will be created using SAP Build that runs on the SAP Business Technology Platfrom (BTP). You will see how professional developers code this service in ABAP and then a citizen developer can create the process in a visual way without any coding skills in SAP Build.  
+
+## The use case
+
+
 
 ## Requirements
 
-The prerequisites if not otherwise noted are normally just a browser ( preferably Chrome ) with Internet access
+To carry out the exercises of this repository, you need to
+- install the ABAP Development Tools (ADT) for the ABAP development parts
+- have a browser ready, preferably Google Chrome, to access the SAP Build
+
+The users for the development environment during the course are email addresses which are provided to you by the hosts.
 
-## Contents
+Go to [Getting Started - Preparation](exercises/ex0/README.md) to find out the installation details, URLs, then start with the first exercise.
 
-- [Accelerate Application Development with Low-Code in the SAP Business Application Studio](https://github.com/SAP-samples/low-code-applications/tree/bas_capex_2204) based on the release 2204
+## Exercises
 
-## How to obtain support
-[Create an issue](https://github.com/SAP-samples/low-code-applications/issues) in this repository if you find a bug or have questions about the content.
+- [Getting Started - Preparation](exercises/ex0/README.md)
+- [Part 1 - ABAP ](exercises/rap/README.md)
+- [Part 2 - SAP Build ](exercises/build/exercises/ex1/README.md)
+
+Start the exercises [here](exercises/rap/exercises/ex1/README.md).
 
-For additional support, [ask a question in SAP Community](https://answers.sap.com/questions/ask.html).
+## How to obtain support!
 
-## Contributing
-If you wish to contribute code, offer fixes or improvements, please send a pull request. Due to legal reasons, contributors will be asked to accept a DCO when they create the first pull request to this project. This happens in an automated fashion during the submission process. SAP uses [the standard DCO text of the Linux Foundation](https://developercertificate.org/).
+Support for the content in this repository is available during the actual time of the session by the hosts. 
 
 ## Contributing
 If you want to contribute, please check the [CONTRIBUTING.md](CONTRIBUTING.md) documentation for contribution guidelines.
@@ -30,4 +43,4 @@ If you want to contribute, please check the [CONTRIBUTING.md](CONTRIBUTING.md) d
 SAP adopts the Contributor's Covenant 2.0 across our open source projects to ensure a welcoming and open culture for everyone involved ([Code of Conduct](CODE_OF_CONDUCT.md)).
 
 ## License
-Copyright (c) 2022 SAP SE or an SAP affiliate company. All rights reserved. This project is licensed under the Apache Software License, version 2.0 except as noted otherwise in the [LICENSE](LICENSE) file.
+Copyright (c) 2023 SAP SE or an SAP affiliate company. All rights reserved. This project is licensed under the Apache Software License, version 2.0 except as noted otherwise in the [LICENSE](LICENSES/Apache-2.0.txt) file.

exercises/build/exercises/ex1/README.md

@@ -0,0 +1,153 @@
+# Exercise 1: Create Actions in SAP Build to access the Onlineshop API
+
+From this exercise on, we will switch to SAP's Business Technology Platform (BTP) on which SAP's solution for citizen developers, SAP Build run.
+
+In this exercise we will create Actions in SAP Build that access the Onlineshop API on S/4HANA from the previous chapter. There will be 2 actions, one to read all the onlineshop entries and another one that creates a new onlineshop entry. 
+
+To create such Actions we need to prepare 2 things first:
+- create a destination in BTP to create the secure connectivity from a BTP subaccount to the Onlineshop API on S/4HANA from the previous chapters
+- download the OData metadata document of the Onlineshop API from the previous chapter
+
+## Exercise 1.1: Create a Destination in a BTP subaccount to access the Onlineshop API
+
+We will now create the destination in a BTP subaccount to our Onlineshop API in the S/4HANA system from the previous chapter. The destination will ensure secure connectivity.
+
+1. In your ABAP Development Tools under **Business Services** -> **Service Bindings** -> **Z_ONLINESHOP_###** copy the **Service URL**, it should be `/sap/opu/odata4/sap/z_onlineshop_###/srvd_a2x/sap/z_onlineshop_###/0001/` (Make sure you don't use the service binding for the UI but the Web API!)
+
+![serviceurl](images/105.png)
+
+2. In a browser open the [destinations view in the BTP Cockpit](https://emea.cockpit.btp.cloud.sap/cockpit/#/globalaccount/47ae62c5-c35b-48a4-99b1-eee46b5b62bf/subaccount/f65e327c-d9e9-44cd-8d7b-e4e7ea8db474/destinations)
+
+3. Press the `New Destination` button.
+
+4. Fill in the following:
+
+    |  Porperty   | Value |
+    |  :------------- | :------------- |
+    |  Name   | Onlineshop_### |
+    |  Type   | HTTP |
+    |  Description   | Onlineshop_### on S4H |
+    |  URL   | http://s4h:443 + the copied Onlineshop URL (e.g. /sap/opu/odata4/sap/z_onlineshop_###/srvd_a2x/sap/z_onlineshop_###/0001/) |
+    |  Proxy Type   | OnPremise |
+    |  Authentication   | BasicAuthentication |
+    |  Location ID   | CALCC |
+    |  User   | lowcode### |
+    |  Password   | ABAP credentials as provided by your instructor |
+
+5. Then press the `New Property` button and add 
+`sap.applicationdevelopment.actions.enabled` with value `true`
+
+6. Press the `New Property` button again and add 
+`sap.processautomation.enabled` with value `true`
+
+![destination](images/100.png)
+
+7. Press `Save`
+
+8. Press `Check Connection`: You should get a pop up that says `Connection to "Onlineshop_###" successful`
+
+## Exercise 1.2: Download the OData metadata document of the Onlineshop API
+
+In this exercise we will download the OData metadata document to a file to later use it for a definiton of an Action for SAP Build.
+
+1. In your ABAP Development Tools you should still have the service binding ( under **Business Services** -> **Service Bindings** -> **Z_ONLINESHOP_###** ) open , this time, click on **Service URL**:
+
+![serviceurl](images/110.png)
+
+2. A browser window opens. The URL will look like this: 
+
+        https://YY.YYY.YYY.YY:44301/sap/opu/odata4/sap/z_onlineshop_###/srvd_a2x/sap/z_onlineshop_###/0001/?sap-client=100
+
+    Delete the `?sap-client=100` at the end and instead add `$metadata`, so the URL looks like this:
+
+        https://YY.YYY.YYY.YY:44301/sap/opu/odata4/sap/z_onlineshop_###/srvd_a2x/sap/z_onlineshop_###/0001/$metadata
+
+    Press `return` to load the metadata document
+
+4. Right Mouse Click on the browser window and select `View Page Source` and press `Ctrl + A` + `Ctrl + C` (`Command + A` + `Command + C` on Mac) 
+
+5. Open a text editor on your computer, paste the copied content using `Ctrl + V` (`Command + V` on Mac) and save the file as `Onlineshop_###_metadata.xml` to a location of your liking on your computer
+
+## Exercise 1.3: Create Actions from the Onlineshop API
+
+1. Open the [lobby](https://lcapteched.eu10.build.cloud.sap/lobby) in the browser with
+
+        User: lowcodeuser+0###@gmail.com
+
+        PW: XXXXXXX
+
+    that is provided by the instructors by the workshop (note this is not the same user as for the ABAP development tools, it is a BTP user)
+
+2. Press `Create`
+
+![lobby](images/150.png)
+
+3. Select `Build an Automated Process`
+
+![lobby](images/155.png)
+
+4. Select `Actions`
+
+![lobby](images/160.png)
+
+5. As Project Name choose `Onlineshop###Action`. Use the `Browse` button to locate the metadata file that you have saved in the previous step on your computer. Press `Create` 
+
+![lobby](images/165.png)
+
+6. Expand the entry `onlineshop` and select both, the `POST /onlineshop Add new entry to onlineshop` and the `Get /onlineshop Get entities from onlineshop`. Press `Add`
+
+![lobby](images/170.png)
+
+7. The 2 actions are now visible, select the `POST` one. In the right upper corner press the `Settings` button that looks like a gear wheel.
+
+![lobby](images/180.png)
+
+## Exercise 1.4: Test Actions from the Onlineshop API
+
+1. Switch `Enable CSRF` to `yes` and press `Save`
+
+![lobby](images/185.png)
+
+2. To test the action, select the destination that you have created before `Onlineshop_###`. In the input fields below, write `AS02` for the `product` and a number into the `quantity` field. Press `Test`.
+
+![lobby](images/190.png)
+
+3. The result should look like this:
+
+![lobby](images/195.png)
+
+## Exercise 1.5: Release the Action and Publish to Library
+
+In order to use the action inside SAP Build products like Process Automation, it has to be released first. Releasing means that the current state of the action is stored in an imutable way. Once the project is released, it can be published to library, which means that it is available inside SAP Build products like Process Automation, it can be discovered and used there.
+
+1. In the upper right corner of your action press `Release`
+
+![lobby](images/200.png)
+
+2. Optionally add some release notes and press `Release` on the dialog
+
+![lobby](images/205.png)
+
+3. After you released the action, in the same upper right corner the button has changed to `release to library`, press it 
+
+![lobby](images/210.png)
+
+4. Confirm that you want to publish, pressing the button
+
+![lobby](images/215.png)
+
+## Excercise 1.6: Add the Destination to the SAP Build Settings
+
+You have set up a destination in the BTP Cockpit to test our new actions and in the last step made the actions available for usage in SAP Build Process Automation. You now also need to register the destination with SAP Build to be used in a real environment of a process, not just for tests of actions.
+
+1. In the SAP Build choose `Settings` and then `Destinations` in the left pane.
+
+2. Press `New Destination` and search for your destination `Onlineshop_###` where of course `###` is your group ID. Select the destination and press `Add`.
+
+![lobby](images/90.png)
+
+## Summary  
+
+You have created 2 actions based on the Onlineshop Service, you built on ABAP Cloud in the previous exercises. You have created a BTP destination to connect to the Online Service and you have tested the actions. You have released the action and published it to a library, so you can use it in the following chapter in a new SAP Build Process Automation. You have also registered the destination for usage in SAP Build. 
+
+You can continue with the next exercise - **[Exercise 2: Create a Process in SAP Build Process Automation based on the Onlineshop Service](../ex2/README.md)**