OAF Extension in Oracle EBS Projects - doag.org · PDF file(Rel. R11 to R12) •...

1

OAF Extension in Oracle EBS Projects

Thomas Echterhagen- PRIMUS DELPHI GROUP GmbH

PRIMUS DELPHI GROUP

• Zusammenschluss der Oracle Certified Partner Primus (gegr. 1992) und delphi (gegr. 1993)

• Fokus auf Oracle Business Software

• E-Business Suite Partner No. 1im deutschsprachigen Raum

2

• Niederlassungen in Deutschland,Österreich und der Schweiz

• 55 international erfahrene Berater

• International erfolgreiche Projekte

Unser Leistungsportfolio

Beratung Schulung Entwicklung

• Projektleitung• Lösungsarchitekturen• Implementierung• Prozessoptimierung(modul- u. systemübergreifend)

• Release Upgrades(Rel. R11 to R12)

• Post-Production Support• Wartungsverträge

• Technische Schulungen• Key-User Schulungen• End-User Schulungen

• Systemintegration• Erweiterungen zur E-Business Suite• Datenmigration• Auswertungen & Reports(Oracle Reports, BI-Publisher)• Database Tuning• Webservices• Mobile Devices• DBA Support• Security-Checks

3

Hardware Outsourcing Lizenzen

• Hardware-Konzepte• Hardware-Sizing• Installation

• Infrastruktur Management• Betrieb und Wartung• ASP - Lösungen

• Oracle Produkte• PDG-Produkte• Drittanbieter

Unser Lösungsportfolio

Oracle Business Solutions Addons zur E-Business Suite

• E-Business Suite

• BI Applications

• Demantra

• Sourcing

• PDG GDPdU für Oracle Financials

• PDG Stammdatenverwaltung

• PDG Zahlungsmanagement

• PDG Dokumentenmanagement

4

• Oracle Transportation Management

• Oracle Retail

• Oracle Projects

• Vertriebsmanagementsystem

• PDG Anlagenspiegel

• PDG Touchscreen user interface

• PDG Zusammenfassende Meldung via xml

• PDG Controlling viewer

• Rechnungsmanagement (Scannen und Abgleich): Invoice IT

• Berichtswesen aus der E-Business Suite in Excel: Excel4Apps

• Dataloads über Excel in die E-Business Suite: More4Apps

• HP-RIM Archivierung

Agenda

• Oracle Application Framework (OAF) Überblick

• Profiloptionen im OAF-Kontext

• Functional Administrator

• Objektorientierte MVC - Struktur

• Meta Data Service Repository (MDS)

5

• About This Page, Diagnostics – OAF Seiteninformation, Business Komponenten und Trace

• Projects relevante OAF Erweiterung

� Ist-Zustand

� Soll-Zustand

� Beispiel AM Extension (timeline) im JDeveloper

OA Framework Überblick 1/2

• Oracle Applications Framework (OAF) ist ein ADF-Framework speziell für die Oracle E-Business Suite. (Whitepaper OAF und ADF im Vergleich (Metalink Note 563047.1))

• Es dient als Basis für HTML-basierende Business Applikationen in der EBS, iProcurement, iExpense, Payments und Projects, etc.


6


• 100% Java und XML basierendes OA Framework unterstützt Funktionalitäten von XML, HTML, Java, JSP, SQL und Web Services.

OA Framework Überblick 2/2

• OAF-Seiten lassen sich durch Personalisierung auf verschiedenen Ebenen ohne Programmierung erweitern

- Admin Level Personalization (Site, Organization, Responsibility)

- User Level Personalization (User Views)

Hierarchisches Konzept, bei der Aktivität der einzelnen Personalisierungen, ähnlich wie bei Profiloptionen.

7

• OAF-Erweiterungen, die nicht ausschließlich durch Personalisierung abgebildet werden können-programmatische Erweiterungen mit Oracle JDeveloper(OA Extension).

• Verschiedene JDeveloper Versionen mit OAF Erweiterungen hängen vom EBS Release und dem Patch-Level ab. (Metalink-Note: 416708.1)

Profiloptionen im OAF-Kontext

• Personalize Self-Service Defn

• Disable Self-Service Personal

• FND: Personalization Region Link Enabled

• FND: Diagnostics

