SAP HANA XS Advanced, Connecting to SAP Web IDE and cloning a Git Repository to begin development
- This tutorial is designed for SAP HANA on premise and SAP HANA, express edition. It is not designed for SAP HANA Cloud.
- If you do not have a HANA System with XS Advanced, get your own instance of SAP HANA, express edition with XS Advanced
- Recommended: It is recommended to map the development space to a tenant database. Follow these instructions before creating your first database module.
With XSA and HDI (SAP HANA Deployment Infrastructure), all design-time artifacts are stored in Git instead of the SAP HANA database. We need to setup the repository so development can be collaborative.
Check this series of blogs posts to get introduced to the basic concepts in XS Advanced development, such as Multi-target Applications and micro-services.
- Step 1
It is recommended that you map the development space to the default tenant in SAP HANA, express edition. Follow these instructions before getting started..
By default, in SAP HANA, express edition, SAP Web IDE for SAP HANA can be accessed using
https://hxehost:53075/. If you are using a different system, you can check the URL using command
xs apps | grep webidein the XS Command Line Interface.
Password: The password provided when you set up HANA Express
- Step 2
From a separate tab in the web browser, log into GitHub. If you do not have an account, proceed to create one by following the instructions to create and activate your account in the sign up button.
If you are setting up the repository for use beyond this tutorial, you may want to create an organization and invite other users to join your repository. Further information can be found on GitHub
Alternatively, if you do not wish to create an account on GitHub, you can create a project by right-clicking on your workspace and following the wizard for Multi-Target Applications in
New->Project from Template
- Step 3
Whether you have just activated a newly-created account or have been using GitHub disconnected from a HANA workspace, you may wish to create a new repository for this tutorial. If you already have a GitHub repository you would like to use, continue to Step 3.
Follow the instructions in the New Repository option from the + menu in the upper right corner on
Complete the form adding a name and description, make sure to tick Initialize this repository with a README and click on Create Repository.
- Step 4
Form the GitHub page, copy the URL of the repository from the Clone or Download menu
Return to the SAP Web IDE for SAP HANA. Right click on the Workspace and choose Clone Repository from the Git menu.
SAP Web IDE for SAP HANA will request the Git URL to access the repository, which you have copied from GitHub:
Enter authentication details:
<Your GitHub User ID>
<You've guessed: Your GitHub password!>
Tick the Remember me box so it will not ask again for the remainder of the session. If you receive a Git Ignore System Files message, please choose Do it later.
If successful, you will see the repository folder in your workspace, which is now connected to the git repository.
- Step 5
Last, you need to configure the space for the repository you have just linked.
Spaces enable applications to access shared resources that can be used to develop, deploy, and maintain applications.
Right-click on the folder for the repository and select Project Settings
Select the proper space (for HANA express,
development) from the list of available spaces, or use the space setup by the System Administrator:
If you cannot find an appropriate space, you may either lack the
SpaceDeveloperrole to one or may need to create one. By default, SAP HANA, express edition brings a development space that is implicitly mapped to the system database. If you are planning on using any of the advanced analytics features (such as Machine Learning), you need to map the space to a tenant database, such as the default one, HXE.
Open the GitHub pane using the menu bar on the right to complete the validation for this tutorial
Mark the actions you see available under Git