Anleitung zur Integration der /data.mill API in SAP Java Applikationen

Transkript

1 Anleitung zur Integration der /data.mill API in SAP Java Applikationen Inhalt 1. Anlage einer HTTP Destination Anmelden an SAP Cloud Platform Destination Konfiguration Eintragen der BasicAuth Zugangsdaten 3 2. Einrichtung von Eclipse als Java IDE 3 3. Einrichtung Beispiel Projekt in Eclipse Download des Beispiel-Projekts Import des Projekts Kontrolle des Servlets (Optional) 5 4. Veröffentlichen der Java-Applikation 5 5. Testen der Java Applikation 6 6. Ressourcen 7 1. Anlage einer HTTP Destination Für die Java Applikation benötigt man zur Kommunikation nach außen, von der SAP Cloud Platform gesehen, sogenannte Destinations (siehe SAP Dokumentation zu http Destinations unter US/b068356dd7c34cf7ad6b6023deeb317d.html) Mit Hilfe dieser Destinations werden API Endpunkte von OnPremise Systeme sowie APIs im Internet innerhalb der SAP Cloud Platform definiert sowie die benötigten Zugangsdaten sicher hinterlegt Anmelden an SAP Cloud Platform Diese Destination kann im SAP Cloud Cockpit importiert werden. Dazu meldet man sich an der SAP Cloud Platform an unter: Falls man in der Übersichtsseite startet muss man den gewünschten Account auswählen /7

2 Im Cockpit wählt am in der Menüleiste Connectivity Destinations /7

3 1.2. Destination Konfiguration Im Folgenden gibt es zwei Möglichkeiten (manuell oder via File-Import) die /data.mill API Destination zu erstellen. Danach müssen die folgenden Werte für die Destination eingetragen werden. Feld Beschreibung Wert Name Der Name für diese Destination datamill_api Type Der Typ der Destination HTTP Description Eine Beschreibung für die Destination /data.mill API URL Der API Host für diese Destination api.methis.at Proxy Type Bestimmt ob Internet API oder On-Premise System Internet Authentication Die Authentifizierungmethode welche wir verwenden wollen BasicAuthentication 1.3. Eintragen der BasicAuth Zugangsdaten Da wir in der Destination die Zugangsdaten für die API hinterlegen können, müssen diese im API-Request nicht mehr angegeben werden. User: Der BasicAuth Benutzer. Tragen Sie hier bitte Ihre License für die /data.mill API ein. Password: Das BasicAuth Passwort: Tragen Sie hier bitte Ihre GUID für die /data.mill API ein. 2. Einrichtung von Eclipse als Java IDE Für die Erstellung der Java Applikation wird Eclipse als IDE verwendet. Für die Installation und Einrichtung der Umgebung für die Entwicklung von Java Applikationen für die SAP Cloud Platform wir hier auf die umfangreichen Anleitungen von SAP verwiesen. Setup Eclipse IDE: Setup basic Java application and deployment: 3. Einrichtung Beispiel Projekt in Eclipse Für unser Beispiel verwenden wir ein vorbereitetes Java Projekt welches unter folgendem Link zur Verfügung gestellt wird Download des Beispiel-Projekts Bitte laden Sie die folgende Datei herunter und entpacken Sie diese in einem eigenen Ordner /7

4 3.2. Import des Projekts Das heruntergeladene Projekt wird nun in Eclipse importiert. Dazu Klicken wir auf File Import Im Import-Fenster wählen wir Archive File und bestätigen mit Next. Im folgenden Fenster klicken wir auf Browse unter Select archive file: und wählen das heruntergeladene ZIP-Archiv aus. Mit einem Klick auf Finish beenden wir den Import /7

5 3.3. Kontrolle des Servlets (Optional) Im nun importierten Projekt öffnen wir die Servlet-Datei unter folgendem Pfad: Projekt > Java Resources > src > com.sap.cloud.sample.connectivity > ConnectivityServlet.java Wie man am Packet-Namen erkennen kann stammt die Basis des Codes aus den Beispielen von SAP. Die folgenden Links führen zur offiziellen SAP Dokumentation auf denen dieses Projekt basiert. Consume Internet Services (Java Web or Java EE 6 Web Profile) US/e592cf6cbb d3c28507d20f1b.html Consume Internet Services (Java Web Tomcat 7) US/22123f544cb b4a1bd8e234c4.html 4. Veröffentlichen der Java-Applikation Um das Projekt testen zu können kann die Java-Applikation in der SAP Cloud Platform gestartet werden. Dies geschieht über einen Rechtsklick auf den Projektordner Run As Run on Server. Wenn der SAP Cloud Platform Server noch nicht eingebunden wurde kann dieser hinzugefügt werden über Manually define a new server SAP SAP Cloud Platform. Als Region host verwenden wir hana.ondemand.com für den Live Account oder für einen Trial Account hanatrial.ondemand.com. Wir können noch den Servernamen definieren und mit Next fortfahren /7

6 Im nächsten Fenster müssen die SAP Cloud Platform Zugangsdaten eingegeben werden und mit Finish kann die Einrichtung abgeschlossen werden. Hinweis: Der Account-Name kann auch der SAP Cloud Cockpit URL entnommen werden. Der Benutzername entspricht den Zugangsdaten des Benutzers für das SAP Cloud Cockpit. Der Java Server fährt nun in der SAP Cloud Platform hoch, dieser Prozess kann einige Zeit in Anspruch nehmen. 5. Testen der Java Applikation Auf der Applikationsseite im SAP Cloud Cockpit Applications Java Application klicken wir auf den Link unserer Applikation um auf die Detailseite zu gelangen., der "Application URL". Diese URL stellt unsere Java-Applikation dar, welche wir zuvor hochgeladen und gestartet haben und alle Requests weiterleitet an die konfigurierte Destination. Im Browserfenster wird uns die Antwort des Endpoints der Destination dargestellt: /7

7 Rufen wir zum Beispiel die folgende Route für die Adresssuche (/address/search) der /data.mill API auf erhalten wir das gewünschte Ergebnis. Wichtig ist hierbei die API entsprechend der Dokumentation mit der HTTP Methode POST und dem gesetzten Parameter "address" aufzurufen (siehe Für die genaue /data.mill API Beschreibung sehen Sie bitte in die offiziellen Dokumentation unter 6. Ressourcen Projekt Destination /7