Oracle APEX

38 Pages·2017·4.37 MB·German

by  Jürgen Sieben

Wissen, wie’s geht.
Leseprobe
Zu Beginn dieser Leseprobe führt Sie Jürgen Sieben in die wesent-
lichen Konzepte und Fachbegriffe von APEX ein. Direkt im An-
schluss erfahren Sie mehr über Websheet-Eigenschaften. In einem
weiteren Abschnitt werfen Sie einen genaueren Blick auf dynami-
sche Aktionen, deren Verwendung, Ereignisse und Typen.
»Überblick über APEX«
»Eine Websheet-Anwendung erstellen«
»Dynamische Aktionen«
Inhaltsverzeichnis
Index
Der Autor
Leseprobe weiterempfehlen
Jürgen Sieben
Oracle APEX – Das umfassende Handbuch
895 Seiten, gebunden, September 2017
79,90 Euro, ISBN 978-3-8362-4530-2
www.rheinwerk-verlag.de/4376
4530.book Seite 54 Donnerstag, 7. September 2017 3:59 15 4530.book Seite 55 Donnerstag, 7. September 2017 3:59 15
2 Grundlagen von APEX 2.2 Überblick über APEX
2.2 Überblick über APEX Die Anwendungsdaten, die von einer APEX-Anwendung benötigt werden, können in
einem oder mehreren Schemata der Datenbank (potenziell auch in mehreren Daten-
Nachdem ich Ihnen die grobe Einsortierung von APEX in das Konzert der Entwick- 2
banken) gespeichert werden, wichtig ist nur, dass APEX auf irgendeine Weise Zugriff
lungswerkzeuge für Webanwendungen erläutert habe, möchte ich mit Ihnen nun
auf diese Daten erhält, damit sie entsprechend genutzt werden können. Um dies
einen Rundgang durch die wesentlichen Konzepte und Fachbegriffe von APEX star-
sicherzustellen, hat das APEX-Schema das Recht, sämtliche Daten der Datenbank, in
ten, damit Sie eine genauere Vorstellung davon erhalten, wovon wir eigentlich reden.
der APEX installiert ist, zu lesen und zu benutzen. Dies ist natürlich ein sehr mächti-
Vielleicht sollte ich damit beginnen, zu erklären, wie APEX installiert oder aktuali-
ges Recht, das in jedem Fall kanalisiert werden muss. Wie dies geschieht, beschreibe
siert wird. Doch führt uns dies im Moment recht weit vom Überblick weg, daher habe
ich im nächsten Abschnitt 2.2.2 »Workspaces«.
ich die Beschreibung der Installation bzw. Aktualisierung von APEX in den Anhang
Wird an die Datenbank nun die Anweisung gegeben, beispielsweise Seite 17 der
dieses Buches verlegt. Sollten Sie noch keine funktionsfähige APEX-Installation
Anwendung 100 auszuführen (wir sprechen hier vom Show Processing), lädt APEX die
haben, haben Sie die Wahl: Entweder installieren Sie APEX nun, indem Sie die Anwei-
Metadaten dieser Seite und prüft anschließend, ob für diese Seite eine Anmeldung
sungen hierzu im Anhang befolgen, oder aber Sie lesen sich zunächst einmal theore-
des Endanwenders bei APEX erforderlich ist. Ist dies so, muss eine gültige Session-ID
tisch in die Denkweise von APEX ein, um dann mit diesem Wissen die Installation
vorhanden sein, ansonsten wird der Benutzer an eine Anmeldeseite weitergeleitet,
oder Aktualisierung später nachzuholen.
die bei erfolgreicher Anmeldung diese Session-ID erzeugt. Ist eine gültige Session-ID
vorhanden oder ist die Seite als public gekennzeichnet und benötigt daher keine Ses-
2.2.1 Allgemeiner Überblick sion-ID, werden die hinterlegten select-Anweisungen zur Ermittlung der darzustel-
lenden Informationen dieser Seite ausgeführt, die Daten mit dem HTML-Rahmen zu
Dass APEX unter einer Anwendung eine Folge von Anwendungsseiten versteht, die
einer HTML-Seite verbunden und ausgeliefert.
innerhalb der Datenbank gespeichert sind, hatte ich bereits erläutert. Damit jedoch
APEX eine solche Anwendung erstellen kann, sind einige Voraussetzungen erforder- Abbildung 2.1 zeigt diesen Fluss im oberen Teil der Abbildung (Show Processing). Die
lich. So müssen Tabellen existieren, die speichern können, welche Webanwendun- Datenbank hat dabei die Möglichkeit, die Darstellung jedes Seitenelements (und
gen existieren, welche Seiten, Seitenelemente etc. in ihr enthalten sind und wie diese auch der gesamten Seite) an ein Rollenkonzept zu binden und damit von den Benut-
Anwendungen ausgeführt werden sollen. Diese Tabellen werden in einem Daten- zerrechten des angemeldeten Benutzers abhängig zu machen. Ist ein Seitenelement
bankschema gespeichert, das auch die gesamte Logik enthält, damit aus diesen Daten für diesen Benutzer nicht freigegeben, wird es gar nicht erst berechnet und fehlt auf
eine Webanwendung berechnet werden kann. Als Datenbankschema (oder einfach der Seite damit komplett.
Schema) wird innerhalb einer Oracle-Datenbank die Gesamtheit der Objekte bezeich-
net, die einem Benutzer gehören. Das Schema hat den Namen APEX_<Version>, aktuell
APEX_050100. Nennen wir dieses Schema der Einfachheit halber das APEX-Schema.
Show Processing
Das APEX-Schema enthält die Tabellen und PL/SQL-Packages, um eine Webanwen-
URL Render HTML Page
dung aus der Datenbank heraus zu betreiben. In diesem Schema liegen daher auch Method Get Fetch Authenti- Page Tab, bread-
cation &
die Tabellen, die die Metadaten unserer Webanwendung (welche Seiten existieren, Meta Data crumbs … regions,
Authorization
items & buttons
welche Elemente sollen auf diesen Seiten dargestellt werden, wie lautet der Sessi-
onkontext einer Anwendung und so weiter) speichern, doch es enthält nicht die
Daten, die durch die Anwendung dargestellt werden sollen, also zum Beispiel die Accept Processing
Page Submit
Kundenadressen. In diesem Licht können Sie die Tabellen des APEX-Schemas mit Method Post Fetch Authentica- (cid:2) Validate
dem Data Dictionary der Datenbank vergleichen, das ja auch die Metadaten der tion & (cid:2) Process
Meta Data
Authorization (cid:2) Branch
Benutzer, Tabellen, PL/SQL-Programme etc. der Datenbank enthält, nicht jedoch die
tatsächlichen Tabellendaten der einzelnen Datenbankbenutzer. Lassen Sie uns hier
vom APEX Data Dictionary sprechen.
Abbildung 2.1 Bearbeitung einer APEX-Seite (Quelle: Oracle)
54 55
4530.book Seite 56 Donnerstag, 7. September 2017 3:59 15 4530.book Seite 57 Donnerstag, 7. September 2017 3:59 15
2 Grundlagen von APEX 2.2 Überblick über APEX
Sendet der Benutzer eine Seite mit Eingaben in Formularfeldern an die Datenbank nistrators frei gewählt werden. Auch dieser Benutzer ist ein APEX-interner Benutzer,
zurück (Accept Processing in Abbildung 2.1), werden die eingefügten Daten zunächst der außerhalb von APEX nicht bekannt ist. Es existiert nach der Installation von APEX
2
in den Sessionkontext kopiert (der, wie gesagt, eine Tabelle innerhalb des APEX-Sche- auch bereits ein erster Workspace mit dem Namen INTERNAL, der nicht gelöscht wer-
mas ist). Die Seite wird anschließend daraufhin geprüft, ob weitergehende Aktivitäten den kann und für den ausschließlich der APEX-Administrator die entsprechenden
innerhalb der Datenbank durchgeführt werden müssen, wie zum Beispiel die einge- Administrationsrechte besitzt.
gebenen Informationen in Datenbanktabellen der Anwendung zu speichern.
Sie melden sich also als APEX-Administrator im Workspace INTERNAL an und legen
Anschließend analysiert APEX, welche Anwendungsseite als Nächstes berechnet wer-
dort weitere Workspaces für die eigentlichen APEX-Anwendungen an, denn im
den soll, erstellt diese analog zum schon besprochenen Show Processing und schickt
Workspace INTERNAL selbst können keine APEX-Anwendungen erstellt werden. Admi-
diese an den Client. Diese Seite kann zum Beispiel eine Bestätigungs- oder Fehlerseite
nistriert wird APEX durch eine APEX-Anwendung, die Sie unter dem URI <server>/
oder einfach die nächste Seite im vorgesehenen Workflow der Anwendung sein. Alle
ords/apex_admin aufrufen können, wie in folgender Abbildung zu sehen.
Details, wie die Verwaltung einer Transaktion, das Reagieren auf Datenbankfehler, die
Ausführung von Validierungslogik etc., sind dabei weitestgehend vor dem Anwen-
dungsentwickler verborgen, solange die vorgefertigten Anwendungselemente ver-
wendet werden. Insbesondere in der Verwendung dieser vorgefertigten Anwen-
dungselemente liegt die hohe Entwicklungsgeschwindigkeit von APEX begründet.
2.2.2 Workspaces
Wie wir gesehen haben, benötigt eine APEX-Installation Zugriff auf die Daten, die
innerhalb einer APEX-Anwendung angezeigt werden sollen, aber in anderen Sche-
mata gespeichert werden. Das ist normalerweise nicht möglich, da ein Datenbankbe-
nutzer nur dann die Daten anderer Schemata sehen darf, wenn diese ihm dies
gestatten oder wenn der Benutzer administrative Rechte besitzt. Um APEX die Mög-
lichkeit zu geben, die erforderlichen Daten zu sehen, ohne ihn gleich zum Datenbank-
administrator zu machen, wird ihm das Recht eingeräumt, das – undokumentierte –
PL/SQL-Package dbms_sys_sql auszuführen, das in der Lage ist, jede beliebige SQL-
Anweisung mit den Rechten des Datenbankeigentümers SYS auszuführen. Verglei-
chen Sie dies vielleicht mit dem Unix-Kommando sudo. Dies ist natürlich ein mächti-
ges Recht, das nach Kanalisierung verlangt.
Abbildung 2.2 Anmeldebildschirm der APEX-Administrationsanwendung
Diese Kanalisierung wird durch sogenannte Workspaces gewährleistet. Ein Work-
space ist ein logisches Konstrukt innerhalb von APEX, das für sich genommen »nur« Da die Anwendung selbst eine APEX-Anwendung ist, können Sie in Abbildung 2.3 ein
ein Eintrag im APEX Data Dictionary darstellt und nicht etwa ein Datenbankobjekt, Beispiel für das Look & Feel von APEX-Anwendungen sehen: Sie erkennen, dass unter
das außerhalb von APEX bekannt wäre. Weil aber auch alle APEX-Anwendungen der Schaltfläche Workspaces verwalten weitere Workspaces angelegt und admi-
innerhalb des APEX-Schemas entwickelt, gespeichert und ausgeführt werden und die nistriert werden können.
Kontrolle über den Datenzugriff komplett über diesen Benutzer erfolgt, ist dies kein
Alternativ zu dieser APEX-Anwendung lassen sich alle administrativen Aufgaben
grundsätzliches Problem. Für die Entwicklung von APEX-Anwendungen ist ein Work-
auch als Skriptdateien ausführen. Dies benötigen Sie, weil auf Produktionsmaschinen
space unbedingte Voraussetzung.
häufig nicht die grafischen Administrations- und Entwicklungswerkzeuge installiert
Ein solcher Workspace muss vom APEX-Administrator erstellt werden, einem Benut- werden. Auch der Export einer APEX-Anwendung wird als eine solche Skriptdatei aus-
zer, der (in unserem Beispiel) während der Installation von APEX unter dem Namen geführt, sodass Sie eine APEX-Anwendung mit einer grafischen Anwendung expor-
ADMIN erstellt und mit einem (sicheren) Passwort versehen wurde. Ab Version 5 von tieren und mit den Administrationswerkzeugen oder als Skript erneut installieren
APEX ist die Erzeugung dieses Benutzers optional, auch kann der Name dieses Admi- können.
56 57
4530.book Seite 58 Donnerstag, 7. September 2017 3:59 15 4530.book Seite 59 Donnerstag, 7. September 2017 3:59 15
2 Grundlagen von APEX 2.2 Überblick über APEX
der Workspace-Administrator Workspace-Benutzer anlegen, die lediglich Benutzer-
rechte haben und daher für den Betrieb der Anwendung genutzt werden können. Ein
2
Workspace-Benutzer hat keinerlei Zugriff auf den Anwendungscode oder die admi-
nistrativen Einstellungen des Workspaces.
Durch diese Festlegungen hat ein Workspace-Entwickler (oder aber auch der Work-
space-Administrator) nur noch die Möglichkeit, auf die Metadaten von APEX und die
Daten des für diesen Workspace freigegebenen Datenbankschemas zuzugreifen, die
Oracle-Datenbank besteht für diese Benutzer also ausschließlich aus den Daten, die
dem zugeordneten Schema gehören oder die diesem Schema zugänglich gemacht
worden sind. Diese Limitierung ist weder durch den Workspace-Administrator noch
durch den Anwendungsentwickler zu umgehen. Innerhalb eines solchen Workspaces
kann nun der Anwendungsentwickler beliebig viele APEX-Anwendungen anlegen
und entwickeln. Für alle diese Anwendungen gilt, dass sie vom gleichen Entwickler-
team entwickelt und vom gleichen Workspace-Administrator verwaltet werden und
sich auf die gleichen Daten der Datenbank beziehen. Die Workspace-Benutzer
schließlich haben nur Zugriff auf die Funktionen, die in der Anwendung für sie frei-
geschaltet wurden.
Abbildung 2.4 zeigt das Verhältnis von Workspaces (Workspace 1–3) zu Datenbank-
schemata (Schema 1–4) einerseits und zu APEX-Anwendungen (Department 1–3)
andererseits. Für Anwendung 1 besteht die Datenmenge, die innerhalb der Daten-
bank benutzt werden kann, lediglich aus den Daten aus Schema 1, zuständig für Ent-
wicklung und Administration der Anwendung ist der Workspace-Administrator bzw.
-Entwickler aus Workspace 1. Im Gegensatz dazu hat Anwendung 2 Zugriff auf die
Daten der Schemata 2 und 3.
Abbildung 2.3 Startseite der APEX-Administrationsseite
Department 1
Bei der Anlage eines neuen Workspaces wird festgelegt, auf welche Schemata inner- (e.g. Sales) Workspace 1 Schema 1
halb der Datenbank dieser Workspace zugreifen darf. Theoretisch möglich ist es,
einem Workspace mehrere Schemata zuzuweisen, das werden wir in diesem Buch
Schema 2
allerdings nicht tun, weil es stets andere Möglichkeiten hierfür gibt, die ich bevor-
Department 2 Workspace 2
zuge. Woher meine Vorliebe hierfür kommt, erläutere ich in Kapitel 21, »Authentifi- (e.g. Support)
zierung und Autorisierung«. Bei der Anlage eines Workspaces wird stets auch ein Schema 3
neuer APEX-Benutzer als Administrator dieses neuen Workspaces definiert. Dieser
Oracle Database
Workspace-Administrator darf dann andere APEX-Benutzer innerhalb dieses Works- Department 3 Workspace 3 with Oracle Application
Schema 4
paces administrieren und diesen zum Beispiel Entwicklerrechte gewähren, was diese (e.g. HR) Express
dann zu Entwicklern von APEX-Anwendungen (Workspace-Entwickler) innerhalb die-
ses Workspaces macht. Wie dies konkret gemacht wird, sehen wir uns in Abschnitt
22.3, »Bereich ›Workspace‹ verwalten«, an. Als letzte Kategorie von Benutzern kann
Abbildung 2.4 Übersicht über Workspaces (Quelle: Oracle)
58 59
4530.book Seite 60 Donnerstag, 7. September 2017 3:59 15 4530.book Seite 61 Donnerstag, 7. September 2017 3:59 15
2 Grundlagen von APEX 2.2 Überblick über APEX
Zusätzlich können in einem Workspace durch den Workspace-Administrator noch Lehnen wir uns einmal kurz zurück, und sehen wir uns an, was wir bislang haben:
sogenannte Gruppen angelegt und einzelnen APEX-Benutzern zugeordnet werden. (cid:2) APEX besteht im Wesentlichen aus einem APEX-Schema, in dem Tabellen für das
2
Mithilfe dieser Gruppen kann innerhalb einer APEX-Anwendung ein Rollenkonzept
APEX Data Dictionary und Logik für die Ausführung von APEX-Anwendungen vor-
realisiert werden, das einzelne Seiten oder Seitenelemente aus- oder einblendet, je
gehalten werden.
nachdem, ob dem angemeldeten Benutzer eine Workspace-Gruppe zugeordnet wurde
(cid:2) Innerhalb von APEX wird ein Workspace angelegt, sagen wir mit dem Namen
oder nicht.
APEX_BUCH_WS. Bei der Anlage wird diesem Workspace der APEX-Benutzer, zum Bei-
spiel BUCH_ADMIN, als Administrator zugeordnet.
Exkurs: Eine Analogie zum Verständnis von Workspaces
(cid:2) Ebenfalls haben wir festgelegt, dass der Workspace Zugriff auf das Schema APEX_
Einen Workspace können Sie sich analog zu einem virtuellen Rechner vorstellen. Bei
BUCH erhalten soll.
der Virtualisierung von Rechnern wird auf einem physikalisch vorhandenen Rechner
eine Software installiert, mit deren Hilfe es möglich ist, virtuelle Rechner zu erstellen (cid:2) Der Workspace-Administrator BUCH_ADMIN meldet sich bei APEX beim Workspace
und zu verwalten. Beispiele für solche Software sind VMware, Citrix, VirtualBox und APEX_BUCH_WS an und erstellt den Benutzer BUCH_ENTWICKLER, dem er Entwicklungs-
andere. rechte zugesteht. Nun kann sich der Benutzer BUCH_ENTWICKLER am Workspace
APEX_BUCH_WS anmelden und beginnen, eine APEX-Anwendung zu erstellen.
Auf Ebene des physikalisch vorhandenen Rechners existieren Benutzer, die als Admi-
nistratoren diesen Rechner verwalten dürfen. In dieser Analogie wären diese Adminis- (cid:2) Dazu stehen ihm die APEX-Entwicklungsumgebung und alle Tabellendaten des
tratoren die »üblichen« Administratoren der Oracle-Datenbank. Der Virtualisierungs- Benutzers APEX_BUCH zur Verfügung. Welche Daten APEX_BUCH jedoch sehen darf,
software, die nun als Rahmen um die virtuellen Rechner ausgeführt wird, entspricht kann dadurch begrenzt sein, welche Tabellen dieser Benutzer anlegt und welche
in unserer Analogie die APEX-Software des APEX-Schemas. Demjenigen, der die Virtu- Daten er einfügt, alternativ aber auch dadurch, welche Rechte diesem Benutzer
alisierungssoftware bedient und neue virtuelle Maschinen anlegen darf, entspricht wiederum durch andere Schemata erteilt wurden. So können zu den eigenen
der APEX-Administrator. Daten eventuell auch einzelne Tabellen aus anderen Schemata oder auch anderen
Wird ein virtueller Rechner aufgesetzt, enthält dieser ein eigenes Betriebssystem Datenbanken hinzukommen.
und eigene Administratoren. Natürlich sind diese Administratoren mit weitreichen- (cid:2) Nachdem die APEX-Anwendung erstellt wurde, kann diese gestartet und durch die
den Rechten bezüglich der virtuellen Maschinen ausgestattet, jedoch haben sie kei-
beiden Benutzer BUCH_ADMIN und BUCH_ENTWICKLER verwendet werden.
nerlei Administrationsrecht zum Beispiel auf den physikalischen Rechner, sie können
(cid:2) Der Workspace-Administrator kann nun weitere Workspace-Benutzer erstellen,
auch keine weiteren virtuellen Maschinen anlegen und wissen sogar nicht einmal
die anschließend die erzeugte Anwendung verwenden können. Sind im Work-
davon, dass es weitere virtuelle Maschinen gibt (philosophisch wird es, wenn wir uns
space zudem Gruppen angelegt worden, könnten diese einzelnen Workspace-
klarmachen, dass sie nicht einmal wissen, dass sie selbst nur virtuell sind …). Das ist
Benutzern zugeordnet worden sein oder nicht und damit steuern, dass bestimmte
bei APEX genauso, eine virtuelle Maschine (ein Workspace) hat einen Workspace-
Administrator, dessen Rechte aber auf administrative Arbeiten innerhalb dieses Funktionalitäten der Anwendung für diesen Benutzer verfügbar sind oder nicht.
Workspaces beschränkt sind.
Wie Sie das alles konkret machen, besprechen wir, wenn wir eine eigene Anwendung
Nun wird es etwas schräg: Die Daten, auf die ein Workspace zugreifen darf, können wir erstellen. Hier soll es zunächst einmal ums große Ganze gehen.
uns als Netzwerklaufwerke vorstellen, die der virtuellen Maschine zugeteilt wurden.
Auf diesen Netzwerklaufwerken finden wir Dateien mit Daten, die wir verarbeiten dür-
2.2.3 APEX-Anwendung
fen. Welche Netzwerklaufwerke wir lesen oder sogar beschreiben dürfen, regeln nicht
wir, sondern der APEX-Administrator beim Einrichten des Workspaces, indem er diesem Eine APEX-Anwendung (ich werde im weiteren Verlauf nur noch von Anwendung spre-
Workspace den Zugriff auf verschiedene Schemata der Datenbank gestattet. Dort fin- chen) existiert also innerhalb eines Workspaces, der den Zugriff auf die Daten der
den sich die Daten für die Anwendungen, die innerhalb unseres Workspaces erstellt Datenbank kanalisiert und eine eigene Benutzerverwaltung implementiert. Eine sol-
werden, und dorthin speichern diese Anwendungen auch die Daten. che Anwendung besteht, wie bereits beschrieben, aus mehreren Anwendungsseiten,
auf denen die verschiedenen Funktionen der Anwendung implementiert werden.
Eine Anwendung ist in APEX ein Organisationsmittel, um fachlich zusammengehö-
60 61
4530.book Seite 62 Donnerstag, 7. September 2017 3:59 15 4530.book Seite 63 Donnerstag, 7. September 2017 3:59 15
2 Grundlagen von APEX 2.2 Überblick über APEX
rige Seiten zusammenzufassen. Dabei kann Ihre komplette Anwendung durchaus aus recht eingeschränkt, können aber für einige Anwendungszwecke sehr gut verwen-
mehreren Teilanwendungen aufgebaut werden. Wie wir später sehen werden, ist dies det werden.
2
in der Entwicklungsumgebung von APEX, die ja selbst auch eine APEX-Anwendung ist, (cid:2) »Normale« APEX-Anwendungen
geschehen, denn die Verwaltung des Workspaces erfolgt über eine andere Anwen- Diese Anwendungen sind es, um die es in diesem Buch hauptsächlich geht, denn
dung als die Erstellung einer Anwendung oder das Ausführen einer SQL-Anweisung. dieser Anwendungstyp ermöglicht es Ihnen, eine komplette Anwendung von
Dennoch bemerken Sie von all dem normalerweise nichts, die Anwendungen inte- Grund auf selbst zu erstellen und alle Möglichkeiten von APEX zu verwenden
grieren sich nahtlos. sowie eigene Erweiterungen hinzuzufügen.
Doch bietet es sich an, auch administrative Festlegungen auf der Ebene einer Anwen-
dung zu definieren. Zu diesen Festlegungen gehört unter anderem, welche optische
2.2.4 Seiten
Form die Anwendung hat. Diese optische Form wird als Sammlung von HTML-Tem-
Auf der nächsten Gliederungsebene finden sich unterhalb der Anwendung die
plates und zugehörigen CSS-Klassen in einem sogenannten Theme organisiert, das
Anwendungsseiten. Auch eine Anwendungsseite (oder einfach eine Seite) ist lediglich
einer Anwendung zugeordnet werden kann. Ein Theme bestimmt also zentral das
eine Zeile innerhalb des APEX Data Dictionary. Auf einer Seite platzieren Sie weitere
Erscheinungsbild unserer Anwendung. APEX liefert mehr als 20 verschiedene
Seitengliederungselemente, insbesondere Regionen, die ich im nächsten Abschnitt
Themes mit, obwohl meine Empfehlung auf ganz wenige, moderne Themes be-
besprechen werde, um das Aussehen der Seite zu gestalten und die Auswahl der
schränkt ist. Die älteren Themes spiegeln sowohl die Lernkurve der APEX-Entwickler
anzuzeigenden Daten zu steuern.
als auch die technische Entwicklung der letzten Jahre wider, in ihnen befinden sich
zum Beispiel Seitenlayouts, die komplett auf Tabellen aufbauen, was heute nicht Eine Seite ist eine wichtige Organisationsebene Ihres Anwendungscodes, denn auf
mehr so gern gesehen wird. Mittlerweile sind die modernen Themes ab 23 jedoch auf ihr wird definiert, welche Seitenelemente angezeigt werden sollen, welche Aktivitä-
div-Basis aufgebaut, extrem flexibel und HTML5-geeignet und zum Teil sogar so kon- ten zur Datengewinnung sowie -bearbeitung ausgeführt werden sollen und auf-
zipiert, dass Anwendungen mit diesen Themes auch auf mobilen Geräten angezeigt grund welcher Logik die nächste darzustellende Seite ermittelt werden soll. Im
werden können, ohne allzu hässlich zu werden. Die in einem Theme enthaltenen Vergleich zum Model-View-Control-Patter, das ich eingangs beschrieben habe, ist die
HTML-Templates werden dann durch die einzelnen Seitenelemente referenziert und Seite wohl am ehesten dem Control-Anteil zuzurechnen. Auch eine Seite als Ganzes
steuern dadurch, wie die konkrete Seite aufgebaut ist. Seit Version 5 von APEX wird referenziert ein Template des Themes und steuert so, wie sie dargestellt werden soll,
ein neues Theme mitgeliefert, das wir in diesem Buch als einziges verwenden wer- doch ist die Hauptaufgabe die Kontrolle des Anwendungsflusses.
den, denn es enthält viele neue und äußerst attraktive Funktionen, die in älteren
Themes schmerzlich vermisst wurden.
2.2.5 Regionen, Items und Schaltflächen
Zusätzlich zur Zuweisung eines Themes werden weitere generelle Einstellungen für
Gehen wir eine Stufe weiter, treffen wir auf einer Seite auf die Regionen. Eine Region
eine Anwendung festgelegt, wie zum Beispiel den Namen der Anwendung, das zu
ist optisch als umrahmter, grob rechteckiger Bereich auf einer Seite erkennbar,
verwendende Datumsformat und viele weitere Details.
obwohl das nicht immer so sein muss. Die verschiedenen Regionen können unter-
APEX bietet an, Anwendungen auf verschiedene Weise zu erzeugen. Zur Wahl stehen
schiedliche Typen besitzen. So könnte eine Region zum Beispiel ein Menü, aber auch
derzeit drei Wege:
ein SQL-Bericht in Form einer Tabelle oder ein Formular sein. APEX liefert eine große
(cid:2) Mitgelieferte Anwendungen Anzahl vorbereiteter Regionstypen mit, die zudem noch mit unzähligen Parametern
Diese Anwendungen sind APEX-Anwendungen, die vom APEX-Entwicklerteam auf Ihre konkreten Bedürfnisse hin angepasst werden können. Einige Regionen wer-
erstellt und mit APEX ausgeliefert werden. Sie können einfach installiert und bei den durch spezielle Seitentypen direkt angelegt und werden dann durch Seitenpro-
Bedarf auch verändert werden. zesse flankiert, die bereits so eingestellt sind, dass zum Beispiel die Verarbeitung von
(cid:2) Websheet-Anwendungen Benutzereingaben automatisiert in der Datenbank gespeichert werden können und
vieles mehr.
Hierbei handelt es sich um eine vorgefertigte APEX-Anwendung, die so generisch
ausgelegt ist, dass sie dem Endbenutzer erlaubt, eigene Anwendungen mit vorge- Abbildung 2.5 zeigt eine Seite einer Anwendung. Auf dieser Seite sehen Sie, durch
gebener Funktionalität zu erzeugen. Websheet-Anwendungen sind funktional Rahmen kenntlich gemacht, einige der angesprochenen Regionstypen in Aktion.
62 63
4530.book Seite 64 Donnerstag, 7. September 2017 3:59 15 4530.book Seite 65 Donnerstag, 7. September 2017 3:59 15
2 Grundlagen von APEX 2.2 Überblick über APEX
mente (Items) enthält, also Formularfelder für jede ausgewählte Spalte Ihres Formu-
lars. Abbildung 2.6 zeigt Ihnen ein Beispiel für ein solches Formular.
2
Abbildung 2.6 Beispiel eines Formulars
Beachten Sie in der Abbildung oben, dass die verschiedenen Datentypen der Spalten
bereits berücksichtigt wurden, als das Formular angelegt wurde: Ein Datumsfeld hat
einen Datepicker als Eingabefeld erhalten, eine BLOB-Spalte (siehe Feld Product Image)
Abbildung 2.5 Eine Seite einer Beispielanwendung mit Regionen hat ein Dateiupload-Control erhalten und so weiter. Mit einfachen Mitteln sind auch
dynamische Einblendmenüs möglich (wie im Beispiel das Feld Category, es reicht im
Viele Regionen werden durch Assistenten in der APEX-Entwicklungsumgebung an-
Regelfall, eine entsprechende SQL-Anweisung zu hinterlegen oder die Werte hän-
gelegt und benötigen lediglich eine Parametrierung, wie etwa die, auf welche Tabelle
disch einzutragen) und vieles mehr. Optional können Sie zu den Eingabefeldern
sie sich beziehen sollen oder auf welche Weise neue Primärschlüsselinformationen
Hilfstexte hinterlegen, kenntlich machen, ob die Eingabe in ein Feld verpflichtend ist
generiert werden sollen. Nachdem Sie einen solchen Assistenten ausgeführt haben,
oder nicht (was, wenn die Spalte einen not null-Constraint enthält, auch automatisch
werden alle benötigten Seitenelemente auf der Seite angelegt. Konkret könnten Sie
geschieht), weitere Validierungen festlegen etc.
eine Region vom Typ Form benötigen, um Tabellendaten in der Webanwendung zu
Zudem hat der Assistent für Sie die benötigten Schaltflächen angelegt. Wichtiger
bearbeiten. In einem Assistenten könnten Sie dann definieren, aus welcher Tabelle
noch: Alle Schaltflächen sind bereits aktiv, das heißt, es wurden dafür vorbereitete
die Daten stammen, welche Spalten Sie in das Formular aufnehmen möchten, welche
Programmteile hinterlegt, die beim Klick darauf aufgerufen werden und dafür sor-
Aktivitäten erlaubt werden sollen (Löschen, Ändern, Neu anlegen) und so weiter. Das
gen, dass die Daten korrekt in der Datenbank verarbeitet werden. Der Assistent legt
Ergebnis ist eine Region vom Typ Form, die bereits eine Reihe sogenannter Seitenele-
64 65
4530.book Seite 66 Donnerstag, 7. September 2017 3:59 15 4530.book Seite 67 Donnerstag, 7. September 2017 3:59 15
2 Grundlagen von APEX
in der Regel auch fest, auf welche Seite als nächstes, im Fall der erfolgreichen (oder Kapitel 3
auch der nicht erfolgreichen) Abarbeitung, verzweigt werden soll. Die Erstellung
einer solchen Formularseite nimmt im Regelfall weniger als 20 Minuten in Anspruch Eine Websheet-Anwendung erstellen
(wovon zwei oder drei auf die eigentliche Erstellung des Formulars gehen und die 3
restliche Zeit auf das Feintuning), so denn keine ungewöhnlichen Validierungen oder
Mit der Betrachtung der Websheets werden wir die erste APEX-
Datenbankaktivitäten vorgenommen werden müssen.
Anwendung erstellen. Der Fokus liegt darauf, zum einen ein Gefühl für
Jede Region, jedes Item und jede Schaltfläche ist wiederum mit HTML-Templates ver- diese Art Anwendungen und mögliche Einsatzbereiche zu schaffen
bunden, die steuern, wie die jeweilige Darstellung erfolgen soll. Jedem Element liegt und zum anderen das Look & Feel der Entwicklung von APEX-Anwen-
dabei eine Auswahl verschiedener Templates zugrunde, aus denen Sie die Darstel- dungen an einem einfachen Beispiel zu erfahren.
lung wählen können, ebenso, wie Sie eigene Templates entwickeln und Elementty-
pen zuordnen können. Ebenfalls können Sie jedem Element einen Verweis auf eine
benötigte Autorisierungsprüfung geben, die zum Beispiel kontrolliert, ob dem ange-
meldeten Benutzer das Recht, dieses Element zu nutzen, zugeordnet wurde oder
nicht. Im Beispiel oben könnte ein Benutzer eventuell das Recht zugestanden
Die Entwicklung eigener Anwendungen in APEX erfolgt normalerweise als Daten-
bekommen, den Preis eines Produktes zu editieren, während dies anderen Benutzern
bankanwendung, weil dieser Anwendungstyp Ihnen die volle Kontrolle über das Aus-
nicht möglich ist. In Abhängigkeit hiervon würde dann das Feld List Price entweder
sehen und das Verhalten der Anwendung bietet. Manchmal jedoch ist dieser Aufwand
in die Seite aufgenommen oder auch nicht. APEX sorgt dafür, dass nur autorisierte
für eine einfache, abteilungs- oder unternehmensweit zugängliche Sammlung simpel
Benutzer diese Elemente sehen können. Dies alles erfolgt einfach durch Auswahl von
strukturierter Daten übertrieben und durch den höheren Entwicklungsaufwand auch
Parametern und nur minimaler, zentral hinterlegter Programmierung.
zu unflexibel. Es wäre oftmals schön, wenn man eine Anwendung hätte, die Endan-
wender selbst dazu verwenden könnten, Daten zu sammeln und im Netzwerk zur
2.2.6 Zusammenfassung Verfügung zu stellen. Wenn dann noch die Möglichkeit der Suche in diesen Daten und
der einfachen Analyse vorhanden ist, umso besser. Websheet-Anwendungen leisten
APEX entlastet Sie als Entwickler also von den grundlegenden Problemen der HTTP-
genau das, erweitert um ein flexibles Benutzerverwaltungskonzept, eine rollenba-
und Datenbanksession-Verwaltung, organisiert die Transaktionen in der Datenbank,
sierte Benutzerrechteverwaltung und der Möglichkeit, eigene Datensammlungen zu
die Benutzerauthentifizierung und -autorisierung, kümmert sich um die unterschied-
erstellen, bestehende zu erweitern und zu bearbeiten sowie Seiten zu kommentieren
lichen Browserimplementierungen und automatisiert die Erstellung weitverbreiteter
und mit Tags oder Verweisen zu versehen.
Anwendungselemente. Anwendungen in APEX sind in Workspaces organisiert und
erlauben einen feingranularen Zugriff auf Daten der Datenbank. Durch die Work- APEX selbst positioniert Websheet-Anwendungen analog zu einem Wiki, hebt aber
spaces entsteht zudem die Möglichkeit, in einer Datenbank viele logisch unabhängige hervor, dass diese Anwendungen einen Vorteil beim Sammeln strukturierter Infor-
APEX-Anwendungen zu verwalten. Eine Anwendung ist zudem, aufgrund der Gestal- mationen bieten. Da die Daten durch den Endanwender eingefügt und bearbeitet
tung der Templates und Themes, internationalisierbar und weitgehend barrierefrei werden können, aber in einer zentralen Datenbank gespeichert werden, kombinie-
und kommt mit minimaler Programmierung aus. So weit, so gut, möchte man sagen, ren diese die Funktionalität von Spreadsheet-Anwendungen mit einem einfachen
zumal sich auch das Look & Feel angenehm und modern präsentiert. Wiki und lösen nebenbei das Problem des Zugriffs auf die Daten im Team und Fragen
Dass natürlich weitergehende Wünsche offenbleiben, liegt in der Natur der Sache. des Backup & Recovery. Eine interessante Alternative also zu einfachen Excel-
APEX ist aber durch eigene Programmierung auch beinahe beliebig erweiterbar. Dateien, die ansonsten im Unternehmen oder in den Abteilungen gepflegt, gespei-
Allerdings steigt mit diesen Möglichkeiten auch der Aufwand. Aus diesem Grund chert und ausgetauscht werden müssen. Denken Sie hierbei, als Beispiel, an techni-
beschäftigt sich der erste und zweite Teil dieses Buches zunächst mit dem, was ohne sche Dokumentationen, FAQ-Listen oder ähnliche Anwendungen.
Programmieraufwand machbar ist. Und das ist, wie wir sehen werden, bereits eine
ganze Menge!
66 67
4530.book Seite 68 Donnerstag, 7. September 2017 3:59 15 4530.book Seite 69 Donnerstag, 7. September 2017 3:59 15
3 Eine Websheet-Anwendung erstellen 3.1 Übersicht über Websheet-Anwendungen
3.1 Übersicht über Websheet-Anwendungen Menüleiste (Menubar)
Jede Seite verfügt über ein vorgegebenes Menü zur Navigation in der Websheet-
Eine Websheet-Anwendung wird durch einen berechtigten Benutzer eines Work-
Anwendung. Zur Navigation zwischen den Seiten werden in diesem Menü alle ange-
spaces erstellt. Im Gegensatz zu Datenbankanwendungen werden die Daten einer 3
legten Seiten in ihrer hierarchischen Struktur dargestellt, es sind aber auch übergrei-
Websheet-Anwendung nicht (vorrangig) im Datenbankschema des zugehörigen
fende Funktionen zur Erweiterung, Suche etc. in der Websheet-Anwendung möglich.
Workspace-Schemas zur Verfügung gestellt, sondern im Rahmen der Bedienung
Welche Optionen Ihnen hier angeboten werden, hängt von den Benutzerrechten des
einer Websheet-Anwendung über die Oberfläche importiert. Dieser Import erfolgt
angemeldeten Benutzers ab.
mittels Copy & Paste aus Tabellenkalkulationen oder CSV-Dateien, kann aber auch
komplett mithilfe der Anwendung erfasst werden. Einen Zugriff auf Tabellen des
Websheet-Suche (Websheet Search)
Workspace-Schemas haben Sie in einer Websheet-Anwendung nur, wenn Sie dies für
das Websheet gestatten. Die importierten oder lokal erfassten Daten werden in soge- Da die Daten einer Websheet-Anwendung in einer bekannten Tabellenstruktur ge-
nannten Datenrastern zur Verfügung gestellt. speichert werden, können die dort gespeicherten Daten über eine zentrale Suchfunk-
tion durchsucht werden. Die Suche erstreckt sich darüber hinaus aber auch auf Tags,
Datenraster und Metadaten der Anwendung.
3.1.1 Bedienung einer Websheet-Anwendung
Eine Websheet-Anwendung stellt Seiten und Datenraster zur Verfügung. Während Präsentationsmodus
die Datenraster die Daten bereitstellen, übernehmen Seiten die Gliederung und
Die Anwendung kann, ohne Menüs und andere störende Seitenelemente, auch in
Bedienung der Anwendung. Abbildung 3.1 zeigt die relevanten Bedienelemente einer
einer Art »Kioskmodus« betrieben werden.
Websheet-Seite bzw. der auf ihr platzierten Abschnitte.
Abschnitte reduzieren (Section Collapse)
Jeder Abschnitt auf einer Seite kann aus- und eingeklappt werden, um größere Da-
tenmengen übersichtlich zu verwalten.
Bearbeiten (Edit Section-Verweis)
Eine Wiki-artige Editierungsfunktion, die an ein Rollenkonzept gebunden ist, erlaubt
dem Anwender, die Informationen eines Abschnitts beliebig zu bearbeiten. Ände-
rungen an Abschnitten stehen allen Anwendern sofort zur Verfügung, im Hinter-
grund wird eine Historie aller Änderungen gepflegt.
Systemsteuerung (Websheet Control Panel)
Zur Bearbeitung bzw. Erweiterung der Websheet-Anwendung stellt jede Seite ein
Menü mit entsprechenden Funktionen zur Verfügung. Auch die Systemsteuerung ist
an ein Rollenkonzept gebunden.
Seiteninformation (Page Information)
Jede Seite stellt statistische Daten dar, die Auskunft über das Erstell- bzw. Änderungs-
datum und andere Informationen geben.
Abbildung 3.1 Bedienelemente einer Websheet-Seite (Quelle: Oracle)
68 69
4530.book Seite 70 Donnerstag, 7. September 2017 3:59 15 4530.book Seite 71 Donnerstag, 7. September 2017 3:59 15
3 Eine Websheet-Anwendung erstellen 3.3 Websheet-Eigenschaften
Ansichtsmodus (Presentation Mode) auf die Schaltfläche Erstellen. Eventuell kann es bei dieser Aktion zu Fehlermeldun-
Jede Websheet-Anwendung ist in einem Standard-, Screenreader- und High Contrast- gen kommen, wenn Ihnen Rechte fehlen, die für die Installation der Objekte benötigt
Modus verfügbar, um einer weiten Anwendergruppe den Zugang zu den Informatio- werden. Fragen Sie in diesen Fällen Ihren Datenbankadministrator. Sind Sie selbst
nen zu ermöglichen. dieser Administrator, gewähren Sie dem Workspace-Schema die entsprechenden 3
Rechte. Hat alles funktioniert, wird dies durch eine Erfolgsmeldung bestätigt, und Sie
können nun die Websheet-Anwendung installieren oder auch selbst eine neue
Anmerkungen (Annotations)
Anwendung erstellen. Um die Anwendung »AnyCo IT Department« zu installieren,
Einer Seite können Dateien, Tags oder Hinweise (Bemerkungen) hinzugefügt werden,
müssen Sie diese auswählen und installieren. Nun sollte alles funktionieren, und
um Informationen zu kategorisieren und dadurch leichter durchsuchbar zu machen
nach Bestätigen der entsprechenden Meldungen können Sie die Anwendung im
oder weitere Informationen anzuhängen.
Bestätigungsbildschirm direkt starten. Sie werden aufgefordert, sich anzumelden.
Verwenden Sie hierfür Ihren APEX-Account, mit dem Sie sich auch bei APEX ange-
meldet haben.
3.2 Mitgelieferte Websheet-Anwendungen
Gerade die Anwendung »AnyCo IT Department« gibt Ihnen einen recht ansprechen-
APEX liefert zwei Websheet-Anwendungen mit: <Mitgelieferte Anwendungen> (cid:2) den Einblick in die Funktionalität, die mit einem Websheet erreicht werden kann.
AnyCo IT Department und Big Cats. Sie installieren die mitgelieferten Anwendungen, Schaffen Sie sich einen Überblick über die Navigation durch die Anwendung und die
indem Sie auf das Icon der Anwendung und anschließend auf die Schaltfläche Mit- verwendeten Seitenelemente. Testen Sie die Funktionalität, indem Sie die in Ab-
gelieferte Anwendung installieren klicken. Sollte noch keine Websheet-An- schnitt 3.1.1 beschriebenen Bedienmöglichkeiten anwenden. Anschließend können
wendung in Ihrem Workspace installiert worden sein, wird APEX vor der Installation Sie sich einen Überblick über die Technik, mit der die einzelnen Abschnitte erzeugt
mitteilen, dass einige Tabellen installiert werden müssen, in denen anschließend die wurden, verschaffen, indem Sie die Schaltfläche Edit der einzelnen Abschnitte an-
Websheet-Anwendung installiert wird, wie in Abbildung 3.2 gezeigt. klicken und sich mit den Metadaten vertraut machen. Die Syntax der Verweise auf
Datenraster bzw. Berichte werden wir noch näher besprechen, wenn wir uns die Er-
stellung einer eigenen Websheet-Anwendung näher ansehen.
3.3 Websheet-Eigenschaften
Die Editierungsseite einer Websheet-Anwendung ist sozusagen ein Extrakt der
Kernfunktionalität von APEX bezüglich der Verwaltung von Anwendungen. Ähnli-
che, wenn auch weiter gehende Möglichkeiten finden Sie in jeder APEX-Daten-
bankanwendung. Die Optionen, die Sie hier einstellen können, lassen sich auch aus
der laufenden Websheet-Anwendung heraus aufrufen, wenn Sie als Administrator
angemeldet sind und das Anwendungsmenü Administration (cid:2) Websheet-Eigen-
Abbildung 3.2 Installation der Websheet-Tabellen beim ersten Installieren schaften wählen. Sie sehen eine Anwendungsseite mit mehreren Sektionen darauf,
die Sie durch einen Klick auf das Pfeilsymbol Verweis der Regionsüberschriften
Diesen Dialog können Sie bestätigen und die Objekte installieren lassen. Hierzu führt auf- und zuklappen können.
Sie APEX zu einer administrativen Seite, in der Sie den Verweis Websheet-Daten-
bankobjekte erstellen angeboten bekommen. Klicken Sie auf diesen Verweis.
3.3.1 Websheet
Nun öffnet sich eine weitere Anwendungsseite, in der Ihnen eine Liste von Tabellen-
namen (und eine Sequenz) angezeigt werden, die nun installiert werden sollen. Kli- Im ersten Seitenbereich finden sich allgemeine Angaben zum Websheet, wie der
cken Sie auf die Schaltfläche Weiter > und auf der Bestätigungsseite, die nun folgt, Name, der Anwendungsstatus, die Startseite, das Standarddatumsformat etc. Das
70 71