De SAP Cloud Connector 2.0 maakt SAPUI5 ontwikkeling via de WEB-IDE mogelijk met data uit je eigen backend systeem. Vele van ons willen wel eens spelen met de WEB-IDE in de could via het SAP Trial Hana Cloud Platform (account.hanatrial.ondemand.com). Maar we zouden het fijn vinden als we data uit ons eigen systeem kunnen gebruiken. Hiervoor is de SAP Cloud Connector 2.0, hiermee kun je je eigen ABAP/Gateway systeem beschikbaar maken voor de WEB-IDE zonder dat je hiervoor je eigen systeem beschikbaar hoeft te maken voor de buitenwereld. Deze tip gaat over het installeren en configuren van de SAP Cloud Connector 2.0. De SAP Cloud Connector. De SAP Cloud Connector ook wel SCC genoemd zorgt ervoor dat je eigen SAP systeem beschikbaar komt voor het SAP Hana Cloud Platform (HCP). De SCC moet worden geïnstalleerd op een pc / server die bij je SAP systeem kan. Dus een PC in je eigen landschap. Als de SCC is geïnstalleerd en geconfigureerd maakt de SCC een beveiligde connectie naar het Hana Cloud Platform waar door deze weet dat er een SCC is verbonden en via deze weg kan het HCP bij je eigen SAP systeem. VNSG Tips & Tricks SAP Cloud Connector Leon Boeijen NL for Business 1
In dit document gaan we kijken hoe we de SCC moeten installeren, configureren en laatste gaan we een eenvoudig SAPUI5 applicatie maken op het HCP via de WEB-IDE de gebruik gaat maken van data uit ons eigen SAP Gateway systeem. Stap 1 Maak een test account aan. Ga naar de website https://account.hanatrial.ondemand.com en registreer je daar. Je kunt hiervoor een email adres gebruiken of je eigen S-nummer. Als je dit hebt gedaan wordt je automatisch naar de HCP Cockpit gestuurd. Hier kun je links onder de link vinden naar je Account informatie. Ga daar naartoe en schrijf je Account naam op: p1569599130trial. Je kunt hier ook je Display naam omzetten van je account nummer naar bijvoorbeeld je eigen naam. Het account naam heb je dadelijk nodig om de SCC te configureren. Stap 2 De installatie van de SAP Cloud Connector. De SCC 2.0 is er alleen voor 64 bit operating systemen en is beschikbaar voor zowel Microsoft Windows, Linux en Mac os X. Deze tip gaat uit van een Windows systeem, maar de procedure is voor de andere systemen hetzelfde. VNSG Tips & Tricks SAP Cloud Connector Leon Boeijen NL for Business 2
Als eerste moet je de Java Development Kit installeren, je kunt kiezen uit Java 6 of 7 1 of de sapjvm 2 JDK. Java versie 8 kan niet gebruikt worden voor de SCC. Als dit is gedaan kunnen we de installatie software voor de SCC downloaden 3. Er zijn twee versies beschikbaar een gewone Productie versie en een Developer versie. Het verschil is dat de Developer versie niet als een service geïnstalleerd worden en dus niet automatisch zal starten. In dat geval moet je elke keer handmatig het go.bat starten om de SCC te activeren. Start de installatie software, sapcc-2.6.0-windows-x64.msi, en volg de instructies. Geef aan waar je de SCC wilt installeren, bijvoorbeeld C:\SAP\scc20\. Geef aan welke poort je wilt gebruiken voor de configuratie van de SCC, bijvoorbeeld 8443. Geef aan of je wilt hebben dat de SCC wordt gestart als de installatie klaar is, Ja graag. Als de installatie klaar is zijn er twee nieuwe icoontjes op je desktop te vinden. Start SAP HANA Cloud Connector 2.0 en Stop SAP HANA Cloud Connector 2.0. Als je de SCC op een windows 7 of windows 8 systeem hebt geïnstalleerd dan moet je deze twee icoontjes altijd uitvoeren als Administrator. Je hebt anders namelijk niet de rechten om de SCC te starten of te stoppen. Als je vervolgens gaat kijken bij je Services dan zul je zien dat daar ook een nieuwe regel is toegevoegd. Je kunt er dan ook voor kiezen dat de SCC automatisch gestart wordt, standaard wordt de service niet automatisch gestart. Stap 3 Configureren van de SAP Cloud Connector. Op het systeem waar je de SCC hebt geïnstalleerd moet je nu een browser starten en ga vervolgens naar het adres: https://localhost:8443. Je moet hier dus het poort nummer invullen dat je tijdens de installatie hebt gekozen. Bij de meeste browsers krijg je dan een fout melding omdat het certificaat niet juist is. Het certificaat is namelijk self-signed. 1 Java JDK 7 kun je hier downloaden: http://www.oracle.com/technetwork/java/javase/downloads/jdk7- downloads-1880260.html 2 De sapjvm JDK kun je hier downloaden: https://tools.hana.ondemand.com/#cloud 3 De SCC installatie files kun je hier downlaoden: https://tools.hana.ondemand.com/#cloud VNSG Tips & Tricks SAP Cloud Connector Leon Boeijen NL for Business 3
Je behoort nu het inlog scherm van de SCC te krijgen. De standaard gebruiker en wachtwoord is: Administrator / manage Geef vervolgens aan of het om een Master of Shadow installatie gaat. Standaard kies je hier voor de Master installatie. Vervolgens moet je het standaard wachtwoord wijzigen. Onthoud je wachtwoord. We komen nu in het scherm Set Up Initial Configuration. Deze gaan we invullen met de volgende gegevens: Veld Inhoud Omschrijving Landscape Host hanatrial.ondemand.com Selecteer hier het HCP waar mee de connector zicht moet verbinden. Account Name <HCP account naam inclusief De account naam van de in stap Display Name het woord trial> <naam die zichtbaar zal zijn in plaats van het account nummer> 1 gemaakte HCP gebruiker. Bijvoorbeeld leon.boeijen@nl4b.nl Account User <HCP account naam ZONDER het woord trial> De account naam van de in stap 1 gemaakte HCP gebruiker maar dan ZONDER het woord trial. Password <wachtwoord> Het wachtwoord van de HCP Location ID <naam van het systeem waarop de SCC is geïnstalleerd> gebruiker uit stap 1. HTTPS Proxy Host Alleen nodig als het systeem waarop de SCC is geïnstalleerd alleen via een proxy naar het internet kan. HTTPS Proxy Port HTTPS Proxy User HTTPS Proxy Password Connector Info Description <naam van het systeem waarop de SCC is geïnstalleerd> Als je een fout melding krijgt als je op Apply klikt, kijk dan goed naar je Account Name, Account User en Password en probeer het nog een keer. VNSG Tips & Tricks SAP Cloud Connector Leon Boeijen NL for Business 4
Je komt nu in het SCC Administration scherm. De connector state zal nu nog geel zijn. Dit komt omdat we nog niet klaar zijn met de configuratie. VNSG Tips & Tricks SAP Cloud Connector Leon Boeijen NL for Business 5
Stap 4 Configureren van de connectie naar ons SAP Systeem. We gaan nu de informatie opgeven voor de connectie naar ons SAP systeem. Klik op Access Control aan de linkerkant van het scherm en kies vervolgens Add Je krijgt dan een popup waarin je aangeeft wat voor soort Backend systeem ons SAP systeem is. Voor het werken met OData kiezen wij voor SAP Gateway. Dan kiezen we daarna voor HTTP, dit is de manier waarop de SCC communiceert met het SAP systeem. Als je voor HTTPS kiest moet je meer stappen uitvoeren 4. Hierna moeten we de hostnaam van ons SAP systeem invullen en de http poort. De http poort van je sap systeem kun je vinden via transactie SMICM en dan Shift-F1. Vaak is dat 8000. Voor de volgende vraag: Optionally enter virtual names, kun je de waarde overnemen die het systeem voorstelt. Als laatste kun je ervoor kiezen om de beschikbaarheid van je sap systeem te checken. 4 Kijk hiervoor in de help: https://help.hana.ondemand.com/help/frameset.htm?e6c7616abb5710148cfcf3e75d96d596.html VNSG Tips & Tricks SAP Cloud Connector Leon Boeijen NL for Business 6
Je ziet dat de Status nog niet groen is. We moeten namelijk nog aangeven welke paden we mogen aanroepen vanuit de SCC naar het backend systeem. Selecteer de zojuist gemaakte regel. Op het volgende scherm dat nu zichtbaar wordt klikken we op Add.. We krijgen nu een popup waarin we kunnen aangeven welke http paden de SCC mag aanroepen op ons SAP systeem. Je kunt dit dus volledig beperken tot alleen die paden die je wilt vrijgeven. Voor ons voorbeeld maken we het eenvoudig en vullen we de root in: / en we kiezen om alle sub paden mee te nemen. Onze SCC kan nu connectie maken met ons SAP systeem. Je kunt nu een controle doen of je SCC echt wel bij je SAP systeem kan komen. Selecteer de regel en klik dan op Check. De SCC zal dan controleren of hij het SAP systeem kan bereiken. Zorg er dus voor dat het systeem waarop de SCC is geïnstalleerd ook daadwerkelijk bij het sap systeem kan. Dit kun je eenvoudig testen door in een browser op het systeem waar de SCC is geïnstalleerd de zelfde URL in te typen als die je hebt opgegeven bij de Internal Host. Mocht de check niet juist zijn, bekijk dan het log. Controleer bijvoorbeeld de firewall settings. Klik nu op Account Dashboard en je zult zien dat onze gemaakte connectie actief is. VNSG Tips & Tricks SAP Cloud Connector Leon Boeijen NL for Business 7
Je kunt hier kiezen om nog meer HCP accounts toe te voegen, bijvoorbeeld die van je collega. Klik dan op Add en herhaal de stappen 3 en 4 die zojuist zijn uitgevoerd. De installatie en configuratie van de SAP Cloud Connector is nu klaar. We gaan nu weer naar het Hana Trial Cloud Platform om de laatste stappen te doen zodat we ons systeem kunnen gebruiken in bijvoorbeeld een SAPUI5 Applicatie. Stap 5 Het aanmaken van een Destination in HCP. Om vanuit HCP gebruikt te kunnen maken van je eigen SAP systeem moet je een Destination maken. Ga naar de HCP Cockpit 5 en klik dan op Destinations. Klik op New Destination en vul de configuratie in. Veld Inhoud Omschrijving Name <SAPSYSID> Sap Systeem Id Type HTTP Communicatie methode Description Gateway Systeem <SAPSYSID> Omschrijving systeem URL http://<host>:<poort> Hostnaam van het eigen sap systeem, poort is de http poort van het sap systeem bijvoorbeeld 8000. Proxy Type OnPremise Ons systeem staat bij ons niet in de cloud Cloud Connector Versie 2 Versie van onze geïnstalleerde Cloud Connector. Authentication NoAuthentication Hier kun je aangeven hoe de Cloud Connector zich moet identificeren naar het SAP systeem. Kies je voor NoAuthentication dan moet de gebruiker bij het starten van de Cloud applicatie zelf zijn gebuiker en wachtwoord invullen als er een connectie nodig is. Je kunt ook kiezen voor BasicAuthentication dan 5 https://account.hanatrial.ondemand.com/cockpit VNSG Tips & Tricks SAP Cloud Connector Leon Boeijen NL for Business 8
Voeg vervolgens nog de volgende vier Additional Properties toe: moet je meteen een gebruiker en wachtwoord invullen. Naam Waarde Omschrijving RDEEnabled true RDESystem <SAPSYSID> Sap Systeem Id RDEUsage odata_abap,dev_abap,ui5_execute_abap odata_abap voor de OData Gateway, dev_abap voor het uitbreiden en deployen van SAPUI5 scenarios naar het ABAP systeem, ui5_execute_abap voor het kunnen starten van SAPUI5 applicaties vanaf het ABAP systeem. sap-client <sap client voor deze connectie> Client van het systeem waar het HCP mee moet communiceren. VNSG Tips & Tricks SAP Cloud Connector Leon Boeijen NL for Business 9
Het SAP Hana Cloud Platform heeft nu ook een destination en is dus klaar om gebuikt te worden. We kunnen nu onze SAPUI5 applicatie gaan maken via de WEB-IDE en de gegevens uit ons eigen SAP systeem gebruiken. Stap 6 Starten van de WEB-IDE. In de HCP Cockpit klikken we nu op Subscriptions. Hier staat standaard al de webide ingevuld. Is dit niet het geval dan kun je via de button New Subscription de webide toevoegen. Klik vervolgens op de klin webide in de kolom Application, je komt dan in je webide HTML5 Subscription scherm waar je de link ziet naar je WEB-IDE. Selecteer de link en je WEB-IDE wordt gestart. VNSG Tips & Tricks SAP Cloud Connector Leon Boeijen NL for Business 10
Stap 7 Maak een simpele SAPUI5 applicatie. Selecteer File -> New -> Project from Template. Kies vervolgens de tile SAP Fiori Master Detail Application en dan NEXT. Vul je project naam in: VNSG_Demo en dan NEXT. Als alles goed is gegaan kun je nu je destination kiezen en dan uit de OData catalogus een standaard OData service selecteren. Als je hebt gekozen om geen gebruiker en wachtwoord in je Destination in te vullen dan moet je nu je ABAP gebruiker en wachtwoord ingeven zodat HCP connectie kan maken met je ABAP systeem. Selecteer de service EPM_RETAIL_SCENARIO_SRV en dan NEXT. LET OP: je ABAP Gateway systeem moet wel juist zijn ingericht en het SEGW project /IWBEP/EPM_RETAIL_SCENARIO moet wel zijn geregistreerd. Veld Project Namespace Master Section Title OData Collection Item Title Numeric Attribute Inhoud VNSG_Demo Product Lijst Products Name Price VNSG Tips & Tricks SAP Cloud Connector Leon Boeijen NL for Business 11
Units Attribute Detail Section Title Detail Text Status Attribute Attribute 1 Attribute 2 Attribute 3 CurrencyCode Product Info Informatie over het product <leeg> ProductId Category Description Klik weer NEXT en dan Finish. Je hebt nu in je WEB-IDE een project met de naam VNSG_Demo. Open de map en selecteer de index.html file. Klik vervolgens boven op de knop Run en je applicatie wordt in de Cloud gestart met data uit je eigen systeem. Ook hier geld weer dat je je gebruiker en wachtwoord moet invullen als je deze niet hebt opgeslagen in je Destination. VNSG Tips & Tricks SAP Cloud Connector Leon Boeijen NL for Business 12
Je kunt deze applicatie zelfs testen op je eigen tablet of telefoon door de QR-code rechts boven te scannen. Deze tip is aangeleverd door Leon Boeijen. Wilt u meer informatie, dan kan dat via leon.boeijen@nl4b.nl VNSG Tips & Tricks SAP Cloud Connector Leon Boeijen NL for Business 13