HANA XS Web Service

Copyright © Blackvard Management Consulting – All rights reserved www.blackvard.com

Internet of Things Using SAP HANA

Lesson Three: HANA XS Web Service

http://www.blackvard.com/

Course Overview


Release Date: March 18, 2016

Release Date:March 31, 2016

Coming Soon… Coming Soon…

Now Available!

Internet of Things Using SAP HANALesson Three: HANA XS Web Service

Learn More @ http://www.blackvard.com/iot-overview/

Release Date:April 14, 2016

Lesson One

•Introduction To Internet of Things

Lesson Two

•XS Trial Application Prerequisites & Setup

Lesson Three

•HANA XS Web Service

Lesson Four

•Consuming Data With HANA XS

Lesson Five

•Sample Application


http://www.blackvard.com/iot-overview/


Agenda

What Will Be Covered:

1. Database Setup/Database Connection/HANA XS Web-Service Connection

1. Creating & Connecting an SAP HANA Trial Instance

2. Creating an SAP HANA Subpackage & Repository Workspace

3. Creating an XS Project

4. Creating the Application Descriptors & Role

5. Creating an XS Destination File/Creating an XSJS File/Granting a User Role

6. Testing Your Application

2. About Us


Creating an SAP HANA Trial Instance (1/4)

Now let’s begin with your next lesson by creating an SAP HANA Trial instance in the SAP HANA Cloud Platform Cockpit

From the main SAP HANA Cloud Platform Cockpit, select Databases & Schemas.




All available account databases will be listed along w/ ID, Type, Database System, & Database Version (none are currently available below for this trial).

To view database details (state & existing bindings) select a database list & click the link name. Database overviews allow you to perform actions such as database deletion, etc.

To create a new trial instance, simply click the New button.




The New Database/Schema pop-up screen is displayed. Enter the Schema ID.

Can be freely defined, but must begin w/ a letter and contain only uppercase & lowercase letters such as a “z” or “Z”, numbers 0 – 9, & only the special characters of “.” and “-”.

For this example, use Schema ID: zhanaxs. Select an available Database System from the drop-down box & click Save.

For this example, use Database System: HANA XS (<shared>).




The new zhanaxs schema has been successfully created.



Connecting an SAP HANA Trial Instance (1/5)

Return to the Eclipse IDE, to connect directly to the shared SAP HANA schema, using SAP HANA Tools.

In Eclipse, navigate to Window - > Show View - > Other….




In the Show View pop-up, open the SAP HANA folder, and select Systems. Click the OK button.




After clicking OK, you will see the Systems view in the main Eclipse IDE. From the Systems menu bar, in the bottom right-hand portion of the screen,

select the Add System icon and then select the Add Cloud System… option.




Modify your Landscape host information (if required). You can learn more about landscape hosts here:

https://help.hana.ondemand.com/help/frameset.htm?350356d1dc314d3199dca15bd2ab9b0e.html

Enter the Account name, User name, Password, and click Next. The system will fetch SAP HANA Schemas and Databases for you.

For more information about your account visit: https://help.hana.ondemand.com/help/frameset.htm?8ed4a705efa0431b910056c0acdbf377.html





https://help.hana.ondemand.com/help/frameset.htm?8ed4a705efa0431b910056c0acdbf377.html

https://help.hana.ondemand.com/help/frameset.htm?8ed4a705efa0431b910056c0acdbf377.html



In the SAP HANA Schemas and Databases window, choose the Schemas radio button (if it is not already selected by default).

From the Schemas drop-down menu, select the desired zhanaxs schema. Click Finish.



Creating an SAP HANA Subpackage (1/4)

Eclipse is now connected to your SAP HANA Cloud Platform zhanaxs schema. Proceed to the SAP HANA Development perspective. If not already in this perspective, click the Open Perspectives icon seen

below, then select SAP HANA Development & click OK.




In the Systems view, open your project. Open the Content folder, then open the package (e.g. p1941908884trial). Right-click on zhanaxs, then follow menu path: New - > Package….




The New Package dialog box appears. In both the Name and Description fields, add the new subpackage name

