Our Partner Reference Application provides you with a golden path to build, run, and integrate full-stack cloud applications on SAP Business Technology Platform.
With this repository, we give SAP partners guidance on how to extend SAP ERP solutions with side-by-side cloud applications running on SAP Business Technology Platform (SAP BTP). It includes:
- a preselection of SAP BTP components with architecture guidance tailored to meet the cost requirements of small and midsize enterprises (SME),
- best practices (golden path) to build, deploy, and provision full-stack SAP BTP applications, and
- information on the interoperability and integration with cloud ERP solutions such as SAP Business ByDesign and SAP S/4HANA Cloud Public Edition.
The repository includes a sample application that is ready to be deployed and run, and tutorials to rebuild it from scratch following an incremental development approach from one-off to multi-consumer solutions.
Imagine you're an event manager, for example, Peter, and your job is to organize and host poetry slams.
As your company runs its business on a cloud ERP system provided by SAP, you use its project management component to plan and staff events, to collect costs, and to purchase equipment. Additionally, an SAP partner provided you with a side-by-side application called Poetry Slam Manager (PSM) to publish poetry slam events and to register visitors and artists such as Julie.
For security and compliance reasons, it's crucial to you that event publishing and visitor registration are clearly separated from your ERP system. Nevertheless, as a power user working in both systems, you asked the partner to ensure a seamless user experience and navigation between the SAP system and Poetry Slam Manager.
The sample showcases how a side-by-side application benefits from using SAP BTP. The qualities relevant for enterprise-grade partner applications, supported by SAP BTP services and programming models, include:
Upcoming versions of the sample application might include further features provided by the SAP BTP:
- Create and change poetry slam events, publish and cancel poetry slams.
- Add and remove visitors, cancel registrations.
- Calculate the number of free seats and block overbookings.
- Create projects for poetry slam events in one click and preview project information on the Poetry Slam Manager UI (here, ERP authorizations must apply in the partner application as well!).
- As an ERP user, start Poetry Slam Manager from your ERP launchpad and navigate from Poetry Slam Manager to the associated project in the ERP system.
- Make use of a standardized online development environment using SAP Business Application Studio.
- Use a state-of-the-art web application architecture based on HTML5, Node.js, and SAP HANA Cloud.
- Make use of a model-driven development based on the SAP Cloud Application Programming Model, core data services (CDS), and SAP Fiori elements.
- Offer a user experience that matches the SAP standard due to standard floorplan patterns, and out-of-the-box theming and personalization.
- Use a draft concept to allow users to change data in multiple steps without having to publish incomplete changes.
- Benefit from enterprise-grade security by authentication and role-based authorizations in line with SAP product standards and technology alignments.
- Have enterprise-ready compliance by personal data management and audit log.
- Offer seamless and secure front-end and back-channel integration with SAP ERP solutions.
- Deliver open solutions by integration-ready OData APIs and business events following SAP technology alignments.
- Deploy the app as a one-off and/or as a multi-customer solution.
Join our community!
Would you like to share your own ideas and best practices? Join our discussions about the Partner Reference Application in our SAP Community.
The application is based on SAP Business Technology Platform (SAP BTP) and SAP ERP solutions. Therefore, here's what you need:
- An SAP BTP Test, Demo, Development (TDD) account, which includes SAP Business Application Studio as a standardized development environment,
- GitHub as your code repository, and
- an SAP ERP system.
To get a more detailed list of the required entitlements and the proposed structure of subaccounts for the deployed Partner Reference Application, go to the Bill of Materials.
This repository explains the development journey along the path from
- development of the core application as a single-customer ("one-off") deployment,
- enhancement to a multi-customer ("multi-tenant") solution,
- integration with different ERP back ends,
- extension with additional features.
A complete and working implementation of the above steps is available in separate branches:
- One-off deployment: branch main-single-tenant
- Multi-tenant deployment and ERP integration: branch main-multi-tenant
- Additional features (based on the multi-tenant implementation): branch main-multi-tenant-features
This allows you to check out those branches and directly work with the respective implementation. You can use GitHub comparisons to understand the changes required along the development journey.
The tutorials are provided in the (main) branch. If you prefer a quick start with a deployment of the poetry slam manager application including all features without further explanation, follow the quick start guide.
Updates to this repository are documented in the change history.
-
Build a full-stack SAP BTP application with a one-off deployment in a customer SAP BTP account:
- Get an overview of the bill of materials
- Prepare your SAP BTP account for development
- Prepare your SAP BTP subaccount for deployment
- Deploy the sample application to a customer SAP BTP account
- Develop the core of the SAP BTP application
- Enhance your SAP BTP application for deployment
- Deploy and set up your SAP BTP application
- Test and troubleshoot the application
- Go on a guided tour to explore the capabilities of the sample application
-
Enhance the application to support multiple customers using shared SAP BTP resources:
- Get an overview of the bill of materials
- Learn about multitenancy and prepare your SAP BTP account for development
- Prepare your SAP BTP subaccount for multi-tenant deployment
- Enhance the core application for multitenancy
- Deploy your SAP BTP multi-tenant application
- Provision your multi-tenant application to subscriber accounts
- Test and troubleshoot multitenancy
-
Integrate the application with the ERP back end of your customer:
- SAP Business One as ERP back end:
- SAP S/4HANA Cloud Public Edition as ERP back end:
- SAP Business ByDesign as ERP back end:
- Test and troubleshoot an ERP integration
- Go on a guided tour to explore the ERP integration
-
To extend your market reach, add additional features and integrate your SAP BTP application with more SAP BTP features and services:
- Get an overview of the bill of materials
- Manage data privacy
- Open the APIs of the SAP BTP application for third-party integrations:
- SAP BTP Developer’s Guide
- SAP Cloud Application Programming Model
- SAP Cloud SDK
- SAP Discovery Center
There aren't any known issues.
This repository is provided "as-is", we don't offer support. For questions and comments, join the SAP Community.
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 file.
![ospo-bot[bot] avatar](https://avatars.githubusercontent.com/in/105976?v=4 "ospo-bot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent