Skip to main content

Create Your First Application with the SAP Cloud SDK for JavaScript

About This Tutorial

This tutorial is divided into multiple sections:

  • Setup tells you about tools you need, setting up a NestJS application, and its project structure.
  • Execute an OData Request will give you a deeper insight into using a pregenerated client to execute requests against an OData service.
  • Deploy Application to Cloud Foundry informs you about managing destinations in Cloud Foundry in SAP BTP.

About the Application

In this tutorial, you will build your own application from scratch, using the SAP Cloud SDK for JavaScript and NestJS. NestJS is a framework for building server-side Node.js applications.

The application will use the business partner client library and connect to an SAP S/4HANA Cloud system. It will fetch a list of business partners and provide the result to a service endpoint that users can consume. You will leverage several of the SAP Cloud SDK features such as:

  • request builders to build OData requests for available request types.
  • destination lookup for destinations created manually or referenced by name.
  • execute method to construct request URL and headers, execute the request, and return a typed response

Prerequisites

This tutorial assumes you have a basic knowledge about the following:

For deploying your application to Cloud Foundry in SAP Business Technology Platform, you will need an account. You can get a trial account here or use an existing account, if you already have one.

You also need to have access to an SAP S/4HANA Cloud system with a technical user. If no SAP S/4HANA Cloud system is available, you can set up a mock server or use a sandbox API as described below.

You can setup a local mock server by following the instructions here. This server hosts an OData v2 mock service that mimics the business partner API. It does not support all the features of the actual OData services, but it suffices to try it out locally. Once it is up and running you should see the list of services at http://localhost:3000.

Alternatively, many APIs can also be tested using the sandbox of the SAP API Business Hub. To use the sandbox, you need an API key. Go to SAP API Business Hub and click Login in the top right corner. If you do not have an account, you will need to register first. When you are logged in, click on Hi name in the top right corner and then click on Settings in the dropdown menu. On the settings page, click Show API Key.

Learning Outcomes

After reading the tutorial, you will learn how to do the following tasks:

  • Consume a pregenerated client in your application.
  • Use the SAP Cloud SDK to perform basic GET requests against a SAP S/4HANA Cloud system.
  • Create and configure a destination and use it in your application.
  • Deploy your application to a Cloud Foundry space.