Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sap-samples/cloud-extension-s4hana-business-process

This sample showcases how to complement an existing business process in an SAP solution – currently SAP S/4HANA, with additional business process steps. This involves adding major logic and/or additional data.
https://github.com/sap-samples/cloud-extension-s4hana-business-process

btp-use-case-factory enterprise-messaging s4hana sample sample-code sap-btp sap-cap serverless

Last synced: about 1 month ago
JSON representation

This sample showcases how to complement an existing business process in an SAP solution – currently SAP S/4HANA, with additional business process steps. This involves adding major logic and/or additional data.

Awesome Lists containing this project

README 

        
# SAP S/4HANA Extended Business Process Scenario

[![REUSE status](https://api.reuse.software/badge/github.com/SAP-samples/cloud-extension-s4hana-business-process)](https://api.reuse.software/info/github.com/SAP-samples/cloud-extension-s4hana-business-process)

## Description

The main intent of this scenario is to complement an existing business process in an SAP solution – currently SAP S/4HANA with additional business process steps. This involves adding major logic and/or additional data and goes beyond simple UI changes.



This application showcases:



- Building applications on SAP Business Technology Platform (BTP) using [SAP Cloud Application Programming Model(CAP)](https://cap.cloud.sap/docs/)

- Consuming events from SAP S/4HANA on premise using [SAP Event Mesh](https://help.sap.com/viewer/bf82e6b26456494cbdd197057c09979f/Cloud/en-US/df532e8735eb4322b00bfc7e42f84e8d.html)

- Consuming REST APIs from SAP S/4HANA on premise using SAP Business Technology Platform Connectivity Service



## Business Scenario



A business scenario is used to showcase how to build a S/4 HANA on premise extension Application on SAP BTP.



John who is an employee of Business Partner Validation Firm iCredible, which is a third-party vendor of ACME Corporation would like to get notifications whenever new Business Partners are added in the S/4HANA backend system of ACME Corporation. John would then be able to review the Business Partner details in his extension app. He would proceed to visit the Business Partner’s registered office and do some background verification. John would then proceed to update/validate the verification details into the extension app. Once the details are verified, the Business Partner gets activated in the S/4HANA system of ACME Corporation.



- Custom extension application that works independently from S/4HANA.



- Changes in S/4 communicated via events in real time to extension application.



- Compute intensive processing available on demand (serverless environment).



- Vendor personnel needs access to only custom app



## Architecture



### Solution Diagram



![solution diagram](./documentation/images/solution-diagram-latest.png)



The Business Partner Validation application is developed using the SAP Cloud Application programming Model (CAP) and runs on the SAP BTP,  Cloud Foundry runtime. It consumes platform services like SAP Event Mesh, SAP HANA and Connectivity. The events occuring in S/4 HANA on premise are inserted into the Event Mesh queue. The application running in Cloud Foundry is notified on events, consumes them from the queue and inserts the event data into the HANA database. The Business Partner Validation Application uses S/4 HANA REST API's to read additional Business Partner Data from the S/4 HANA system.



## Requirements

* SAP S/4HANA on premise system.

* SAP Business Technology Platform account



### For local development you would require the following:

* [Node js](https://nodejs.org/en/download/)

>Make sure you run the latest long-term support (LTS) version of Node.js with an even number like 16. Refrain from using odd versions, for which some modules with native parts will have no support and thus might even fail to install. In case of problems, see the [Troubleshooting guide](https://cap.cloud.sap/docs/advanced/troubleshooting#node-version) for CAP for more details.

* [Cloud Foundry Command Line Interface (CLI)](https://github.com/cloudfoundry/cli#downloads)

* [Visual Studio Code](https://cap.cloud.sap/docs/get-started/in-vscode)

* [cds-dk](https://cap.cloud.sap/docs/get-started/)

* [SQLite ](https://sqlite.org/download.html)

* To build the multi target application, we need the [Cloud MTA Build tool](https://sap.github.io/cloud-mta-build-tool/), download the tool from [here](https://sap.github.io/cloud-mta-build-tool/download/)

* For Windows system, install 'MAKE' from https://sap.github.io/cloud-mta-build-tool/makefile/

* [multiapps plugin](https://github.com/cloudfoundry-incubator/multiapps-cli-plugin) - `cf install-plugin multiapps`  

*  mbt -  `npm install -g mbt`



### Entitlements



The application requires below set of SAP Business Technology Platform Entitlements/Quota



| Service                           | Plan       | Number of Instances |

|-----------------------------------|------------|:-------------------:|

| Event Mesh                        | default    |          1          |

| SAP HANA Schemas & HDI Containers | hdi-shared |          1          |

| SAP HANA Cloud                    | hana       |          1          |

| Cloud Foundry runtime             |            |          1          |



## Configuration



### Step 1: Setup SAP BTP subaccount



You can use [SAP BTP - Boosters](https://help.sap.com/viewer/DRAFT/65de2977205c403bbc107264b8eccf4b/Validation/en-US/fb1b56148f834749a2bf51127421610b.html) to setup the subaccount. Boosters Will create the subaccount with the required entitlements, subscriptions and assign the required roles to your user to run this application. Steps to run the booster are provided in [link](https://github.com/SAP-samples/cloud-extension-s4hana-business-process/blob/mission/mission/Prepare-Cloud-Platform/Booster.md). You can create subaccount manually also following [link](https://github.com/SAP-samples/cloud-extension-s4hana-business-process/blob/mission/mission/Prepare-Cloud-Platform/README.md)



### Step 2: [S/4HANA Enable OData Service for business partner](https://github.com/SAP-samples/cloud-extension-s4hana-business-process/blob/mission/mission/configure-oData-Service/README.md)



### Step 3: [Setup connectivity between S/4HANA system, SAP BTP](https://github.com/SAP-samples/cloud-extension-s4hana-business-process/blob/mission/mission/cloud-connector/README.md)



### Step 4: Build and deploy the CAP application



#### Steps to deploy locally



- Open terminal in VSCode

- Run `npm install sqlite3 --save-dev`

- Run `cds watch`



#### Steps to deploy the application on Cloud Foundry



1. Build the application

    `mbt build -p=cf `  

2. Login to Cloud Foundry by typing the below commands on command prompt

    ```

    cf api 

    cf login -u  -p 

    ```

    `api` - [URL of the Cloud Foundry landscape](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/350356d1dc314d3199dca15bd2ab9b0e.html) that you are trying to connect to.



    Select the org and space when prompted to.



3. Deploy the application



	Navigate to mta_archives folder and run the below command from CLI



   `cf deploy BusinessPartnerValidation_1.0.0.mtar`

### Step 5: [Configure event based communication between S/4HANA and Event Mesh](https://help.sap.com/viewer/810dfd34f2cc4f39aa8d946b5204fd9c/1809.000/en-US/fbb2a5980cb54110a96d381e136e0dd8.html)



## Demo script



1. Go to Launchpad and access the 'Business Partner Validation' application



2. Click on Business Partner Validation tile



![fiori tile](./documentation/images/fioriLaunchpad.JPG)



3. The list of BusinessPartners along with their verification status gets displayed. 



![BP list](./documentation/images/BPListView.JPG)



4. Login to the S/4HANA on-premise system



![S/4HANA login](./documentation/images/GuiLogin.JPG)



5. Enter transaction code 'bp'



![bp transaction](./documentation/images/BPtransaction.JPG)



6. Click on Person



![person](./documentation/images/person.png)



7. Provide first name, last name for the business partner

![name](./documentation/images/name.png)



8. Provide the address

![address](./documentation/images/bpaddress.png)



9. Move to the status tab and check mark the 'Central Block' lock. Save the BP. This will create a new Business Partner 



![lock](./documentation/images/lock.png)



10. Now go back to the BusinessPartnerValidation application to see if the new BusinessPartners has come on the UI



![new bp](./documentation/images/bpNew.png)



11. Go to the details page for the new BusinessPartner. Click on edit.



![edit bp](./documentation/images/editBP.png)



12. Change the Verification Status to VERIFIED. You can also edit the street name, postal code also if needed. Save the data. 



![edit values](./documentation/images/editValue.png)



13. Open S/4HANA system, bp transaction. Search for the newly created bp



![search bp](./documentation/images/searchBP.png)



14. Double click on the BP



![click bp](./documentation/images/clickBP.png)



15. You can see that the central Block lock has been removed 



![release lock](./documentation/images/releasedLock.png)



16. You can also notice that in the BusinessPartner Validation UI, the status is now set as COMPLETED.



## Known Issues



No known issues.



## How to Obtain Support



In case you find a bug, or you need additional support, please [open an issue](https://github.com/SAP-samples/cloud-extension-s4hana-business-process/issues/new) here in GitHub.



## License

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