Oracle BI Publisher Webservice API in Action

Transkript

1 Oracle BI Publisher Webservice API in Action Marco Fischer

2 Agenda Firmenvorstellung Einführung Oracle BI Publisher Webservice API WSDL-Beispiel Security Nutzung der BI Publisher Webservices soapui APEX PL/SQL Projektbeispiel Fazit

3 Zahlen und Fakten Robotron Datenbank-Software GmbH Gründungsjahr 1990 Mitarbeiterzahl 326 (Stand 03/2014) Stammkapital Umsatz 2012 Geschäftssitz 2,4 Mio. EUR 31,1 Mio. EUR Stuttgarter Str Dresden Oracle-Partner ISO 9001 zertifiziert

4 Robotron-Firmengruppe Tschechien: Robotron Database Solutions s.r.o. Schweiz: Robotron Schweiz GmbH Österreich: Robotron Austria GmbH Russland: Robotron Rus GmbH Deutschland, mit ECG Erdgas-Consult GmbH: Robotron ECG solutions GmbH

5 Einführung Webservices: plattform-, programmiersprachen- und protokollunabhängig präzise beschrieben, modular, granular, zusammensetzbar XML-basierte Beschreibung zur Charakterisierung des Webservice (WSDL) Beschreibung Schnittstelle und Datentypen Protokoll zum Austausch XML-basierter Nachrichten (SOAP) Möglichkeit für Anwendungen, eine API zur Verfügung zu stellen Bildquelle:

6 Oracle BI Publisher Webservice API Methoden, um mit BI Publisher Berichtsobjekten zu interagieren, z.b. Berichte auszuführen, Informationen über Berichte abzufragen, Berichte zu definieren und zu ändern, Berichtstemplates hochzuladen Methoden, um BI Publisher Scheduler-Aufgaben auszuführen, z.b. Berichtsjobs zu definieren und zeitlich zu planen, Berichte abzufragen, Berichtsjobhistorie zu verwalten Methoden, um BI Publisher Katalogobjekte zu verwalten (Erstellen, Kopieren, Hochladen, Herunterladen und Löschen), z.b. von Ordnern, Berichten, Datenmodellen und Templates Methoden, um Sicherheitsaufgaben durchzuführen, z.b. Authentifizierung (login, logout) und Kontenmanagement Bildquelle: Developer's Guide for Oracle Business Intelligence Publisher:

7 WSDL-Beispiel

8 Security Session-Based Webservices Aufruf der Webservice-Methode SecurityService.login(), um Nutzer zu authentifizieren Response ist entweder eine AccessDeniedException oder bei erfolgreichem Login eine loginresponse-nachricht mit loginreturn-token allen anschließenden Webservice-Methoden mit dem Suffix [...]InSession wird dieser Token als Teil des Aufrufes mitgegeben nützlich für Anwendungsfälle, in dem mehrere Webservice-Aufrufe erfolgen und der Nutzerkontext erhalten bleiben soll Stateless Webservice in jedem Webservice-Aufruf werden Nutzername und Passwort mitgegeben geeignet für einzelne Webservice-Aufrufe, zum Beispiel in SOA-Prozessen

9 Nutzung der BI Publisher Webservices soapui freies Werkzeug zum Softwaretest für SOAP Oracle Application Express PL/SQL unter Verwendung von FLEX_WS_API Projektbeispiel Java Web Service Proxy BPEL

10 soapui

11 soapui

12 soapui

13 soapui

14 Oracle Application Express

15 Oracle Application Express

16 Oracle Application Express

17 Oracle Application Express

18 Oracle Application Express Bildquelle: Oracle

19 PL/SQL unter Verwendung von FLEX_WS_API FLEX_WS_API: freies PL/SQL-Package Mittlerweile als APEX_WEB_SERVICE-Package verfügbar mit selber Funktionalität Reines PL/SQL unter Verwendung von UTL_HTTP, während das UTL_DBWS-Package mit ähnlicher Funktionalität ein Wrapper für Java- Code ist SOAP-Envelope muss manuell zusammengestellt werden und wird mit MAKE_REQUEST-Funktion an Webservice gesendet Response ist wiederum ein SOAP-Envelope, der mittels XMLDB- Funktionalitäten geparst werden kann

20 PL/SQL unter Verwendung von FLEX_WS_API FUNCTION FNC_WS_LOGIN(p_bip_user_id varchar2, p_bip_user_pw varchar2, p_bip_url varchar2) return varchar2 is l_env CLOB; l_xml XMLTYPE; l_parse CLOB; BEGIN l_env := '<soapenv:envelope xmlns:soapenv=" xmlns:v2=" <soapenv:header/> <soapenv:body> <v2:login> <v2:userid>' p_bip_user_id '</v2:userid> <v2:password>' p_bip_user_pw '</v2:password> </v2:login> </soapenv:body> </soapenv:envelope>'; l_xml := FLEX_WS_API.MAKE_REQUEST(p_url => p_bip_url, '/services/v2/securityservice', p_envelope => l_env); IF l_xml.existsnode('//faultstring') = 1 THEN raise_application_error(-20001, 'Bei der Anmeldung ist ein Fehler aufgetreten! (Originalfehlermeldung: ' l_xml.extract('//faultstring/text()').getstringval() ')'); end if; l_parse := FLEX_WS_API.PARSE_XML_CLOB(l_xml, '//loginreturn/text()', 'xmlns=" return to_char(l_parse); END;

21 Projektbeispiel APEX-Anwendung zur flexiblen Steuerung der monatlichen Generierung von Zahlungsavisen und deren Druck Monatliche Erzeugung von mehr als 4000 PDF- und Text-Dokumenten APEX-Anwendung zur Eingabe von Parametern sowie Start der Generierung und des Drucks Steuerung des BI Publisher über Webservice API aus Datenbank heraus mittels PL/SQL und FLEX_WS_API Verwendung von: SecurityService.login() ScheduleService.scheduleReportInSession() ScheduleService.getScheduledReportStatusInSession() SecurityService.logout()

22 Fazit Oracle BI Publisher Webservice API Interessante, stabile und gut dokumentierte Schnittstelle Vielzahl von Methoden, um BI Publisher Funktionen zu automatisieren Einbindung von BI Publisher Funktionen in eigene Anwendungen, unabhängig von der Programmiersprache

23 Marco Fischer Dipl.-Wirtschaftsinformatiker Leitender Systemberater Certified Business Intelligence Professional Robotron Datenbank-Software GmbH Stuttgarter Straße Dresden Telefon: (0351) Telefax: (0351) Mobil: (0151)