1

<Insert Picture Here>

Berichte à la carte - BI Publisher in eigene Anwendungen integrieren

Jürgen Menge Oracle Deutschland

3

Berichte à la carte –BI Publisher in eigene Anwendungen integrieren

• Überblick• Alternativen für die Anwendungs-

Integration• Konkrete Ansätze für die Integration• Weiterführende Informationen

4

Oracle BI Publisher

• Moderne Lösung zur Entwicklung, Erzeugung und Verteilung von Berichten und Dokumenten

• Funktionale Bereiche• Dokumente, Drucksachen (Output Management)

• Geschäftsberichte (Business Intelligence)• elektronische Formularbearbeitung• elektronischer Datenaustausch

• Verschiedene Arten von Dokumenten• Formulare, Berichte, Serienbriefe,

Rechnungen, Etiketten, ...

• Verschiedene Formate• pdf, html, Excel, Word, PPT, ...

• Verschiedene Kanäle• Druck, Online, Email, ftp, webDAV, Portal,

mobiler Zugriff XML / EFT / EDI

Reports

Checks

Labels

Destinations

Invoices

5

Oracle BI Publisher - Implementierungen

BIP in E-Business Suite

BIP in PeoplesoftBIP in J.D. EdwardsBIP Enterprise

BIP Embedded Oracle BI Suite EE / SE1

6

Übersetzung

XLIFF

TemplateXSL

DatenXML

PDF Word Excel More…

Template Manager

Übersetztungs-kataloge

Translation Handler

etc…

WebDAV

DeliveryServer

Printer

FAX

EmailDokument

Ausgabe-formate

SQL

XML

WebServices

AppsModule

DataEngine

Data Template

Oracle BI Publisher - Architektur

7

Berichte à la carte –BI Publisher in eigene Anwendungen integrieren

• Überblick• Alternativen für die Anwendungs-

Integration• Konkrete Ansätze für die Integration• Weiterführende Informationen

8

BI Publisher – Anwendungs-Integration

Variante 1: Aufruf über URL• Aufruf von Berichten, die vom BIP Server erzeugt werden

Variante 2: Aufruf über das Java API• Schreiben eigener Anwendung auf Basis der APIs des BI

Publishers

• Varianten: Klassen, Servlets, JSP/JSF

Variante 3: Aufruf über Web Service• Aufruf des BI Publisher Servers über die Web Service-

Schnittstelle

9

Aufruf über URL

10

BI Publisher – Aufruf über URL (1)

• verwendet den laufenden BI Publisher-Server• vorhandene Berichtsdefinitionen können genutzt werden

• kein Scheduling möglich

• nur synchrone Aufrufe möglich

• Security des BI Publisher-Server ist wirksam -Alternativen• erneute Authentifizierung notwendig

• mit User/Password aufrufen

• Konfiguration des SSO-Modus• Berichte unter dem Guest-Folder ablegen

11

BI Publisher – Aufruf über URL (2)

Userid

Report-spezifische Parameterparam

Passwortpasswd

Format des Outputs (PDF, HTML, ...)_xf

Name des verwendeten Templates_xt

Anzeige im Browser-Window (0) oder in einem separaten Window (1)

_xpt

Datendefinitionhttp://host:port/xmlpserver/.../Kunden.xdo?

12

Java API

13

BI Publisher – Integration über API

Frankfurt 24.9. PaulBerlin 30.9.

München 22.10. Johannes

• Komponenten des BI Publisher sind in Java implementiert

• Komponenten können über Java APIs angesprochen werden• Data Engine API

• Erzeugen von XML aus SQL oder Data Template

• BI Publisher Core API• PDF Form Processor

• RTF Processor

• FO Processor

• PDF Document Merger

• eText Processor

• Document Processor

• BI Publisher Advanced API (ab 10.1.3.3)

• Bursting Engine

• Delivery Manager

14

BI Publisher - Verarbeitungsprozesse

15

BI Publisher - Bibliotheken

für Delivery Manager und Bursting Enginecollections.jar