connectivity to the end of the full package path as seen below. Choose OK to confirm.




The new subpackage connectivity is added to the package hierarchy below the zhanaxs package.



Creating a HANA Repository Workspace (1/3)

Now create a Repository Workspace. Navigate to the Repositories view. Click the Create Repository Workspace icon.




Select your SAP HANA system from the displayed SAP HANA Systems list. If your system is not listed, click the Add System… button and add it to the list. If you have more than one system, ensure the correct system is selected.

Enter Workspace Name zhanaxs (the same name as the root package name). In the Workspace Root field, browse and select the desired folder that will

contain the workspace you are creating. Click Finish.




The workspace now appears in the Repositories view, and a folder has been added to your local system (e.g. C:\Users\Erin\hana_work), which will contain all your development files.



Creating an XS Project (1/7)

Return to the Project Explorer view. In the Project Explorer view, choose File - > New - > XS Project.




The New XS Project dialog box appears. Enter connectivity as the Project name, and click the Next button.

For this tutorial, keep all default settings as-is.




Select the Repository Workspace you created (eg. zhanaxs). In the Repository Package field, choose the Browse… option.




Navigate to the subpackage (e.g. p1941908884trial.zhanaxs.connectivity). Double-click it, or click OK.




The package now appears in the Repository Package field. Click Next.




In the New XS Project dialog box, de-select the default XS Application Access (.xsaccess) and XS Application Descriptor (.xsapp) Access Objects.

Click Finish.




The new project (e.g. connectivity) now appears in the Project Explorer view.



Creating The Application Descriptors (1/9)

Now create the Application Descriptor file. In the Project Explorer view, select the project (e.g. connectivity), right-click it. Choose New - > File.




In the File name field, insert .xsapp, and click Finish.




After entry, save it by clicking the Save icon, or select Ctrl + S. Activate it by clicking the green Activate SAP HANA Development Object icon.




Now create the Application Access file. In the Project Explorer view, select the project, and right-click it. Select New - > File.




Enter the File name as .xsaccess, and click Finish.




For the .xsaccess file, insert the coding seen below. After entry, save it by clicking the Save icon, or select Ctrl + S. Activate it by clicking the green Activate SAP HANA Development Object icon.

Enhanced Coding View:




Now create the Application Privileges file. In the Project Explorer view, select the project, and right-click it. Choose New - > File.




Enter the File name as .xsprivileges, and choose Finish.




Insert the coding seen below and click the Save icon. Then click the Activate SAP HANA Development Object icon.




Creating The Application Role (1/3)

Now create the Role. In the Project Explorer view, select the project, and right-click it. Choose New - > File.




Enter the File name as model_access.hdbrole, and select Finish.




Insert the coding below & replace <package name> with the package name where the project is shared.

Please note that the brackets “<>” are only placeholders and should be deleted. For this tutorial, the code should appear similar to p1941908884trial.zhanaxs.connectivity.

Save the file, then click the Activate SAP HANA Development Object icon.




Creating an XS Destination File (1/3)

Now create the XS Destination file. In the Project Explorer view, select the project, and right-click it. Follow the menu path New - > File.




Enter the File name as google.xshttpdest, and click Finish.




Insert the below destination configuration settings, then click the Save icon. Click the Activate SAP HANA Development Object icon.




Creating an XSJS File (1/4)

Now create the XSJS file. In the Project Explorer view, select the project, and right-click it. Follow menu path New - > File.




Enter the File name as google_test.xsjs, and click Finish.




Insert the XSJS JavaScript coding below, then click the Save icon. Click the Activate SAP HANA Development Object icon. Note: A larger view of the full JavaScript coding can be seen on the next slide.




An enhanced visual of the full XSJS JavaScript coding can be seen below:



Granting a Role To The User (1/4)

Now Grant a Role to the user. Return to the Systems view. Select your system & right-click it, then select Open SQL Console.




The SQL Console opens.




In the SQL Console, enter the coding below:

Replace <SAP HANA Cloud user> w/ your user ID, & replace the sample trial instance w/ your own trial information as depicted below:

Right-click on the coding, & select Execute to execute the procedure.




