SAP Event Registration app backend

This is the successor of SITreg. Now implemented using the SAP Cloud Application Programming Model. Check out the roadmap for the next steps.

Get Started

Development Environment

We recommend using Visual Studio Code as local development environment. To get the language support for the CDS objects you must manually install the corresponding extension for Visual Studio Code. To install this extension, proceed as follows

1. Download the vsix file from SAP Development Tools -> Cloud -> CDS Language Support for Visual Studio Code
2. Install the downloaded vsix file in Visual Studio Code using command Install from VSIX...

NPM Registry

The NPM packages for CDS are not part of the default NPM registry. As a consequence, you must configure your registry to lookup the packages in the SAP NPM registry. Enter the following command:

npm set @sap:registry=https://npm.sap.com

CDS Command Line Tools

Install the CDS command line tools

npm i -g @sap/cds

Build the Project

To build the project, walk through the following steps

1. Download or clone the repository.
2. Navigate to the folder of your local repository
3. Execute the command npm installto install the relevant NPM packages
4. Execute the command npm run build to trigger a clean build of the project
5. Execute the command npm run deploy to deploy in the local sqlite database
6. Execute the command npm start to startup the project locally

You can now access the services via

 http://localhost:4004

Initialize the Local Database

Run the following command to Initialize your local SQLite DB:

cds deploy --to sqlite:db/sitregcapm.db

Do not forget to repeat this step to initialize the local database whenever you changed the datamodel

Setup XSUAA

To be able to use authenticaiton and the defined scopes (authorization) a XSUAA must be set up. First compile the CDS to xs-security.json:

mkdir gen
cds srv/ --to xsuaa,json > gen/xs-security.json

now deploy that to your SAP CP Cloud Foundry trial:

cf login
cf create-service xsuaa application sitregcapm-uaa -c gen/xs-security.json

then create the service-key:

cf create-service-key sitregcapm-uaa sitregcapm-uaa-key && cf service-key sitregcapm-uaa sitregcapm-uaa-key

cf push sitregcapm --no-start --no-manifest --random-route
cf bind-service sitregcapm sitregcapm-uaa
cf restage sitregcapm

Recommended Extensions

Local execution makes use of SQLite3 as database. To get an insight into the database from visual studio code we recommend to install the SQLite Extension from the Visual Studio Marketplace

Communication

Please join the SAP Mentors & Fiends Slack Workgroup in the channel #sitreg.

Additional Resources

Here are some additional resources for the SAP Cloud Application Programming Model (CAPM):

• help.sap.com
• developers.sap.com tutorial
• Hands-on SAP dev with qmacro – live stream series