Extensibility Guide | PUBLIC Develop a Custom UI on SAP Business Technology Platform and Deploy it to SAP S/ 4HANA Cloud company. All rights reserved. All rights company. affiliate THE BEST RUN 2021 SAP SE or an SAP SE or an SAP SAP 2021 © Content 1 Overview.................................................................. 4 1.1 Business Scenario............................................................4 Scenario Process Flow.......................................................5 2 Preparation.................................................................7 2.1 Prerequisites................................................................7 3 Implementation.............................................................9 3.1 Configure and Create the Custom Business Object in the SAP S/4HANA Cloud System........... 9 Create the Code Lists Used in the Custom Business Object.............................9 Create a Custom Business Object.............................................. 11 Implement Custom Logic for the Custom Business Object (Optional).....................13 3.2 Prepare Your SAP Business Technology Platform Environment............................ 15 3.3 Set Up Trust Between Identity Authentication and Your SAP Business Technology Platform Subaccount................................................................16 3.4 Configure Trust Between SAP S/4HANA Cloud and Your SAP Business Technology Platform Subccount.................................................................23 Create a Communication System.............................................. 24 Create a Communication Arrangement..........................................27 Configure the Destination on SAP Business Technology Platform........................28 3.5 Expose the Custom Business Object as an External Web Service...........................32 Check OData Service for the Custom Business Object................................33 Create Custom Communication Scenario........................................ 34 Create Communication Arrangement........................................... 34 3.6 Configure the Delivered Sample App for Use in the S/4HANA Cloud System...................35 Import and Test the SAP Fiori Sample App to Your SAP Web IDE Environment...............36 Deploy the SAP Fiori App Back to Your SAP S/4HANA Cloud System.....................38 Extend a Business Catalog and Embed an App in the SAP Fiori Launchpad.................40 4 Test the Custom UI..........................................................42 5 Transport the Extensions from Quality to Productive System..........................43 5.1 Export Extensions from the Quality System..........................................43 5.2 Import Extensions to the Productive System.........................................44 5.3 Test Imported Extensions in the Productive System....................................44 6 Appendix.................................................................46 6.1 Issues....................................................................46 Develop a Custom UI on SAP Business Technology Platform and Deploy it to SAP S/4HANA Cloud 2 PUBLIC Content 6.2 Document History........................................................... 46 Develop a Custom UI on SAP Business Technology Platform and Deploy it to SAP S/4HANA Cloud Content PUBLIC 3 1 Overview 1.1 Business Scenario Note This sample scenario is for learning purposes only. It is intended to give you an understanding of the various technical aspects related to extending SAP S/4HANA Cloud. The sample scenario may not always be available in a readily consumable state due to the continuous improvements being made in the underlying products or services. If this is the case, appropriate adaptations based on the latest documentation of the respective products or services are required. This guide describes a simple SAP Fiori UI sample application scenario that showcases an extension to an SAP S/4HANA Cloud system. The app uses a custom business object to store equipment data. Within this custom business object, you can maintain equipment records and temporarily assign equipment to your employees. The sample SAP Fiori app must be seen in the context of the overall scenario which includes several focal topics. With this scenario, you learn how to create in-app extensions on SAP S/4HANA Cloud using a custom business object, expose a service for it, and consume this service in a custom SAP Fiori UI on SAP Business Technology Platform. This scenario also describes how to deploy the custom UI from SAP Business Technology Platform to SAP S/4HANA Cloud and how to transport extensions from a quality system to a productive system. Please note that this example focuses on deployment to SAP S/4HANA Cloud and, therefore, only describes a basic check logic (see Implement Custom Logic for the Custom Business Object (Optional)). The basic check logic is intended to give you an insight into how this kind of logic might be implemented. Develop a Custom UI on SAP Business Technology Platform and Deploy it to SAP S/4HANA Cloud 4 PUBLIC Overview 1.1.1 Scenario Process Flow The following diagram shows the technical steps and the system landscape required to run and understand the sample: The following table gives you a brief overview of the steps in this scenario: Step Details 1 Creating a Custom Business Object You create a custom business object on SAP S/4HANA Cloud. In this example, the object is called Equipment. 2 Exposing the Custom Business Object You expose the business object using (CDS view) as an OData Service an OData service. This means that data from the custom business object can be consumed on SAP Business Tech­ nology Platform. 3 Creating a Custom Fiori UI Using SAP You develop a custom Fiori UI and up­ Web IDE load the source code for the application to SAP Web IDE. Develop a Custom UI on SAP Business Technology Platform and Deploy it to SAP S/4HANA Cloud Overview PUBLIC 5 Step Details 4 Setting Up a Shared Identity Provider In order to deploy the app back to SAP (IdP) for Single Sign-on S/4HANA Cloud, you need to establish the trust between the SAP S/4HANA system and SAP Business Technology Platform subaccount using a shared identity provider. You also need to configure the trusted connection between the SAP Web IDE and SAP S/4HANA Cloud 5 Deploying the Fiori UI to SAP S/4HANA You deploy the app back to the SAP S/ Cloud 4HANA Cloud ABAP repository. 6 Making a Custom Fiori UI Available on You extend a business catalog to make SAP Fiori launchpad the app available on the SAP Fiori launchpad. 7 Transporting Extensions and the UI Finally, you execute the required steps from Q to P System to transport your extension from the quality system to the productive SAP S/4HANA Cloud system. Develop a Custom UI on SAP Business Technology Platform and Deploy it to SAP S/4HANA Cloud 6 PUBLIC Overview 2 Preparation 2.1 Prerequisites To perform the steps in this document, you need to make sure that the following prerequisites are met: Prerequisites Details SAP S/4HANA Cloud system You have access to an SAP S/4HANA Cloud system with all the necessary users and authorizations (refer to the follow­ ing prerequisites). SAP Business Technology Platform You have an SAP Business Technology Platform account. You can use an SAP Business Technology Platform trial account. Find more information here, on how to get a trial account . You have access to the SAP Web IDE. For more information, refer to Open SAP Web IDE. For more information on account types and on purchasing an enterprise account, refer to SAP Business Technology Platform Accounts. Moreover, if want to try out this sample scenario, you need to have a productive SAP Business Technology Platform Neo subaccount. Identity Provider In the Deploy the SAP Fiori App Back to Your SAP S/4HANA Cloud System [page 38] section, you learn how to deploy an app developed in the SAP Web IDE to your SAP S/4HANA Cloud. You need to configure the connectivity based on OAuth authentication. OAuth can be used only when a common identity provider is configured for both systems. As a prerequisite, a trust be­ tween the identity authentication tenant and your SAP S/ 4HANA Cloud has already been established. For identity au­ thentication, you must have a user with administration au­ thorization for the tenant’s administration console. Develop a Custom UI on SAP Business Technology Platform and Deploy it to SAP S/4HANA Cloud Preparation PUBLIC 7 Prerequisites Details Personas/users and authorizations Make sure that roles that contain the following business cat­ alogs have been assigned to your users (depending on the persona): ● SAP_CORE_BC_EXT (Extensibility) ● SAP_CORE_BC_EXT_UI (Extensibility - Fiori App Devel­ opment) ● SAP_CORE_BC_EXT_TST (Extensibility - Custom Apps and Services) ● SAP_CORE_BC_COM (Communication Management) ● SAP_CORE_BC_SL_EXP (Transport Management – Ex­ port) [for the quality system] ● SAP_CORE_BC_SL_IMP (Transport Management – Im­ port) [for the productive system] This ensures that users have the necessary authorizations and can access the respective apps on the SAP Fiori launch­ pad. An administrator user who has the necessary authori­ zation can take care of the role administration (a role that contains the SAP_CORE_BC_IAM - Identity and Access Man­ agement catalog has been assigned to the administrator). You can, for example, create a new custom business role if necessary. To do so, go to the Maintain Business Roles app. Add the business catalogs on the Assigned Business Catalogs tab.