A confirmation message that the statement was successfully executed will appear.



Testing Your Application (1/8)

Now test the application. Return to the SAP HANA Cloud Platform Cockpit. Navigate to HANA XS Applications.




The new HANA XS Application will now display in your SAP HANA Cloud Platform Cockpit.

In the HANA XS Applications table, click the application URL link to launch the application.




Since SAP HANA Cloud Cockpit only displays the root of an application’s URL path, a possible 404 (Not found) error may appear after clicking the new application’s URL.

To resolve this issue, the following steps may be required: Add the application name to the URL address in the internet browser (hello.xsjs). Create an index.html file, which is the default setting for the file displayed when the

package is accessed without specifying a file name in the URL. Override the above default setting by specifying the default_file keyword in the .xsaccess

file. For example:




To correct the 404 error (if required), return to the Repositories view in Eclipse.

Navigate to the connectivity subpackage, and right-click it. Select New - > Other….




In the Wizard, open the Web folder, then select HTML File. Click Next.




Give the New HTML File the File name: index.html. Click Finish.




The below index.html file coding will appear. Change the Insert title here text to: Hello, World! Change the character set from “ISO-8859-1“ to “UTF-8” as seen below. Click the Save icon to save it. Then click the Activate SAP HANA Development Object icon to activate it.




Return to the 404 error page, and add index.html to the end of the URL below: https://s12hanaxs.hanatrial.ondemand.com/p1941908884trial/zhanaxs/connectivity/

Now use the new URL to test your application, as seen here: https://s12hanaxs.hanatrial.ondemand.com/p1941908884trial/zhanaxs/connectivity/index.html

Your Hello, World! HANA XS Trial Application is now connected & displayed.


https://s12hanaxs.hanatrial.ondemand.com/p1941908884trial/zhanaxs/connectivity/

https://s12hanaxs.hanatrial.ondemand.com/p1941908884trial/zhanaxs/connectivity/

https://s12hanaxs.hanatrial.ondemand.com/p1941908884trial/zhanaxs/connectivity/index.html


Success – You Completed The Lesson!

10/10Copyright © Blackvard Management Consulting – All rights reserved www.blackvard.com

Congratulations, you completed the lesson!

In this lesson you successfully: – Created & Connected an SAP HANA Trial Instance– Created an SAP HANA Subpackage & Repository Workspace– Created an XS Project– Created Application Descriptors and Role– Created an XS Destination File, XSJS File & Granted a User Role– Tested Your Application



Want to learn more about connecting your devices?

Contact us today for your FREE consultation with our experts.

Email: [email protected]

Require A Consultation?




Technical project leads and ABAP architects responsible for quality in technical scope and budget in global roll-outs of SAP Logistics applications (SAP LE / LO)

Conducted multiple SAP ABAP, SAP HANA®, and SAP Fiori® trainings for various US companies

Implementation of a standard SAP software solution for Spend Management within SAP AG & ARIBA (annual spend volume 3 Bill. EUR) which can be used in all SAP systems

Improved claims management using SAP FS-CM which is generating annual savings of 15 Mio € for a huge German public healthcare organization

Implemented a global solution for procurement processes at BMW AG using SAP SRM / B2B

Blueprinting and implementation of SAP software for banking credit cancelations for VOLKSWAGEN

Key Achievements of Blackvard Management Consulting in Previous Projects

What We’ve Accomplished


Blackvard Management Consultants

www.blackvard.comCopyright © Blackvard Management Consulting – All rights reserved

Short Bio:

Lukas M. Dietzsch is managing director at Blackvard Management Consulting, LLC. He is holding a Master’s degree in Information Technology and is an experienced IT solution architect and project lead.

His strong background in adapting to requirements and standards in different industries and on various platforms are valuable assets for Blackvard customers.

He is repeatedly commended by customers for driving efficient solutions for complex problems in globally distributed team environments and meeting tough deadlines.

For further information please visit:

www.blackvard.com

Lukas M. Dietzsch

[email protected]

Copyright © Blackvard Management Consulting- All rights reserved www.blackvard.com

Managing Director





An overview of current and previous customers:

Customers That Recommend Blackvard