8

ausführlichere Informationen und weitere interessante Profiloptionen (Metalink-Note: 275876.1)

Functional Administrator 1/4

• Eigene Zuständigkeit

• Modulübergreifende Übersicht und Verwaltung bestehender Personalisierungen

• Import/Export von Personalisierungen

• Profiloption "FND:Personalization Document Root Path" setzen, um Personalisierungen importieren und exportieren zu können ($APPL_TOP/<CompanyIdentifier>/<CustProductShortName>/<ProductVersion>/mds/we

bui)

9

bui)

• Ermöglicht das Leeren des MDS-Caches und des Caches der Java Virtuellen Maschine (JVM) über Global Cache Configuration

• Ein Lebensretter bei kniffligen Personalisierungen ;)


• Application Catalog

10


• Im-/Export Personalisierungen

11


• Caching Framework

12

Objektorientierte MVC- Struktur

OA Controller (CO)

BC4J

VO

View Objekte sind Datenbankabfragen, die

entweder unabhängig genutzt werden oder auf

EO basieren.

AM

Dient als Broker zwischen dem User-

Interface und den Datenbankobjekten

(VO u. EO). Bündelt alle relevanten

Datenbankinformationen (Connection

pooling, Management von

Datenbanktransaktionen)

CO

Java Klasse, die einer Region zugefügt ist. Ihre Hauptaufgabe besteht darin den

grafischen Aufbau einer Region zu regeln, Benutzerinteraktionen zu validieren,

behandeln und weitere Aktionen durchzuführen. Ihre Methoden sind:

• processRequest() – wird ausgeführt bevor eine Region gerendert wird

• pocessFormRequest() – verarbeitet Benutzerinteraktionen (z.B. Button

gedrückt)

13

Entity Objects (EO)

View Objects (VO)

Application Modules (AM)

DB

BC4J

MDS

Sorgt für die Seitenstruktur und die Regionen,

die in einer OAF-Seite zur Laufzeit angezeigt

werden.

DB DB DB EO

Entiy Objekte setzen default-Werte u.

validieren Spalten, Zeilen in einer

Tabelle. Es kann jegliche Daten-

manipulation vorgenommen werden

(insert, update, delete).

MDS – Meta Data Service 1/2

Meta – Symbolisiert das Dictionary, wobei die Kompo-nenten, in kleine Einzelteile (Felder, Buttons, etc. ) gestückelt werden. Zur Laufzeit werden sie kombiniert und als Webpage im Browser gerendert/geladen.

Data – Die Metadaten sind nicht als Dateien auf dem Server abgespeichert, sondern als Komponenten

14

Server abgespeichert, sondern als Komponenten mit ihren Definitionen und Relationen in JDR-Tabellen (JDR_COMPONENTS, JDR_ATTRIBUTES, JDR_ATTRIBUTES_TRANS & JDR_PATHS).

Service - OA Framework liest die Daten bei einem HTTP-Request und baut die Webseite aufgrund der Meta-Daten strukturell auf.

MDS – Meta Data Service 2/2

Extensions mit dem JDeveloper und Relation zum MDS

• Neu erstellte Seiten, Regions und ihre Subkompontenbspw. LOVs, Shuttle RN können in die EBS mit dem Script „xmlimport“ implementiert werden. Substitutionen von bspw. EO, VO, AM Business-Komponenten werden mittels „jpximport“ in die EBS integriert.

15

„jpximport“ in die EBS integriert.

• Die Personalisierungen können zusätzlich noch mit den JDR_UTILS Package und ihren nachfolgenden Prozeduren abgefragt bzw. gelöscht werden („listCustomizations“, „printDocument“, „deleteDocument“).

About This Page – OAF Seitenkomponenten 1/3

• Profiloption: FND Diagnostics

- Aktiviert die Links „About This Page“(1) u. „Diagnostics“(2)

16

• Profiloptionen, um auf den OAF-Seiten nähere Seiteninformationen mit ihren Business Komponenten zu erhalten. ("About this Page")

• Ermöglicht Debugging innerhalb der Seitennavigationen. Die Informationen können in Dateien auf dem Server weggeschrieben oder auf dem Bildschirm in unterschiedlichem Detaillierungsgrad angezeigt werden. ("Diagnostics")


