Learn how the 3-tier extensibility model works and how to mitigate a missing released SAP API by wrapping an appropriate unreleased SAP API.
- How the 3-tier extensibility model works for SAP S/4HANA Cloud Private Edition and SAP S/4HANA
- The concept how to mitigate missing released SAP APIs using custom wrappers
- The sample business scenario that will be used to show how to mitigate a missing released SAP API by wrapping an unreleased BAPI
Familiarize yourself with the tier-3 extensibility model by reading the blog post How to use Embedded Steampunk in SAP S/4HANA Cloud, private edition and in on-premise – The new ABAP extensibility guide.
Understand the concept how to mitigate missing released SAP APIs in SAP S/4HANA Cloud Private Edition and SAP S/4HANA
Learn the concept how to mitigate missing released SAP APIs by reading:
- the blog post ABAP Cloud – How to mitigate missing released SAP APIs in SAP S/4HANA Cloud Private Edition and SAP S/4HANA – The new ABAP Cloud API enablement guide and
- the official SAP guidelines ABAP Cloud API Enablement Guidelines for SAP S/4HANA Cloud, private edition, and SAP S/4HANA.
User can launch custom online shop application to order gadget. When gadgets are ordered, a purchase requisition is automatically created in the S/4HANA system.
In this scenario you have a Shopping Cart business object built with the ABAP RESTful Application Programming Model (RAP) for an online shop application in tier 1. You then want to be able to create purchase requisitions for the shopping cart entries. In an ideal case, this could be achieved by making use of a released SAP API.
In this hands-on exercise we will show you how to deal with the case where no convenient released SAP API is available to create purchase requisitions: you will find a suitable unreleased SAP API in tier 3 to use as an alternative to a released API, you will wrap it in tier 2 and then release the wrapper for consumption in tier 1. You will then integrate this wrapper into your Shopping Cart RAP BO. As a final product, you will have a RAP BO in tier 1 that will consume the released wrapper to create purchase requisitions for your Shopping Cart RAP BO entries.
ℹ️ This hands-on workshop follows the assumption that there is no suitable released API to create purchase requisitions, and we therefore need to find and wrap an unreleased API as a suitable alternative.
Please be aware that we follow this assumption simply for illustrative purposes, as SAP does indeed provide a released API to create purchase requisitions (see Integrate released purchase requisition API into Shopping Cart Business Object).
For productive use, you would develop your RAP BO in the productive package ZCUSTOM_DEVELOPMENT in your SAP S/4HANA system as suggested in the Developer Extensibility guidelines Create Structure Package, and you would develop the wrapper in a dedicated package of software component HOME, for instance ZAPI_DEVELOPMENT. For the scope of this tutorial group we will follow a simplified approach, and you will use local development packages ZLOCAL and $TMP rather than productive packages.
⚠️ This step is not needed for SAP-led events such as ABAP Developer Days and SAP CodeJam.
The following requirements are needed for this tutorial group:
- If your system is running on feature pack stack 1 (SAP S/4HANA 2022 release), you have imported the SAP Note 3250849, SAP Note 3294354, SAP Note 3330593 and SAP Note 3280851 into your system.
- If your system is running on feature pack stack 0 (SAP S/4HANA 2023 release), you have imported the SAP Note 3350873
- You are connected to your SAP S/4HANA system in the ABAP Development Tool (ADT) in Eclipse
- You have a user in the system with full development authorizations.
- You have set up developer extensibility as described in the official documentation Set Up Developer Extensibility. In particular: the
ZLOCALdevelopment package is available and you have set up an ABAP Test Cockpit check variant (we will refer to this as 'ATC Check Variant' throughout the tutorial group).
We suggest to follow this hands-on workshop using SAP S/4HANA, fully-activated appliance in SAP Cloud Appliance Library for an easy start without the need for system setup, as the
ZLOCALdevelopment package is automatically available, as well as the needed ATC check variant and the material used for the gadget shopping cart entries.
Now that you've learned
- how the 3-tier extensibility model works for SAP S/4HANA Cloud Private Edition and SAP S/4HANA,
- the concept how to mitigate missing released SAP APIs using custom wrappers,
- the sample business scenario that will be used to show how to mitigate a missing released SAP API by wrapping an unreleased BAPI,
- and eventually verify the technical requirements,
you can continue with the next exercise - Exercise 1: Implement a Wrapper for the "Create Purchase Requisition" (BAPI_PR_CREATE) function module.