Skip to Content

Get Started with SAP Cloud SDK for JavaScript

test
0 %
Get Started with SAP Cloud SDK for JavaScript
Details

Get Started with SAP Cloud SDK for JavaScript

2020-03-13
Scaffold an application that is ready to be used with the SAP Cloud SDK for JavaScript.

Details

You will learn

  • How to scaffold your application
  • About the project’s structure
  • How to run the application locally

Step 1: Scaffold an application

Personally, we are fans of TypeScript and recommend using it for most applications. However, if you prefer using plain JavaScript, we recommend looking at step 4.

The main differences you will notice between TypeScript and JavaScript are the type annotations and module definitions - ES6 modules in TypeScript vs. commonJS modules in JavaScript. To migrate a TypeScript file to JavaScript, you only need to change the file extension from .ts to .js, remove all type annotations and change the imports and exports.

To create an application that already contains all the files and configuration you need to use the SAP Cloud SDK for JavaScript, you can use SDK’s command line interface (CLI). To get the CLI, run the following command:

npm install -g @sap-cloud-sdk/cli

This will install the CLI globally on your machine, allowing you to use it anywhere.
Now you can create a new project by running the CLI’s init command:

sap-cloud-sdk init my-sdk-project

Since the target folder is empty, the CLI will ask you whether a new nest.js project should be initialized. Answer with y and subsequently accept the suggested project name. The CLI will already install all the necessary dependencies for the project, so this might take a minute. If everything worked correctly, you should see output like this:

+---------------------------------------------------------------+
| ✅ Init finished successfully.                                |
|                                                               |
| 🚀 Next steps:                                                |
| - Run the application locally (`npm run start:dev`)           |
| - Deploy your application (`npm run deploy`)                  |
|                                                               |
| 🔨 Consider setting up Jenkins to continuously build your app |
| Use `sap-cloud-sdk add-cx-server` to create the setup script  |
+---------------------------------------------------------------+
Log on to answer question
Step 2: Get familiar with the project

The project contains the following files and folders, among others, to get you started with the SAP Cloud SDK for JavaScript:

NPM / Project

  • package.json: Specifies dependencies, metadata and user-defined scripts. The application comes with some predefined scripts and dependencies, that will be explained in detail in the course of this group of tutorials.
  • .npmrc: The npm configuration file. The SAP Cloud SDK consists of some generic libraries, that are available as Open Source Software and service libraries for the whitelisted SAP S/4HANA APIs, referred to as the Virtual Data Model (VDM). In the scaffolding we specify the registry for the @sap scope, where the VDM libraries are published.

TypeScript

  • tsconfig.json: Configuration file for TypeScript. This is not needed in the plain JavaScript version.
  • tslint.json: Configuration file for tslint, the de facto default linter for TypeScript.

Continuous Delivery

Cloud Foundry

  • manifest.yml: The deployment descriptor file for Cloud Foundry in SAP Cloud Platform.

Local development

  • src/: Source code for the initial application.

SDK specific

  • systems.json+credentials.json: Allows you to maintain destinations for testing purposes.
  • sap-cloud-sdk-analytics.json: Only if you have agreed to usage analytics during the initialization of your project. You can find more information about anonymous usage analytics in the CLI’s repository.
Log on to answer question
Step 3: Run the application

To run the application locally, simply run the following command:

npm run start:dev

Go to http://localhost:3000 and you should get a ‘Hello, World!’ in response. Before continuing with the next tutorial, open src/main.ts and switch the port from 3000 to 8080. The corresponding line should then look like this:

await app.listen(process.env.PORT || 8080);

Since nest was started in watch mode, it should detect this change and restart the server.

Log on to answer question
Step 4: Use the SDK in an existing project (optional)

If you already have an existing project that you want to start using the SAP Cloud SDK for JavaScript in, the SDK’s command line interface (CLI) allows you to add the necessary configuration in a single step. If you haven’t done so already, start by installing the CLI with the following command:

npm install -g @sap-cloud-sdk/cli

Then navigate to your project and execute the CLI’s init command:

cd <path/to/your/project>
sap-cloud-sdk init

Most importantly, the will add the necessary dependencies to your project, along with a set of scripts that allow you to use the SAP Cloud SDK’s Continuous Delivery Toolkit.

Log on to answer question

That’s it! You should now have a running application that is ready to be integrated with SAP S/4HANA Cloud.

Step 5: Test yourself
Which of the following files are part of the scaffolding introduced above?
×

Next Steps

Back to top