• Page Layout und ihre OAF Komponenten (Extrakt)

17


• Business Komponenten (BC4J) (Extrakt)

18

Diagnostics – Trace

• Debugging von Seitennavigation mit Bildschirmausgabe (Extrakt)

19

Projects Resources Timeline Erweiterung

20

Projects Resources Timeline Erweiterung

21

Projects Resources Timeline Erweiterung (Ext.)

22

Projects Resources Timeline Erweiterung (Ext.)

23

OA Framework Projects Szenario 1/8

• Analyse der bestehenden Business Komponenten (Reengineering)

� Mit Hilfe „About this Page“ gelangt man an die nötigen Informationen

• Java Binaries liegen auf dem Apps-Server unter $JAVA_TOP/oracle/apps/pa/

24

� Der Quellcode kann mit einem Decompiler angesehen und untersucht werden

• Erweiterungen nach Oracle Coding Standards vornehmen (Metalink-Note: 275846.1)

� zusätzliche/ sehr hilfreiche Dokumentation/Beispiele sind im jeweiligen JDeveloper Patch enthalten


• Aufgrund hoher Komplexität der darunter liegenden und miteinander verschachtelten OAF-Komponenten, wurde eine neue Seite erstellt. Diese Seite wurde durch Extensions bestehender Java Klassen und XML Komponenten erweitert und enthält neue Business-Anforderungen. Sie kann als neu angelegte Funktion, den jeweiligen Zuständigkeiten zugewiesen werden.

� Substitution VO, AM, CO-Klassen und ihren XML-

25

� Substitution VO, AM, CO-Klassen und ihren XML-Sourcen. (Keine Root Komponenten!)

� Java-Klassen wurden mit „extends“ und Java Interfaces mit „implements“ erweitert.

� Datenbankobjekte (Packages, Tabellen) wurden erweitert, um einen neuen tagesgenauen Berech-nungsalgorithmus für die Projektressourcen zu gewährleisten.


• Timeline AM Extensions (Bsp.)

� AM Komponenten identifizieren und vom Apps-Server herunterladen und ins lokale Verzeichnis „myclasses“ vom JDeveloper hereinkopieren. $JAVA_TOP/oracle/apps/pa/timeline/server

� Hinweis: zu erweiternde Klassen müssen als Source .java ins „myprojects“ Unterverzeichnis dekompiliert und referenzierte Objekte wie bspw. VO hereinkopiert werden.

Im JDeveloper Workspace (.jws) und Project (.jpr) erstellen

26

� Im JDeveloper Workspace (.jws) und Project (.jpr) erstellen

a. Name: XxpdgTimelineAM

b. Package: XXPDG.oracle.apps.pa.timeline.server.TimelineAM

c. erweitert das Application Module (extends)oracle.apps.pa.timeline.server.TimelineAM


• Erstellen des neuen Application Modules 1/5

27



28



29



30



� <Substitutes>

<Substitute OldName ="oracle.apps.pa.timeline.server.TimelineAM"

NewName="XXPDG.oracle.apps.pa.timeline.server.XxpdgTimelineAM" />

</Substitutes>

� FTP alle notwendigen Dateien auf den Applications Server

� Substitution in der EBS ins MDS Repository durch „jpximport“

31

jpximport

E:\Entwicklungsteam\Jdeveloper_Gantt\jdevhome\jdev\myprojects\extensionsA

M.jpx -username apps -password ****** -dbconnection " ****** „

� Apps-Server bouncen und danach steht die AM-Extension zur

Verfügung

Apps-Server herunterfahren: $INST_TOP/admin/scripts/adstpall.sh apps/******

Apps-Server herauffahren: $INST_TOP/admin/scripts/adstrtal.sh apps/******

Fragen und Antworten / Kontakt

Vielen Dank für Ihre Aufmerksamkeit.

32

Thomas EchterhagenConsultant

Am Hange 27

D-22844 Norderstedt

Fon: +49 40 28 41 86 – 45

[email protected]

www.primus-delphi-group.com

OAF Extension in Oracle EBS Projects - doag.org · PDF file(Rel. R11 to R12) •...

Documents

Transcript of OAF Extension in Oracle EBS Projects - doag.org · PDF file(Rel. R11 to R12) •...