Ebus-J-Programme
bestehen aus Indexdateien, Masken, Reports
und Makros.
Die
Indexdateien dienen der Speicherung der Daten. Auch bei großen Datenmengen kann
über frei definierbare Schlüssel sehr schnell auf alle Datensätze einer
Indexdatei zugegriffen werden. In den Masken und Reports und in den Makros
werden die Indexdateien verwendet. Deshalb müssen die Indexdateien eines
Programms als erstes erfasst werden.
Danach werden
die Masken und Reports des Programms erstellt. Masken bestehen im Wesentlichen
aus Maskenfeldern (Controls), die die Erfassung und Anzeige von Daten
ermöglichen. Bei jedem Maskenfeld kann ein Makro vorher und/oder Makro
nachher festgelegt werden. Der Makro vorher wird
ausgeführt, wenn das Feld angesprungen wird. Der Makro nachher
wird nach der Dateneingabe ausgeführt. Ein Makro ist ein Programmteil, der in
der Programmiersprache von Ebus-J geschrieben ist.
Mit Hilfe der
Reports können komfortabel Drucklisten erzeugt werden.
Jeder Makro
wird über einen Namen (Makroname) angesprochen. Auf den Masken und Reports werden
die Namen der verwendeten Makros angegeben. Die Erfassung der Makros kann auf
den Masken und Reports sofort (Tasten F8, F9, F10) oder später über den
Menuepunkt Datei/Öffnen/Makro erfolgen.
Im Folgenden wird
anhand eines kleinen Beispiels erklärt, wie ein Programm in Ebus-J erstellt
wird.
Es soll ein
Programm erzeugt werden, das Bilddateien anzeigt und die angezeigten Bilder in
einer Indexdatei protokolliert.
Zuerst wird die
Beschreibung der Indexdatei PROTOKOLL erfasst. Dazu wird der Menuepunkt Datei/Öffnen/Indexdatei
(Alt/I) ausgewählt.
Es werden 4
Felder erfasst: USERNAME$, DATUM und UHRZEIT$ protokollieren, von wem und wann
das Bild angezeigt wurde. In DATEINAME$ wird der Name der angezeigten Bilddatei gespeichert.

Der Primärkey muss eindeutig sein, deshalb wird als Primärkey USERNAME$, DATUM und UHRZEIT$ festgelegt.

Wir definieren
einen Sekundärkey, um alle Datensätze unabhängig von USERNAME$ nach Datum und Uhrzeit
sortiert anzeigen zu können.

Als nächstes
wird das Programm erfasst. Dazu wird der Menuepunkt Datei/Öffnen/Programm
(Alt/P) ausgewählt.
Als Programmname
wird PROG1 angegeben. Anschließend wird eine neue Maske erzeugt durch Klicken
auf den Eintrag neue Maske:
Als Maskennummer
wird 10 angegeben, als Maskenüberschrift wählen wir "Bild
anzeigen", die restlichen Felder können leer bleiben.

Durch Drücken des Buttons "OK" gelangen wir in den Maskeneditor.

In der Iconleiste werden die Symbole der möglichen Maskenfelder angezeigt. Durch Drücken eines Icons wird die entsprechende Maskenfeldart ausgewählt. Durch Ziehen mit der Maus kann das Maskenfeld erzeugt werden.
Texte können auch durch das Tippen von Text erzeugt
werden. An der Cursorposition
wird dabei automatisch ein Textfeld erzeugt.
Die Cursorposition kann durch einen linken Mausklick oder durch
Strg/<←>, Strg/<→>, Strg/<↑>,
Strg/<↓> verschoben werden.
Als erstes
erzeugen wird ein Textfeld, indem wir den Text "Bilddatei" eintippen.

Hinter dem Text benötigen wir ein alphanumerisches
Maskenfeld für die Eingabe des Dateinamens. Dazu klicken wird das Icon "abc" an und erzeugen dann das Feld
durch Ziehen mit der Maus.

Hinter dem Eingabefeld erzeugen wir einen Button, über den der Dateidialog zur Auswahl eines Datei aufgerufen werden soll. Dazu klicken wir das 2. Icon an und erzeugen den Button wieder durch Ziehen mit der Maus.

Wir erzeugen zwei weitere numerische Maskenfelde (Icon "123"), die die Position (Zeile und
Spalte) festlegen, an der das Bild angezeigt werden soll.
Dahinter wird
ein weiterer Button erzeugt, der das Anzeigen des Bildes ausführt.