für Entwicklung im EBS-Umfeldaolj.jar

zusätzliche Bibliothek für Diagrammeshare.jar

zusätzliche Bibliothek für Diagrammejewt4.jar

Bibliothek für Diagrammebicmn.jar

Bibliothek für Diagrammebipres.jar

skalierbarer XML-Parser und XSLT 2.0-Enginexdoparser.jar

hauptsächlicher XML-Parser und XSLT-Enginexmlparserv2-904.jar

Lokalisierungs-Funktioneni18nAPI_v3.jar

versioninfo.jar

Core-Bibliothek für BI Publisherxdocore.jar

* Bibliotheken können aus der Installation des BI Publisher Desktop kopiert werden

16

Web Service API

17

Historie der Web Services im BIP

• Web Service API bis 10.1.3.3.0• für die interne Nutzung• nicht dokumentiert

• Public Web Service API ab 10.1.3.3.1• geringfügige Änderungen am API in 10.1.3.3.2• wesentliche Erweiterung am API in 10.1.3.4• Web Service Endpoint:

http://host:port/xmlpserver/services/PublicReportService?wsdl

• daneben gibt es weitere interne Web Services• nur für die Standalone Edition verfügbar (BIP Enterprise)

• Vielfältige Einsatzmöglichkeiten• BPEL-Integration• …

18

BI Publisher Web Services (1)• Informationen über Berichte, das Repository und den Server

• getFolderContents

• getReportDefinition

• getReportParameters

• getSecurityModel• getBIPHTTPSessionInterval

• Erzeugen und Ausführen von Berichten• runReport

• uploadReportDataChunk

• downloadReportDataChunk

• createReport

• deleteReport

• updateReportDefinition

• createReportFolder• uploadTemplateForReport

• removeTemplateForReport

• uploadReport

• downloadReport

19

BI Publisher Web Services (2)

• Validierung von Privilegien• validateLogin

• hasReportAccess

• Scheduling• scheduleReport• suspendScheduledReport

• resumeScheduledReport

• deleteScheduledReport

• getScheduledReport

• getScheduledReportInfo

• getScheduledReportHistoryInfo

• deleteScheduledReportHistory• getScheduledReportStatus

20

Alternativen für die Integration

neinnein•Data Engine•Core API•Advanced API

Java-Klassen

Java API

neinjaServlet, JSP/JSF

jaja•Verwendung bestehender Reports-Definitionen möglich•Integration in .NET-Umgebung möglich•Orchestrierung mittels BPEL möglich

Web Service API

neinjaEJB Session Bean

jaja•kein Scheduling•nur synchrone Aufrufe•Verwendung bestehender Reports-Definitionen möglich•Einschränkungen bei der Authentifizierung

HTTP-Aufruf

BIP Server-Instanz notwendig

Remote Zugriff möglich

BesonderheitenSchnittstelle

21

Berichte à la carte –BI Publisher in eigene Anwendungen integrieren

• Überblick• Alternativen für die Anwendungs-

Integration• Konkrete Ansätze für die Integration• Weiterführende Informationen

22

Application Express

23

BI Publisher – Integration in APEX 3.0

• Konfiguration: Manage Services => Instance Settings

• Varianten• Standard: Nutzung von APEX- oder XSL:FO-Templates

• Advanced: Nutzung von RTF-Templates

• ab BI Publisher 10.1.3.2 mit Servlet convert

