Around the last days of 2011 I started looking into SAPUI5 and really liked this great piece of SAP software. After I showed a small tool I've written in SAPUI5 to a colleague that I was running on my local Tomcat installation he asked me "Why don't you deploy it on Neo?". I was not really convinced if I was already be prepared for another challenge, but I gave it a try. I've installed the necessary plugins in Eclipse and you know what happened when I right-clicked on the newly added SAP NetWeaver Neo server in my Eclipse environment? It worked!!! This was the moment I knew I'd like to learn more about Neo and SAPUI5.
After working for some time with these cool SAP technologies I decided to start a blog series around my experience with Neo and SAPUI5. I'll provide some lessons learned and will show you some code snippets that you can re-use, too. This first blog is pretty basic, but in this series I'd like to cover all kind of aspects you probably will go through, too, in case you are planning to develop (or already are developing) a complete application using the Neo persistence and security layers.
I don't claim to give you THE best answer to all issues, but rather what I found worked best for me. So in case you find a better way to do the same thing, please don't hesitate and add your feedback as a comment to the blog.
I'm also not working in the SAPUI5 team so what you read in my blogs might not be 100% accurate or precisely described. But whenever I describe something in my blogs I've tested it in my environment successfully so you shouldn't get things that don't work (hopefully) ;-).
As I'm using a MacBook Pro at work and use an iMac at home you can follow my blogs best if you have a Mac computer. But most of the differences are only relevant when you setup your Eclipse environment. Once all is setup you should be able to follow this blog series also with your Windows PC.
But enough introduction. Let's start with the beginning :-)
My System Landscape
As I wrote above I'm using a MacBook Pro with 8GB RAM, an 2GHz Intel Core i7 Processor with Mac OS X Lion 10.7.3. And I'm working behind a network firewall.
I got my Eclipse environment directly from the Eclipse webpage. As I have a Mac I took one of the possible downloads for Mac OS X. At that point in time I've installed "Eclipse Java EE IDE for Web Developers, Version: Indigo Service Release 1, Build id: 20110916-0149".
Set proxy settings right (in case you work behind a firewall)
After installing Eclipse I first changed the proxy settings in my Eclipse as I work behind a firewall. Go to Eclipse "Preferences" and in the search field of the Preferences window type in "proxy". In case you work behind a firewall, too, set the settings as they fit to your network environment.
Install/setup Neo in Eclipse
To be able to follow these blogs you either need to be part of the SAP NetWeaver Neo Beta Programm or have a valid license for SAP NetWeaver Neo once it'll be globally available. In both cases you should already have a very good documentation how to install Neo on your machine for local testing and for deploying it to your Neo instance.
By then you should see two new entries in the "Server" tab. One for local testing and another one for deploying it to your Neo instance.
Get SAPUI5 and deploy on your local Neo instance
Go to the SAPUI5 webpage in the SAP Developer Center and the Download Trial for UI Development Toolkit for HTML5. Unzip the file and import e.g. the getting-started-sample.war file.
Go to "File", "Import", "War file", click on "Next", select the getting-started-sample.war file that you should have at the place where you unzipped the SAPUI5 zip file from SCN.
After selecting the target runtime "SAP NetWeaver Neo" you click on "Finish" and can now deploy the getting started app to your local machine.
To do so click on the local Neo server, right-click on it and select the "Add and Remove" command. Click on the "getting-started-sample" under the "Available" section and click on the "Add" button. Once "getting-started-sample" appears on the "Configured" section you click on "Finish". Now you right click on your local Neo instance in the "Servers" tab and click on "Publish".
If everything worked out fine you should now see under http://localhost:8080/getting-started-sample/ the getting started sample app (in case you are using another port, the link looks different).
That's all for now. Try out yourself and I'll provide you in my next blog post of this series with more.