26.1.07

APEX Dokumentations Modul

Immer mal wieder taucht die Frage nach einer "vernünftigen" Dokumentation auf. Die Funktion "View Application Reports" / "Anwendungsberichte anzeigen" gibt zumindest schonmal eine Übersicht der Objekte.
Oft reicht das aber nicht.

Dieses Dokumentations-Modul (4 Seiten) stellt die wesentlichen Komponenten einer Seite dar und über die "SVG link Map" die Verlinkung der Seiten.

Ich hatte bis heute eine ganz pfiffige Studentin der Wirtschaftsinformatik für 4 Monate als Studien-Praktikantin bei Oracle (hiermit Danke an Melanie Maronde aus Stralsund!), der ich diese Aufgabe übertragen konnte.

Das dann entstandene, generische "Dokumentations Modul" besteht aus 4 Seiten:
1) Seite mit Report basierend auf A) verlinked zu
2) Seite mit Form mit 4 Regions: (siehe Bild oben)
2.1) Region: Form - mit "Page Name" and "FUNKTION" basierend auf A)
2.2) Region: HTML - an SVG basierend auf pl/sql procedure mit grafischer "link map"
2.3) Region: Report basierend on B)
2.4) Region: Report basierend on C)
3.) Seite mit Suchmöglichkeit.
4.) Seite zum Erfassen der Funktionsbeschreibung - ID = Seiten-Nummer der APEX Anwendung - Tabelle "DOKU_PAGE_FUNKTIONEN"

Dann hat man ein ganz smartes "Dokumentations-Modul", dass man überall einsetzen kann und einem den Überblick verschafft, was welcher Entwickler wo getrieben hat.
Vorraussetzung ist etwas Disziplin oder eine "organisatorische Vorgabe" und zwar:
VORGABE 1) Die allgemeine Beschreibung wird in 4.) eingegeben
VORGABE 2) Das Kommentarfeld in den Objekten Seite, Region, Process wird benutzt.

Wir machten extensiven Gebrauch des "Kommentar" Feldes der Objekte und nutzten es wie folgt:

A) Für die Seiten/Pages (--> APEX_APPLICATION_PAGES)
SELECT
p1.PAGE_ID Seite,
p1.PAGE_NAME Name,
p2.FUNKTION
FROM (SELECT PAGE_ID,
PAGE_NAME
FROM APEX_APPLICATION_PAGES
WHERE APPLICATION_ID = &APP_ID.) p1 LEFT JOIN
DOKU_PAGE_FUNKTIONEN p2 ON p1.PAGE_ID = p2.PAGE_ID
order by Seite;
Wie man sieht, legten wir eine neue Tabelle "DOKU_PAGE_FUNKTIONEN" an, da der
View des APEX Data Dictionaries "APEX_APPLICATION_PAGES" die Spalte "Kommentar" nicht enthält und wir eine allgemeine Beschreibung der jeweiligen Seiten haben wollten; wir "jointen" mit dem View "APEX_APPLICATION_PAGES".

B) für die Regionen nutzten wir
SELECT
REGION_NAME Region,
COMPONENT_COMMENT Funktion,
CONDITION_TYPE
FROM APEX_APPLICATION_PAGE_REGIONS

C) für die Prozesse
SELECT
PROCESS_NAME,
PROCESS_POINT,
COMPONENT_COMMENT,
condition_type
FROM APEX_APPLICATION_PAGE_PROC

Wenn ich demnächst Zeit habe, werde ich dieses Modul für das APEX Studio bereitstellen (wenn sie es dann nehmen...) - zur Not hier (;-)
Wer Interesse hat, bitte Kommentar hinterlassen
(E) if you have interest in this module kindly leave a message as comment.

"Freeze Panes" - oder "Fixed Header" im Report


Ich stolperte gerade im Discussion Forum über ein cooles Feature für APEX: Fixed Headers bei Reports analog "freeze panes" in Excel.

Bei einer großen Anzahl von Datensätze möchte man immer den Header sehen.....(wenn man nicht blättern möchte).

Working Example here - Code here;
(nicht erschrecken ! - ist ne Menge Code, aber funktioniert)

Info: Es geht scheinbar nicht mit jedem Report Template - ich benutzte das "Standard Report (with alt colors)" - Template (Kopieren !!) und der Eintrag: id="table_grab" muss zwischen '<'table ...und ... class eingefügt werden:
Also bei im Template BEFORE ROWS:
'<'table id=table_grab" class="t3standardalternatingrowcolors" cellpadding="0 usw...

Danke an - Thanks to - Bill Ferguson aus Denver Colorado (US), der den Code und die Anleitung zusammenschrieb.
Viel Erfolg und Spaß damit.

23.1.07

APEX Sizing

Es ist gerade ein sehr interessanter Artikel im Oracle Magazin zum Thema APEX Sizing von Mike Hitchwa erschienen - es wird u.a auf diese Performance Grafik Bezug genommen:


12.1.07

Incredible Dimitr Gielis

Schonmal was von Dimitri Gielis gehört ? Von der WM2006 Fussball Anwendung ? Man konnte da online wetten (basierend auf APEX!) - ich berichtete darüber im Juni 2006. Ich habe seinen BLOG in meine Favorite BLOGs aufgenommen.
Der Typ ist ein APEX Verrückter (Belgier)! Das letzte smarte Feature hier in seiner Shoutbox ( "Thumbnail Expander" - eine Vergößerung der Bilder-Thumbnails beim Draufklicken und Verkleinern beim erneuten Klicken - cool!) .
Viel Spaß !