Jetzt müssen noch die Attribute der Maskenfelder
geändert werden. Mit Hilfe der Tab-Taste <®|>
wird das erste bzw. das nächste Feld markiert. Durch Drücken von <RETURN>
oder durch einen Doppelklick auf das Maskenfeld werden die Attribute des
Maskenfeldes angezeigt. Wird ändern zunächst das Feld "abc". Als Feldname ist DUMMY_ALPHAFIELD$
eingetragen. Wir ändern das in DATEINAME$. In den Makros, die wir später
erfassen, enthält die Variable DATEINAME$ den Inhalt des Maskenfeldes. Außerdem
ändern wird Anzahl Eingabezeichen auf 128, damit auch längere
Dateinamen in dem Maskenfeld Platz haben.

Durch Drücken des Buttons "F12 = Speichern" werden die Attribute
gespeichert. Es erscheint noch die Meldung, dass der Formatstring angepasst
wird, da die Anzahl der Eingabezeichen geändert haben.

Bei dem ersten
Button tragen wir als Text "Durchsuchen" ein.

Durch Drücken des Buttons "weitere Feldattribute" kann ein Standardbild
für den Button ausgewählt werden.

Bei den beiden
numerischen Feldern hinter Zeile und Spalte ersetzen wird den Feldnamen
DUMMY_NUMFIELD durch ZEILE bzw. SPALTE und Anzahl Eingabezeichen
setzen wir auf 2.

Bei dem zweiten
Button tragen wir als Text "Bild laden" ein.

Die Maske sieht dann folgendermaßen aus:

Die Maske ist jetzt erfasst. Allerdings fehlt noch die Verarbeitung, wenn einer der beiden Buttons gedrückt wird.
Durch einen
Doppelklick auf den Button "Durchsuchen" wird wieder die
Attributmaske angezeigt. Bei Makro nachher tragen wir ein:
PROG1.DURCHSUCHEN.
Der Makro
PROG1.DURCHSUCHEN wird ausgeführt wenn der Button "Durchsuchen"
gedrückt wird.

Den Makro PROG1.DURCHSUCHEN können wir sofort erfassen, indem wir die Taste F9 drücken. Es öffnet sich das Editorfenster, in dem der Makro erstellt werden kann.

Wir wollen den Dateidialog zur Auswahl einer Bilddatei aufrufen. Das erledigt der Befehl FILEDIALOG. Mit F4 können alle Befehle und Variablen der Programmiersprache von Ebus-J angezeigt werden. Durch Tippen der Anfangsbuchstaben wird in dem Auswahlfenster automatisch auf den entsprechenden Befehl positioniert.

Durch <RETURN> oder einen Mausklick wird der Befehl ausgewählt. Es erscheint ein Fenster, in dem die Parameter des Befehls angegeben werden können. Parameter in eckigen Klammern [ ] sind optional.

Überschrift legt die Überschrift des Dateidialogs fest.
Filter legt fest, welche Dateien ausgewählt werden
können. Wir lassen nur gif-, png- und jpg-Dateien zu.
Bei Default-Verzeichnis,
Default-Dateiname und Default-Erweiterung wird der Leerstring
angegeben.
Mit Shift/F10
kann die vollständige Beschreibung des Befehls FILEDIALOG
angezeigt werden.
Durch Drücken
des Buttons "OK" wird der Befehl in das Editorfenster
übernommen.

Nach
der Beendigung des Dateidialogs enthält die Variable EBUS_DATA den Status und die Variable EBUS_DATA$ den ausgewählten Dateinamen.
Nur
wenn EBUS_DATA = 1 ist, wurde ein Dateiname ausgewählt. In diesem Fall müssen
wir unserer Maskenfeldvariablen DATEINAME$ den ausgewählten Dateinamen zuweisen
und den neuen Inhalt des Maskenfeldes mit der Anweisung DISPLAY anzeigen.

Damit ist der
Makro bereits erfasst und kann mit F12 gespeichert werden. Wir befinden uns
wieder auf der Attributmaske des Buttons und speichern die Attribute ebenfalls
mit F12.
Als nächstes
erstellen wird den Makro zur Anzeige des Bildes. Dazu klicken wir doppelt auf
den Button "Bild anzeigen". Bei Makro nachher tragen wir
PROG1.BILD.ANZEIGEN ein und rufen mit F9 wieder den Editor auf.
Als erstes
müssen wir prüfen, ob ein Dateiname angegeben wurde:
IF ISSPACE(DATEINAME$)
THEN ERRORMES =
"Dateiname fehlt."
GOTO #10.#DATEINAME$
ENDIF
Die Anweisung ERRORMES zeigt die Fehlermeldung in einem Fenster an.
GOTO #10.#DATEINAME$
verlässt den Makro und springt zum Feld DATEINAME$.
Zum Anzeigen des Bildes verwenden wir die Funktion LOAD_PICTURE. Da Funktionen einen Ergebniswert liefert, dürfen sie nur auf der rechten Seite einer Zuweisung vorkommen. Wir schreiben deshalb im Editor
ERGEBNIS% =
und drücken dann F4 für die Anzeige der Befehle. Durch Eingabe der Anfangsbuchstaben LO wird automatisch auf LOAD_PICTURE positioniert. Wir wählen den Befehl mit <RETURN> aus und geben folgende Parameter an:

