Fortsetzung des Tutorials.
In diesem Teil werden die Prozesse zum Erstellen einer Oracle APEX-Anwendung und zum Erstellen von Seiten in der Anwendung beschrieben.
Vorheriger Teil: Oracle Application Express-Lernprogramm. IDE-Übersicht
Inhaltsverzeichnis
Anwendungserstellung
Standardseiten
Anwendungsstart
Seitenerstellung
Hauptseitenkomponenten
Visuelle Elemente
Nicht visuelle Elemente
Grundlegende Eigenschaften von Elementen
Allgemeine Eigenschaften
Seiteneigenschaften
Anwendungserstellung
Um eine Anwendung zu erstellen, müssen Sie zum App Builder gehen und auf die Schaltfläche "Erstellen" klicken.
Historischer Hintergrund zu AnwendungstypenIn früheren Versionen des Apex schlug der Assistent im ersten Schritt die Auswahl des Anwendungstyps vor (in den Versionen 4.x waren dies die Typen "Datenbankanwendung" und "Websheet-Anwendung", in den Versionen 5.x - "Desktop", "Mobil", wenn der Speicher mir gute Dienste leistet "," Websheet "und" Packaged Application "), in der aktuellen Version werden alle anderen Typen ein wenig zur Seite geschoben (obwohl das" Websheet "erhalten bleibt), und Sie müssen nur" New Application "auswählen. Und "Packaged Application" - dies sind die gleichen Demo-Anwendungen aus der App Gallery .
Als Nächstes wird der Assistent zur Anwendungserstellung gestartet. Im ersten Schritt müssen Sie "Neue Anwendung" auswählen, im zweiten - füllen Sie einfach die Felder "Name" und die Anwendungs-ID (Anwendungsnummer) aus. Der Name wird nur benötigt, weil es sich um ein Pflichtfeld handelt, und die Application ID
- weil es dann nicht möglich ist, ihn zu ändern. Genauer gesagt ist es möglich (durch Export / Import), aber es ist lang und unpraktisch, es ist besser, sofort die gewünschte Nummer einzustellen, wenn der automatisch generierte Apex nicht zu Ihnen passt. Die Nummer muss eindeutig sein. Diese Nummer wird als Teil der Anwendungsadresse verwendet. Schauen wir uns eine typische Apex-URL an:
https://apex.oracle.com/pls/apex/f?p=123456:1:14675052744498:::::
Hier ist 123456
die Anwendungs-ID.
Für die restlichen Felder im Assistenten können Sie bisher nicht aufpassen, alle diese Einstellungen können später geändert werden.
Danach müssen Sie auf "Anwendung erstellen" klicken. Der Apex erstellt die Anwendung und verschiebt Sie automatisch zur Anwendungsseite, auf der Sie sehen werden
Standardseiten
Standardmäßig erstellt Apex 3 Seiten in der Anwendung. Seiten haben wie Anwendungen eine Nummer und einen Titel. Die Nummer wird in der URL auf die gleiche Weise verwendet, um die Seite zu identifizieren. Sie folgt unmittelbar der Anwendungsnummer und wird durch einen Doppelpunkt getrennt. Das heißt, das Format ist wie folgt:
https://apex.oracle.com/pls/apex/f?p=APPLICATION_ID:PAGE_ID:< url>
Die erstellten Standardseiten sind:
- Globale Seite (Seiten-ID: 0)
Dies ist eine spezielle Seite, die nicht unabhängig verwendet wird, sondern zu der Sie ein Element hinzufügen können, wenn es auf allen Seiten angezeigt werden soll. Homepage (Seiten-ID: 1)
Dies ist die Startseite der Anwendung. Sie werden standardmäßig darauf zugreifen, nachdem Sie den Benutzernamen und das Kennwort in die Anwendung eingegeben haben oder wenn Sie die URL Ihrer Anwendung angeben, ohne eine Seite und alles andere anzugeben, dh wie folgt:
https://apex.oracle.com/pls/apex/f?p=123456
- Anmeldeseite (Seiten-ID: 9999, in den Versionen 4.x, 5.x war 101)
Dies ist offensichtlich die Anmeldeseite. Es enthält Felder für die Eingabe eines Logins und eines Passworts für einige Zeit (ich kann die Version nicht benennen, aber erst vor relativ kurzer Zeit) - ein Kontrollkästchen "Benutzername speichern" und eine Schaltfläche "Anmelden".
Anwendungen und Seiten haben auch die nützliche Alias
Eigenschaft. Für eine Anwendung wird diese Eigenschaft in den Anwendungseigenschaften ("Anwendungseigenschaften" → "Definition" → "Name" → "Anwendungsalias") und für eine Seite im Seiteneditor im Eigenschaftenfenster rechts konfiguriert. Alias
kann in der Seiten-URL anstelle der Nummer verwendet werden. Die Standardanmeldeseite wird mit dem LOGIN_DESKTOP
LOGIN_DESKTOP und die Startseite mit dem Alias HOME
. Wenn Sie den Anwendungsalias MY_APP
, können Sie zur Anmeldeseite unter gehen
https://apex.oracle.com/pls/apex/f?p=MY_APP:LOGIN_DESKTOP
#define true false (oder ich weiß, was du gedacht hast)Was passiert, wenn die Anwendung 123 zum Alias 456 und die Anwendung 456 zum Alias 123 wird? Es wird nichts geben, der Scheitelpunkt wird nicht zulassen, dass solche Aliase für Anwendungen verwendet werden. Dies ist in der Hilfe nicht eindeutig angegeben, aber der Anwendungsalias scheint den Regeln für Bezeichnernamen in PL / SQL zu unterliegen.
Was passiert, wenn Seite 123 Alias 456 und Seite 456 Alias 123 ist? Es wird nichts geben, Sie können Seiten solche Aliase geben, aber sie werden ignoriert. 123
in der URL öffnet Seite 123.
Anwendungsstart
Nachdem die Anwendung erstellt wurde, kann sie bereits "gestartet" werden (es gibt noch nichts zu sehen). Dies ist nicht genau das Gleiche wie das Starten einer regulären Anwendung (wie unter Windows oder Linux). Die Apex-Anwendung wird von derselben Engine wie die IDE selbst gerendert. Sobald Sie die Anwendung erstellen, ist sie sofort einsatzbereit und jeder, der ihre Adresse in die Adressleiste eingibt, kann damit arbeiten. Der Start der Anwendung selbst ist in der Tat ein solcher Name zum Öffnen der Startseite (die mit der Nummer 1). Sie können die Anwendung auf verschiedene Arten starten:
- Im App Builder in der Liste der Anwendungen befindet sich eine Spalte "Ausführen" mit einer Schaltfläche gegenüber jeder Anwendung.
- Auf der Anwendungsseite befindet sich eine große Schaltfläche "Anwendung ausführen".
- Sie können nicht nur die Anwendung "starten", sondern auch jede Seite ohne Dialog (Dialoge können nur von normalen Seiten aufgerufen werden): In der Liste der Anwendungsseiten befindet sich auch eine Spalte mit der Schaltfläche "Ausführen".
- Sie können die aktuelle Seite im Seiteneditor starten, indem Sie auf die Schaltfläche in der oberen rechten Ecke klicken.
- und schließlich können Sie die Seite starten, wenn sich in der oberen rechten Ecke solche Schaltflächen befinden:

Diese beiden Schaltflächen befinden sich in fast jedem Abschnitt der IDE. Die linke enthält die Nummer der letzten Seite, die Sie im Seiteneditor geöffnet haben. Wenn Sie darauf klicken, werden Sie mit der Bearbeitung dieser Seite fortfahren. Wenn Sie auf die rechte Schaltfläche klicken, wird diese Seite gestartet.
Was wird nach dem Start passieren? Wenn die gestartete Seite nur eingeschränkten Zugriff hat, wird der Benutzer zuerst zur Anmeldeseite weitergeleitet. Wenn der Benutzer bereits angemeldet ist oder die Einstellungsseite als öffentlich markiert ist, wird diese Seite geöffnet.
Standardmäßig wird die Seite mit eingeschränktem Zugriff erstellt. Es gibt zwei mögliche Einstellungen in den Seiteneigenschaften ( Seiteneditor - rechtes Feld - Eigenschaftengruppe "Sicherheit" - "Authentifizierung"):
Page Requires Authentication
: Die Seite steht nur angemeldeten Benutzern während der Sitzung zur Verfügung.Page is Public
: Eine öffentliche Seite, die für registrierte und nicht registrierte Benutzer sichtbar ist.
Seitenerstellung
Sie können eine Seite auf der Anwendungsseite erstellen. Klicken Sie auf "Erstellen", und der Assistent zum Erstellen von Seiten wird gestartet. Schritte des Assistenten:
- Auswählen eines Seitentyps aus (derzeit) 12 Typen, von denen einige auch Untertypen haben (falls vorhanden, wird im nächsten Schritt angezeigt). Der erste Typ aus der Liste ist die "leere Seite", dh eine leere Seite ohne alles. Die verbleibenden Typen sind gängige Seitenoptionen für die Arbeit mit der Datenbank: Berichte, Eingabeformulare, Diagramme usw. Hier werde ich den Prozess des Erstellens einer leeren Seite beschreiben, und die verbleibenden Typen haben einen separaten Artikel.
- Geben Sie die Seitenzahl und den Titel ein. Ich habe oben über Zahlen gesprochen. Die Nummer wird in diesem Schritt festgelegt und kann dann nicht mehr geändert werden. Achten Sie daher genau darauf. Manchmal teilen Entwickler Seiten in Gruppen ein (zum Beispiel für funktionale Zwecke) und reservieren einen Zahlenbereich für jede Gruppe. Wenn Sie dies also in Ihrem Projekt verwenden, seien Sie vorsichtig. Sie müssen sofort den Seitentyp auswählen: normaler, modaler Dialog, modellloser Dialog.
- Passen Sie die Navigationselemente an. Sie können überspringen (auf "Weiter" klicken) und später konfigurieren (obwohl es praktisch ist, sofort alles in diesem Schritt einzustellen und kein Dampfbad mehr zu nehmen, wenn Sie bereits ein Navigationssystem eingebaut haben).
- Bestätigung der Schöpfung.
Danach wird die Seite erstellt und ist einsatzbereit.
Hauptseitenkomponenten
Visuelle Elemente
Visuelle Elemente sind Elemente, die irgendwie auf dem Bildschirm angezeigt werden. Das:
- Hauptmenü. Es enthält den Anwendungsnamen, das Logo, den Benutzernamen und den Link "Abmelden" (wenn der Benutzer angemeldet ist). Dort können Sie weitere Elemente hinzufügen.
- Navigationsmenü links. Es kann zum Navigieren in der Anwendung verwendet werden, um beispielsweise eine hierarchische Struktur der Anwendungsabschnitte zu erstellen.
- Regionen (normalerweise auf Russisch werden sie „Regionen“ genannt): Container mit Elementen. Kann Berichte, Grafiken, Eingabefelder, Schaltflächen und andere Regionen enthalten.
- Elemente (es gibt keine gut etablierte Übersetzung ins Russische, sie sagen, wer was ist, sie verwenden normalerweise die Wörter Element, Feld und oft nur ein Element): Dies sind verschiedene Felder für Benutzereingaben;
- Knöpfe (Knöpfe): Nun, das sind gewöhnliche Knöpfe, kurz gesagt, was kann ich noch sagen;)
- Berichte: Tabellen mit Daten basierend auf SQL-Abfragen;
- Grafiken / Diagramme: Grafische Anzeige von Informationen aus der Datenbank, auch basierend auf SQL-Abfragen.
Berichte und Grafiken können als Sorten von Regionen betrachtet werden (technisch gesehen sind sie es), aber gleichzeitig sind sie ziemlich unabhängige Einheiten mit ihrem eigenen Verhalten, ihren eigenen Eigenschaften und anderen.
Nicht visuelle Elemente
Dies sind Elemente, um die Logik der Anwendung sicherzustellen. Es gibt tatsächlich eine Vielzahl von Elementen, obwohl der Benutzer sie buchstäblich nicht sieht. Die Haupttypen sind:
- Prozess: In der Regel wird PL / SQL-Code auf dem Server als Reaktion auf eine Benutzeraktion ausgeführt.
- Validierung: Eine Art von Prozess zum Validieren von Benutzereingaben.
- Dynamische Aktion (es gibt keine etablierte Übersetzung, normalerweise schreibt sie jeder - Dynamische Aktion oder nur DA, und wenn Sie zu faul sind, um das Layout zu ändern, kann der Sprecher eine Aktion schreiben oder JA): Der vom Browser ausgeführte Vorgang. Letztendlich ist DA ein Handler für ein Javascript-Ereignis. Javascript zu kennen ist optional, aber wenn Sie es wissen (und gleichzeitig CSS-Selektoren), können Sie Wunder vollbringen.
- Zweige (keine etablierte Übersetzung): Leitet abhängig von bestimmten Bedingungen auf andere Seiten weiter.
Grundlegende Eigenschaften von Elementen
Allgemeine Eigenschaften
Die Hauptgruppen von Eigenschaften, die für jeden (oder fast jeden) Elementtyp charakteristisch sind. Sie können im Seiteneditor angezeigt und bearbeitet werden. Hier werde ich kurz ihren Zweck beschreiben (damit Sie wissen, wonach Sie suchen müssen), und ich werde in anderen Artikeln ausführlicher darauf eingehen.
Identification
: Legt den Namen des Elements und zusätzliche Eigenschaften fest (je nach Typ).Appearance
: Eigenschaften, die für das Aussehen des visuellen Elements verantwortlich sind. Für jeden Elementtyp gibt es eine Reihe von Vorlagen, von denen Sie hier eine auswählen können ( Template
Eigenschaft). Außerdem verfügen Vorlagen über zusätzliche Einstellungen ( Template Options
- durch Klicken auf die Schaltfläche wird ein Fenster mit Einstellungen geöffnet).Layout
: Passen Sie die Position des visuellen Elements auf der Seite an. Die Elemente sind in einem Raster von 12 Spalten angeordnet. Hier können Sie festlegen, wie sie angeordnet werden sollen.Source
: für Regionen und Elemente - eine Datenquelle zur Anzeige, für Prozesse - ein Prozesscode;Server-side Condition
: Eine auf dem Server überprüfte Bedingung (es gibt eine große Auswahl an Bedingungen, von einfachen Bedingungen wie solchen und solchen Elementen mit solchen und solchen Werten bis hin zu beliebigen PL / SQL-Codes). Das Element wird auf der Seite angezeigt, wenn diese Bedingung erfüllt ist, und wenn nicht, wird dies nicht der Fall sein. Darüber hinaus wird es nicht versteckt, sondern einfach nicht gerendert;Client-side Condition
(für Dynamic Action
): Eine auf dem Client überprüfte Bedingung (ohne Zugriff auf den Server). DA ist erfüllt, wenn die Bedingung erfüllt ist;Read only
: Es funktioniert genauso wie die Server-side Condition
, nur dass nicht das Vorhandensein / Fehlen eines Elements gesteuert wird, sondern die Möglichkeit, den Wert zu ändern. Diese Eigenschaft gilt für Elemente, Regionen und Seiten. Für ein Element gilt es für das Element selbst und für Regionen / Seiten für alle Elemente innerhalb der entsprechenden Region / Seite.Security
: Kontrollieren Sie den Zugriff auf das Objekt. Im Prinzip kann alles mit der Server-side Condition
, es ist jedoch besser zu unterscheiden zwischen: Server-side Condition
- für Anwendungslogik, Security
- für die Anzeige in Abhängigkeit von den Zugriffsrechten.Configuration
: Zum Aktivieren / Deaktivieren der Build Option
. Eine sehr offensichtliche Sache, aber sehr nützlich: Sie können einzelne Funktionen der Anwendung aktivieren oder deaktivieren. Dies ist sehr praktisch, wenn Sie Funktionen für mehrere verschiedene Versionen parallel entwickeln.Comments
: Kommentare für andere Entwickler;Help
(für visuelle Elemente): Hilfe für Endbenutzer der Anwendung.
Seiteneigenschaften
Seitenspezifische Eigenschaften:
Navigation
: In dieser Gruppe gibt es zwei Eigenschaften. Cursor Focus
gibt an, ob der Fokus unmittelbar nach dem Laden auf das Eingabefeld auf der Seite übertragen werden soll (Optionen - entweder nicht übertragen oder auf das erste Feld auf der Seite übertragen). Warn on Unsaved Changes
Benutzer die Seite verlässt, wenn nicht gespeicherte Daten vorhanden sind.JavaScript
: Ermöglicht das Hinzufügen von JavaScript-Code zur Seite. Sie können den Pfad zur Datei angeben oder Ihren Code direkt zur Seite hinzufügen.CSS
: Gleiches gilt für CSS. Fügen Sie eine Datei hinzu oder fügen Sie sie der Seite hinzu, wenn Sie nur für diese Seite eine lokale CSS-Einstellung benötigen.Advanced
: Mit dieser Option können Sie den Schutz gegen erneutes Senden des Formulars aktivieren oder deaktivieren.