SAP Cloud Connector
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
SAP Cloud Connector 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
SAP Cloud Connector Als eerste moet je de Java Development Kit installeren, je kunt kiezen uit Java 6 of 71 of de sapjvm2 JDK. Java versie 8 kan niet gebruikt worden voor de SCC. Als dit is gedaan kunnen we de installatie software voor de SCC downloaden3. 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/jdk7downloads-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
SAP Cloud Connector 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 Landscape Host
Inhoud hanatrial.ondemand.com
Account Name
Display Name
Account User
Password
<wachtwoord>
Location ID
HTTPS Proxy Host
De account naam van de in stap 1 gemaakte HCP gebruiker maar dan ZONDER het woord trial. Het wachtwoord van de HCP gebruiker uit stap 1.
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
Omschrijving Selecteer hier het HCP waar mee de connector zicht moet verbinden. De account naam van de in stap 1 gemaakte HCP gebruiker. Bijvoorbeeld [email protected]
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
SAP Cloud Connector
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
SAP Cloud Connector 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 uitvoeren4. 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
SAP Cloud Connector 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
SAP Cloud Connector
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 Cockpit5 en klik dan op Destinations. Klik op New Destination en vul de configuratie in. Veld Name Type Description URL
Inhoud <SAPSYSID> HTTP Gateway Systeem <SAPSYSID> http://:<poort>
Proxy Type
OnPremise
Cloud Connector Versie
2
Authentication
NoAuthentication
5
Omschrijving Sap Systeem Id Communicatie methode Omschrijving systeem Hostnaam van het eigen sap systeem, poort is de http poort van het sap systeem bijvoorbeeld 8000. Ons systeem staat bij ons niet in de cloud Versie van onze geïnstalleerde Cloud Connector. 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
https://account.hanatrial.ondemand.com/cockpit
VNSG Tips & Tricks
SAP Cloud Connector Leon Boeijen NL for Business
8
SAP Cloud Connector moet je meteen een gebruiker en wachtwoord invullen. Voeg vervolgens nog de volgende vier Additional Properties toe: Naam RDEEnabled RDESystem RDEUsage
sap-client
VNSG Tips & Tricks
Waarde Omschrijving true <SAPSYSID> Sap Systeem Id 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 voor deze connectie> Client van het systeem waar het HCP mee moet communiceren.
SAP Cloud Connector Leon Boeijen NL for Business
9
SAP Cloud Connector 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
SAP Cloud Connector
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
VNSG Tips & Tricks
Inhoud VNSG_Demo Product Lijst Products Name Price
SAP Cloud Connector Leon Boeijen NL for Business
11
SAP Cloud Connector Units Attribute Detail Section Title Detail Text Status Attribute Attribute 1 Attribute 2 Attribute 3
CurrencyCode Product Info Informatie over het product 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
SAP Cloud Connector
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 [email protected]
VNSG Tips & Tricks
SAP Cloud Connector Leon Boeijen NL for Business
13