Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/sap-samples/abap-platform-rap110

This repository contains the material for the hands-on session RAP110 - Building Fiori Apps with the ABAP RESTful Application Programming Model (RAP).
https://github.com/sap-samples/abap-platform-rap110
abap abap-restful rap rap-workshop sample sample-code
Last synced: 2 months ago
JSON representation
This repository contains the material for the hands-on session RAP110 - Building Fiori Apps with the ABAP RESTful Application Programming Model (RAP).
Host: GitHub
URL: https://github.com/sap-samples/abap-platform-rap110
Owner: SAP-samples
License: apache-2.0
Created: 2023-11-17T18:43:31.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2024-05-22T19:41:57.000Z (7 months ago)
Last Synced: 2024-10-10T02:23:43.445Z (2 months ago)
Topics: abap, abap-restful, rap, rap-workshop, sample, sample-code
Language: ABAP
Homepage:
Size: 27.6 MB
Stars: 16
Watchers: 4
Forks: 9
Open Issues: 3
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project

README

        [Home - Workshops about the ABAP RESTful Application Programming Model (RAP)](https://github.com/SAP-samples/abap-platform-rap-workshops/blob/main/README.md)

[![REUSE status](https://api.reuse.software/badge/github.com/SAP-samples/abap-platform-rap110)](https://api.reuse.software/info/github.com/SAP-samples/abap-platform-rap110)

# RAP110 - Build transactional SAP Fiori elements-based Apps with the ABAP RESTful Application Programming Model (RAP)

## Level: Intermediate

## Introduction

#### Description

This repository contains the material for the hands-on session **RAP110 - Building Fiori Apps with the ABAP RESTful Application Programming Model (RAP)**. It includes a managed Business Object (BO) with two BO nodes or entities, and features such as virtual elements in dealing with BO projection views, late numbering, determine actions, static default factory actions, side effects, functions, business event exposure, and additional save. 

#### Table of Content

- [Requirements for attending this workshop](#requirements-for-attending-this-workshop)

- [Overview](#overview)

- [Exercises](#-exercises)

- [Recording](#recording)

- [Solution Package](#solution-package)

- [How to obtain support](#how-to-obtain-support) 

- [Further Information](#ℹfurther-information)

## 📋Requirements for attending this workshop 

[^Top of page](#)

> You need the latest version of the ABAP Development Tools for Eclipse (ADT) on your laptop or PC as well as the access to an appropriate ABAP system* to carry out the practical exercises of this workshop.

>

> (*) The supported ABAP systems are SAP BTP ABAP Environment, SAP S/4HANA Cloud Public Edition, or at least the release 2023 of SAP S/4HANA Cloud Private Edition and SAP S/4HANA.

> The [ABAP Flight Reference Scenario](https://github.com/SAP-samples/abap-platform-refscen-flight) and the [openSource RAP Generator](https://github.com/SAP-samples/cloud-abap-rap) must imported into the relevant system - e.g. SAP BTP ABAP Environment Trial.

  Click to expand!

The requirements to follow the exercises in this repository are:

1. [Install the latest Eclipse platform and the latest ABAP Development Tools (ADT) plugin](https://developers.sap.com/tutorials/abap-install-adt.html)

2. [Create an user on the SAP BTP, ABAP environment Trial](https://developers.sap.com/tutorials/abap-environment-trial-onboarding.html) (_Read exception below_)

3. [Create an ABAP Cloud Project](https://developers.sap.com/tutorials/abap-environment-create-abap-cloud-project.html)

>> ⚠ **Exception regarding SAP-led events such as "ABAP Developer Day" and "SAP CodeJam"**:   

>> → A dedicated ABAP system with pre-generated packages for the hands-on workshop participants will be provided.   

>> → Access to the system details for this on-site workshop will be provided by the instructors during the session.    

## 🔎Overview

> This workshop is all about RAP fundamentals; especially about how to use RAP core features when building greenfield implementations.

  Click to expand!

### Business Scenario

> In this hands-on session we will guide you through the development of the OData service of a SAP Fiori elements based _Travel Processing App_ with RAP, using the _managed_ business object (BO) runtime implementation with semantic key and late numbering. We will give you more details on the scenario in the different exercises.

>   

> The OData service you are going to implement is based on the _ABAP Flight Reference Scenario_. To set the business context, the scenario is the following: The department responsible for managing worldwide Travels for multiple Agencies is requesting you to build a new Fiori app with draft capabilities for processing (i.e. creating, updating and deleting) Travels. 

  

  Click to expand!

The resulting _Travel_ app is a SAP Fiori elements-based List Report app with search, filter, and draft capabilities for processing travel bookings. A navigation to an Object Page for displaying the details of each _travel_ entry in the list report is offered. The application will look like this: 

**List Report**:



  

**Object Page**: 



Below is the simplified _Flight_ data model underlying the app.



### About the ABAP RESTful Application Programming Model (RAP)

[^Top of page](#)

   

> **ABAP Cloud** is the development model for building cloud-ready business apps, services and extensions on SAP BTP and all SAP S/4HANA editions, i.e. public or private cloud, and even on-premise.

>

> The **ABAP RESTful Application Programming Model (RAP)** is the centerpiece of _ABAP Cloud development model_ for building transactional, cloud-ready SAP Fiori apps and Web APIs. RAP offers a set of concepts, tools, languages, and powerful frameworks provided on the ABAP platform. It supports the efficient development of innovative and cloud-ready enterprise applications, as well as the extension of SAP standard applications in an upgrade-stable way in the cloud and on-premise.

Click to expand!

RAP is an enabler for improving the user experience and innovating business processes in ABAP-based SAP solutions by leveraging SAP Fiori, SAP HANA, and the cloud. 

It is a long-term strategic solution for ABAP development on SAP’s flagship product SAP S/4HANA, in the cloud and on-premise (as of release 1909), as well as on the SAP BTP ABAP Environment.

The illustration below shows the high-level end-to-end development stack when working with RAP.  



## 🛠 Exercises

[^Top of page](#)

#### Main Exercises: 

Follow these steps to enhance an existing OData UI service developed with RAP for a transactional SAP Fiori elements-based Travel Processing app.

| Exercises | Boosters |

| ------------- | -- |

| [Getting Started](exercises/ex00/README.md) | -- |

| [Exercise 1: Generate and Inspect your Exercise Package](exercises/ex01/README.md) | -- |

| [Exercise 2: Enhance the Data Model of the Base and Projected BO](exercises/ex02/README.md) | -- |

| [Exercise 3: Enhance the BO Behavior Definition and Projection](exercises/ex03/README.md) | 💡 |

| [Exercise 4: Implement the Base BO Behavior - Late Numbering](exercises/ex04/README.md) | -- |

| [Exercise 5: Adjust the UI Semantics in the Metadata Extensions](exercises/ex05/README.md) | 💡  |

| [Exercise 6: Implement the Base BO Behavior - Validations](exercises/ex06/README.md) | 💡 |

| [Exercise 7: Implement the Base BO Behavior - Actions](exercises/ex07/README.md) | -- |

| [Exercise 8: Implement the Base BO Behavior - Determinations](exercises/ex08/README.md) | -- |

| [Exercise 9: Enhance the BO Behavior with Side Effects](exercises/ex09/README.md) | -- |

| [Exercise 10: Implement the Base BO Behavior - Functions](exercises/ex10/README.md) | -- |

| [Exercise 11: Enhance the BO Behavior with Business Events](exercises/ex11/README.md) | -- |

| [Exercise 12: Implement the Base BO Behavior - Dynamic Feature Control](exercises/ex12/README.md) | -- |

   

_BO: Business Object_  

_EML: Entity Manipulation Language_    

_💡: Exercises with _boosters_ that provide an accelerated way to do them._ 

#### Optional Exercises: 

The main exercises (1-12) focus on the development capabilities available in the ABAP Development Tools for Eclipse (ADT). The _SAP Fiori elements App Preview_ integrated in ADT is used to preview the resulting app. To create, deploy, and run the actual SAP Fiori elements-based _Travel_ app using the SAP Business Application Studio, follow the instructions in the following tutorials from the _SAP Developer Center_:

> **Info**: _Exercise 13 can be done after any of the main exercises (1-12), but preferably after at least Exercise 5_.

| Exercises | -- |

| ------------- |  -- |

| [Exercise 13: Create an SAP Fiori elements App and Deploy it to SAP BTP ABAP Environment with SAP Business Application Studio](https://developers.sap.com/tutorials/abap-environment-deploy-fiori-elements-ui.html) | -- |

| [Exercise 14: Integrate an SAP Fiori App into the ABAP Fiori Launchpad](https://developers.sap.com/tutorials/abap-environment-integrate-app-into-flp.html) (_license required_)| -- |

## 📹Recording 

[^Top of page](#)

For a compact overview of the exercises, watch the session replay from SAP TechEd 2023 (_gated content_):  

⏺ [Delve into ABAP Cloud on SAP BTP, ABAP Environment – AD181v](https://go3.events.sap.com/sapteched/virtual/2023/reg/flow/sap/sapteched23/catalog/page/catalog/session/1693019545062001fMQZ)

## 📤Solution Package

> You can import the solution package **`ZRAP110_SOL`** into your system*. 

>

> (*) The supported ABAP systems are SAP BTP ABAP Environment, SAP S/4HANA Cloud Public Edition, or at least the release 2023 of SAP S/4HANA Cloud Private Edition and SAP S/4HANA.

> The [ABAP Flight Reference Scenario](https://github.com/SAP-samples/abap-platform-refscen-flight) must available in the system before importing the solution package.

Follow this instructions to import the solution:

1. [Install the abapGit plugin in your ABAP Development Tools (ADT) for Eclipse](https://developers.sap.com/tutorials/abap-install-abapgit-plugin.html) if you have not already done so.

2. In ADT, create the ABAP package **`ZRAP110_SOL`** in your system.

3. Open the **abapGit Repositories** view in ADT and follow the steps below.  

4. Create a link to the repository using the **Link abapGit Repository** window.    

    📤 Git repository URL: https://github.com/SAP-samples/abap-platform-rap110

5. Now pull/import the solution implementation using the context menu _**Pull...**_.

6. Activate the imported development objects (**Ctrl+Shift+F3**).

## Known Issues

No known issues.

## 🎧How to obtain support

[^Top of page](#)

Support for the content in this repository is available during the actual time of the online session for which this content has been designed. Otherwise, you may request support via the [Issues](../../../../issues) tab. 

For additional support, [ask a question in SAP Community](https://answers.sap.com/questions/ask.html).

## ℹFurther Information

[^Top of page](#)

You can find further information on the ABAP RESTful Application Programming Model (RAP) here:

  - 📍 [Overview of the ABAP Cloud Sessions at SAP TechEd 2023](https://blogs.sap.com/2023/10/02/abap-cloud-at-sap-teched-in-2023/)  

  - 📃 [State-of-the-Art ABAP Development with RAP | SAP Community](https://community.sap.com/topics/abap/rap)- A collection of diverse getting started materials.   

  - 📄 [ABAP Cloud – SAP S/4HANA extensibility – May 2023 update | SAP Blogs](https://blogs.sap.com/2023/05/26/abap-cloud-sap-s-4hana-extensibility-may-2023-update/)

  - ❓ Most frequently asked questions: [RAP FAQ](https://blogs.sap.com/2020/10/16/abap-restful-application-programming-model-faq/) 

  - 🛠 [Develop and Run a Fiori Application with SAP Business Application Studio | SAP Tutorials](https://developers.sap.com/tutorials/abap-environment-deploy-cf-production.html)

  - 🛠 [Landing page with various hands-on workshop materials on ABAP Cloud, including RAP and embedded analytics](https://github.com/SAP-samples/abap-platform-rap-workshops/blob/main/README.md) 

## 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/).  

## License

Copyright (c) 2024 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.