IN260 - Resilient Integration of SAP Solutions on SAP BTP

Description

This repository contains the material for the SAP TechEd 2023 session IN260 - Resilient Integration of SAP Solutions on SAP BTP.

Overview

This session dives into how tools such as SAP Cloud Application Programming Model, SAP Cloud SDK, and others can be used to develop applications that connect to SAP applications of any kind through APIs.

SAP Cloud Application Programming Model or CAP is a framework of languages, libraries, and tools for building enterprise-grade services and applications. It guides developers through proven best practices and accelerates the development process.

SAP Cloud SDK is a set of libraries and tools for developers to build cloud-native applications on the SAP Business Technology Platform (SAP BTP). CAP internally uses the SAP Cloud SDK for service consumption.

Over the course of this workshop, you will create an application that consumes both an OpenAPI and an OData service in a resilient manner.

For the OData part, you will see how to fetch data from SAP SuccessFactors Goal Plan API by using CAP's Remote Services.

For the OpenAPI part, you will see how to use the SAP Cloud SDK to conveniently interact with the service in a type-safe manner.

You could then follow similar steps to connect to any other SAP application that exposes an API and easily build extensions for them in the cloud in a resilient manner.

Requirements

The requirements to follow the exercises in this repository are:

• Java 17
• Maven 3.9
• Node 18+
• NPM 9+
• cdsdk 7.0+
• cf cli 7.7+

Exercises

• Getting Started
  • Prerequisites
  • Understanding the Use Case
• Exercise 1 - Understand the Existing Project Setup
  • Exercise 1.1 - Understanding the Project Structure
  • Exercise 1.2 - Understanding Service Definitions
  • Exercise 1.3 - CDS Maven Plugin
  • Exercise 1.4 - Understanding EventHandlers
  • Exercise 1.5 - Run Your Application Locally
• Exercise 2 - Use SAP Cloud SDK to make Your Application Resilient
  • Exercise 2.1 - Add the Required Dependencies to Your Project
  • Exercise 2.2 - Use the Resilience API
  • Exercise 2.3 - Use the Time Limiter Pattern
  • Exercise 2.4 - Locally Test the Resilience Patterns
  • Exercise 2.5 - The Retry Pattern
  • Exercise 2.6 - The Rate-Limiter Pattern
  • Exercise 2.7 (Optional) - The Circuit Breaker Pattern
  • Exercise 2.8 (Optional) - Interactions between Resilience Patterns
• Exercise 3 - Caching with the SAP Cloud SDK
  • Exercise 3.1 - Add the Required Dependencies to Your Project
  • Exercise 3.2 - Create a Cache Configuration
  • Exercise 3.3 - Apply the Cache Configuration
  • Exercise 3.4 (Optional) - Access the Created Cache
• Exercise 4 (Optional) - Asynchronous Operations
  • Exercise 4.1 - Making the SuccessFactors Update Asynchronous
  • Exercise 4.2 - The Problem with this Approach
  • Exercise 4.3 - How to Fix the Problem
  • Exercise 4.4 - Using Resilience Patterns with Async Operations
• Exercise 5 - Multi-Tenancy and Isolation
• Exercise 6 (Optional) - Deploying the Application to SAP Business Technology Platform
  • Exercise 6.1 - Creating a Destination for SuccessFactors API Endpoint and the Synthetic OpenAPI Service
  • Exercise 6.2 - Creating a Destination Service Instance
  • Exercise 6.3 - Adjusting the Deployment Descriptor - manifest.yml
  • Exercise 6.4 - Deploy and Test the Application
• Share your feedback

Useful Links

• SAP Customer Influence for SAP S/4HANA Cloud APIs.

Contributing

Please read the CONTRIBUTING.md to understand the contribution guidelines.

Code of Conduct

Please read the SAP Open Source Code of Conduct.

How to obtain Support

Support for the content in this repository is available during the actual time of the online session for which this content has been designed. Otherwise, you may request support via the Issues tab.

License

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