• mit OracleDB 11g Netzwerk-Zugriff erlauben (Package DBMS_NETWORK_ACL_ADMIN

http://www.oracle.com/global/de/community/tipps/bip /index.html

24

Oracle Forms

25

BI Publisher – Integration in Forms

Variante 1: Aufruf über URL• Aufruf des BI Publishers über web.show_document(url);

Variante 2: Aufruf über das Java API• Schreiben eigener Anwendung auf Basis der API des BI Publishers

• Import der betreffenden Java-Klassen (Java Importer)

Variante 3: Aufruf über Web Service• Nutzung der Web Service-Schnittstelle des BI Publisher (ab 10.1.3.3.1)• Import des Web Service Client Stub (Java Importer)

26

BI Publisher in Forms – Java API

Aufruf des BI Publishers über das Java API• Erzeugen der Dokumente aus XML-Datei und Template

mit geringem Aufwand möglich• Varianten zur Erzeugung der XML-Datei

1. Data Template mittels Java API verarbeiten(dataProcessor.setDataTemplate)

2. SQL-Statement mittels Java API verarbeiten(dataProcessor.setSQL)

3. XML-Datei server-seitig erzeugen

• XMLType-View ausführen• Nutzen der XML DB (DBUri Servlet)• Funktion in Application Express

• ...

RTFTemplate

RTFProcessor

XSL-FOTemplate

FOEngine

PDF

XML

DataTemplate

SQL

27

Datenbank

OracleASForms Service

Client

OracleASBI PublisherWeb Service

Daten

Bericht

BI Publisher in Forms – Web Service API

28

Oracle ADF

29

• Integration des BI Publisher über die Komponenten-Palette des Oracle JDeveloper

• BIP-Regionen können in eine ADF Page eingebettet werden

• Unterstützung für “Push-”und “Pull-”Modell

Integration in Oracle ADF

30

“Push”-ModellEntwicklung• Entwickler registriert einen vorhandenen Bericht vom

BI Publisher-Server• Bericht verfügt über Templates und Musterdaten• Entwickler benutzt eine BIP Region, um ein Berichts-Objekt

in die Seite zu ziehen• Entwickler konfiguriert die Region mittels der Property

Palette

Laufzeit• Seite führt die Region aus und ruft den Bericht auf dem

BI Publisher-Server mit der angegebenen Konfiguration auf• BI Publisher Server gibt den Bericht an die Region zur

Darstellung zurück

31

“Pull”-ModelEntwicklung• Entwickler registriert einen Bericht auf dem BI Publisher-Server,

der auf einem View Object (VO) basiert• Bericht verfügt über Templates und Musterdaten• Entwickler benutzt eine BIP Region, um ein Berichts-Objekt in

die Seite zu ziehen• Entwickler konfiguriert die Region mittels der Property Palette

Laufzeit• Seite führt die Region aus und ruft den Bericht auf dem

BI Publisher-Server auf• Server extrahiert und formatiert den Bericht und gibt das

Ergebnis an die Region zur Darstellung zurück

32

Berichte à la carte –BI Publisher in eigene Anwendungen integrieren

• Überblick• Alternativen für die Anwendungs-

Integration• Konkrete Ansätze für die Integration• Weiterführende Informationen

33

• Oracle BI Publisherhttp://www.oracle.com/technology/products/xml-publisher

• Deutsche BI Publisher Communityhttp://www.oracle.com/global/de/community/bip

• Oracle BI Publisher Bloghttp://blogs.oracle.com/xmlpublisher

• BI Publisher Users Guide – Java API (10.1.3.4)http://download.oracle.com/docs/cd/E12844_01/doc/bip.1013/e12188/T421739T517850.htmhttp://download.oracle.com/docs/cd/E12844_01/doc/bip.1013/e12188/T421739T517851.htm

• BI Publisher Java Doc (10.1.3.4)http://download.oracle.com/docs/cd/E12844_01/doc/bip.1013/e12693/toc.htm

• Business Intelligence New Features Guide – Web Serviceshttp://download.oracle.com/docs/cd/E12844_01/doc/bip.1013/e10416/bip_webservice_101331.htm

Weiterführende Informationen

34

Q&A

35

Integration in Oracle ADF (geplant)

• BI Publisher als Reporting-Framework innerhalb von Oracle ADF

• neue Data Sources• View Objects (VO) der ADF Business Components• Data Controls im Binding Layer

• Erstellen der Berichtsdefinition im JDeveloper/Eclipse

• Layout-Template• BI Publisher Studio als Plug-In im Oracle JDeveloper/Eclipse

36

Einführung