Skip to content

Latest commit

 

History

History
181 lines (136 loc) · 12.7 KB

README.md

File metadata and controls

181 lines (136 loc) · 12.7 KB
Raw

Partner Reference Application 'Poetry Slam Manager'

REUSE status

Description

This Partner Reference Application repository provides you with a “golden path” to becoming a SaaS provider of multi-tenant applications based on the SAP Business Technology Platform (SAP BTP).

The guidance covers building, running, and integrating scalable full-stack cloud applications. It includes an ERP-agnostic design that lets you deliver your application as a side-by-side extension to consumers using any SAP solution, such as SAP S/4HANA Cloud, SAP Business One, and SAP Business ByDesign.

By using BTP services and the SAP Cloud Application Programming Model (CAP), your application meets SAP standards for enterprise-class business solutions. It offers a harmonized user experience and seamless integration, including:

  • centralized identity and access management,
  • a common launchpad,
  • cross-application front-end navigation,
  • and secure back-channel integration.

The repository includes the “Poetry Slam Manager” application as a ready-to-run example. It also provides tutorials on how to build the application from scratch using an incremental development approach.

Based on this sample application, you will find the bill of materials and a sizing example. This addresses the question "Which BTP resources do I need to subscribe to and in what quantities?" and serves as a basis for cost calculation.

About the Sample Application Poetry Slam Manager

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 manage bookings of 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:

Features

  • Create and change poetry slam events, publish, and cancel poetry slams.
  • Maintain, add, and remove visitors, cancel bookings.
  • Calculate the number of free seats and block overbookings.
  • Create projects for poetry slam events with one click and preview project information on the Poetry Slam Manager UI (here, ERP authorizations apply in the partner application as well).
  • Create and print a guest list.
  • 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.
  • Analyze and monitor logging data of the customer deployment.

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.

Requirements

The application is based on SAP Business Technology Platform (SAP BTP) and SAP ERP solutions. Therefore, here's what you need:

  • An SAP BTP 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, the proposed structure of subaccounts for the deployed Partner Reference Application, and the scaling effects of the multi-tenant solution, go to the Bill of Materials.

Overview

This repository explains the development journey along the path from

  1. development of the core application as a single-customer ("one-off") deployment,
  2. enhancement to a multi-customer ("multi-tenant") solution,
  3. integration with different ERP back ends,
  4. extension with additional features.

A complete and working implementation of the above steps is available in separate branches:

  1. One-off deployment: branch main-single-tenant
  2. Multi-tenant deployment and ERP integration: branch main-multi-tenant
  3. 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.

Tutorials

  1. Build a full-stack SAP BTP application with a one-off deployment in a customer SAP BTP account:

    1. Get an overview of the bill of materials
    2. Prepare your SAP BTP account for development
    3. Prepare your SAP BTP subaccount for deployment
    4. Deploy the sample application to a customer SAP BTP account
    5. Develop the core of the SAP BTP application
    6. Enhance your SAP BTP application for deployment
    7. Deploy and set up your SAP BTP application
    8. Test and troubleshoot the application
    9. Go on a guided tour to explore the capabilities of the sample application

  2. Enhance the application to support multiple customers using shared SAP BTP resources:

    1. Learn about multitenancy and get an overview of the bill of materials
    2. Prepare your SAP BTP subaccount for multi-tenant deployment
    3. Enhance the core application for multitenancy
    4. Deploy your SAP BTP multi-tenant application
    5. Provision your multi-tenant application to consumer accounts
    6. Test and troubleshoot multitenancy
    7. Estimate the required size of the SAP HANA Cloud database

  3. Integrate the application with the ERP back end of your customer:

    1. SAP Business One as ERP back end:
      1. Learn more about the prerequisites and the purpose of SAP Business One integration
      2. Integrate the SAP BTP application with SAP Business One
      3. Configure the integration with SAP Business One
    2. SAP S/4HANA Cloud Public Edition as ERP back end:
      1. Learn more about the prerequisites and the purpose of SAP S/4HANA Cloud Public Edition integration
      2. Integrate the SAP BTP application with SAP S/4HANA Cloud Public Edition
      3. Configure the integration with SAP S/4HANA Cloud Public Edition
    3. SAP Business ByDesign as ERP back end:
      1. Learn more about the prerequisites and the purpose of SAP Business ByDesign integration
      2. Integrate the SAP BTP application with SAP Business ByDesign
      3. Configure the integration with SAP Business ByDesign
    4. Test and troubleshoot an ERP integration
    5. Go on a guided tour to explore the ERP integration

  4. To extend your market reach, add additional features and integrate your SAP BTP application with more SAP BTP features and services:

    1. Get an overview of the bill of materials
    2. Manage data privacy
    3. Open the APIs of the SAP BTP application for third-party integrations:
      1. Enable API access to SAP BTP applications using service broker
      2. Configure and consume the APIs of the SAP BTP application
    4. Observability: logging, metrics, and tracing
    5. Add capabilities for output management to your application:
      1. Manage forms
      2. Print documents
      3. Send emails
    6. Add capabilities for generative artificial intelligence (GenAI)

More Information

Known Issues

There aren't any known issues.

Get Support

This repository is provided "as-is", we don't offer support. For questions and comments, join the SAP Community.

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 file.