Bei Zeile und Spalte geben wir ZEILE und SPALTE an. Diese Variablen enthalten die Werte, die auf der Maske in den Feldern Zeile und Spalte eingetragen wurden.
Modus = 0 bedeutet, dass das Bild in der Originalgröße angezeigt wird. Die Parameter Höhe in Zeilen und Breite in Spalten haben dann keine Bedeutung.
Löschen = 1 bewirkt, dass ein eventuell vorher angezeigtes Bild zuerst gelöscht wird, bevor das neue Bild angezeigt wird.
Bei Bildname geben wird DATEINAME$ an. DATEINAME$ enthält den Bildnamen, der auf der Maske eingegeben wurde.
Wird drücken "OK" und befinden uns wieder im Editor. Jetzt müssen wir prüfen, ob LOAD_PICTURE einen Fehler gemeldet hat.
IF ERGEBNIS% <> 0
THEN ERRORMES
= "Fehler " + STR$(ERGEBNIS%)
QUIT
ENDIF
ERGEBNIS%
ist <> 0, wenn ein Fehler aufgetreten ist. In diesem Fall wird der Fehler
gemeldet und der Makro mit QUIT verlassen.
Schließlich
soll das erfolgreiche Anzeigen des Bildes in der Indexdatei PROTOKOLL
protokolliert werden.
PROTOKOLL.USERNAME$ = GET_USERNAME$
PROTOKOLL.DATUM = NUMDATE(DATEG8$)
PROTOKOLL.UHRZEIT$ = TIME$
PROTOKOLL.DATEINAME$ = DATEINAME$
WRITE PROTOKOLL ON ERROR ERRORMES
= "Fehler" + STR$(OK) + STR$(OK2) + ": " + ERRORTEXT$
END
GET_USERNAME$ liefert den Usernamen.
NUMDATE wandelt das alphanumerische Datum DATEG8$ in einen numerischen Wert um.
TIME$ enthält die aktuelle Uhrzeit im Format
HH:MM:SS.
WRITE schreibt den Datensatz in die Indexdatei.
Die
Indexdateifelder PROTOKOLL.USERNAME$,... können mit F2 im Editor eingefügt
werden.
Jedesmal
wenn im Editor der Name einer Funktion (z.B. NUMDATE) oder einer Anweisung
eingegeben wird, wird die Syntaxautomatik gestartet. Es erscheint dann wieder
das Fenster zur Eingabe der Parameter. Die Syntaxautomatik kann ausgeschaltet
werden mit F12 im Menuepunkt Datei/Öffnen/Makro.
Der
Makro ist nun vollständig erfasst:

Mit
F12 wird der Makro gespeichert und durch erneutes F12 werden auch die Attribute
des Buttons gespeichert.
Unter
dem Button "Bild laden" fügen wir noch einen weiteren Button ein, der
die Protokolldatei anzeigen soll. Als Makro nachher tragen wir
bei den Attributen PROG1.PROTOKOLL.DATEI ein und starten mit F9 wieder den
Editor.
Die
Funktion SELECT zeigt die Datensätze einer
Indexdatei an.
Vorher
muss mit der Anweisung WINDOWPOS noch
angegeben werden, wo das SELECT-Fenster positioniert werden soll.
WINDOWPOS(0,0)
bewirkt, dass das SELECT-Fenster zentriert im Mainwindow angezeigt wird.

Der
vollständige Makro sieht dann folgendermaßen aus:

Die
Anweisung INITIALIZE bewirkt, dass alle
Felder der Indexdatei mit 0 bzw. Blanks initialisiert werden. Dadurch beginnt
die Anzeige der Datensätze am Anfang der Indexdatei.
Durch
Drücken des Buttons "Speichern" wird die gesamte Maske
gespeichert:

Das
Programm kann jetzt generiert und gestartet werden. Dazu wird der Menuepunkt Generator
(Alt/G) aufgerufen.

Wenn die
Checkboxen Compilierung nach Generierung starten und Programm
nach Compilierung starten gesetzt sind, wird nach der Generierung
automatisch die Compilierung und danach das fertige Programm gestartet.
Voraussetzung ist, dass das JDK 1.5.0 oder höher ordnungsgemäß installiert ist.
Der
Generierungslauf wird gestartet mit F8 oder durch <RETURN>.