Copyright

Any redistribution or reproduction of part or all of the contents in any form is prohibited other than the following:

You may print or download to a local hard disk extracts for your personal and non-commercial use only.
You may copy the content to individual third parties for their personal use, but only if you acknowledge this document as the source of the material.

You may not, except with our express written permission, distribute or commercially exploit the content. Nor may you transmit it or store it in any website or other form of electronic retrieval system.

SAP, ABAP, SAP Business Suite, SAP ERP, SAP Customer Relationship Management (SAP CRM), SAP ERP Human Capital Management (SAP ERP HCM), SAP ERP Operations, SAP ERP Financials, SAP Product Lifecycle Management (SAP PLM), SAP Supplier Relationship Management (SAP SRM), SAP Supply Chain Management (SAP SCM), SAP Business One, SAP Business All-in-One, SAP NetWeaver Business Intelligence (SAP NetWeaver BI), SAP NetWeaver Master Data Management, SAP NetWeaver, SAP Solution Manager, SAP Exchange Infrastructure (SAP NetWeaver XI) SAP Business Information Warehouse (SAP BW), SAP Strategic Enterprise Management (SAP SEM), SAP R/3, SAP R/3 Enterprise, SAP Business ByDesign, SAP BusinessObjects GRC Global Trade Services, SAP GTS are the trademarks or registered trademarks of SAP AG in Germany and in several other countries.

How to setup HANA XS application

For delivery of HANA XS application standard delivery unit (DU) is used.

Prerequisites for installation

access to an SAP HANA system
assigned the SAP HANA sap.hana.xs.lm.roles::Administrator user role

Open HANA Application Lifecycle Management
1. using link: http://<host_address>:80<instance_number>/sap/hana/xs/lm
Import Delivery Unit
1. Navigate to Products → Delivery units
2. Click Import and find delivery unit package in your file system
3. Click Import and then confirm with import button
4. Application is successfully imported

Create database users

For successful configuration two kind of users needs to be created. First user will be dedicated to connection from SAPUI5 application, second from indexing agent to SAP HANA XS server.

User roles

User role	Description
dvd.filesearch.roles::user	Used for connection from SAPUI5 application to XS server, only reading access is allowed
dvd.filesearch.roles::agent	Used for connection from File indexing agents to XS server, modification operation are allowed

If you are using multiple File indexing agent, we strongly recommend to create dedicated database user for each agent.

How to add destination to SAP Cloud

Log in into your SAP Cloud platform account.
Create database user that will be used in destination and assign role 'dvd.filesearch.roles::user'
1. Navigate to SAP HANA / SAP ASE → Databases & Schemas and chose dedicated database
2. Click on SAP HANA Web-based Development Workbench
3. Login with user with administrator rights
4. Click on Security tile
5. Right click on Users and chose New user
6. Assign role 'dvd.filesearch.roles::user' to created user
7. Set initial password
8. Save user
9. Log in with user and initial password and set production password
10. User is ready to use for destination
Create new Destination to HANA XS server
Fill in all necessary connection details
1. As authentication chose BasicAuthentication
  1. Use user and password that you created at beginning of this step list
2. add additional parameters:
  Parameter Value
  odata_xs /dvd/filesearch/
Check created Destination

Parameter	Value
odata_xs	/dvd/filesearch/

How to import and setup SAPUI5 application to SAP Cloud platform

Log in into your SAP Cloud platform account.
Open SAP Web IDE
Services → SAP Web IDE
Import file into SAP Web IDE
1. Chose File → Import → From File System
2. Find zip file with application and chose path where application should be imported
3. After successful import new directory should be added into your SAP Web IDE
Deploy application
1. Right click on root directory of imported application → Deploy → Deploy to SAP Cloud Platform
2. Now you have to options:
  1. Deploy a new application (if you are doing initial setup)
  2. Update an existing application (if you are doing update of already deployed application)
3. After successful deployment you will obtain link to application
Change default location of oData service for deployed application
1. Return back to SAP Cloud platform Cockpit and navigate to HTML5 Applications
  Applications → HTML5 Applications
2. Click on deployed application name and in application details change mapped Subaccount Destination to destination to HANA XS server setup-ed before and save
3. Now your application should be fully working from link that you gather in this step list

Browser not supported