Table of Contents
In the third blog post of this blog post series around Raspberry Pi and the SAP HANA Cloud Platform we've provided our Raspberry Pi with a Java app that can retrieve the data from the external sensor and send it to the Java app on the SAP HANA Cloud Platform we've setup in the second blog post of this series.
In this blog post we'll take care of the missing piece of our application: the user interface for the dashboard. We'll create a dashboard that can be used to monitor and keep track of the temperature sensors.
Image may be NSFW.
Clik here to view.
Setup the app as an HTML5 app
In a first step we need to create an HTML5 app in your SAP HANA Cloud Platform account. That's pretty straight forward and for those of you who are used to work with Git this will be a piece of cake.
Initialize your Git settings (for first-time-HTML5-app users)
In case you are creating an HTML5 app on the SAP HANA Cloud Platform you have to provide Git with some metadata first.
If you've already used the HTML5 apps on SAP HANA Cloud Platform you can jump to the next chapter around the creation of an HTML5 app in your account.
If you haven't done that, yet, this is what you need to do:
Task | Screenshot |
---|---|
1. Start Eclipse and open the Eclipse Preferences (Window > Preferences). Once there click on Team > Git > Configuration | Image may be NSFW. Clik here to view. ![]() |
2. Click on “Add Entry” and add as the Key the text core.autocrlf and as a Value the text false | Image may be NSFW. Clik here to view. ![]() |
3. Click again on “Add Entry” and do the same for the following entries:
| |
4. At the end of these steps your setup should look similar to the screenshot. Click on Apply and after that on OK. | Image may be NSFW. Clik here to view. ![]() |
Create the app in your account
We need to create the app first on our account so that we get a Git repository for the app. Follow these steps:
Task | Screenshot |
---|---|
1. Open your cockpit for your trial account on SAP HANA Cloud Platform via the link https://account.hanatrial.ondemand.com/cockpit and switch to the HTML5 Applications navigation tab | Image may be NSFW. Clik here to view. ![]() |
2. Click first on the button New Application… , enter the application name fishdashboard and click on the Create button. | |
3. Click on the name of the newly created app | Image may be NSFW. Clik here to view. ![]() |
4. Click on the tab Development and copy the link of the Git repository to your clipboard |
Copy the code into your app
Task | Screenshot |
---|---|
1. Start Eclipse and switch to the Git perspective | |
2. Click on Clone a Git Repository | Image may be NSFW. Clik here to view. ![]() |
3. Paste the Git-URL you've copied from your cockpit into the URI field of the popped-up window, provide your user name and password of your SAP HANA Cloud Platform trial account into the fields User and Password.
Don't forget to click on the option Store in Secure Store so you don't have to provide the credentials later on. Click on Next, click on Next again and click on Finish. | Image may be NSFW. Clik here to view. ![]() |
4. Now right-click on the Git repository and select the command Import Projects | Image may be NSFW. Clik here to view. ![]() |
5. Select Import as general project, click on Next and after that on Finish | Image may be NSFW. Clik here to view. ![]() |
6. Switch to the Web perspective in Eclipse (similar to step 1) |
|
7. Create a file called index.html. To do that right-click on the project fishdashboard and click on New and on File. After that provide the file name index.html and click on Finish. | Image may be NSFW.
|
8. Now you can copy and paste the code from the index.html file I've attached to this blog post to the newly created index.html file in your Eclipse project. Be aware that you need to unzip the index.html file first. | Image may be NSFW. Clik here to view. ![]() |
9. Save the index.html file | Image may be NSFW. Clik here to view. ![]() |
10. Repeat the steps 7 - 10 for a file called neo-app.json. | Image may be NSFW. Clik here to view. ![]() |
12. Right-click on your Eclipse project fishdashboard and select Team and Commit. | Image may be NSFW. Clik here to view. ![]() |
13. Provide a short commit message, select all files and click on Commit and Push | Image may be NSFW. Clik here to view. ![]() |
15. As a result you should get a message as response with a done message at the end. In case you get something different, something went wrong. Press OK to finish the commit and push. | Image may be NSFW. Clik here to view. ![]() |
With this last step you already have the code of your app in your HTML5 app on your SAP HANA Cloud Platform account. There are now only a few steps missing to have everything up-and-running.
Setup the destination
The last step that is missing is the setup of a destination that the app needs to use. This is necessary due to the Same-Origin-Policy of browsers which don't let you call a resource in your Javascript-code that is outside of the domain space of your app.
Task | Screenshot |
---|---|
1. Now switch back to your cockpit for your trial account on SAP HANA Cloud Platform and click on your HTML5 app fishdashboard. You should see your commit message above the initial commit. As the neo-app.json file needs a destination you’ll notice that there is a message under the Referecenced Destinations… block telling you that a destination is missing. This is the next task we need to accomplish. | Image may be NSFW. Clik here to view. ![]() |
2. Switch to account level on your cockpit and click on the Destinations tab | Image may be NSFW. Clik here to view. ![]() |
3. Click on New Destination and provide the details for the destination.
Name: fishimportsensordata Type: HTTP Description: Fish import sensor data URL: https://fishimport<your user account ID>.hana.ondemand.com/iotscenario1/ Proxy Type: Internet Cloud Connector Version: 2 Authentication: NoAuthentication
At the end click on Save | Image may be NSFW. Clik here to view. ![]() |
4. Select again the tab HTML5 Applications, click on your HTML5 app fishdashboard and click on the Development tab.
As a result you should see now your new destination listed in your Destinations tab. | Image may be NSFW. Clik here to view. ![]() |
7. Now click on the link of the commit message you've created and a new tab will be opened in your browser. You should see the app up-and-running and displaying the temperature values in a nice SAPUI5 app. | Image may be NSFW. Clik here to view. ![]() |
But the link you’ve clicked on is only accessible to you as the developer of the application. If you want to make it accessible to others we need to version our commit and activate the version.
Create your first version
What you need to do next is to go back to your HTML5 app in the cockpit. At the very right of your commit you'll find an icon in the column Create Version. Click on that icon, provide a name like 1.0 and click on Add.
Start the dashboard
The last thing you need to do now is to switch to the tab Version Management and click on the symbol in the Activate column for the version you've created in the previous step. A popup will show-up and after confirming with clicking on Yes that you want to start the application you can access the app by clicking on the link under Application URL.
Image may be NSFW.
Clik here to view.
Now you can share that link with others and even try out how the app looks like on your smartphone or other devices.
Click on one of the tiles of the app and if you have followed the steps of the first, second and third blog post you can see the chart showing you the last 10 stored temperature values of a sensor that you've connected to the RaspberryPi.
Image may be NSFW.
Clik here to view.
What comes next?
Image may be NSFW.
Clik here to view.
We have now our app up-and-running. In the next blog posts will tweak a bit here and there and we'll look into other aspects of IoT around the SAP HANA Cloud Platform. Stay tuned.
Best,
Rui