Gunther Oracle APEX und Datenbank Wiki

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== BI Publisher Reports für Oracle Primavera erstellen ======

Den ersten BI Publisher Report für Primavera erstellen.

Vorbereitung Installation: 
  * BI Publisher 
    * siehe [[prod:bipublisher_11g_install|Installation Oracle BI Publisher (Oracle Business Intelligence 11g ) auf Oracle Linux 5]]
  * Primavera mit BI Publisher eingerichtet und konfiguriert
    * siehe [[prod:primavera_p6_p_8_web_install#installation_und_konfiguration_bi_publisher|Installation Oracle Primavera P6 R8.2 EPPM - Enterprise Project Portfolio Management auf Oracle Linux 6.3]]
  * XP Arbeitsplatz mit Microsoft Office 2010 - Word und Excel
  * .NET Framework 3.5

===== Einrichten der Arbeitsumgebung =====
An dem BI Publisher Server über den Browser ( <server>:<port>/xmlpserver ) anmelden und die BI Publisher Tools herunterladen:

{{ :prod:img:bi_publisher:bipublisher_report_primavera_01.png?direct&200 | Download Template Builder}}


BIPublisherDesktop.exe  starten:

  * Installationsprache auswählen: Englisch - ( da hier das Englische Office installiert ist)
  * Setup Screen
    * Next
  * Location auswählen - wie D:\oracle\product\BIPublisherDesktop
    * Next
  * Installation wird durchgeführt
    *Finish 
  * Word startet mit einer Übersicht
  * Reiter BI Publisher anwählen
  * Log On (Schlüssel ganz recht anwählen)
  * {{ :prod:img:bi_publisher:bipublisher_report_primavera_02.png?direct&300 | Login Dialog Word BI Publisher}}
  * Die Templates auf dem BI Server werden angezeigt
  * Word wieder schließen

Damit ist die erste Einrichtung der Umgebung abgeschlossen.

<note important>Für das Lesen der Daten muss immer der entsprechende Primavera Anwender verwandt werden! (Login Name BI Publisher = Login Name Primavera User!)</note>


===== Der erste Bericht =====

Es soll ein einfacher Bericht über die Standorte und die Ressourcen an den Standorten erstellt werden.
Dazu muss aber zuvor, falls auf dem Beispiel Daten getestet wird, auch eine Location pro Ressource angeben werden!

=== Die Primavera Basis Tabellen ===

Das Reporting mit Primavera bezieht sich auf die Views des PXRPTUSER User Schema (P6 Extended Schema).
Die Views haben meist einen Schlüssel mit dem Namen OBJECTID mit dem sich die Join Bedingungen abbilden lassen.

  * Standorte: P6LOCATION   Synonym auf die View LOCATION
  * Ressourcen: P6RESOURCES  Synonym auf die View RESOURCES

Verknüpft werden kann das über die LOCATIONOBJECTID der View P6RESOURCES

Wir entwerfen dazu mit einer SQL Oberfläche die passende SQL Abfrage über die gewünschten Spalten:

<code sql>
select L.LOCATIONNAME
     , L.OBJECTID location_id
     , L.CITY
     , L.COUNTRY
     , L.LOCATIONTYPE 
     , R.OBJECTID resouce_id
     , R.NAME
     , R.EMPLOYEEID
     , R.PRIMARYROLENAME
     , R.RESOURCETYPE
  from P6LOCATION l, P6RESOURCES r
 where r.LOCATIONOBJECTID = l.OBJECTID(+)
</code>


=== Das BI Datamodell ===

Über die BI Weboberfläche erzeugen wir das "Datenmodell" für den ersten Bericht.

Data Model Dialog öffnen:
{{ :prod:img:bi_publisher:bipublisher_report_primavera_03.png?direct&450 |Datamodel Dialog öffnen}}

Beschreibung ausfüllen und Data Source für Primavera auswählen, Hacken für "leere Tags für Nullelemente einschließen" anwählen:

{{ :prod:img:bi_publisher:bipublisher_report_primavera_04.png?direct&450 | Data Source auswählen}}

"Data Sets anwählen", über erstes Icon Links SQL auswählen und in neuen Fenster die SQL Abfrage hinterlegen, Name vergeben, Primavera P6RPT Datasource auswählen und mit "ok" bestätigen:

{{ :prod:img:bi_publisher:bipublisher_report_primavera_05.png?direct&450 | SQL Abfrage einfügen}}

"Save" anwählen und unter dem P6 Folder ( oder ähnlich je nach Konfiguration von Primavera) als "Location_and_resource" speichern:

{{ :prod:img:bi_publisher:bipublisher_report_primavera_06.png?direct&450 | Speichern}}

"XML" Button anwählen

"Get XML Output" anwählen, XML Icon recht neben dem "Save" und Ergebnis abfragen

{{ :prod:img:bi_publisher:bipublisher_report_primavera_07.png?direct&450 |XML Abfrage}}


Nun XML als Beispiel Datensatz für das Modell speichern:

{{ :prod:img:bi_publisher:bipublisher_report_primavera_08.png?direct&450 |Sample.xml für den Bericht speichern}}


Über den Speicher Button rechts das Modell speichern, danach nochmals das Datenmodell erneut aufrufen (Über "Catalog") und prüfen, ob die Sample.xml Daten vorhanden sind, falls nicht obigen Vorgang wiederholen:

{{ :prod:img:bi_publisher:bipublisher_report_primavera_08_01.png?direct&450 | Prüfen, ob XML Daten im Datamodell angehängt sind!}}

=== Das Datenmodell in Word einlesen und ein Template für den Bericht speichern ===

Word öffnen und ein neues leeres Dokument erstellen, als *.rtf Datei speichern (zum Beispiel als rec_loc_report.rtf).

Am BI Publisher anmelden (Richtigen Primavera User beachten!) und das zuvor erstellte Datenmodell "Location_and_resource" auswählen

{{ :prod:img:bi_publisher:bipublisher_report_primavera_09.png?direct&450 | Datenmodell auswählen}}

Mit dem Button "create Report" den Bericht auf dem Server speichern:

{{ :prod:img:bi_publisher:bipublisher_report_primavera_10.png?direct&450 | Report Speichern}}

Den Table Wizard starten:
{{ :prod:img:bi_publisher:bipublisher_report_primavera_11.png?direct&450 | Wizard Starten}}
  * Data Set wählen
  * Spalten auswählen
  * Gruppen Funktion auswählen und Break auswählen
  * Sortierung wählen
  * Finish

In Word wird die Tabelle angezeigt. Diese Tabelle kann nun mit Word Mitteln bearbeitet werden, es ist nur darauf zu achten, dass die Tags nicht gelöscht werden!

Das Template wird nun wieder auf dem BI Server geladen:
{{ :prod:img:bi_publisher:bipublisher_report_primavera_12.png?direct&450 | Template wieder auf den Server laden}}

=== Bericht aufrufen ===

Der Bericht kann nun auf dem BI Server aufgerufen werden:
{{ :prod:img:bi_publisher:bipublisher_report_primavera_13.png?direct&450 | Der Bericht im Katalog auf dem BI Publisher}}
{{ :prod:img:bi_publisher:bipublisher_report_primavera_14.png?direct&450 | Der fertige Bericht im BI Publisher}}

Funktioniert er hier, kann der Bericht auch in Primavera über "Reports" gestartet werden.

{{ :prod:img:bi_publisher:bipublisher_report_primavera_15_aufruf.png?direct&450 | Start Bericht in Primavera}}

===== Fehlersuche=====

=== " ..not valid for connection to the reporting database ..." ===

In einer eigentlich funktionierenden Primavera Umgebung können plötzlich die Berichte nicht mehr aufgerufen werden:


{{ :prod:img:bi_publisher:bipublisher_report_primavera_15_fehler.png?direct&300 | Fehler eim Aufruf von Berichten in Primavera }}

Lösung:
Neustart des Weblogics Servers, die Weblogic Primavera Umgebung ist anscheinend mit der Weblogic BI Publisher Umgebung aus dem "Tritt" gekommen.


===== Quellen =====

  * http://www.oracle.com/technetwork/testcontent/xmlpclient-082400.html
  * http://www.oracle.com/technetwork/middleware/bi-publisher/learnmore/index.html
  * http://www.rittmanmead.com/2010/09/obiee-11gr1-new-features-in-bi-publisher-11gr1/




{{tag>primaveraarchitektur}}